TMF Supplement for Large Audit Files (G06.24+)

TMF Application Programmer’s Guide
HP NonStop TMF Supplement for Large Audit-Trail Files—527391-001
7-3
How to Include Audit Reading in an Application
(Page 5-95)
How to Include Audit Reading in an
Application
(Page 5-95)
The TMF audit-reading procedures are contained in a set of files that are delivered with
the TMF product. Table 7-1 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 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 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.
Table 7-1. Files Supplied With TMFARLB2 (T2781)
File Name Content
ARDECS2 External declarations (in TAL) for the audit-reading procedures.
ARDECSC2 External declarations (in C) for the audit-reading procedures.
ARDDL2, ARC2,
ARCOBOL2,
ARTACL2, ARTAL2
DDL source and corresponding data-definition files for C,
COBOL85, TACL, and TAL programs, respectively, that are going to
call the audit-reading procedures. These files each contain the
following sections:
•
FILESPEC and ARRECORD define the record formats.
•
ARTYPE-LITERALS contains the literals for record types.
•
ARVALUE-LITERALS contains the literals for special values of
certain fields and returned parameters.
•
AR-RETURN-CODES contains the literals for the return codes.
TMFARLB2 Object file containing the ARLIB2 audit-reading procedures.
TMFARUL2 The user library object file that is used by TMFARLB2. This file must
be licensed.