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
- Customize the JOB statement as needed.
- 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.
- 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')
- 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.
- 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.