%ARMPROC Macro

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

Category: ARM Post-Processing Macro
Restriction: Do not use with ARMAGENT=LOG4SAS.

Syntax

Optional Arguments

LIB=libref

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

Default Work

LOG=pathname

is the pathname of 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.
The input is the external file containing the ARM log.
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 'SAS-library';
    %armproc(lib=user);
run;

Example 2: Supplying the LIB= and LOG= Options

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