Editing the RCCRUNM or RCCRUNU member

The RCCRUNM (for z/OS® MVS™ platforms) or RCCRUNU (for z/OS UNIX® System Services ) JCL member contains customizable options that are passed to the server when it starts. To customize these options, you make changes to this member.

About this task

To edit the RCCRUNM or RCCRUNU member, do these steps. See the related concepts for more information on setting these options and how these options function.
Note: You should customize RCCRUNU only if you chose to install the Remote Build feature on z/OS UNIX System Services.

Procedure

  1. Customize the JOB statement as needed.
  2. Modify the RSERVER (in RCCRUNM) or RSERVERU (in RCCRUNU) parameter in the following manner:
    Note: The RSERVER or RSERVERU PROC contains default values for user-defined variables in the PARM EXEC parameter and the DD statements.
    • PORTNO=portno: Replace portno with the server listening port. This variable is passed to the server in the -p runtime parameter.
    • AUTH=number: Replace number with the server authentication mode. Valid values are 0, 1, 2, and S. This variable is passed to the server in the -a runtime parameter.
    • MAXBUILD=number: Replace number with the maximum number of concurrent builds. The default is 1. This variable is passed to the server in the -n runtime parameter.
    • HLQ=high level qualifier: Replace high level qualifier with the high level qualifier of the load library data set name that contains the Remote Build modules.
  3. Optional: Specify the following runtime parameters by adding them to the PARM clause within the EXEC statement:
    -strict
    Activates the comment field continuation feature.
    -oldcond
    Activates the former behavior of pseudo-JCL COND. Before release 7.0.1.1, BCL was called pseudo-JCL. The former behavior is the behavior that the JCL COND clause had prior to release 7.0.1.1. This option is meaningful only for the z/OS MVS Remote Build server (that is, the RCCRUNM member).
    Note: This option is not recommended. It is included as a migration aid and might be removed in the future.
    –t
    Activates tracing. Trace entries are captured in the data set defined by the RCCBLOG DD statement.
    –q number
    Specifies the size of the queue for client requests. The default is 10.
    -u device
    Enables you to change the default UNIT specification for temporary data sets allocated by the Remote Build server.

    The device option is an alphanumeric character string of up to 8 characters.

    Valid values for the device are site-dependent. VIO is the default. If your z/OS MVS environment cannot support the default value (VIO), then this runtime parameter is mandatory. For example, specify -u 3390 if your z/OS MVS environment only has 3390 devices.

    This option is meaningful only for the z/OS MVS Remote Build server (that is, the RCCRUNM member).

    –V
    Specifies the verbosity level of server messaging (1, 2, or 3). The first instance sets the level at 1. Specify up to three instances.

    The following string sets the verbosity level at 2.

    PARM='… –V –V'

    The following is an example of runtime parameters with several options that are added to the PARM clause within the EXEC statement:
    // PARM=('ENVAR("_CEE_ENVFILE=DD:EDCENV")/
    //             –p &PORTNO –a &AUTH –n &MAXBUILD –q 5 -t –V –V')
  4. Modify the data set name in the STEPLIB DD statement to point to the version level of the load library data set name that contains the Remote Build modules.
    Note: The STEPLIB DD statement must be present even if the data set is added to the system linklist.
  5. Modify the data set name in the RCCWJCL DD statement to point to the version level of the JCL data set name that contains the RCCMVS member.