Overriding the default job name

On a z/OS® MVS™ Remote Build server, you can override the default Remote Server build job name with the name of the user who requests the job.

When you use a JOB statement in your RCCMVS JCL that specifies a hardcoded job name, the Remote Build server generates the following job name:

your_job_name + n

In this name, n is a number from 0 through 9. For example, the first job that is named RCCMVS becomes RCCMVS0

There are two ways of overriding the job name in RCCMVS with the TSO user ID of the build requestor:
  • You can override the default job name when you submit a build request from the client:
    rccbuild –h servermachine@portno –j jobName
  • You can specify a user-defined parameter in the RCCMVS JCL member:
    1. Substitute the job name value with the user-defined parameter &USERID. For example:
      //&USERID JOB (ACCT#),'DEFINE TSO ID',CLASS=A
    2. Specify a valid TSO user ID as the rccbuild –au parameter. For example:
      rccbuild –h servermachine@portno –j jobName
    3. Start the Remote Build server using authentication mode –a1 or –a2.

      The following table describes the requirements for substituting a TSO user ID as a remote build job name. In this table, n is designated by "suffix."

      Table 1. Authentication modes and runtime job names
      Server auth mode User ID supplied in rccbuild command? Job name supplied in rccbuild command? &USERID value in RCCMVS JCL Member Runtime job name
      –a0 No No Replaced by the user ID that starts the server Server job ID plus suffix
      –a0 Yes No Replaced by the user ID that starts the server Server job ID plus suffix
      –a1 No No Replaced by the user ID that starts the server Server job ID plus suffix
      –a1 Yes No Replaced by the –au supplied name –au name plus suffix
      –a2 Yes No Replaced by the –au supplied name –au name plus suffix
      –a0 No Yes Replaced by the user ID that starts the server -j name plus suffix
      –a0 Yes Yes Replaced by the user ID that starts the server -j name plus suffix
      –a1 No Yes Replaced by the user ID that starts the server -j name plus suffix
      –a1 Yes Yes Replaced by the –au supplied name -j name plus suffix
      –a2 Yes Yes Replaced by the –au supplied name -j name plus suffix
      -aS Yes Yes Replaced by the -au supplied name -au name plus suffix