This function locates the section matching the last item in the list defined by the section configured as a parameter, and retrieves it into the data file.
Important: The PgExTool dll must be loaded (using the LOAD_DLL instruction) at the beginning of the program and must still be loaded when section list management functions are called.
Parameters
ALPHA(256) |
File |
Full name of the data file. |
ALPHA(n) |
ListSection |
List section. |
ALPHA(n) |
ItemSection |
List item section (updated by the function) in the ListSection#number form; ItemSection should be specified to contain more than ListSection . |
NUM_BIN_4 |
SectionSize |
Size of ItemSection : n. |
NUM_BIN_4 |
ReturnCode |
Read return code (updated by the function). |
Possible return code values
0 |
Read operation successful: ItemSection is configured, and contains a section that can be used in the functions PgExToolReadValue and PgExToolWriteValue. |
Failure while retrieving the list item: ItemSection is cleared.
-1 |
Parameter file not found. |
-2 |
Invalid ListSection : - either ListSection is empty, - or the data file is a parameter file for use with an EXIT program and ListSection is not one of the permitted sections. |
-4 |
ItemSection is too small to contain the result of the function. |
-10 |
The requested list item does not exist; consequently, the list is empty. |
Example
/* This example runs through a list in a parameter file |
||
/* for use in an EXIT program during a correction validation procedure |
||
ALPHA(256) |
||
PARAM |
||
|
||
ALPHA(40) |
||
ALPHA(50) |
||
NUM_BIN_4 |
||
NUM_BIN_4 |
||
|
||
ALPHA(40) |
||
ALPHA(200) |
||
|
||
/* Beginning of program: loading PgExTool dll |
||
LOAD_DLL 'PgExTool' |
||
/* Runs backwards through the list of objects received during the |
||
/* correction validation |
||
|
||
ListSection = 'RECEIVED_OBJECT' |
||
SectionSize = 50 |
||
|
||
/* reads the last item section in the list |
||
CALL_DLL 'PgExTool' 'PgExToolLastItemSection' ParamFile ListSection ItemSection SectionSize ReturnCode |
||
|
||
DO_WHILE ReturnCode = 0 |
||
/* the parameters associated with the received object can then be read |
||
/* using ItemSection, for example the name of the received object: |
||
Key = 'NAME' |
||
ValueSize = 200 |
||
CALL_DLL 'PgExTool' 'PgExToolReadValue' ParamFile ItemSection Key Value ValueSize ReturnCode |
||
|
||
|
||
/* reads the previous item section (previous object received) |
||
CALL_DLL 'PgExTool' 'PgExToolPreviousItemSection' ParamFile ListSection ItemSection SectionSize ReturnCode |
||
REDO |
||
/* End of program: unloading DLL |
||
UNLOAD_DLL 'PgExTool' |
||
Click below for further information about: