Appendix H. Overriding JCL SYSIN Parameters

You can specify SYSIN parameters by using the PARM= parameter of the JCL EXEC statement.

The parameters describing the server (SERVER, SERVLUNAME, SERVIPADDR, SERVIPNAME) and their values must be the first group of items specified. For more information on the required PARM fields, see the batch interface chapter of TIBCO® Managed File Transfer Platform Server for z/OS User's Guide.

Following the server name, any valid SYSIN parameters can be specified in the parameter string. For more information on valid SYSIN parameters, see the batch interface chapter of TIBCO® Managed File Transfer Platform Server for z/OS User's Guide.

Each parameter and its corresponding value must be separated by an equal sign (=). A comma must separate each parameter/value pair. The PARM statement might span multiple lines by typing up to column 71 and placing a continuation mark in column 72. The next line must begin in column 16.

In the following example, the interpreted value of DSN is DATASET.NAME. Long file names with spaces are also supported by enclosing the remote file name in double quotation marks.

//STEPNAME EXEC PGM=OSIUB000,PARM=’SERVER=FUSION,NODE=RemNode,DSN=DATAS
//       ET.NAME,REMOTE_FILE=”c:\test file.tst”’

The parameters specified by the PARM string are processed after the SYSIN parameters and override any duplicate parameter values specified in the SYSIN. The parameters in the PARM string are also applied to every PROCESS statement (every transaction) queued in that particular step.

See the following batch example for your reference. The SYSIN parameters are overwritten.

//BATCH1    JOB 555,MSGCLASS=X,REGION=4M
//STEP1     EXEC PGM=OSIUB000,PARM=’SERVER=FUSION,REMOTE_FILE=C:\SalesRe-
//          port.DOC’
//STEPLIB   DD DISP=SHR,DSN=PROD.LOADLIB
//SYSPRINT  DD SYSOUT=*
//SYSUDUMP  DD SYSOUT=X
//SYSIN     DD *    
PROCESS,SALES1,TRANSFER,RECEIVE
        NODE=REMNOD1
        DSN=SALES.REPORT1
        REMOTE_FILE=C:\OVERRIDE
        EFFECT=CR
        ISSUER=USERID 
        RPASS=PASSWD
PROCESS,SALES2,TRANSFER,RECEIVE
        NODE=REMNOD2
        DSN=SALES.REPORT2
        EFFECT=CR
        ISSUER=USERID 
        RPASS=PASSWD
//STEP2     EXEC PGM=OSIUB000,PARM=’SERVER=FUSION,DSN=DISTRIB.ANNUAL.RE-
//          PORT,REMOTE_FILE=C:\AnnualReport.Doc’
//STEPLIB   DD DISP=SHR,DSN=PROD.LOADLIB 
//SYSPRINT  DD SYSOUT=*
//SYSUDUMP  DD SYSOUT=X
//SYSIN     DD *    
PROCESS,DISTRIB1,TRANSFER,SEND  
        NODE=REMNOD1
        DSN=DATASET.OVERRIDE
        EFFECT=CR
        ISSUER=USERID 
        RPASS=PASSWD
PROCESS,DISTRIB2,TRANSFER,SEND
        NODE=REMNOD2 
        EFFECT=CR
        ISSUER=USERID 
        RPASS=PASSWD

Bold type SYSIN parameters in the previous example will be overridden and are therefore unnecessary to code. The process names SALES1 and SALES2 in the first step will receive a remote file called C:\SalesReport.DOC whether or not the parameter is specified in the SYSIN. In the second step, processes DISTRIB1 and DISTRIB2 will send the dataset named DISTRIB.ANNUAL.REPORT to the remote file name C:\AnnualReport.Doc. Both the DSN and the REMOTE_FILE parameters are ignored if specified in SYSIN.

When a parameter is overridden, a warning message is written to the batch output file following the SYSIN parameters. The message contains the overridden parameter name and is displayed for every parameter specified in the PARM string.

See the following example of the warning message issued when the SYSIN parameter has been overwritten.

PGTB4124W PARM string parameter DSN will over write SYSIN value