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

TMF ARLIB2 Audit-Reading Procedures

HP NonStop TMF Application Programmer’s Guide—522419-005

5-7

Procedural Retrieval of Message Text

When messages corresponding to error codes are printed on the operator terminal, the

error information is normally remembered by the associated cursor. The text of the

most recent message generated for a given cursor is available by calling the

ARPRINTMESSAGE or ARGETMESSAGELINE procedures.

ARPRINTMESSAGE copies the message text to a file whose filenumber is passed to

the procedure. ARGETMESSAGELINE allows you to retrieve lines of message text

into your application buffer. Both procedures return a warning if no error information is

currently recorded for the specified cursor.

Audit Compression

There are circumstances under which the disk process generates audit records

containing less than the complete before-image and after-image of an updated data

record.

Enscribe

When audit compression is enabled for an Enscribe file, the before-images and after-

images of updated records are recorded as compactly as possible to save space in the

audit trail (only those bytes in the data record that were actually modified are

represented).

If you want to be able to retrieve complete before-images and after-images for

Enscribe updates, do not enable audit compression.

NonStop SQL/MP

By default, NonStop SQL/MP applies a form of audit compression when updating

tables (only the individual fields that changed are recorded).

If you want to be able to retrieve complete before-images and after-images for

NonStop SQL/MP updates, you must first specify the NOAUDITCOMPRESS file

attribute.

If you are reading the audit trail for a NonStop SQL/MP table whose audit records are

compressed, you can use the ARFETCHFIELDVALUE procedure to retrieve the

before-image and after-image of those fields that are present in field-compressed

update records (both updated and key fields). The ARGETFIELDINFO procedure

provides information about the fields that are present.