Object Manager Submit Utilities panel Model JCL Parameters
Article ID: 62705
Updated On:
Products
Issue/Introduction
When generating JCL for a utility via the Object Manager panels, the Submit Utilities panel has fields for Model JCL parameters. What should be supplied for the Model JCL Parameters?
On the Submit Utilities panel under menu option "U" - "DB2 Object Manager" of the Database Management Solutions for DB2 for z/OS Main Menu:
Model JCL Parameters
JOB Card:
Step JCL:
Library:
Environment
Component: GEN
Resolution
The Model JCL comes from the highlvl.CDBAMDL library. The JOB Card comes from member MJJOBUT and the Step JCL comes from MJPTIUT.
For example:
Model Jcl Parameters
JOB Card : MJJOBUT
Step JCL : MJPTIUT
Library : 'hlq.CDBAMDL'
The JOB Card member (MJJOBUT) contains the jobcard model code. It isn't JCL yet!
Sample of the supplied standard :
//%USERID.@ JOB CLASS=%CLASS,MSGCLASS=%MSGCLASS
This model code pulls in Symbolic Variables indicated by a "%" at the start of the word.
While %USERID is an "Automatic Symbolic" , %CLASS and %MSGCLASS require input from the user.
As an example, enter the object manager using a "U" on the main Database Management for DB2 for Z/OS menu.
Select "1" for Tablespace
Enter a Database name and obtain a list of tablespaces related to that Database.
Enter a "C" in the OPT column against a tablespace. Go through the Quick Copy Screen requirements and PF3.
The next screen is the Submit Utilities where the Model Jcl Parameters fields can be seen.
Enter a "P" to preview: EXECUTION MODE: P and enter.
The next screen displayed is below....where the CLASS and MSGCLASS value must be entered.....then enter.
UOPGLMD - Symbolic Replacement Variables - yyyy/mm/dd hh:mm
COMMAND ==> SCROLL ==> CSR
Loc: LOCAL ------------------------------------------------- User ID: authid1
MODEL: MJJOBUT LIBRARY: 'hlq.CDBAMDL'
********************************* TOP OF DATA *********************************
- SYMBOLIC PARM -- -------------- REPLACEMENT -------------
USERID - AUTOMATIC REPLACEMENT -
CLASS a_____________________________________________
MSGCLASS x_____________________________________________
MODEL JCL STATEMENTS ==>
//%USERID.@ JOB CLASS=%CLASS,MSGCLASS=%MSGCLASS
******************************** BOTTOM OF DATA *******************************
The JCL for the job is then displayed in ISPF edit for saving, submitting or editing.
//AUTHID1@ JOB CLASS=A,MSGCLASS=X
//*
//* MODEL = MJPTIUT DATE = mm-dd-yyyy TIME = nnnnnn
//*
//UTIL0001 EXEC PGM=PTLDRIVM,
// PARM='EP=UTLGLCTL/ssid,',
// REGION=0M
//*
//STEPLIB DD DISP=SHR,DSN=hlq.CDBALOAD
// DD DISP=SHR,DSN=hlq.PRIVATE.SDSNEXIT
// DD DISP=SHR,DSN=hlq.SDSNLOAD
//PTILIB DD DISP=SHR,DSN=hlq.CDBALOAD
// DD DISP=SHR,DSN=hlq.PRIVATE.SDSNEXIT
// DD DISP=SHR,DSN=hlq.SDSNLOAD
//PTIPARM DD DISP=SHR,DSN=hlq.CDBAPARM
//*
//PTIMSG DD SYSOUT=*
//PTIIMSG DD SYSOUT=*
//*
//SYSOUT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//ABNLIGNR DD DUMMY SUPPRESS ABENDAID DUMPS
//STXXMSG DD SYSOUT=*
//*
//SYSCP101 DD DSN=hlq.DBCORP.DSN8S12A.SYSCP101.COPY,
// DISP=(,CATLG),SPACE=(4096,(1,5)),UNIT=SYSDA
//SYSIN DD *
COPY TABLESPACE DBCORP.DSN8S12A
STOP-LIMIT 1
COPY-TASKS 1
ALLMSGS
COPY-BUFFERS 3
STARTUP-ACCESS RW
EXCP YES
MODIFYBITS NO SHRLEVEL REFERENCE
FULL YES FULL-AUTO YES
QUICKCOPY COPY01(Y,SYSCP101,,LP)
This jobcard may or may not be acceptable at your site but that is what is generated from the vanilla model.
The Step JCL member (MJPTIUT) contains model JCL for the EXEC cards, STEPLIBs, LOADLIBs, input/outputs and work datasets for the utility. There are also a great many Symbolic Variables used here also to pull in values for the generated JCL. Strongly recommend not to alter MJPTIUT in any way.
If a user copy of highlvl.CDBAMDL library was made with another name the jobcard member( MJJOBUT ) could be customised to suit local requirements. ALternatively, a copy of MJJOBUT could also be created in the same library, assuming the user has access to do that, and instead of using MJJOBUT the user would use the customised one. Strongly recommend not altering the vanilla MJJOBUT as any maintenance applied to it will wipe out any customisations. Always make and use copies of them.
Additional Information
Feedback
