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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-004
5-76
AROPEN
returns a number used to identify the cursor in subsequent calls.
min-seqno input, optional
INT(32):value
is a double-word value, within the range 1 through 999999, specifying the minimum
audit file sequence number that this cursor will accept. By including this value, you
can prevent the cursor from reading or being positioned into any audit file whose
sequence number is less than this value. The default value is one.
max-seqno input, optional
INT(32):value
is a double-word value, within the range 1 through 999999, specifying the
maximum audit file sequence number that this cursor will accept. By including this
value, you can prevent the cursor from reading or being positioned into any audit
file whose sequence number is greater than this value. The default value is
999999.
open-flags input, optional
INT:value
specifies certain attributes of the cursor, as described below. If open-flags is
omitted, all fields default to 0.
trail-index-count input, optional
INT:value
is the number of entries in the trail-index-list that follows. If the cursor is
not a MERGE cursor, the value must be zero or the parameter must be omitted. If
specified for a MERGE cursor, the value must be in the range of 1 through 15.
Bit Meaning When Set
0 Audit restore from audit dumps should be attempted for files that are not
present on disk when an attempt is made to read from them.
The requested audit dumps must be in the local TMF catalog and the TMP
process must be running on the local system.
1 Audit restore from audit dumps should be attempted for the next audit file in the
cursor direction if the file is not on disk when the current file is first read. The
use of this option might improve performance for sequential reading through
multiple audit files. This flag bit is ignored unless bit 0 is also set.
all
others
Undefined.