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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-005
5-96
How to Include Audit Reading in an
Application
The TMF audit-reading procedures are contained in a set of files that are delivered with
the TMF product. Table 5-4 summarizes the audit-reading procedure files.
Because TMFARLB2 is a native object file, NLD must be used to build the executable
object file. If SQL/MX is installed, the following parameter must be part of the NLD
command:
-l ZCLIPSRL
If SQL/MX is not installed, the -l ZCLIPSRL parameter is not required.
The TMFARUL2 user library file must be associated with the application object file.
Either NLD or the TACL RUN command can be used. For NLD, include the -libname
$vol.subvol.TMFARUL2 option when building the executable file. For TACL, include
the /LIB $vol.subvol.TMFARUL2/ option in the RUN command the first time the
executable file is run.
If the TMFARUL2 file is moved to a new location, either the NLD step or the TACL
RUN command must be used to change the location stored in the executable file.
Using FUP LICENSE and FUP PROGID to a Super group user will allow users other
than SUPER.SUPER to run the program based on Guardian file security.
Both the final application object file and the TMFARUL2 file must be LICENSED.
-902 ARE-FILE-NOT-FOUND The cursor is positioned to a sequence
number that does not correspond to an
audit file on disk, and audit restore failed or
is not enabled. This error condition can
result either from explicit cursor positioning
(ARPOSITION) or successive reads. No
further reads will be allowed for the current
cursor until it has been repositioned.
Internal Errors
-1000 ARE-INTERNAL-ERROR An exceptional condition occurred within
system code. Contact your service
provider.
-2000 ARE-MEMORY-ALLOCATION An internal memory allocation occurred.
Contact your service provider.
Table 5-3. Error Codes by Class (page 4 of 4)
Code DDL Name Meaning