TMF Application Programmer's Guide (H06.06+, J06.03+)

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—540139-009
5-110
How to Include Audit Reading in an Application
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-6
summarizes the audit-reading procedure files.
Using FUP LICENSE and FUP PROGID to a Super group user will allow users other
than SUPER.SUPER users to run the program based on Guardian file security.
There are two ways to associate the TMFARUL2 library file with the application run
object file: the ELD -libname option, or the TACL RUN command LIB option.
Once the association is made, the LIB option does not need to specified to execute
the program. The RUN command LIB option can be used to change the location of
the TMFARUL2 file.
Examples:
ELD linkfile .. TMFARLB2 .. -o runfile -l ZCLIPDLL .. other
required DLL's ..
-libname $vol.subvol.TMFARUL2
FUP LICENSE (runfile, TMFARUL2)
TACL RUN /LIB TMFARUL2/ runfile
If -libname is part of the ELD step, the TACL LIB option is not required unless the
TMFARUL2 file location changes.
A third party can use the ELD step to build the application file that is shipped to its
customer, the -libname option is not required. Then the customer can do the FUP
LICENSE and TACL RUN command with the LIB option to prepare the files for
execution.
The FUP LICENSE and TACL RUN commands must be executed each time either file
is replaced or moved.
Both the application runfile and TMFARUL2 must be LICENSEd or either a
Process_Create_ error or ARLIB2 error -905 will occur. This will occur even if
Super.Super runs the program.
Usage of the ZCLIDLL and ZCLIPDLL DLLs with the TMFARLB2 product
For the NonStop SQL/MX version released in the H06.10 RVU, the programs that call
the TMFARLB2 procedures must use ZCLIPDLL.
Before this version of SQL/MX, some of the procedures required by TMFARLB2 were
not exported by SQL/MX, thereby resulting in compile or link or run-time error when a
user application tried to compile or link with TMFARLB2.
A workaround for this problem, on releases before the H06.10 RVU, is to use ZCLIDLL
in place of ZCLIPDLL. The ZCLIDLL requires the CRE. This means that the EPTAL
main must be renamed and a C main must be created to call the EPTAL main.