TMF Application Programmer's Guide (G06.26+)

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-005
5-21
Record Formats
Within some of the record definitions, the EXTERNALNAME entry refers to the
following DSMSMFILESPEC definition:
ABORT (1)
This record is generated whenever a transaction is aborted. Abort records can occur
only in the master audit trail.
Variable-length fields: none
AUX POINTER (17)
This record shows ranges of audit for each auxiliary audit-trail file, creating a logical
ordering among all audit records in audit trails on a given system. Aux pointer records
can occur only in the master audit trail.
Variable-length fields: aux pointers
When an AUX POINTER record is returned by ARREAD, the NUMAUXTRAILS value
may increase. This is because, during the time between two AUX POINTER records,
one or more new auxiliary audit trails could have been added to the audit trail
configuration. When another audit trail is added to the configuration, a range of audit
corresponding to that new trail will exist in every subsequent AUX POINTER record. If
that happens, you should determine if it is necessary to retrieve audit from the new
audit trail for the task at hand and, if so, open a new cursor(s) to read the additional
audit trail(s).
definition DSMSMFILESPEC.
02 FILENAME type character 36. ! \sys.$vdp.svol.file
! blank-filled on right
02 FILENAME-I type binary 16,0 occurs 18 times
redefines FILENAME.
end ! of definition DSMSMFILESPEC.
02 ABORTREC redefines BODY.
04 TRANSID type binary 64,0.
04 HOMENODE type binary 32,0. ! system number
04 FILLER type x(4).
02 AUXPOINTERREC redefines BODY.
04 NUMAUXTRAILS type binary 16,0. ! # of auxiliary
! audit-trail files