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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-005
5-30
Field Descriptions
DATAFILE
This is the 12-word (24-character) local internal form of the name of the audited file
upon which the action was performed (“$DATA JOB100 PARTS ”, for example).
For files managed by the HP NonStop Storage Management Foundation (SMF)
product, DATAFILE contains the logical name of the affected file. For files not
managed by the SMF product, DATAFILE contains the physical filename.
Users of the TMF audit-reading procedures who change to the SMF environment need
only re-compile their applications using the new audit-reading procedures to take
advantage of this capability.
FRAGMENTS
This is a pair of before- and after-image fragments from a compressed Enscribe
update record.
The NUMFRAGS field returned by the ARREAD procedure specifies the number of
fragments in an audit-compressed update record.
You use the ARFETCHFRAGMENTS procedure to copy the before- and after-image
fragments into your application buffer.
HOMENODE
This is the system number of the home node of a network transaction.
PARENTNODE
This field specifies the system number of the node that was the immediate parent of
the current node in a network transaction.
For a local commit record, the value of PARENTNODE is -1D, indicating that there is
no parent node.
RBA
This field specifies the relative byte address (byte offset) of the audit record within the
audit-trail file. RBA is part of the cursor positioning information.
Record Key
This field is present only in update auditcomp records. The KEYLEN field returned by
the ARREAD procedure specifies the length (in bytes) of the associated record key
field.
For key-sequenced files, the record key field is a byte-for-byte copy of the record key.
For key-sequenced files, you use the ARFETCHRECORDKEY procedure to copy the
record key field from the audit record into your application buffer.