| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Send TCP/IP Spooled File (SNDTCPSPLF) command sends a spooled file to be printed on a remote system. The remote system must be running TCP/IP. The SNDTCPSPLF command is the iSeries version of the TCP/IP LPR (Line Printer Requester) command.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| RMTSYS | Remote system | Character value, *INTNETADR | Required, Positional 1 |
| PRTQ | Printer queue | Character value | Required, Positional 2 |
| FILE | Spooled file | Name | Required, Positional 3 |
| JOB | Job name | Single values: * Other values: Qualified job name |
Optional |
| Qualifier 1: Job name | Name | ||
| Qualifier 2: User | Name | ||
| Qualifier 3: Number | 000000-999999 | ||
| SPLNBR | Spooled file number | 0-999999, *ONLY, *LAST, *ANY | Optional |
| JOBSYSNAME | Job system name | Name, *ONLY, *CURRENT, *ANY | Optional |
| CRTDATE | Spooled file created | Single values: *ONLY, *LAST Other values: Element list |
Optional |
| Element 1: Creation date | Date | ||
| Element 2: Creation time | Time, *ONLY, *LAST | ||
| DESTTYP | Destination type | *AS400, *PSF2, *OTHER | Optional |
| TRANSFORM | Transform SCS to ASCII | *YES, *NO | Optional |
| USRDTATFM | User data transform | Single values: *NONE Other values: Qualified object name |
Optional |
| Qualifier 1: User data transform | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| MFRTYPMDL | Manufacturer type and model | Character value | Optional |
| INTNETADR | Internet address | Character value | Optional |
| WSCST | Workstation customizing object | Single values: *NONE Other values: Qualified object name |
Optional |
| Qualifier 1: Workstation customizing object | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| DLTSPLF | Delete file after sending | *NO, *YES | Optional |
| DESTOPT | Destination-dependent options | Character value | Optional |
| SEPPAGE | Print separator page | *NO, *YES | Optional |
| Top |
Specifies the remote system name to which the print request is sent.
To be successful, the name must be valid, and the system must be able to communicate with the local system. You can assign names to an internet address. Use the Work with TCP/IP host table entries option on the Configure TCP/IP menu (CFGTCP command). A remote name server also maps remote system names to internet addresses. You can use the Change remote name server option on the CFGTCP menu to specify a remote name server.
| Top |
Specifies the destination printer queue to be used.
If a library name qualifier is not specified, the library list of the sending user ID on the destination system is searched. If not found or not authorized, QGPL/QPRINT is used as the default. The output queue is usually specified as library name/output queue name (for example, QGPL/OUTQ1). For destination systems that are not iSeries systems, this name is system-dependent. This name can be either the actual name of the device or the name of a printer queue for the device. The name used for the OS/2 operating system is the actual name of the device. Often, the name used for the UNIX operating system is the name of the printer queue for the device. This parameter is limited to 128 characters.
Note: On some systems, the printer queue name may be case sensitive. To preserve the lowercase letters in a printer queue name, enclose the printer queue name in apostrophes 'MyPrtQ'.
| Top |
Specifies the spooled file that is sent to the specified system and printer. The file name is the same file name that is displayed with the Work with Spooled File (WRKSPLF) command.
| Top |
Specifies the job that created the spooled file to be sent.
Single values
Qualifier 1: Job name
Qualifier 2: User
Qualifier 3: Number
Note: If no job number or user name is given, all jobs currently running on the system are searched for a match against the job name.
| Top |
Specifies the number of the spooled file from the job whose data records are to be sent.
| Top |
Specifies the system from which the job that created the spooled file was ran on.
| Top |
Specifies the date the spooled file was created on the system. This parameter is considered after the job name, user name, job number, spooled file name, spooled file number, and job system name parameter requirements have been met.
Single values
Element 1: Creation date
Element 2: Creation time
The spooled file create time is the time the spooled file was created on the system. This parameter must have a value set if a date is specified for the first element of this parameter. This create time is considered after the job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date requirements have been met.
| Top |
Specifies the type of destination system to which the spooled file is being sent. This information allows the SNDTCPSPLF command to send the file in a format that is most likely to be received and processed correctly on the destination system. When sending to another iSeries system, this parameter should be *AS400.
| Top |
Specifies whether or not to make use of the host print transform function to transform a SNA character string (SCS) or Advanced Function Printing data stream (AFPDS) into ASCII data.
Note: If you specify TRANSFORM(*YES), you cannot use the USRDTATFM parameter.
| Top |
Specifies the program that is used to transform the spooled file data. User data transform programs must be written to the Writer Transform Exit Program interface. For information on this interface, see the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Single values
Qualifier 1: User data transform
Qualifier 2: Library
| Top |
Specifies the manufacturer, type, and model for a printer using the host print transform function.
If the Workstation customizing object (WSCST) parameter is used in conjunction with the MFRTYPMDL parameter, information that is specified in the workstation customization object takes precedence over the MFRTYPMDL parameter.
| Top |
Specifies the internet address of the remote system to which the print request is sent.
This parameter is accessed by entering *INTNETADR for the RMTSYS parameter or by leaving the RMTSYS parameter blank and pressing the Enter key.
| Top |
Specifies an object that consists of a table of attributes used to customize a given ASCII device, such as a workstation or printer. Character presentation, font specifications, and control key sequences are examples of characteristics that can be customized.
If the Manufacturer type and model (MFRTYPMDL) parameter is used in conjunction with the WSCST parameter, information that is specified in the workstation customization object takes precedence over the MFRTYPMDL parameter.
Single values
Qualifier 1: Workstation customizing object
Qualifier 2: Library
| Top |
Specifies whether or not to delete the specified spooled file after it has been successfully sent. No guarantee can be made as to the correct printing of the sent file. Only correct transmission can be verified.
| Top |
Specifies the destination-dependent options. These options may be specific to a particular implementation of an LPD print server. When this parameter is not specified, the SNDTCPSPLF command sends default options that are common to all LPD print servers. The options specified by this parameter are inserted into the control file generated by the SNDTCPSPLF command, one option per line, and sent to the specified LPD print server. The options specified by this parameter must have the following format:
"option1 option2 option3...optionN"
where each option is separated from the next by one or more blanks.
Options typically have a format of <control characters><value>. An example is
"-oTITLE=LPR"
where "-o" are the control characters and "TITLE=LPR" is the value. SNDTCPSPLF examines the first character of each option to determine if it is a reserved control character. The following control characters cannot be specified as their values are determined by SNDTCPSPLF. If any of the following control characters are specified, the option is ignored and a warning message is generated.
C T H U I W L 1 M 2 N 3 P 4 S k
For example, "Class=ASCII" is not allowed because the "C" control character is reserved for use by the SNDTCPSPLF command. However, "-Class=ASCII" is permitted.
The control character "X" is allowed, but the value of "AS/400" used with it is not permitted. For example, "XMyLPD" can be specified, but "XAS/400" cannot be. The option "XAS/400" is reserved for use by the SNDTCPSPLF command. It is used to indicate to another iSeries system that the request is coming from an iSeries system.
The option "XAIX" controls how multiple copies are sent to the printer. This option specifies that the data and control files are to be sent multiple times, once for each copy. The default is to send the data and control files once, with multiple print commands in the control file.
The following print "filters" are supported by SNDTCPSPLF (see section 7 of RFC 1179):
c n d p f r g t l v
If one of these characters is specified as the first character in a destination option, the character is used on the "print file" command in the control file. Only the first occurrence of one of these characters in this position is used in the control file. Subsequent use of these characters in this position is ignored. If none of these options is specified, the default character "l" is used on the "print file" command, which prints the file "as is" without filtering out any control characters.
If "J" is specified as the first character of a destination option, the remaining characters in the option are used to override the default job name for the banner page (see RFC 1179, section 7.4). For instance, to specify a job name of /nff, specify:
DESTOPT('J/nff')
Only the first occurrence of this option is used to override the job name. If this option is not specified, the spooled file name is used as the job name (the default).
You can enable an auto-queue option by using the destination dependent option XAUTOQ on the SNDTCPSPLF command (or on the CRTOUTQ or CHGOUTQ commands). When you use the auto-queue option, files are sent as before unless the remote system times out during the transform. If this happens, the transformed spool files are sent back to the same output queue using the iSeries LPD server. When a remote writer is running, it will then send the transformed spooled file to the remote system.
| Top |
Specifies whether or not a separator page is requested when the spooled file is printed on the remote system.
Note: A separator page may not be printed in all cases. Printing of separator pages depends on whether the LPD implementation on the receiving system honors the separator page request. Some LPD implementations ignore the SEPPAGE parameter and print or do not print a separator page by default.
| Top |
| Top |
*ESCAPE Messages
| Top |