Chapter 5 - SPLTOOL Batch Commands

The SPLTOOL package contains a set of batch commands that makes performing options on one or a group of spooled files much easier. These commands are similar to the interactive commands discussed in Chapter 4 but the difference being these commands allow the use of generic names or the *ALL parameter.

This means that you can perform options on spooled files easily by such attributes and file name, user, form type, output queue and user data.

The batch commands available with SPLTOOL are:

  • Spooled File to Folder - Batch (SPL2FLRB) - Use this command to copy a set of spooled files to a folder.
  • Spooled File to Stream File - Batch (SPL2STMFB) - Use this command to copy a set of spooled files to the Integrated File System (IFS).
  • Spooled File to FTP - Batch (SPL2FTPB) - Use this command to FTP a set of spooled files to a machine running an FTP server.
  • Spooled File to Email - Batch (SPL2EMAILB) - Use this command to Email a set of spooled files to a recipient as attachments. The maximum number of spooled files is 50 using this command. You must have the MAILTOOL program installed, be on V4R3 or higher of the operating system, and have email working for this option to function.

Spooled File to Folder - Batch (SPL2FLRB)

**NOTE: The SPL2FLR and SPL2FLRB commands will be removed in the future from SPLTOOL as they are and have been obsolete for a while.  Please update your applications to use the SPL2STMF and SPL2STMFB commands and also use the IFS instead of the QDLS file system.

                    Spooled File To Folder - Batch (SPL2FLRB)

Type choices, press Enter.

Output queue . . . . . . . . . . __________ Name, *ALL
Library . . . . . . . . . . . *LIBL_____ Name, *LIBL
Spooled file . . . . . . . . . . __________ *ALL, generic*, Name
User Name . . . . . . . . . . . __________ *CURRENT, *ALL, Name
Job Name . . . . . . . . . . . . __________ *ALL, generic*, Name
Job Number . . . . . . . . . . . __________ *ALL, 000000-999999
Spooled File Number . . . . . . ________ *ALL, 1-9999
User data . . . . . . . . . . . __________ *ALL, User data
Form type . . . . . . . . . . . __________ *ALL, Form type
From Date (MMDDYYYY) . . . . . . *ALL______ Number, *ALL
To Date (MMDDYYYY) . . . . . . . *ALL______ Number, *ALL
Folder . . . . . . . . . . . . . ___________________________________________________
___________________________________
PC file extension . . . . . . . ___ Name
Replace file . . . . . . . . . . *NO *YES, *NO, *ADD

Stream file code page . . . . . 437 1-32767

Only file name . . . . . . . . . *NO *NO, *YES
File name . . . . . . . . . . . *NONE__ *JOB, *FILE, *USER, File name
Include blank pages . . . . . . *YES *YES, *NO
HTML Title . . . . . . . . . . . ___________________________________________________
_______________________________________________________________________________________
___________
Line selection . . . . . . . . . ___________________________________________________
_______________________________________________________________________________________
____________________________________________________________...
PDF Password . . . . . . . . . . *NONE______________________________________________


F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display
F24=More keys

  • Output Queue - Enter an output queue to select spooled files from or specify *ALL for all output queues.
  • Spooled file - Enter a spooled file name to select spooled files, *ALL for all spooled files, or a generic name ending with an asterisk (*).
  • User Name - Enter a user name to select spooled files, *CURRENT to specify the current user, or *ALL to specify all user names.
  • Job Name - Enter a job name to select spooled files, *ALL to specify all job names, or a generic job name ending with an asterisk (*).
  • Job Number - Enter a job number that identifies the spooled file or *ALL to specify all job numbers.
  • Spooled file number - Enter a spooled file number to select a spooled file or *ALL to specify all spooled file numbers.
  • User Data - Enter a value to select spooled files by user data or *ALL to specify all user data attributes.
  • Form Type - Enter a value to select spooled files by form type or *ALL to specify all form type attributes.
  • From Date - Enter a value to select spooled files by form date. This is the beginning date. Specify *ALL for all spooled files.
  • To Date - Enter a value to select spooled files by form date. This is the ending date. Specify *ALL for all spooled files.
  • Folder - Enter the name of the folder that exists on your AS/400 that you wish the new document to be created in. The folder must exist. To check for the existance of the folder, use the Work with Folders (WRKFLR) command.
  • PC file extension - Enter the extension of the new document. This value should be entered for both automatic and manual file naming.
  • Merge spooled files - No longer available with v9.60 and up.
  • Replace file - Specify if the file created should replace an existing file.
  • Stream file code page - Specify the stream file code page that the resulting document should use.
  • Only file name - If you wish to specifically name the target file, enter *YES in this paramter and then enter a value on the file name parameter. If you want SPLTOOL to automatically name the spooled files for you, enter *NO on this parameter.
  • File name - If you specified *YES on the Only file name parameter, enter the file name you wish SPLTOOL to name the target file. Special values for this parameter are *USER, *JOB, and *FILE which will name the target file with the user name, job name, or file name respectively. Entering *NONE or leaving this parameter blank will tell SPLTOOL to automatically name the files even if the Only file name parameter is *YES.
  • Include Blank Pages - Specify *YES to include blank pages, or *NO to omit blank pages from the resulting file.
  • HTML Title - Enter the title of the document if you are copying the new file to an .htm (web page) extension. This will set the title of the report.
  • Line Selection - This is used as an array to tell this command which lines of the spooled file to omit. Placeing an "X" in a position will cause the corresponding line to be ommitted from the new file. For example, if position 2 contains a "X", the second line of every page of the spooled file will be ommitted. This is used to remove standard headings from every page of the new document.
  • PDF Password - Enter an optional password to protect the PDF.

Spooled File to Stream File - Batch (SPL2STMFB)

                   Spooled File To Stream File - Batch (SPL2STMFB)

Type choices, press Enter.

Output queue . . . . . . . . . . __________ Name, *ALL
Library . . . . . . . . . . . *LIBL_____ Name, *LIBL
Spooled file . . . . . . . . . . __________ *ALL, generic*, Name
User Name . . . . . . . . . . . __________ *CURRENT, *ALL, Name
Job Name . . . . . . . . . . . . __________ *ALL, generic*, Name
Job Number . . . . . . . . . . . __________ *ALL, 000000-999999
Spooled File Number . . . . . . ________ *ALL, 1-9999
User data . . . . . . . . . . . __________ *ALL, User data
Form type . . . . . . . . . . . __________ *ALL, Form type
From Date (MMDDYYYY) . . . . . . *ALL______ Number, *ALL
To Date (MMDDYYYY) . . . . . . . *ALL______ Number, *ALL
Directory . . . . . . . . . . . ____________________________________________________
_____________________________________
PDF Overlay . . . . . . . . . . ____________________________________________________
Concatenate PDF . . . . . . . . ____________________________________________________
File Name Prefix . . . . . . . . *JOB______________________
PC file extension . . . . . . . __________ Name
Only file name . . . . . . . . . *NO *NO, *YES
File name . . . . . . . . . . . *NONE_______________________________________________
______
Merge Spooled Files . . . . . . *NO *YES, *NO
Create directory . . . . . . . . *NO_ *YES, *NO
Public authority for data . . . *INDIR *INDIR, *RWX, *RW, *RX...
Public authority for object . . *INDIR *INDIR, *NONE, *ALL...
Replace file . . . . . . . . . . *NO_ *YES, *NO
Stream file code page . . . . . 437_______ 1-32767, *STMF, *PCASCII...
Include blank pages . . . . . . *YES *YES, *NO
HTML Title . . . . . . . . . . . ___________________________________________________
_______________________________________________________________________________________
___________
Line selection . . . . . . . . . ___________________________________________________
_______________________________________________________________________________________
____________________________________________________________...
PDF Password . . . . . . . . . . *NONE______________________________________________
Manufacturer type and model . . *WSCST
WSCST Name . . . . . . . . . . . QWPTIFFG4 Character value, *NONE
WSCST Library . . . . . . . . . QSYS Character value, *LIBL
Page width . . . . . . . . . . . 8.5 Number
Page length . . . . . . . . . . 11 Number
Page rotation . . . . . . . . . 0 0, 90, 180, 270
Margin offset . . . . . . . . . 20 Number
Left margin offset . . . . . . . 0 Number
Top margin offset . . . . . . . 0 Number

F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display
F24=More keys

  • Output Queue - Enter an output queue to select spooled files from or specify *ALL for all output queues.
  • Spooled file - Enter a spooled file name to select spooled files, *ALL for all spooled files, or a generic name ending with an asterisk (*).
  • User Name - Enter a user name to select spooled files, *CURRENT to specify the current user, or *ALL to specify all user names.
  • Job Name - Enter a job name to select spooled files, *ALL to specify all job names, or a generic job name ending with an asterisk (*).
  • Job Number - Enter a job number that identifies the spooled file or *ALL to specify all job numbers.
  • Spooled file number - Enter a spooled file number to select a spooled file or *ALL to specify all spooled file numbers.
  • User Data - Enter a value to select spooled files by user data or *ALL to specify all user data attributes.
  • Form Type - Enter a value to select spooled files by form type or *ALL to specify all form type attributes.
  • From Date - Enter a value to select spooled files by form date. This is the beginning date. Specify *ALL for all spooled files.
  • To Date - Enter a value to select spooled files by form date. This is the ending date. Specify *ALL for all spooled files.
  • Directory - Enter the name of the directory that resides in your AS/400 IFS that you wish the new document to be created in. If the path does not exist and the Create directory parameter is set to *YES, the path will be created.
  • PDF Overlay - This parameter allows you to specify a PDF file that resides in the IFS that will be overlayed on top of the PDF created by SPLTOOL.  This can be used for report design, adding letterheads, etc.
  • Concatenate PDF - Specify the path to an existing PDF to append to the end of the PDF created from the spooled file.
  • File Name Prefix - If you are letting SPLTOOL name the target files for you, you can specify a value here that will be used as a prefix for the filename. You can enter any string, or the specify value of *JOB which will use the job name as the file prefix.
  • PC file extension - Enter the extension of the new document. This value should be entered for both automatic and manual file naming.
  • Only file name - If you wish to specifically name the target file, enter *YES in this paramter and then enter a value on the file name parameter. If you want SPLTOOL to automatically name the spooled files for you, enter *NO on this parameter.
  • File name - If you specified *YES on the Only file name parameter, enter the file name you wish SPLTOOL to name the target file. Special values for this parameter can be found at the bottom of this page. Entering *NONE or leaving this parameter blank will tell SPLTOOL to automatically name the files even if the Only file name parameter is *YES.
  • Merge spooled files - Specify if all spooled files in selection should be merged into one file.  This is only valid for PDF formats.
  • Create directory - Enter *YES if you want the target directory to be created if it does not exist or *NO if you do not wish to create the directory.
  • Public authority for data - Enter the public authority for data if a new directory is created.
  • Public authority for object - Enter the public authority for object if a new directory is created.
  • Replace File - Enter *YES if you wish to replace the document if it already exists or *NO to not replace the document.
  • Stream file code page - Enter the code page for the new document.
  • Include Blank Pages - Specify *YES to include blank pages, or *NO to omit blank pages from the resulting file.
  • HTML Title - Enter the title of the document if you are copying the new file to an .htm or .html (web page) extension. This will set the title of the report.
  • Line Selection - This is used as an array to tell this command which lines of the spooled file to omit. Placeing an "X" in a position will cause the corresponding line to be ommitted from the new file. For example, if position 2 contains a "X", the second line of every page of the spooled file will be ommitted. This is used to remove standard headings from every page of the new document.
  • PDF Password - Enter an optional password to protect the PDF.
  • Manufacturer Type and Model - Used when converting AFPDS spooled files to PDF.
  • WSCST Name - Used when converting AFPDS spooled files to PDF.
  • WSCST Library - Used when converting AFPDS spooled files to PDF.
  • Page Length - Used when converting AFPDS spooled files to PDF.
  • Page Width - Used when converting AFPDS spooled files to PDF.
  • Page Rotation - Used when converting AFPDS spooled files to PDF.
  • Margin Offset - Used when converting AFPDS spooled files to PDF.
  • Left Margin Offset - Used when converting AFPDS spooled files to PDF.
  • Top Margin Offset - Used when converting AFPDS spooled files to PDF.

Spooled File to FTP - Batch (SPL2FTPB)

                     Spooled File To FTP - Batch (SPL2FTPB)

Type choices, press Enter.

Output queue . . . . . . . . . . __________ Name, *ALL
Library . . . . . . . . . . . *LIBL_____ Name, *LIBL
Spooled file . . . . . . . . . . __________ *ALL, generic*, Name
User Name . . . . . . . . . . . __________ *CURRENT, *ALL, Name
Job Name . . . . . . . . . . . . __________ *ALL, generic*, Name
Job Number . . . . . . . . . . . __________ *ALL, 000000-999999
Spooled File Number . . . . . . ________ *ALL, 1-9999
User data . . . . . . . . . . . __________ *ALL, User data
Form type . . . . . . . . . . . __________ *ALL, Form type
From Date (MMDDYYYY) . . . . . . *ALL______ Number, *ALL
To Date (MMDDYYYY) . . . . . . . *ALL______ Number, *ALL
IP address . . . . . . . . . . . ___________________________________
User ID . . . . . . . . . . . . ___________________________________
Password . . . . . . . . . . . . ___________________________________
Directory . . . . . . . . . . . ___________________________________________________
________________________________________
PDF Overlay . . . . . . . . . . ____________________________________________________
Concatenate PDF . . . . . . . . ____________________________________________________
File Name Prefix . . . . . . . . *JOB______________________
PC file extension . . . . . . . __________ Name
Only file name . . . . . . . . . *NO *NO, *YES
File name . . . . . . . . . . . *NONE_______________________________________________
______
Put or Append . . . . . . . . . *PUT *PUT, *APP
FTP Representaction . . . . . . ASCII__________________________
Stream file code page . . . . . 437 1-32767
Merge spooled files . . . . . . *NO *YES, *NO
Include blank pages . . . . . . *YES *YES, *NO
HTML Title . . . . . . . . . . . ___________________________________________________
_______________________________________________________________________________________
___________
Line selection . . . . . . . . . ___________________________________________________
_______________________________________________________________________________________
____________________________________________________________...
PDF Password . . . . . . . . . . *NONE______________________________________________
Manufacturer type and model . . *WSCST
WSCST Name . . . . . . . . . . . QWPTIFFG4 Character value, *NONE
WSCST Library . . . . . . . . . QSYS Character value, *LIBL
Page width . . . . . . . . . . . 8.5 Number
Page length . . . . . . . . . . 11 Number
Page rotation . . . . . . . . . 0 0, 90, 180, 270
Margin offset . . . . . . . . . 20 Number
Left margin offset . . . . . . . 0 Number
Top margin offset . . . . . . . 0 Number

F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display
F24=More keys

  • Output Queue - Enter an output queue to select spooled files from or specify *ALL for all output queues.
  • Spooled file - Enter a spooled file name to select spooled files, *ALL for all spooled files, or a generic name ending with an asterisk (*).
  • User Name - Enter a user name to select spooled files, *CURRENT to specify the current user, or *ALL to specify all user names.
  • Job Name - Enter a job name to select spooled files, *ALL to specify all job names, or a generic job name ending with an asterisk (*).
  • Job Number - Enter a job number that identifies the spooled file or *ALL to specify all job numbers.
  • Spooled file number - Enter a spooled file number to select a spooled file or *ALL to specify all spooled file numbers.
  • User Data - Enter a value to select spooled files by user data or *ALL to specify all user data attributes.
  • Form Type - Enter a value to select spooled files by form type or *ALL to specify all form type attributes.
  • From Date - Enter a value to select spooled files by form date. This is the beginning date. Specify *ALL for all spooled files.
  • To Date - Enter a value to select spooled files by form date. This is the ending date. Specify *ALL for all spooled files.
  • IP Address - Enter the IP address of server name (if it is resolvable from your AS/400) of the machine you wish to FTP the spooled file to.
  • User ID - Enter the User ID required to sign on to the remote FTP server.
  • Password - Enter the password required to sign on to the remote FTP server.
  • Directory - Enter the name of the directory of the remote machine you wish the new document to be created in.
  • PDF Overlay - This parameter allows you to specify a PDF file that resides in the IFS that will be overlayed on top of the PDF created by SPLTOOL.  This can be used for report design, adding letterheads, etc.
  • Concatenate PDF - Specify the path to an existing PDF to append to the end of the PDF created from the spooled file.
  • File Name Prefix - If you are letting SPLTOOL name the target files for you, you can specify a value here that will be used as a prefix for the filename. You can enter any string, or the specify value of *JOB which will use the job name as the file prefix or the value of *USRDTA which will use the user data as the file prefix.
  • PC file extension - Enter the extension of the new document. This value should be entered for both automatic and manual file naming. The following substitution variables may be used: &F - File Name, &J - Job Name, &N - Job Number, &U - User ID, &S - Spooled File Number, &R - User Data.
  • Only file name - If you wish to specifically name the target file, enter *YES in this paramter and then enter a value on the file name parameter. If you want SPLTOOL to automatically name the spooled files for you, enter *NO on this parameter.
  • File name - If you specified *YES on the Only file name parameter, enter the file name you wish SPLTOOL to name the target file. Special values for this parameter can be found at the bottom of this page. Entering *NONE or leaving this parameter blank will tell SPLTOOL to automatically name the files even if the Only file name parameter is *YES. The following substitution variables may be used:&F - File Name, &J - Job Name, &N - Job Number, &U - User ID, &S - Spooled File Number, &R - User Data.
  • Put or Append - Enter *PUT to put the file to the remote server. If the file already exists on the target machine, it will be replaced. Enter *APP to append the file to the remote server. If the file already exists, the data will be appended to the file, otherwise the file will be created.
  • FTP Representation - Enter the FTP representation to use with the file transfer.
  • Stream file code page - Enter the code page for the new document.
  • Merge spooled files - Specify if all spooled files in selection should be merged into one file.   This is only valid for PDF formats.
  • Include Blank Pages - Specify *YES to include blank pages, or *NO to omit blank pages from the resulting file.
  • HTML Title - Enter the title of the document if you are copying the new file to an .htm or .html (web page) extension. This will set the title of the report.
  • Line Selection - This is used as an array to tell this command which lines of the spooled file to omit. Placeing an "X" in a position will cause the corresponding line to be ommitted from the new file. For example, if position 2 contains a "X", the second line of every page of the spooled file will be ommitted. This is used to remove standard headings from every page of the new document.
  • PDF Password - Enter an optional password to protect the PDF.
  • Manufacturer Type and Model - Used when converting AFPDS spooled files to PDF.
  • WSCST Name - Used when converting AFPDS spooled files to PDF.
  • WSCST Library - Used when converting AFPDS spooled files to PDF.
  • Page Length - Used when converting AFPDS spooled files to PDF.
  • Page Width - Used when converting AFPDS spooled files to PDF.
  • Page Rotation - Used when converting AFPDS spooled files to PDF.
  • Margin Offset - Used when converting AFPDS spooled files to PDF.
  • Left Margin Offset - Used when converting AFPDS spooled files to PDF.
  • Top Margin Offset - Used when converting AFPDS spooled files to PDF.
Note:  The special value of *USRDFT can be used on the IP Address, User ID, Password and Directory parameters and the values set up as defaults in the SPLTOOL interface for that user will be used.

Spooled File to Email - Batch (SPL2EMAILB)

                   Spooled File To E-Mail - Batch (SPL2EMAILB)

Type choices, press Enter.

Output queue . . . . . . . . . . __________ Name, *ALL
Library. . . . . . . . . . . . __________ Name, *LIBL
Spooled File . . . . . . . . . . __________ *ALL, generic*, Name
User name . . . . . . . . . . . __________ *CURRENT, *ALL, Name
Job Name . . . . . . . . . . . . __________ *ALL, generic*, Name
Job Number . . . . . . . . . . . __________ *ALL, 000000-999999
User data . . . . . . . . . . . __________ *ALL, User data
Form type . . . . . . . . . . . __________ *ALL, Form type
To Address . . . . . . . . . . . ___________________________________________
To Name . . . . . . . . . . . . ___________________________________________
From Address . . . . . . . . . . ___________________________________________
From Name . . . . . . . . . . . ___________________________________________
CC Address . . . . . . . . . . . ___________________________________________
CC Name . . . . . . . . . . . . ___________________________________________
BCC Address . . . . . . . . . . ___________________________________________
BCC Name . . . . . . . . . . . ___________________________________________
Subject . . . . . . . . . . . . ___________________________________________
Message Text . . . . . . . . . . ___________________________________________
MDN Address . . . . . . . . . . *NONE______________________________________
MDN NAME . . . . . . . . . . . . *NONE______________________________________
Sender Address . . . . . . . . . *NONE______________________________________    
Sender Name . . . . . . . . . . ___________________________________________
Importance . . . . . . . . . . . *NORMAL *NORMAL, *HIGH, *LOW...
PDF Password . . . . . . . . . . *NONE______________________________________________
Merge Spooled Files . . . . . . *NO *YES, *NO
Recipient Separator . . . . . . ',' Character value
Debug . . . . . . . . . . . . . *NO *YES, *NO
Debug File Name . . . . . . . . 'mailtooldebug.txt'________________________
Extra Attachment . . . . . . . . *NONE______________________________________
Footer Stream File . . . . . . . *NONE______________________________________
PDF Overlay . . . . . . . . . . ____________________________________________
Concatenate PDF . . . . . . . . ____________________________________________
Send With Server Type . . . . . *IBMSMTP *MAILTOOL, *IBMSMTP
Mail Router . . . . . . . . . . *NONE
Use Mail Router . . . . . . . . *NO *NO, *YES, *ONLY
Perform MX Lookup . . . . . . . *YES *NO, *YES
SMTP Auth User . . . . . . . . . *NONE
SMTP Auth Password . . . . . . . *NONE
File Name Prefix . . . . . . . . *JOB______________________
PC file extension . . . . . . . __________ Name
Only file name . . . . . . . . . *NO *NO, *YES
File name . . . . . . . . . . . *NONE_______________________________________________
______
Stream file code page . . . . . 437_______ 1-32767, *STMF, *PCASCII...
Translate Table . . . . . . . . Q037337850 Name
Library . . . . . . . . . . . *LIBL_____ Name, *LIBL, *CURLIB
Mime header code page . . . . . 819 1-65535
WSCST Name . . . . . . . . . . . QWPTIFFG4 Character value, *NONE
WSCST Library . . . . . . . . . QSYS Character value, *LIBL
Page width . . . . . . . . . . . 8.5 Number
Page length . . . . . . . . . . 11 Number
Page rotation . . . . . . . . . 0 0, 90, 180, 270
Margin offset . . . . . . . . . 20 Number
Left margin offset . . . . . . . 0 Number
Top margin offset . . . . . . . 0 Number
Include blank pages . . . . . . *YES *YES, *NO
HTML Title . . . . . . . . . . . ____________________________________________

F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display
F24=More keys

  • Output Queue - Enter an output queue to select spooled files from or specify *ALL for all output queues.
  • Spooled file - Enter a spooled file name to select spooled files, *ALL for all spooled files, or a generic name ending with an asterisk (*).
  • User Name - Enter a user name to select spooled files, *CURRENT to specify the current user, or *ALL to specify all user names.
  • Job Name - Enter a job name to select spooled files, *ALL to specify all job names, or a generic job name ending with an asterisk (*).
  • Job Number - Enter a job number that identifies the spooled file or *ALL to specify all job numbers.
  • Spooled file number - Enter a spooled file number to select a spooled file or *ALL to specify all spooled file numbers.
  • User Data - Enter a value to select spooled files by user data or *ALL to specify all user data attributes.
  • Form Type - Enter a value to select spooled files by form type or *ALL to specify all form type attributes.
  • To Address - Enter the email address of the person you wish to email this spooled file to.
  • To Name - Enter the name of the person you are emailing this spooled file to.
  • From Address - Enter the email address of the person sending the email.
  • From Name - Enter the name of the person sending the email.
  • CC Address - Enter the email address of a Carbon Copy recipient.
  • CC Name - Enter the name of the Carbon Copy recipient.
  • BCC Address - Enter the email address of a Blind Carbon Copy recipient.
  • BCC Name - Enter the name of the Blind Carbon Copy recipient.
  • Subject - Enter the text that you wish to appear in the subject line of the email.
  • Message Text - Enter the test that you wish to appear in the message body of the email.
  • MDN Address - Specifies the Message Disposition Notification email address to be used. With some email clients, a receipt will be returned to this email address when the email message is delivered to and read by the recipient. Do keep in mind that this method is not foolproof and can be turned off on the server or client level of the recipient. In some cases it is not even supported. See RFC 2298. The possible values are: *NONE - No MDN is requested *FROM - Use the "From" email address for the MDN address.
  • MDN Name - Specifies the name to be used with the MDN email address. This parameter will be ignored if *FROM is used for the MDNADDR parameter.
  • Sender Address - Specifies the "sender" address to be used.  The values available are *NONE, *FROM, which will use the FROM address, or you can enter an email address.
  • Sender Name - Specifies the name to be used with the Sender email address.  This parameter will be ignored if *FROM is used for the SENDADDR parameter.
  • Extra Attachment - Enter the qualified names of any files you would like to attach to the email besides the spooled file.
  • Footer Stream File - Specify the full path and file name of a stream file containing data to be included as a footer in the email.  The special value of *NONE specifies that no footer will be included.
  • PDF Overlay - This parameter allows you to specify a PDF file that resides in the IFS that will be overlayed on top of the PDF created by SPLTOOL.  This can be used for report design, adding letterheads, etc.
  • Concatenate PDF - Specify the path to an existing PDF to append to the end of the PDF created from the spooled file.
  • Send With Server Type - Enter *IBMSMTP to send with the default IBM SMTP Server, or specify *MAILTOOL to send using MAILTOOL Plus! (requires MAILTOOL Plus!)
  • Mail Router - Specify the IP address or domain name of the mail router to use to send emails when specifying SENDWITH(*MAILTOOL). If no mail router is used, specify *NONE.
  • Use Mail Router - If specifying a mail router to use, specify *ONLY to use only the mail router, or specify *YES to use the mail router as a backup if none of the host mail servers are reachable. (Note: If you are using a mail router, most of the time you should specify *ONLY).
  • Perform MX Lookup - Specify if an MX lookup should be performed on the mail router specified.  This value can only be *NO if USERTR is*YES or *ONLY.
  • SMTP Auth User  - If your SMTP server requires authentication, enter the user id associated with the account here.
  • SMTP Auth Password - If your SMTP server requires authentication, enter the password associated with the account here.
  • Importance - Enter the importance of this email. The valid values are *HIGH, *NORMAL, and *LOW.
  • PDF Password - Enter an optional password to protect the PDF.
  • Merge spooled files - Specify if all spooled files in selection should be merged into one file.  This is only valid for PDF formats.
  • Recipient Seperator - Enter the seperator to be used with multiple addresses. It is advised to leave this as the default.
  • Debug - Entering *YES will produce a debug file for the email that is sent.
  • Debug File Name - Enter the name of the debug file that is produced.
  • File Name Prefix - If you are letting SPLTOOL name the target files for you, you can specify a value here that will be used as a prefix for the filename. You can enter any string, or the specify value of *JOB which will use the job name as the file prefix.
  • PC file extension - Enter the extension of the new document. This value should be entered for both automatic and manual file naming.
  • Only file name - If you wish to specifically name the target file, enter *YES in this paramter and then enter a value on the file name parameter. If you want SPLTOOL to automatically name the spooled files for you, enter *NO on this parameter.
  • File name - If you specified *YES on the Only file name parameter, enter the file name you wish SPLTOOL to name the target file. Special values for this parameter can be found at the bottom of this page. Entering *NONE or leaving this parameter blank will tell SPLTOOL to automatically name the files even if the Only file name parameter is *YES.
  • Stream file code page - Enter the code page for the new document.
  • Translate table - Enter the library and name of the translation table you wish to use during the conversion to a document.
  • Mime header code page - Specify the code page to use to build the MIME header for the email to be sent. Most of the time you don't have to change this value.
  • WSCST Name - Top Margin Offset - These parameters were added for compatibility with the AFPTOOL command. When using SPL2EMAIL on an AFP spooled file, AFPTOOL will be called to create the file.
  • Include Blank Pages - Specify *YES to include blank pages, or *NO to omit blank pages from the resulting file.
  • HTML Title - Enter the title of the document if you are copying the new file to an .htm or .html (web page) extension. This will set the title of the report.
  • Manufacturer Type and Model - Used when converting AFPDS spooled files to PDF.
  • WSCST Name - Used when converting AFPDS spooled files to PDF.
  • WSCST Library - Used when converting AFPDS spooled files to PDF.
  • Page Length - Used when converting AFPDS spooled files to PDF.
  • Page Width - Used when converting AFPDS spooled files to PDF.
  • Page Rotation - Used when converting AFPDS spooled files to PDF.
  • Margin Offset - Used when converting AFPDS spooled files to PDF.
  • Left Margin Offset - Used when converting AFPDS spooled files to PDF.
  • Top Margin Offset - Used when converting AFPDS spooled files to PDF.

Batch Command Replacement Values

  • &F - File name
  • &J - Job Name
  • &N - Job Number
  • &U - User
  • &S - Spooled File Number
  • &R - User Data
  • &T - Form Type
  • &CY - Current Year
  • &CM - Current Month
  • &CD - Current Day
  • &PY - Spooled File Year
  • &PM - Spooled File Month
  • &PD - Spooled File Day
Comments