Skip to Content

Examples - using the job statement information

The following examples show how job statement information that is specified in an RMGR environment record is used during execution of the Create Recovery JCL function.

Formatting Option 1 (Yes)

The following job statement information is specified in the RMGR environment record:

//IRCV&T2&SEQ2 JOB (&JOBDATA1,&JOBDATA2),'&JOBDATA3',
//     CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),REGION=5M,
//     NOTIFY=&USERID
//* IMS1 RMGR FORMATTED JOBCARD

The value of the Formatting Option field is specified as 1 (Yes).

The following values are specified in PROFILE1, which applies to the Create Recovery JCL job:

  • JOBDATA1 is 4211
  • JOBDATA2 is 1921D
  • JOBDATA3 is USERNAME
  • JOBDATA4 is blank
  • JOBDATA5 is blank

During execution of the Create Recovery JCL function, the function performs the following substitutions of values that depend on current conditions:

  • It substitutes &T2 with the two right-most digits of the RMGR task number. In this case, the task number is 4322, and the right-most digits are 22.
  • It substitutes &SEQ2 with the sequence number. This case shows the first job in the sequence; therefore the number is 01.
  • It substitutes &JOBDATA1, &JOBDATA2, and &JOBDATA3 with the values of the JOBDATA1, JOBDATA2, and JOBDATA3 fields from the PROFILE1 profile.
  • It substitutes &USERID with the TSO user ID of the user who initiated the function (or with the value specified by the FROM keyword). In this case, the user ID is ABCDEF.

The following job statement results from the substitution:

//IRCV2201 JOB (4211,1921D),
//         'USERNAME',
//         CLASS=A,
//         MSGCLASS=X,
//         MSGLEVEL=(1,1),
//         REGION=5M,
//         NOTIFY=ABCDEF
//* IMS1 RMGR FORMATTED JOBCARD

Formatting Option 2 (No)

The following job statement information is specified in the RMGR environment record:

//IRCV&SEQ1 JOB (&JOBDATA1,&JOBDATA2),'&JOBDATA3',
//     CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),REGION=5M,
//     NOTIFY=&USERID
//* IMS1 RMGR NONFORMATTED JOBCARD
&JOBDATA5

The value of Formatting Option field is specified as 2 (No).

The following values are in specified in PROFILE1, which applies to the Create Recovery JCL job:

  • JOBDATA1 is 4211
  • JOBDATA2 is 1921D
  • JOBDATA3 is USERNAME
  • JOBDATA4 is blank
  • JOBDATA5 is //* JOB FOR &USERID

During execution of the Create Recovery JCL function, the function performs the following substitutions of values that depend on current conditions:

  • It substitutes &SEQ1 with the sequence number. This case shows the first job in the sequence; therefore the number is 0.
  • It substitutes &JOBDATA1, &JOBDATA2, &JOBDATA3, and &JOBDATA5 with the values of the JOBDATA1, JOBDATA2, JOBDATA3, and JOBDATA5 fields from the PROFILE1 profile.
  • It substitutes &USERID in the NOTIFY parameter and in the JOBDATA5 field with the TSO user ID of the user who initiated the function (or with the value specified by the FROM keyword). In this case, the user ID is ABCDEF.

The following job statement results from the substitution with PROFILE1:

//IRCV0 JOB (4211,1921D),'USERNAME',
//     CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),REGION=5M,
//     NOTIFY=ABCDEF
//* IMS1 RMGR NONFORMATTED JOBCARD
//* JOB FOR ABCDEF

The following values are in specified in PROFILE2, which applies to another Create Recovery JCL job that uses this RMGR environment record:

  • JOBDATA1 is 4211
  • JOBDATA2 is 1921D
  • JOBDATA3 is USERNAME
  • JOBDATA4 is blank
  • JOBDATA5 is blank

The following job statement results from the substitution with PROFILE2; since this profile has no value for the JOBDATA5 variable, this variable is treated as null:

//IRCV0 JOB (4211,1921D),'USERNAME',
//     CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),REGION=5M,
//     NOTIFY=ABCDEF
//* IMS1 RMGR NONFORMATTED JOBCARD



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

IMS Database Guides 3.0