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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-005
5-43
ARFETCHFIELDVALUE
ARFETCHFIELDVALUE returns an error for values of max-before-copy-len
less than 1.
actual-before-len output, optional
INT:ref
returns the actual length of the retrieved before-image of the field. For a variable-
length character (VARCHAR) field, this value includes the 2-byte length word of the
field. For null fields, this count includes the two bytes occupied by the null
indicator.
after-image output, optional
INT .EXT:ref:*
is a buffer in the application process in which the after-image of the field is
returned.
max-after-copy-len input, optional
INT:value
is the maximum number of bytes to copy into after-image. This value must be
supplied if after-image is present.
ARFETCHFIELDVALUE returns an error for values of max-after-copy-len
less than 1.
actual-after-len output, optional
INT:ref
returns the actual length of the retrieved after-image of the field. In the case of a
variable-length character (VARCHAR) field, this value includes the 2-byte length
word of the field. For fields that can be set to a null value, this count includes the
2 bytes occupied by the null indicator.
Considerations
•
The modified data file 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 ARFETCHFIELDVALUE will most
likely be incorrect. The TMF audit-reading procedures cannot always detect this
situation.