COZZI - Transmit a SPOOL File (SENDSPLF)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The COZZI - Transmit a SPOOL File (SENDSPLF) command simplifies sending a SPOOL file to another IBM i (AS/400) system over TCP/IP. It is only intended to be used when the remote system is also an IBM i (AS/400) system. Up to 64 remote systems may be specified at a time. The output queue specified on the OUTQ parameter must exist on the remote system(s). A copy of the SPOOL file is sent to each remote system(s) and placed on that OUTQ. If RMTSYS(*LOCAL) is specified, the SENDSPLF command routes the request to the COZTOOLS CPYPRTF command to create a duplicate SPOOL file on the local OUTQ.

Restrictions:

Top

Parameters

Keyword Description Choices Notes
SPLFNAME Spooled file name Name, *LAST Required, Positional 1
JOB Job name Single values: *, *CURRENT
Other values: Qualified job name
Optional, Positional 2
Qualifier 1: Job name Name
Qualifier 2: User Name
Qualifier 3: Number 000000-999999
SPLNBR Spooled file number 000000-999999, *ONLY, *LAST, *ANY Optional, Positional 3
OUTQ Send to OUTQ Qualified object name Optional, Positional 4
Qualifier 1: Send to OUTQ Name
Qualifier 2: OUTQ Library Name, *LIBL
RMTSYS Send to remote system(s) Values (up to 64 repetitions): Character value, *LOCAL Optional, Positional 5
Top

Spooled file name (SPLFNAME)

Specifies the name of the SPOOL file being sent to the remote system.

This is a required parameter.

name
Specify the name of SPOOL file that you want to send to the remote system.
*LAST
The SPOOL file whose name was the most recently created (last) SPOOL file is used as the SPOOL file name.
Top

Job name (JOB)

Specifies the qualified job name for the job that created the SPOOL file.

Single values

* or *CURRENT
The current job (the job running the SENDSPLF command) is used.
Top

Spooled file number (SPLNBR)

Specifies the SPOOL file number of the SPOOL file.

*LAST
The last (most recently created) SPOOL file whose name matches the SPLFNAME parameter is sent.
*ONLY
The only SPOOL file whose name matches the SPLFNAME parameter is sent.
*ANY
Any SPOOL file number whose name matches the SPLFNAME parameter is sent. If multiple SPOOL files exist with the same SPLFNAME, it is unknown which SPOOL file will be transmitted by the command.
Top

Send to OUTQ (OUTQ)

Specifies the target output queue on the remote system(s) where the SPOOL file is placed.

Send to OUTQ

name
Specify the name of output queue. This output queue must exist on the remote system.
Top

Send to remote system(s) (RMTSYS)

Specifies the systems receiving the copy of the SPOOL file.

You can specify upto 64 values for this parameter.

*LOCAL
The SPOOL file is copied to the output queue specified on the OUTQ parameter on the local system.
IP or host-name
Specify up to 64 remote system names or IP addresses where the SPOOL file will be sent. The output queueu specified on the OUTQ parameter must exist on each of the remote systems specified. If the OUTQ does not exist, the command fails for that system only, and continues with the next system. The remote name or IP can be up to 64 characters in length.
Top

Examples for SENDSPLF

Example 1:

SENDSPLF  SPLFNAME(REPORT) OUTQ(BOB) RMTSYS(CHICAGO NASSAU)

This command copies the SPOOL file named REPORT to the output queue named BOB on remote systems CHICAGO and NASSAU. The original SPOOL file stays where it is.

Top

Error messages

Unknown
Top