The PgExTool dll functions are used to manage the data held in two categories of file:
INI files:
An INI file is a text file organized into sections, keys and values.
Example INI file:
[Section_A]
Key_A1=Value_A1
Key_A2=Value_A2
[Section_B]
Key_B1=Value_B1
Key_B2=Value_B2
...
The structure and content of this type of file are not checked by the PgExTool dll functions.
Parameter files generated by the correction validation, which can be handled in EXIT programs:
These INI files contain the following information:
[EXIT_PGM]
VALUE=XXXXX
Where XXXXX can be BEFORE_VALIDATION, AFTER_VALIDATION, BEFORE_RECEPTION or AFTER_RECEPTION.
The PgExTool dll functions use this information to establish that they are handling a parameter file for an EXIT program and perform the following controls:
Consistency between the type of EXIT program and the section: only certain sections are permitted with a given EXIT program.
Consistency between the section and the key.
Consistency between the key and the value, although only with certain keys that can only take specific values.
Section modification authorities; some data, such as the return code, the report or the confirmation message can be modified from the EXIT program and taken into account by the correction validation.
The PgExTool dll functions are divided into two different categories:
Important: In EXIT programs, the PgExTool dll must have already been loaded (using the LOAD_DLL instruction) at the beginning of the program, and still be loaded when the functions it contains are called.
Click below for further information about:
the sections available for "Before Validation" EXIT programs,
the sections available for "After Validation" EXIT programs,
the sections available for "Before Reception" EXIT programs,
the LOAD_DLL 4GL instruction.