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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-005
5-76
AROPEN
AROPEN
This procedure opens a cursor. You can specify bounds on the sequence number of
the audit files to which the cursor refers. The number of the cursor assigned to the
audit trail is returned for use in subsequent calls to other audit-reading procedures.
return-code output
INT .EXT:ref:1
is a returned value indicating the outcome of this procedure.
generic-name input
INT:ref:9
is an array containing the name ($volume.subvol.two-char-prefix) of the audit-trail
file (must be in local internal format) or the audit-trail identifier (MAT, MERGE,
AUX01…AUX15) which identifies the audit trail to be read. If the audit-trail ID is
MERGE, a merge cursor is opened and the master audit trail and auxiliary audit
trails are merged into a single cursor (note that AuxPtr records are not returned to
the application).
If the subvol name is "ZTMFAT" or generic-name is an audit-trail ID, TMF must be
running and the TMP will locate and restore the necessary audit-trail files. If audit
restore is allowed and is required, the TMP will start a TMFDR process to restore
the audit file to a configured restore volume. When an EOF is returned, there is no
need to close and reopen the cursor or call ARPOSITION. Simply delay a short
time and call ARREAD again so that any additional audit written to the audit trail
will be returned, even if a rollover to a new audit file has occurred. If TMF is not
running, an error 82 will be returned when trying to obtain the current audit-file
name or EOF.
If the subvol name is not “ZTMFAT” or an audit-trail ID, you must pre-restore the
audit files to a chosen location and specify that location in this parameter.
cursor-number output
INT:ref
CALL AROPEN ( return-code ! o
, generic-name ! i
, cursor-number ! o
, [ min-seqno ] ! i
, [ max-seqno ] ! i
, [ open-flags ] ! i
, [ trail-index-count ] ! i
, [ trail-index-list ] ); ! i
Errors (<0) Table 5-3 (later in this section) describes the error codes.
Warnings (>0) None.