Menu item16: Convert spool file into TEXT (CVTSPLTXT)

The command "Convert Spooled File to Text" (CVTSPLTXT) converts spooled files to the plain text format. Files created in this manner can be processed by PC or UNIX applications or viewed in NotePad etc.

Spooled File (FILE)

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

OUTPFILE

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

JOBNAM

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

SPLNBR

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

STMFOPT

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

PAGESIZE

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

CUSTOMPAGE

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

PRTDEV

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

PAGEOPTION

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

SPLIT

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

SPLITPAGE

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

SPLITPOS

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

SPLITKEY

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

EXITPGM

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

EXITPGMPRM

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

EXITPGMPOS

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

EXITPGMKEY

The description of this parameter can be found under

Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

Text Options (TEXT)

Contains four further elements:

Include Overlay Text

Determines if textual content derived from an overlay or page segment object will be included in the output.

Overlays often contain constants, labels, and heading text while the spooled file contains the variable data associated with those constants, labels, and headings. For example, an invoicing application where the overlay might contain text such as "Customer Name", "Invoice Number," and "Invoice Date" and the spooled file supplies the actual customer name, invoice number, and invoice date information to be printed alongside those labels.

In some circumstances, for example when creating PDF versions of the spooled file, it may be appropriate to include the overlay text. How-ever, in other circumstances, for example when identifying bookmark text, it might be more appropriate to exclude the overlay text and process the variable data from the spooled file.

This parameter indicates which option should be chosen.

*OUTPUT	Overlay text is included in the created stream file. However, text from overlays and page segments are ignored when processing text functions such as bookmarks, split triggers and exit program parameters.
*YES	Overlay text will be included.
*NO	Overlay text will be excluded.
*SPLF	i-effect determines, if overlay text should be included, based on the format of the spooled file, which will be converted. Overlay text will be excluded, if the spooled file's format is *SCS. If this is not the case, than the overlay text will be included.

Retain Blank Lines?

This parameter defines if blank lines in the original spooled file should be duplicated in the output or data stream file.

*YES	Blank lines in the original report are reflected in the output. Pages are padded out with blank lines to resemble the original print version.
*NO	Blank lines in the original report are not reflected in the output and are compressed out.
*FF	Blank lines in the original report are reflected in the output. At the end of each page, a form feed character (x'0C' or equivalent) is embedded in the output to force a page throw .
*IGNOVLDTA	All content from overlay and page segment objects (both text and non-text) is ignored and excluded from the processing.

Line Calculation Method

This option determines the way in which i-effect defines the report's line numbers for text file creation and text selection ( e.g. for bookmarks, Split Key, and exit program parameters).
It is not clear how text lines for text parts should be defined by the *ROWCOL method if the spooled files text contains different font sizes, especially with proportional fonts.

*ENVVAR

The method which will be used depends on the setting for environment variables in CS_TXT_LINE_METHOD.

If there are system level variables and job level variables, the job level variables replace the system level variables.

If *NEW is specified as the environment variable, then this method will be used (refer to the following description of *NEW).

If no environment variable exists or it does not contain the value *NEW, the old method will be used (refer to the description of *OLD).

If PTF 5CV0028 or higher is in use and no system level environment variable CS_TXT_LINE_METHOD exists, then it will be created with *OLD. This is to prevent unwanted changes for applications of exis-ting users, which use the old line number calculation.

If the product is being installed or reinstalled and no CS_TXT_LINE_METHOD system environment variable exists, then the variable will be set to *NEW. This affords new users the benefits of the new line calculation methods from the start.

The system environment variables can be changed to activate or deactivate the new method for the whole system. The environment variable can also be replaced at the job level to use a different variable for specific jobs. This can be used to test the effects of a change in the system level variables.

*NEW

The spooled file's LPI attribute will be used to calculate line numbers in the text. This method is also used by DSPSPLF.

*OLD

i-effect uses LPI values, but the results are different than they would be with *NEW and can vary from those displayed by DSPSPLF.

This option is included for backwards compatibility. *NEW is the recommended value. Choose this option, if applications are in use, which display data, based on the old line calculation method. The applications will not need to be modified if this option is chosen.

CPI Value

This option specifies the CPI (Characters Per Inch) value which i-effect will use to calculate column positions in the text file.
Where the spooled file contains text with different font sizes, especially proportional fonts, it is not obvious how to calculate the column position for a piece of text. Both DSPSPLF and, by default, i-effect use the CPI attribute of the spooled file. If this does not render the desired results, for example, if characters overlay one another, try specifying a higher CPI value here than that given in the spooled file attributes.