ARM Macros

%ARMPROC Macro

Processes the ARM log, and creates six SAS data sets that contain the information from the log.

Category:	ARM Postprocessing Macro
Restriction:	Do not use with ARMAGENT=LOG4SAS.

Syntax
Options
Details
Input
Output
Examples
	Example 1: Defining a Permanent Library to Store %ARMPROC Macro Output
	Example 2: Supplying the LIB= and LOG= Options

Syntax

%ARMPROC (<option-1 <, ...option-n>>);

Options

LIB=libref

is the libref for the SAS library that contains the six SAS data sets.

Default:

WORK

LOG=pathname

is the pathname for the physical location of the ARM log. If a pathname is not specified, you must pre-assign the ARMLOG fileref before calling the macro.

LOGNEW=pathname

is the pathname of the physical location of the new ARM log. It is used when ARM processing is resumed.

Details

The %ARMPROC macro reads an ARM log and creates six SAS data sets that contain the information from the log. This macro reads the variable name and value pairs from the ARM log as named input (VAR=VALUE). You should pre-assign the ARMLOG fileref before calling the macro or supply the LOG= option. If the ARMLOC= option is ignored, an actual FILENAME statement is required to pre-assign the ARMLOG fileref.

Note: The %ARMPROC macro does not work from SCL. A comma in the name of the log causes the log to be parsed incorrectly. A comma in the data of the UPDATE record does not cause any issues. [cautionend]

Input

The input is the external file containing the ARM log.

Output

The %ARMPROC macro creates six SAS data sets. These SAS data sets contain information from calls to the ARM API function calls. The following lists the six SAS data sets:

INIT--contains information from all ARM_INIT calls
GETID--contains information from all ARM_GETID calls
START--contains information from all ARM_START calls
UPDATE--contains information from all ARM_UPDATE calls
STOP--contains information from all ARM_STOP calls
END--contains information from all ARM_END calls

Examples

Example 1: Defining a Permanent Library to Store %ARMPROC Macro Output

libname user 'f:\arm\user';
    %armproc(lib=user);
run;

Example 2: Supplying the LIB= and LOG= Options

libname armout 'sas library name';
    %armproc(lib=armout,log=c:\userID\arm\armlog);

Top of Page