IBM CDI5UG1107 Computer Accessories User Manual


 
Sending a File 29
COPIES(number-of-copies) specifies the number of copies to be printed. Valid values range
from 1–255. This parameter is valid only when SPOOL(*YES).
MAXRCDS(maximum-records) specifies the maximum number of records that is placed in the
spooled file. Valid values range from 1–500000. This parameter is valid only when
SPOOL(*YES).
FILESEP(number-of-file-separators) specifies the number of blank separator pages to be
placed between each copy of the file printed.
HOLD(*YES|*NO) specifies whether the file is to be held on the output queue until released by
the user. This parameter is valid only if SPOOL(*YES).
SAVE(*YES|*NO) specifies whether the spooled output file is to be saved on the output queue
once printed. This parameter is valid only if SPOOL(*YES).
OUTPTY(*JOB|output-priority) specifies the scheduling priority of the file on the output
queue. This parameter is valid only if SPOOL(*YES).
USRDTA(user-data) allows up to 10 characters of data to identify the spooled output file. This
parameter is valid only if SPOOL(*YES).
Refer to the IBM Sterling Connect:Direct Processes Web site at
http://www.sterlingcommerce.com/documentation/processes/processhome.html
for general
information on SMS support and TOSYSOPTS parameters for other platforms.
Optional Parameters
The following parameters, listed alphabetically, are optional. Unless noted, the parameters apply to all remote
node environments.
BLKSIZE(n|*CALC
)
specifies the blocksize value for the source file. This value must be a multiple of the file record size.
n specifies the block size of the file. This value must be a multiple of the record size. The valid range
is 1–32720
*CALC
indicates that the blocksize is calculated.
CKPTINV(n)
Number of bytes, from 1K to 2 gigabytes, to send or receive before taking a checkpoint. The format is
nnnnnnn, nnnnnnK, or nnnnnnM, where K specifies thousands of bytes and M specifies millions of
bytes. A value of 0 specifies no checkpoint restart Sterling Connect:Direct for i5/OS uses the value
you specify, rounded up to the nearest record boundary, to determine when to take a checkpoint. If
you specify a value between 1 and 1023, the value becomes 1024 or 1K.
A checkpoint interval specified here overrides the system-wide default value in the initialization
parameters file.
Checkpointing cannot occur in the following cases, even if you specify a checkpoint interval:
The file being sent is compressed during the send operation by the local node using the extended
compression feature, and decompression is deferred on the receiving node. That is, the
TOSYSOPTS parameter has DECMPR(*NO).
A precompressed file is sent and decompressed by the receiving node during the send operation.
That is, the FMSYSOPTS has PRECMPR(*YES) and TOSYSOPTS has DECMPR(*YES).
A file is sent to a single z/OS partitioned data set member.
If you request checkpointing when you are transferring multiple members of a file, checkpoints are
taken only at member boundaries regardless of the interval specified in the initialization parameters or
in the CDSND or CDRCV command.