Parameters recognized by the ARM implementation
The ARM APIs provide a way to delineate application transactions through the use of a named set of parameters that are recognized by the ARM implementation and Advanced Accounting.
The parameters set for ARM enable the operating system to identify them and Advanced Accounting to measure and record them in the accounting data file. The ARM APIs also enable applications to describe their transactions, so that site-specific information can be provided. This is accomplished largely by convention.
Advanced Accounting recognizes the parameters shown in the following table.
| Parameter | Description |
|---|---|
| application name | The application name is specified through the app_name parameter to the arm_register_application() interface. This parameter is set by the application and cannot be overridden by the user. It names the application, so a name similar to "IBM® DB2 Universal Database" should be used. |
| application group name | The application group name is specified through the app_group parameter to the arm_start_application() interface. This parameter provides a grouping of the individual application instances that are collectively configured to provide an integrated service, so something identifiable such as "Sample Supply Chain Management" should be used. |
| transaction name | The transaction name is specified through the arm_register_transaction() interface. The name that is provided should be descriptive so the data file can be analyzed to determine the type of operation that transpired. |
| identity properties | Identity properties are used to specify properties
that never change values. Identity properties can be specified for
registered applications and transactions so they can be used at different
levels to describe the fixed nature of an application or transaction.
Identity properties can be used to identify discount rates or account
codes that are known by the Advanced Accounting subsystem. Account
codes (similar to project codes) should be specified through the predefined
property: |
| context properties | Context properties are used for information
that changes. Context properties are associated with application and
transaction instances, although Advanced Accounting does not capture
accounting data for the latter. Only the name of the context property
is captured for a transaction instance. Accounting codes (similar
to project codes) can also be specified through context properties.
In this cases, use the predefined property: |