The SASEBLS Interface Engine
Syntax: SASEBLS Interface Engine
The SASEBLS interface engine uses standard engine syntax to read the observations or data values for one or more economic time series. Table 1 summarizes the options that the SASEBLS engine uses. There are two required options: USER=’bls_apikey’ and INSET=’bls_input_dataset_name’.
Table 1: Summary of LIBNAME libref SASEBLS Options
| Option | Description |
|---|---|
| ANNUALAVERAGE= | Specifies whether or not to retrieve annual average data observations |
| ASPECTS= | Specifies whether or not to retrieve the aspects data containing name-value pairs of variables associated with a given data point for a specified BLS series ID |
| CALCULATIONS= | Specifies whether or not to retrieve the net change and percentage change calculations available for 1, 2, 3, 6, or 12 months |
| CASLIB= | Specifies the name of the caslib where the in-memory CAS table containing the BLS data is stored |
| CASOUT= | Specifies the name of the in-memory CAS table, which contains the data that the SASEBLS interface engine returns |
| CATALOG= | Specifies whether or not to retrieve the series descriptive information for a BLS series ID |
| CONNECT= | Specifies whether or not to use the connect method for a secure connection via a proxy server. You must specify the PROXY= option when you use the CONNECT=ON option. |
| DEBUG= | Specifies whether or not to use diagnostic message logging in the SAS log window |
| ENDYEAR= | Specifies the ending year for the observation period (YYYY formatted string, optional) |
| FORMAT= | Specifies a file extension that indicates the type of file to retrieve. Only the JSON format is supported. |
| FREQ= | Specifies the reporting frequency of the selected data: ‘A’ for annual, ‘S’ for semiannual,‘Q’ for quarterly, ‘M’ for monthly. The BLS frequency annual average feature enables you to select ‘A02’, ‘S03’, or ‘M13’ for retrieving annual average data. For the complete list of frequencies, see Table 2. |
| GOCAS= | Specifies whether to generate an in-memory CAS table for the BLS data |
| INSET= | Specifies a SAS input data set that contains a list of BLS time series IDs for retrieving BLS data |
| OUTJSON= | Specifies the name of the output SAS data set and the JSON file requested by the INSET= option |
| PAYPATH= | Specifies the fully qualified name of the location where the SASEBLS engine stores the payload text file that contains the series IDs to retrieve |
| PROXY= | Specifies the proxy server that you want to use (if you have trouble connecting without specifying a proxy). If you also need the connect method for a secure connection, use the CONNECT=ON option in addition to the PROXY= option. See the CONNECT= option. |
| SETNAME= | Specifies the data set name of the data you want to access |
| STARTYEAR= | Specifies the starting year for the observation period (YYYY formatted string, optional) |
| USER= | Specifies the required BLS registration key that enables you to access the data that the BLS website provides |
Last updated: September 15, 2022