Skip to main content
Skip table of contents

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 underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
OUTPFILEThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
JOBNAMThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
SPLNBRThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
STMFOPTThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
PAGESIZEThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
CUSTOMPAGEThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
PRTDEVThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
PAGEOPTIONThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
SPLITThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
SPLITPAGEThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
SPLITPOSThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
SPLITKEYThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
EXITPGMThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
EXITPGMPRMThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
EXITPGMPOSThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
EXITPGMKEYThe description of this parameter can be found underMenu 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.

*OUTPUTOverlay 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.
*YESOverlay text will be included.
*NOOverlay text will be excluded.
*SPLFi-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.

*YESBlank lines in the original report are reflected in the output. Pages are padded out with blank lines to resemble the original print version.
*NOBlank lines in the original report are not reflected in the output and are compressed out.
*FFBlank 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 .
*IGNOVLDTAAll 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.

*NEWThe 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.

*SPLFThe CPI value specified in the spooled file attributes will be used.
00.1-99.9Enter the desired CPI value.


DBCSThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
EXCLPAGNBRThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
EXCLPAGKEYThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
EXCLLINNBRThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
EXCLLINKEYThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
RSCDIRThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
STMFCODPAGThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
SPLFCCSIDThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1
AUTThe description of this parameter can be found underMenu item 11: Convert spool file to PDF (CVTSPLPDF) Part 1

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.