User guide

RTRA parameters
Program name
Program content: Statistics

In order for the RTRA to automate the processes necessary for confidentiality, your programs need to be written in a standard format. To write a SAS program in the correct format, users need to apply information from the RTRA parameters document and create statistics by calling standard RTRA macros. Terms and usage of these standards are explained below.

RTRA parameters

The RTRA parameters contains essential information that users will require to write their SAS programs. The terms in this document are explained below.

SAS Tag Name - A tag name is a unique reference term for each survey library available through the RTRA system. To ensure access to the correct survey library, the tag name must be referenced in the title of your SAS program. Please refer to Program name for directives on the correct naming convention of your SAS program.

SAS datasets - The SAS dataset name must be referenced using the standard libname called RTRAData. To ensure access to the correct survey dataset, please refer to the RTRA parameters document for the complete list of dataset names.

Rounding base - Frequencies are rounded in accordance with the rounding base specified for each survey dataset. The rounding base is developed using information on the weight distribution, minimum-respondent rules and existing rounding practice for each survey dataset.

Variables renamed - For RTRA compatibility reasons, certain variables are renamed.{No variables are being renamed currently}

Deleted variables - Sensitive variables that pose a disclosure risk are deleted from the micro-data files.

Weight - Weight variables for each survey dataset are made available in this document. Although sample weights do not exist for administrative datasets, a standard name of “WEIGHT” must be inputted for the RTRA system to pass in the macro. This “WEIGHT” variable is equal to 1 for administrative data files.

Execution time limit - The execution time limit specifies the maximum time length for running the program submission. This limit prevents the SAS program from running for an excessive amount of time and consuming unnecessary computing resources.

Program name

To ensure access to the correct survey library, the tag name must be referenced in the title of your SAS program. Please refer to the RTRA parameters for the complete list of tag names.

You will need to name your SAS program starting with the "Tag Name" followed by an underscore. Following that underscore, you may call the program anything you like. For example, researchers submitting a program using the 2006 General Social Survey should name their program: GSS2006_anynameyouwant.sas. Please note that the program name cannot exceed 70 characters or include the characters & and %.

Program content: Statistics

Please ensure your program follows the structure in the sections below.

Part 1: Program element

  • Users need to reference a standard libname called RTRAData. The list of corresponding dataset names can be found in the RTRA parameters.
  • Do not attempt to create a SAS libref; including a libname statement will result in the termination of your program.
  • In this section you can massage the data using "proc sort" and "data steps".
  • When using the "keep" statement or "keep=" dataset option in SAS, you must include the 'ID' variable.

Part 2: Statistics

In this section, tabulations are created by calling the custom RTRA procedures macros. You can call these procedures a maximum of 10 times per program.

Date modified: