Previous Topic: To Transfer Print Files UnmodifiedNext Topic: Replacement Variables


JCL Parameters

You can specify the following JCL parameters, separated by commas, using the file's OUTPUT ADDRESS parameters:

PATH=remote-directory,
FILENAME= remote-file-name[.PDF/.PDFL/.HTML/.RTF],
USERID= local-userid,
PASSWORD= local-password,
PROC= procedure-name,
PNODE= local-node,
SNODE= target-node,
SNODEID= target-node-userid,
SNODEPW= target-node-password,
TOENVIR=NT,
LU= remote-LU,
DSNAME=temp-data-set-name,
DISP=NEW|MOD|OLD|SHR,
UNIT=device-type,
VOLSER=volume-serial-number,
RECFM=F|V,
LRECL=99999,
DATACLAS=temp-data-set-SMS-data-class-name,
MGMTCLAS=temp-data-set-SMS-management-class-name,
STORCLAS=temp-data-set-SMS-storage-class-name,
AM=C:D (or TCPDRIV=C:D)
CDSYSOPT= p1/p2/p3

PATH and FILENAME will be combined to form the complete remote target directory and file name. This extends the value used to a maximum of 106 characters.

For binary transfers, if the COPYCF proc is not specified or taken as a default, the &DSN1 and &DSN2 variables will be passed to the custom proc for optional use. They will have the same values as what would have been passed to a non-binary transfer. This may also help in the formation of a long directory structure and file name combination.

Up to 50 characters of data can be passed using the CDSYSOPT parameter.

For example,

DRIVPRM1='CDSYSOPT=DATATYPE=text/XLATE=yes/STRIP.BLANKS=yes'

or

DESTID QDEST=CDDEST1,FLRECL=133,
FADDRES1='USERID=USER0001,PASSWORD=ABCD',
FADDRES2='FILENAME=TARGET.FILE',
FADDRES3='DSNAME=TEMP.FILE',
FADDRES4='CDSYSOPT=XLATE.TBL(TABLE02.CDX)'

Separate multiple SYSOPTS values with a '/'. Embedded blanks are not supported. Free form parameters containing '/' are not supported. Both instances will yield unexpected results and are unlikely to send the file.

CDSYSOPT= is not supported and ignored for binary file transfers.

In most cases, it is required to use a unique process to take advantage of the CDSYSOPT parameter. The data in the CDSYSOPT parameter is passed as &SYSOPTS to Connect:Direct and the '/' delimiters are changed to blanks. The default COPY process does not expect to have an &SYSOPTS variable passed to it and ignores it. A new process must be built similar to this COPY process to facilitate passing the required data:

PROCXLT PROCESS SNODE=BSBABC1234 -
        CLASS=4 &DISP=RPL
STEP01 COPY FROM (DSN=&DSN1 DISP=SHR -
                 PNODE) -
            TO   (DSN=&DSN2 -
                 DISP=&DISP -
                 SNODE -
                 SYSOPTS=&SYSOPTS) -
                 COMPRESS EXT

This example is for illustration only. See Connect:Direct support for questions regarding the specific syntax.

Add the new process name to the PROC=parameter, to pass the name to the C:D print driver.