Audit Application Program Interface › $NMAUAPI OPT=ADJUST-COUNTER—Gather Statistics

Previous Topic: $NMAUAPI OPT=REGISTER-COUNTER—Register Counter for Utilization Statistics

Next Topic: $NMAUAPI OPT=RESET-COUNTER—Reset Counter

$NMAUAPI OPT=ADJUST-COUNTER—Gather Statistics

The $NMAUAPI OPT=ADJUST-COUNTER API option gathers statistics for the audited activities. You use this option after you register the counter.

This API option has the following format:

$NMAUAPI OPT=ADJUST-COUNTER
         OBJCLASS=#class
        [OBJNAME=object_name]
         ACTION=action_type
         VALUE=adjust_value
        [TRACE={NO | YES}]
OPT=ADJUST-COUNTER

Specifies that the value of the counter be adjusted. The other parameters should match those used when the counter is created.

OBJCLASS=#class

Specifies the class (user-defined) of the objects to be audited. The class name must start with # (for example, #CLASS01).

Limits: Eight characters, including #

OBJNAME=object_name

(Optional) Identifies the object for which statistics is to be gathered.

ACTION=action_type

Specifies the performed action. The API provides the following predefined actions:

ACTION

ADD

CLOSE

COMMAND

COMPILE

CREATE

DELETE

ENHANCE

EXECUTE

ISSUE

LOAD

MODIFY

REPLY

RESET

SET

START

STATECHANGE

STOP

SUPPRESS

TRIGGER

UPDATE

In SMF, actions are represented in hexadecimal values.

If you specify your own action, it will be recorded in SMF as X'FFFF' (USER-DEFINED) with the TEXT field as action_type:action_text. If you want to assign a specific hexadecimal ID to a user action not in the list, you can define it through Common Application Services (CAS).

Limits: 12 characters

VALUE=adjust_value

Specifies a number to decrement or increment the counter.

Limits: Integer, either negative or positive

TRACE

Specifies whether to trace each invocation of the API by writing NMAU0001 messages to the activity log.

TRACE=NO has effect only if the &GLBL$NMAUTRC global variable is not set to YES or Y.

Default: NO