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

TMF ARLIB2 Audit-Reading Procedures

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

5-85

ARSETOPTIONS

This procedure sets several options that control audit-record processing. Rather than

having multiple procedures to turn on and off the various options, this single procedure

controls all of them. If a parameter is not specified, that option is not changed from its

current setting.

return-code output

INT .EXT:ref:1

is a returned value indicating the outcome of this procedure.

return-networkrecs input

INT:value

controls the returning of Network Abort and Network Commit records. If TRUE, the

records are returned. The default is FALSE; the records are not returned.

return-nondatachangerecs input

INT:value

controls the returning of audit records that do not change the data in the database,

including audit generated by AudServ during certain operations WITH SHARED

ACCESS. Some types of SQL/MX audit may also be ignored. If FALSE, the

records are not returned. If TRUE, the records are returned. The default is TRUE;

the records are returned.

max-ignorereccount input

INT(32):value

sets the maximum number of continuous audit records that can be ignored before

returning an ARTYPE-CURRENTPOS record (no data is returned in the body area

of the ARRECORD). Must be zero or a positive number. If zero, there is no limit

on the number of audit records that may be ignored. The default is zero.

CALL ARSETOPTIONS ( return-code ! o

, [ return-networkrecs ] ! i

, [ return-nondatachangerecs ] ! i

, [ max-ignorereccount ] ! i

, [ set-undoauditflag ] ); ! i

Errors (<0) Table 5-3 (later in this section) describes the error codes.

Warnings (>0) None.