49
CoolSpools Spool Converter User Guide V6R1
Page:
175
www.ariadnesoftware.co.uk
EXITPGMPOS - Exit program parameters string position
Parameter
EXITPGMPOS
Applies to
commands:
CVTSPLSTMF, CVTSPLCSV, CVTSPLHTML, CVTSPLPDF,
CVTSPLRTF, CVTSPLSAV, CVTSPLSPLF, CVTSPLTIFF,
CVTSPLTXT, CVTSPLXLS, SAVSPLF
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).
If you specify your own variable name on Variable name below, you can also refer
to the item of data extracted by this parameter using that name.
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.
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.
In the main, use DSPSPLF as your guide to determine the line number and column
position. However, where you specify an alternative CPI and/or LPI value on the
TEXT parameter, column and/or line numbers will differ from DSPSPLF (which
always uses the spooled file attribute CPI and LPI settings). You might find it helpful
to convert the spooled file to text with CVTSPLTXT using the same CPI and LPI
settings and calculate line and column numbers from the text file thus produced.
Line number
Enter the line number on which the parameter text appears in the spooled file.
In the main, use DSPSPLF as your guide to decide the line number. However, where
you specify an alternative CPI and/or LPI value on the TEXT parameter, column
and/or line numbers will differ from DSPSPLF (which always uses the spooled file
attribute CPI and LPI settings). You might find it helpful to convert the spooled file to
