ARM Appender Syntax

ARMAppender Syntax Description

appender class="ARMAppender" name="ARM"

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

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

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.
Required:	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
Required:	No

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

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

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

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.
Required:	No

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

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

Default:	None
Required:	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
Required:	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
Required:	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
Required:	No

Top of Page