ARMAppender Syntax Description

appender class="ARMAppender" name="ARM"

specifies ARM as the appender name. The ARMAppender name must be ARM.

Default	None
Restriction	Only a single instance of an ARMAppender per process.
Requirement	Yes. ARM must be the name of the ARMAppender.

name="Agent" value="library-name"

specifies the name of the library that contains the external ARM 4.0 agent library that receives the events. See your vendor documentation for the correct library name. Two values that can be used:

value=" "

if no agent is specified, output is sent to any referenced appenders. In the syntax example, the output is sent to the file appender, "ARM-log-name".

value="library-name"

specifies the name of the library that contains the external ARM 4.0 agent library that receives the events.

Default	Output is sent to any referenced appenders
Requirement	No

name="AppName" value="application-name"

specifies the name of the application. The maximum length of the value is 128 characters, which includes the termination character ( / ). This value is sent to the ARM_REGISTER_APPLICATION() function call. To override this value, specify the SAS start-up option LOGAPPLNAME=application-name.

Default	SAS
Requirement	No

name="ConversionPattern" value="conversion-pattern"

specifies how the log event is written to the ARM log.

Default	None. If a conversion pattern is not specified, then the log event produces an empty string.
Requirement	No

name="Encoding" value="encoding-value"

specifies the type of character set encoding that is used for strings that are sent to and calls that are received by the ARM 4.0 agent library.

Default	Native Unicode character set for the host, or UTF-8 as required by the ARM 4.0 standards.
Requirement	No

name="File" value="path-and-filename"

specifies the path and filename of the file to which ARM messages are written.

Default	None
Requirement	Yes

name="GetTimes" value="TRUE | FALSE"

enables the ARM appender to compute transaction response time metrics.

TRUE

enables the appender to compute transaction response times.

FALSE

disables the appender to compute transaction response times.

Default	False
Requirement	No

name="ManageCorrelators" value="TRUE | FALSE"

specifies whether ARMAppender manages transaction correlation.

TRUE

enables automatic transaction correlation. The true value might affect existing benchmarks for ARM 2.0 records.

FALSE

enables the application to manage transaction correlation.

Default	True
Requirement	No

name="GroupName" value="group-name"

specifies the name of a group of application instances, if any. Application instances that are started with a common run-time purpose are candidates for using the same group name. The maximum length of the value is 256 characters. This value is passed to the ARM_START_APPLICATION() function call.

Default	Current user ID if available, otherwise NULL
Requirement	No