Adding ARM to an Existing SAS Application That Contains Extensive Use of ARM Instrumentation

An application created prior to SAS 9.4 that extensively uses ARM user-defined metrics and correlators continues to execute without modification.

Although you can execute the application without modification, you can enhance performance by making the following changes to the application:

Create a SAS logging facility -logconfigloc configuration file. For an example, see SAS Logging Facility Configuration File. For more information about the SAS logging facility, see SAS Logging: Configuration and Programming Reference.
Specify <name="ManageCorrelators"> and <value="FALSE"> (if correlators are defined) in the SAS logging facility configuration file.
Specify ARMAGENT=LOG4SAS in a configuration file or within SAS language code.
Review the additional user metrics in Default User Metrics within Performance Macros , and add these metric definitions and values to your %ARMGTID, %ARMSTRT, and %ARMSTOP macros.

The SAS logging facility, using the pattern layouts and conversion specifiers, enables you to customize output format and layout. Using default correlation and the additional user metrics enables you to isolate performance issues within the application.

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.