Key Behaviors That Change with the SAS Logging Facility

If an application containing ARM was created in SAS 9.1 or earlier, you can migrate the application to the SAS logging facility. The SAS 9.4 ARM interface enables the older application, tools, and facilities to execute without change.

The ARM appender is configured and enabled through the SAS logging facility. The following table lists the key behaviors or results for the SAS 9.1 ARM interface option or configuration value.

SAS 9.1 ARM Application and SAS 9.4 ARM Integration
Option or Configuration Value	Behavior or Results	SAS Logging Facility Processing
SAS ARM or PERF macro events, such as %ARMINIT or %PERFINIT	SAS macro processing is the same.	The SAS logging facility namespace is Perf.ARM.APPL. (footnote 1)
ARMAGENT=LOG4SAS	Enables the SAS logging facility ARM appender. ARM transactions are processed by the ARM appender.	SAS 9.1 ARM interface record formats are available through the SAS logging facility %X{ARM2.Record} pattern layout.
ARMSUBSYS=ARM_DSIO	Enables the ARM_DSIO subsystem.	The SAS logging facility namespace is Perf.ARM.DSIO.
ARMSUBSYS=ARM_PROC	Enables the ARM_PROC subsystem.	The SAS logging facility namespace is Perf.ARM.PROC.
ARMLOG and ARMLOC	ARM transaction records are emitted into the SAS logging facility architecture.	SAS 9.1 ARM interface record formats are available through the SAS logging facility %X{ARM2.Record} pattern layout. This option is ignored.
%ARMGTID and %ARMSTRT macros with user metrics	SAS macro processing is the same. Metrics are sent to the SAS logging facility ARM appender and made available as SAS logging facility pattern layout values.	SAS 9.1 ARM interface record formats are available via the SAS logging facility %X{ARM2.Record} pattern layout.

If the SAS logging facility is disabled, existing SAS applications that include ARM transaction support continue to execute without change.

Note: In SAS 9.4, if you have an ARM appender that is defined in the XML configuration file, you no longer need to set the ARMAGENT=LOG4SAS system option. ARM sets ARMAGENT to LOG4SAS internally.

FOOTNOTE 1:The name value is obtained from the SAS system option LOGAPPLNAME=, %ARMINIT macro, or the SAS logging facility configuration specifications.[return]