Adding ARM to an Existing SAS Application That Contains Basic ARM Instrumentation

The SAS 9.4 ARM interface does the following:
  • enables applications to conform to ARM 2.0 without modification
  • supports enhanced metric capabilities
  • provides greater flexibility and control of the output data formats by using the SAS logging facility.
Basic ARM 2.0 instrumentation does not contain user-defined metrics or correlation.
The following steps are the recommended changes to an application that contains basic ARM instrumentation:
  1. 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.
  2. Specify ARMAGENT=LOG4SAS in a configuration file or within SAS language code.
  3. Replace the %ARMINIT and %ARMEND macros with the %PERFINIT and %PERFEND macros.
  4. Replace the %ARMSTRT and %ARMSTOP macros with the %PERFSTRT and %PERFSTOP macros.
    Note: The simplified syntax of the %PERFSTRT and %PERFSTOP macros contains the additional default user metrics, which include memory, thread count, and disk Read and Write statistics.
The SAS logging facility contains transaction metrics for key events. The output destination, output format, and quantity of the information can be defined in a file appender.
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.