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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-005
5-62
ARGETFIELDINFO
is-key-field output, optional
INT:ref
is a Boolean value indicating whether or not the field is an element of the primary
key (either user-defined or system-defined) of the data file. The value returned is
nonzero for a key field and 0 for all other types of fields.
next-field output, optional
INT:ref
is the ordinal field number of the next field (in ascending field number order) that is
present in the audit record. If no field follows the field specified by field-number
in the audit record, then next-field is set to -1.
null-allowed output, optional
INT:ref
is a Boolean value indicating whether or not the null value is allowed for the field.
The value returned is nonzero if the field can be set to a null value and 0 if it
cannot be set to a null value. Note that this flag does not indicate whether or not
the field is actually null.
Considerations
•
The file that was modified must be accessible.
•
If a file that has the same name as the modified file, but different characteristics,
exists on disk and is accessible, the results of ARGETFIELDINFO will probably be
incorrect. The TMF audit-reading procedures cannot always detect this situation.
•
If the specified field does not exist in the audit record, return-code is -17 (field
not present). In this case, the value of next-field is valid despite the error
indication.