46
Page:
135
EXITPGMPOS - Exit program parameters string position
Parameter
EXITPGMPOS
Applies to
commands:
CVTSPLSTMF, CVTSPLCSV, CVTSPLHTML, CVTSPLPDF,
CVTSPLRTF, CVTSPLSAV, CVTSPLSPLF, CVTSPLTIFF,
CVTSPLTXT, CVTSPLXLS, SAVSPLF
Dependent on: CVTSPLSTMF: PMTADLPARM(*YES) and EXITPGMPRM(*POS)
Others: EXITPGMPRM(*POS) or EXITPGMPRM(*POSKEY)
This parameter allows you to define positions in the report from which CoolSpools
will extract items of text and pass them as parameters to the exit program(s) you
specified on the EXITPGM parameter.
If EXITPGM(*VAR) is specified, no exit programs will be called but you can use the
EXITPGMPOS parameter for the purposes of defining variables to be extracted from
the spooled file and referred to through the CoolSpools variable name
<:EXITPGMPOSn:> (where n = 1-99, corresponding to the order in which the
different parameters are defined on the EXITPGMPOS parameter).
Up to 100 parameters may be selected in this way.
Refer to the CoolSpools Programmer‟s Guide for further details of how to write and
call an exit program.
Each item consists of five elements:
o Page number
o Line number or y coordinate
o Char. position or x coordinate
o Length
o Measurement method
Page number
The page number from which the text should be extracted.
CoolSpools will extract the text from the position on the page specified below and will
pass it as a parameter to the exit program(s) defined on the EXITPGM parameter,
but only for the page specified here.
Note that this is the page number from the output file, not the input file. For example,
if CoolSpools splits a 10-page spooled file into two 5-page stream files, then a page
number of 1 on this parameter would refer to the first page in the two stream files,
i.e. pages 1 and 6 from the original spooled file.
Alternatively, specify *ALL and CoolSpools will pass the value at the specified
location on each page in the output file. If the output file consists of 5 pages, 5
parameters will be passed, one for each page.
Line number or y coordinate
Depending on the value specified for the “Measurement method” below, enter either
the line number on which the parameter text appears in the spooled file (*ROWCOL)
or the vertical coordinate on the page at which the start of the text appears
(measured in millimeters for *MM, centimeters for *CM or inches for *INCH).
