Chapter 9 - SPLTOOL Defaults

SPLTOOL allows each user to specify a set of defaults that are to be used when using options in the SPLTOOL display. These defaults only apply when using the SPLTOOL front end. The do not apply when using the interactive or batch commands included with the SPLTOOL package.

A user users the F23=Defaults function key to display and change each of the defaults. The defaults are broken up into groups according to the speicific function to which they apply.

• Global Defaults
• Print Spooled File Range (PRTRNG) Defaults
• Spooled File To Folder (SPLF2FLR) Defaults
• Spooled File To Stream File (SPL2STMF) Defaults
• Spooled File To FTP (SPL2FTP) Defaults
• Misc Defaults

Global Defaults

Global defaults are used to change settings that are applicable to most general functions within SPLTOOL.

• Process in batch - This default is used on all commands that have the process in batch option.
• PC Extension - The extension here will be replaced on all the parameters that as for a PC extension, including the Stream File and FTP options. In these cases this value will be appended to the file name.
• Job Queue - Specify the default job queue to use when the process in batch option is used.
• Translate Table - The default translation table used on all commands that require this parameter.
• Code Page - The default code page used on all commands that require this parameter.
• Overlay - The default overlay to be used on any options that allow an overlay. This must be the fully qualified path and file name of the PDF file you will be using as an overlay.

Print Spooled File Range (PRTRNG) Defaults

The PRTRNG defaults are used to specify defaults used on the PRTRNG option.

• Output Queue - Specify the default output queue that spooled files created with the PRTRNG option will be placed in.
• Hold - Specify the default hold attribute that new spooled files created with the PRTRNG option will have. The valid values are *SAME, *YES, and *NO.
• Save - Specify the default save attribute that new spooled files created with the PRTRNG option will have. The valid values are *SAME, *YES, and *NO.

Spooled File To Folder (SPLF2FLR) Defaults

The SPL2FLR defaults are used to specify defaults used on the SPL2FLR option.

• Folder - Specify the default folder where spooled files copied with this option are to be placed.

Spooled File To Stream File (SPL2STMF) Defaults

The SPLSTMF defaults are used to specify defaults used on the SPL2STMF option.

• Create Directory - Specify the default value for the create directory parameter.
• Replace File - Specify the default value for the replace file parameter.
• Stream File Directory - Specify the default directory in the Integrated File System (IFS) where spooled files copied with this option are to be placed.

Spooled File To FTP (SPL2FTP) Defaults

The SPLSTMF defaults are used to specify defaults used on the SPL2STMF option.

• FTP User ID - Specify the default user id.
• FTP Password - Specify the default password.
• Hide Password - Specify *YES if you want the password hidden on the FTP Spooled File option. Specify *NO if you don't want the password hidden. The parameter also affects if the password is hidden or not on this display.
• FTP *PUT or *APP - Specify the default value for the *PUT or *APP parameter. *PUT specifies to put the file and replace it if is already exists. *APP specifies to append the file to the existing file of the same name, or create the file if it doesn't exist.
• FTP Representation - Specify the default value for the FTP representation.
• FTP Remote Sys - Specify the default IP address or host name that you are FTPing files to. The host that you are transferring to must be running and FTP server.
• FTP Remote Directory - Specify the default directory to place the spooled files on the host machine when the FTP option is used.

Misc Defaults

• If you already have multiple spooled files with HTML embedded in the data and do not wish to convert all of the < and > characters to %%< and %%>, make sure you have at least v7.33 and service pack st031202 installed. You can then issue the following command to override the HTML conversions:
  • CRTDTAARA DTAARA(QGPL/SPLCVTHTML) TYPE(*CHAR) VALUE(N)
  • Please bear in mind that if any < or > characters exist in your spooled file data that is not intended to be HTML this may corrupt your data.
• In older versions of SPLTOOL if you created a text file using SPLTOOL it would eliminate the trainiling blank lines from the document. For example, if you had 60 available lines, and only 40 were used, the remaining 20 would not be included in the document. The latest version of SPLTOOL includes these blank lines.
  • If you want SPLTOOL to behave like the older version and not include the blank lines use the followingn command:
    • CRTDTAARA DTAARA(QGPL/SPLINCBLNK) TYPE(*CHAR) VALUE(N)
    • This will create a data area that will tell SPLTOOL to not include trailing blank lines in a document conversion.