Open topic with navigation

TIBCO® Managed File Transfer Platform Server for z/OS 8.1.0

# 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

Copyright © 2003-2021. TIBCO Software Inc. All Rights Reserved.