SNDTCPSPLF (Send TCP/IP Spooled File)
SNDTCPSPLF Command syntax diagram
Purpose
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.
Required Parameters
- RMTSYS
- 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. Use the Change remote name server option on the CFGTCP menu to specify a remote name server.
If this parameter is left blank, you are prompted for the INTNETADR parameter when the Enter key is pressed.
*INTNETADR: The value of the INTNETADR parameter is used.
remote-system: Specify the remote system name to which the print request is sent.
- PRTQ
- Specifies the name of the destination printer queue. For destination systems that are iSeries, this is the name of an output queue to which the spooled file is sent.
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, 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'. - FILE
- Specifies the name of 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.
Optional Parameters
- JOB
- Specifies the name of the job that created the spooled file whose data records are to be sent.
*: The job that issued this command is the job that created the spooled file.
job-name: Specify the qualified name of the job that created the spooled file.
user-name/job-name: Specify the user name and the name of the job that created the spooled file.
job-number/user-name/job-name: Specify the job number, the user name, and the name of the job that created the spooled file. The name of the job has a fully specified form of job-number/user-name/job-name. 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.
- SPLNBR
- Specifies the number of the spooled file from the job whose data records are to be sent.
*ONLY: One spooled file from the job has the specified file name. The number of the spooled file is not necessary. If *ONLY is specified and more than one spooled file has the specified file name, an error message is sent.
*LAST: The spooled file with the highest number and the specified file name is used.
*ANY: The spooled file number is not used to determine which spooled file is used. Use this value when the job system name parameter or the spooled file creation date and time parameter is to take precedence over the spooled file number when selecting a spooled file.
spooled-file-number: Specify the number of the spooled file having the specified file name whose data records are to be sent.
- JOBSYSNAME
- Specifies the name of system where the job that created the spooled file (JOB parameter) ran. This parameter is considered after the job name, user name, job number, spooled file name, and spooled file number parameter requirements have been met.
*ONLY: There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and spooled file creation date and time.
*CURRENT: The spooled file created on the current system with the specified job name, user name, job number, spooled file name, spooled file number, and creation date and time is used.
*ANY: The job system name is not used to determine which spooled file is used. Use this value when the spooled file creation date and time parameter is to take precedence over the job system name when selecting a spooled file.
system name: Specify the name of the system where the job that created the spooled file ran.
- CRTDATE
- Specifies the date and time the spooled file was created. 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.
*ONLY: There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and job system name.
*LAST: The spooled file with the latest creation date and time of the specified job name, user name, job number, spooled file name, spooled file number, and job system name is used.
Element 1: Date spooled file was created
date: Specify the date the spooled file was created.
Element 2: Time spooled file was created
*ONLY: There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file creation date.
*LAST: The spooled file with the latest creation time of the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file creation date is used.
time: Specify the time the spooled file was created.
- DESTTYP
- 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, this parameter should be *AS400.
*OTHER: The destination system is not an iSeries and is not using Print Services Facility/2.
*AS400: The destination system is an iSeries. If TRANSFORM(*NO) is specified, a duplicate of the spooled file is created on the destination system. If the spooled file is *SCS or *AFPDS and TRANSFORM(*YES) is specified, the spooled file is transformed to ASCII and spooled as *USERASCII on the destination iSeries.
*PSF2: The destination system is using Print Services Facility/2. This destination system can receive both ASCII data and Advanced Function Printer data stream (AFPDS) data. This means that in addition to sending ASCII data to a PSF/2, you can also send a spooled file of device type *AFPDS. When sending *AFPDS files, consider any external resources of the file. These resources, such as fonts and overlays, must also reside on the destination system to allow the file to print correctly.
- TRANSFORM
- Specifies whether 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. If you specify DESTTYP(*OTHER), you typically specify TRANSFORM(*YES). This is because most non-iSeries destination systems do not support printing of non-ASCII data. The non-iSeries destination systems do receive and correctly process ASCII data.
Note: If you specify TRANSFORM(*YES), you cannot use the USRDTATFM parameter.
*YES: Use the host print transform.
*NO: Do not use the host print transform.
- MFRTYPMDL
- Specifies the manufacturer, type, and model for a printer using the host print transform function.
This parameter is prompted only when TRANSFORM(*YES) is specified.
*IBM42011: The IBM 4201-1 Proprinter is used.
manufacturer-type-model: Specify the manufacturer, type, and model for a printer using the host print transform function. Specify one of the values in Table 1 that matches the device.
*WSCST: The value of the WSCST parameter is used.
Table 1 lists the printer values for the manufacturer, type, and model.
Table 1. Manufacturer Type and Model (MFRTYPMDL Parameter)***
*IBM2380
- IBM 2380 Personal Printer Series II
- IBM 2380 Plus Printer
*IBM2381
- IBM 2381 Personal Printer Series II,
- IBM 2381 Plus Printer
*IBM2390
- IBM 2390 Personal Printer Series II
- IBM 2390 Plus Printer
*IBM2391
- IBM 2391 Personal Printer Series II
- IBM 2391 Plus Printer
*IBM3112
- IBM 3112 Page Printer
*IBM3116
- IBM 3116 Page Printer
*IBM3130
- IBM 3130 Advanced Function Printer
*IBM3812
- IBM 3812 Pageprinter
*IBM3816
- IBM 3816 Pageprinter
*IBM3912HP
- IBM 3912 Page Printer (HP Mode)
*IBM3916HP
- IBM 3916 Page Printer (HP Mode)
*IBM39302
- IBM 39302 IBM 3930-02S Page Printer
- IBM 39302 IBM 3930-02D Page Printer
*IBM39303
- IBM 39303 IBM 3930-03S Page Printer
- IBM 39303 IBM 3930-03D Page Printer
*IBM4019
- IBM 4019 LaserPrinter
- IBM 4019E LaserPrinter E
*IBM4019HP
- IBM 4019 LaserPrinter (HP** Mode)
- IBM 4019E LaserPrinter E (HP Mode)
*IBM4029
- IBM 4029-010 LaserPrinter 5E
- IBM 4029-020 LaserPrinter 6
- IBM 4029-030 LaserPrinter 10
- IBM 4029-040 LaserPrinter 10L
*IBM4029HP
- IBM 4029-010 LaserPrinter 5E (HP Mode)
- IBM 4029-020 LaserPrinter 6 (HP Mode)
- IBM 4029-030 LaserPrinter 10 (HP Mode)
- IBM 4029-040 LaserPrinter 10L (HP Mode)
*IBM4037
- IBM 4037 5E Printer
*IBM4039HP
- IBM LaserPrinter 4039-10D (HP Mode)
- IBM LaserPrinter 4039-10D Plus (HP Mode)
- IBM LaserPrinter 4039-10R (HP Mode)
- IBM LaserPrinter 4039-10R Plus (HP Mode)
- IBM LaserPrinter 4039-12R (HP Mode)
- IBM LaserPrinter 4039-12R Plus (HP Mode)
- IBM LaserPrinter 4039-12L (HP Mode)
- IBM LaserPrinter 4039-12L Plus (HP Mode)
- IBM LaserPrinter 4039-16L (HP Mode)
- IBM LaserPrinter 4039-16L Plus (HP Mode)
*IBM4070
- IBM 4070 IJ
*IBM4070EP
- IBM 4070 IJ (Epson** Mode)
*IBM4072
- IBM 4072 ExecJet*
*IBM4076
- IBM 4076 ExecJet* II Printer (HP Mode)
*IBM42011
- IBM 4201-1 Proprinter*
*IBM42012
- IBM 4201-2 Proprinter II
*IBM42013
- IBM 4201-3 Proprinter III
*IBM42021
- IBM 4202-1 Proprinter XL
*IBM42022
- IBM 4202-2 Proprinter II XL
*IBM42023
- IBM 4202-3 Proprinter III XL
*IBM42071
- IBM 4207-1 Proprinter X24
*IBM42072
- IBM 4207-2 Proprinter X24E
*IBM42081
- IBM 4208-1 Proprinter XL24
*IBM42082
- IBM 4208-2 Proprinter XL24E
*IBM4212
- IBM 4212 Proprinter 24P
*IBM4216
- IBM 4216-10 Personal Pageprinter
*IBM4226
- IBM 4226-302 Printer
*IBM4230
- IBM 4230-4S3 Printer (IBM Mode)
- IBM 4230-4I3 Printer (IBM Mode)
*IBM4232
- IBM 4232-302 Printer (IBM Mode)
*IBM4244MAN
- IBM4244 Printer (single tractor or manual feed selection)
*IBM4244ASF
- IBM4244 Printer (single tractor feed and ASF)
*IBM4244DUAL
- IBM4244 Printer (dual tractor feeds)
*IBM4247MAN
- IBM4247 Printer (single formfeed or manual selection)
*IBM4247DUAL
- IBM4247 Printer (dual tractor feeds)
*IBM4247ASF
- IBM4247 Printer (single tractor feed and ASF)
*IBM4312
- IBM Network Printer 12
*IBM4317
- IBM Network Printer 17
*IBM4320
- IBM InfoPrint 20
*IBM4324
- IBM Network Printer 24
*IBM4332
- IBM InfoPrint 32
*IBM47121
- IBM 4712-1 Transaction Printer
*IBM47122
- IBM 4712-2 Transaction Printer
*IBM47221
- IBM 4722-1 Document Printer
*IBM47222
- IBM 4722-2 Document Printer
*IBM4770
- IBM 4770 InkJet Transaction Printer
*IBM5152
- IBM 5152 Graphics Printer
*IBM5201
- IBM 5201-2 Quietwriter*
*IBM5202
- IBM 5202-1 Quietwriter III
*IBM5204
- IBM 5204-1 Quickwriter*
*IBM5216
- IBM 5216 Wheelprinter
*IBM5575
- IBM 5579-H02 Printer
- IBM 5579-K02 Printer
- IBM 5577-T02 Printer
- IBM 5579-S02 Printer
- IBM 5577-K02 Printer
- IBM 5577-J02 Printer
- IBM 5577-G02 Printer
- IBM 5577-H02 Printer
- IBM 5577-F02 Printer
- IBM 5577-B02 Printer
- IBM 5575-H02 Printer
- IBM 5575-F02 Printer (with SBCS Cartridge)
- IBM 5575-B02 Printer (with SBCS Cartridge)
- IBM 5573-K02 Printer
- IBM 5573-J02 Printer
- IBM 5573-H02 Printer
- IBM 5573-G02 Printer
- IBM 5572-B02 Printer
- IBM 5417-011 Printer
- IBM 5407-011 Printer
- IBM 5327-011 Printer
- IBM 4208-502 Printer
*IBMPAGES
- IBM 5589-H01 Printer
- IBM 5588-H02 Printer
- IBM 5587-H01 Printer
- IBM 5586-H02 Printer
- IBM 5585-H01 Printer
- IBM 5584-K02 Printer
- IBM 5584-H02 Printer
- IBM 5584-G02 Printer
*IBMPAGES300
- IBM Network Printer 12 (with PAGES feature)
- IBM Network Printer 17 (with PAGES feature)
- IBM Network Printer 24 (with PAGES feature)
*IBM6400
- IBM 6400 Printers (IBM Mode)
*IBM6400EP
- IBM 6400 Printers (Epson Mode)
*IBM6404
- IBM 6404 Printers (IBM Mode)
*IBM6404EP
- IBM 6404 Printers (Epson Mode)
*IBM6408
- IBM 6408-A00 Printer (IBM Mode)
- IBM 6408-CTA Printer (IBM Mode)
*IBM6408EP
- IBM 6408-A00 Printer (Epson Mode)
- IBM 6408-CTA Printer (Epson Mode)
*IBM6412
- IBM 6412-A00 Printer (IBM Mode)
- IBM 6412-CTA Printer (IBM Mode)
*IBM6412EP
- IBM 6412-A00 Printer (Epson Mode)
- IBM 6412-CTA Printer (Epson Mode)
*CANLIPS3
- Canon LIPS3 DBCS Printers
*CPQPM15
- COMPAQ** PageMark 15 (HP Mode)
*CPQPM20
- COMPAQ PageMark 20 (HP Mode)
*HPDBCS
- HP LaserJet-compatible printers for Double Byte Character Set (DBCS) input.
*HPII
- HP LaserJet** Series II
*HPIID
- HP LaserJet IID
*HPIIP
- HP LaserJet IIP
*HPIII
- HP LaserJet III
*HPIIID
- HP LaserJet IIID
*HPIIIP
- HP LaserJet IIIP
*HPIIISI
- HP LaserJet IIISi
*HP1200C
- HP DeskJet 1200C
*HP1600C
- HP DeskJet 1600C
*HP310
- HP DeskJet 310
*HP320
- HP DeskJet 320
*HP4
- HP LaserJet 4
*HP4000
- HP LaserJet 4000 series
*HP5
- HP LaserJet 5 series
*HP500
- HP DeskJet 500
*HP520
- HP DeskJet 520
*HP540
- HP DeskJet 540
*HP550C
- HP DeskJet 550C
*HP560C
- HP DeskJet 560C
*HP5000
- HP LaserJet 5000 series
*HP5SI
- HP LaserJet 5Si
*HP6
- HP LaserJet 6 series
*HP8000
- HP LaserJet 8000 series
*HPCOLORLJ
- HP Color LaserJet 5
*HPPAINT
- HP PaintJet
- HP PaintJet XL
- HP PaintJet XL300
*LEXOPTRA
- Lexmark Optra Family (HP Mode)
*LEXOPTRAC
- Lexmark Optra C Color Printer
*LEXOPTRAN
- Lexmark Optra N Printer
*LEXOPTRAS
- Lexmark Optra S Printer family
*LEXOPTRASC
- Lexmark Optra SC Color Printer
- Lexmark Optra Color 1200 Printer
*LEX2380
- Lexmark Forms Printer 2380 Plus
*LEX2381
- Lexmark Forms Printer 2381 Plus
*LEX2390
- Lexmark Forms Printer 2390 Plus
*LEX2391
- Lexmark Forms Printer 2391 Plus
*LEX4227
- Lexmark 4227 Forms Printer
*ESCPDBCS
- Epson ESC/P DBCS Printers
*EPAP2250
- Epson ActionPrinter 2250
*EPAP3250
- Epson ActionPrinter 3250
*EPAP5000
- Epson ActionPrinter 5000
*EPAP5500
- Epson ActionPrinter 5500
*EPDFX5000
- Epson DFX-5000
*EPDFX8000
- Epson DFX-8000
*EPFX850
- Epson FX-850
*EPFX870
- Epson FX-870
*EPFX1170
- Epson FX-1170
*EPLQ570
- Epson LQ-570
*EPLQ860
- Epson LQ-860
*EPLQ870
- Epson LQ-870
*EPLQ1070
- Epson LQ-1070
*EPLQ1170
- Epson LQ-1170
*EPLQ510
- Epson LQ-510
*EPLQ2550
- Epson LQ-2550
*EPLX810
- Epson LX-810
*EPSQ870
- Epson SQ-870
*EPSQ1170
- Epson SQ-1170
*EPEPL7000
- Epson EPL-7000
*EPEPL8000
- Epson EPL-8000
*NECPR201
- NEC** PC-PR101
- NEC** PC-PR201
*NECP2
- NEC** P2 Pinwriter
*NECP2200
- NEC P2200 Pinwriter
*NECP2200XE
- NEC P2200 XE Pinwriter
*NECP5200
- NEC P5200 Pinwriter
*NECP5300
- NEC P5300 Pinwriter
*NECP6200
- NEC P6200 Pinwriter
*NECP6300
- NEC P6300 Pinwriter
*NONE
- Printer supports page-descriptor language generated by the CVTIMG API. Note: Spoolfiles with device type of *SCS or *AFPDS cannot be processed by the Host Print Transform function for these printers.
*OKI184IBM
- Okidata** Microline 184 Turbo (IBM Mode)
*OKI320IBM
- Okidata Microline 320 (IBM Mode)
*OKI321IBM
- Okidata Microline 321 (IBM Mode)
*OKI390IBM
- Okidata Microline 390 Plus (IBM Mode)
*OKI391IBM
- Okidata Microline 391 Plus (IBM Mode)
*OKI393IBM
- Okidata Microline 393 Plus (IBM Mode)
*OKI590IBM
- Okidata Microline 590 (IBM Mode)
*OKI591IBM
- Okidata Microline 591 (IBM Mode)
*OKI400
- Okidata OL400 LED Page Printer
*OKI800
- Okidata OL800 LED Page Printer
*OKI810
- Okidata OL810 LED Page Printer
*OKI820
- Okidata OL820 LED Page Printer
*OKI3410
- Okidata Pacemark 3410
*PAN1123EP
- Panasonic** KX-P1123 (Epson Mode)
*PAN1124EP
- Panasonic KX-P1124 (Epson Mode)
*PAN1124IEP
- Panasonic KX-P1124i (Epson Mode)
*PAN1180EP
- Panasonic KX-P1180 (Epson Mode)
*PAN1180IEP
- Panasonic KX-P1180i (Epson Mode)
*PAN1191EP
- Panasonic KX-P1191 (Epson Mode)
*PAN1624EP
- Panasonic KX-P1624 (Epson Mode)
*PAN1654EP
- Panasonic KX-P1654 (Epson Mode)
*PAN1695EP
- Panasonic KX-P1695 (Epson Mode)
*PAN2123EP
- Panasonic KX-P2123 (Epson Mode)
*PAN2124EP
- Panasonic KX-P2124 (Epson Mode)
*PAN2180EP
- Panasonic KX-P2180 (Epson Mode)
*PAN2624EP
- Panasonic KX-P2624 (Epson Mode)
*PAN4410HP
- Panasonic KX-P4410 (HP Mode)
*PAN4420HP
- Panasonic KX-P4420 (HP Mode)
*PAN4430HP
- Panasonic KX-P4430 (HP Mode)
*PAN4450IHP
- Panasonic KX-P4450i (HP Mode)
*PAN4451HP
- Panasonic KX-P4451 (HP Mode)
*XRX4215MRP
- Xerox** 4215/MRP (HP Mode)
*XRX4219MRP
- Xerox 4219/MRP (HP Mode)
*XRX4220MRP
- Xerox 4220/MRP (HP Mode)
*XRX4230MRP
- Xerox 4230/MRP (HP Mode)
*XRX4235
- Xerox 4235 LaserPrinting (HP Mode)
*XRX4700II
- Xerox 4700 II Color Document Printer (HP Mode)
*WSCST
- Printer is not listed
*WSCSTLETTER
- Printer is not listed (letter-sized paper)
*WSCSTLEGAL
- Printer is not listed (legal-sized paper)
*WSCSTLEDGER
- Printer is not listed (ledger-sized paper)
*WSCSTEXECUTIVE
- Printer is not listed (executive-sized paper)
*WSCSTA3
- Printer is not listed (A3-sized paper)
*WSCSTA4
- Printer is not listed (A4-sized paper)
*WSCSTA5
- Printer is not listed (A5-sized paper)
*WSCSTB4
- Printer is not listed (B4-sized paper)
*WSCSTB5
- Printer is not listed (B5-sized paper)
*WSCSTCONT80
- Printer is not listed (8-inch continuous forms)
*WSCSTCONT132
- Printer is not listed (13.2 inch continuous forms)
*WSCSTNONE
- Printer is not listed (paper size not specified)
- USRDTATFM
- Specifies the qualified name of the program 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 Application Program Interfaces (APIs) topic in the Information Center.
*NONE: No data transform program is specified.
The name of the data transform program can be qualified by one of the following library values:
*LIBL: All libraries in the job's library list are searched until the first match is found.
*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library to be searched.
data-transform-program-name: Data transform program used to transform the spooled file data.
- INTNETADR
- 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.
internet-address: Specify the internet address of the remote system. The internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.
- WSCST
- 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. This parameter is prompted only when TRANSFORM(*YES) is specified.
If the 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.
*NONE: Do not specify a workstation customizing object.
The name of the WSCST can be qualified by one of the following library values:
*LIBL: All libraries in the job's library list are searched until the first match is found.
*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library to be searched.
workstation-customizing-object: Specify a valid workstation customizing object that was created with the Create Work Station Customizing Object (CRTWSCST) command.
- DLTSPLF
- 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.
*NO: Do not delete the spooled file after it has been successfully sent.
*YES: Delete the spooled file after it has been successfully sent.
- DESTOPT
- 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 kFor example "Class=ASCII" would not be allowed because the "C" control character is reserved for use by SNDTCPSPLF. However, "-Class=ASCII" would be 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 that the request is coming from an iSeries.
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 vIf 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 AS/400 LPD server. When a remote writer is running, it will then send the transformed spooled file to the remote system.
destination-dependent-options: Specify the destination-dependent options.
- SEPPAGE
- 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.
*YES: Request a separator page.
*NO: Do not request a separator page.
Examples for SNDTCPSPLF
The following examples assume that the spooled file is the only one with that name within the job under which you are currently running when making the request.
Example 1: Sending a File to Another iSeries
SNDTCPSPLF RMTSYS(SYS1) PRTQ(DISTRIB/LAMP) FILE(SALES) DESTTYP(*AS400) TRANSFORM(*NO)This command sends the spooled file named SALES to the output queue LAMP in the library DISTRIB on the remote iSeries system SYS1. An exact duplicate of the spooled file is created on the destination system because it is an iSeries system-to-iSeries system transfer as specified on the DESTTYP parameter. The spooled file is not transformed.SNDTCPSPLF
Example 2: Sending a File to a System of Type *OTHER
SNDTCPSPLF RMTSYS(SUN) PRTQ(MOON) FILE(STARS) DESTTYP(*OTHER) TRANSFORM(*YES) MFRTYPMDL(*HPIIID)This command sends the spooled file STARS to the printer queue MOON on the remote system SUN. If the spooled file data stream is SCS, the file is transformed to the correct ASCII format for a Hewlett-Packard IIID Printer.
Example 3: Sending a File to a System of Type *OTHER
SNDTCPSPLF RMTSYS(*INTNETADR) PRTQ(MOON) FILE(STARS) DESTTYP(*OTHER) TRANSFORM(*YES) MFRTYPMDL(*WSCST) WSCST(USERLIB/QWPMYPRT) INTNETADR('9.5.255.128')This command sends the spooled file STARS to the printer queue MOON on the remote system with the Internet address 9.5.255.128. If the spooled file data stream is SCS, the file is transformed to the correct ASCII format for a custom printer definition. The workstation customizing object (created with the CRTWSCST command) can be found in file QWPMYPRT, library USERLIB.
Example 4: Sending a File to a System of Type *PSF2
SNDTCPSPLF RMTSYS(OS2SRVR) PRTQ(PSFQ) FILE(JOBLOG) DESTTYP(*PSF2) TRANSFORM(*YES) MFRTYPMDL(*IBM5202)This command sends the spooled file JOBLOG to the printer queue PSFQ on the remote system OS2SRVR. If the spooled file data stream is SCS, the file is transformed to the correct ASCII format for an IBM 5202 Printer.
Example 5: Using a Transform Program Other than the Host Print Transform
SNDTCPSPLF RMTSYS(OS2SRVR) PRTQ(PSFQ) FILE(JOBLOG) DESTTYP(*PSF2) TRANSFORM(*NO) USRDTATFM(library/program)This command sends the spooled file JOBLOG to the printer queue PSFQ on the remote system OS2SRVR. The file is transformed using the program specified with the USRDTATFM parameter.
Error messages for SNDTCPSPLF
*ESCAPE Messages
- TCP3701
- Send request failed for spooled file &1.
- TCP3702
- Not authorized to spooled file &1.
- TCP3703
- Send request failed. Spooled file &1 open.
- TCP3704
- Send request failed. Spooled file &1 not spooled print file.
- TCP3705
- Spooled file &1 not transformed.
- TCP3706
- Spooled file &1 not transformed.
- TCP3715
- Not authorized to delete spooled file &1. The spooled file was sent.