Appendix G. Overriding JCL SYSIN Parameters

The parameters specified by the PARM string are processed after the SYSIN parameters and override any duplicate parameter values specified in the SYSIN statement. Therefore, you can specify SYSIN parameters by using the PARM field of the JCL EXEC statement. The parameters in the PARM string are also applied to every PROCESS statement (every transaction) queued in that particular step.

In the PARM field, the parameters describing the server (SERVER, SERVLUNAME, SERVIPADDR, and SERVIPNAME) and their values must be the first group of items specified. For more information on the required PARM parameters, see Batch Interface.

Following the server name, any valid SYSIN parameters can be specified in the parameter string. For more information on valid SYSIN parameters, see Batch Interface.

Each parameter and its corresponding value must be separated by an equal sign (=). A comma must be used to separate each parameter or 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”’

In the follwing Batch example some SYSIN parameters will be 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
In this example, the SYSIN parameters in bold will be overridden and are therefore unnecessary to code. In the first step, processes SALES1 and SALES2 will receive a remote file called C:\SalesReport.DOC whether or not the parameter is specified in the SYSIN statement. In the second step, processes DISTRIB1 and DISTRIB2 will send the data set named DISTRIB.ANNUAL.REPORT to the remote file named C:\AnnualReport.Doc. Both the DSN and the REMOTE_FILE parameters are ignored if specified in the SYSIN statement.

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

PGTB4124W PARM string parameter DSN will over write SYSIN value