Sample z/OS JCL

Contents
idms
Contents
Library, Dataset, and File Name References in z/OS JCL
References are made to the following libraries, Datasets, and file names in z/OS JCL or elsewhere in this section.
For more information on libraries and Datasets see the
Installing section for z/OS
.
  • asfData
    Ddname of the ASF Data (IDMSR-AREA2) area
  • asfdefn
    Ddname of the ASF Data definition (IDMSR-AREA2) area
  • asfdml
    Ddname of the ASF dictionary definition (DDLDML) area
  • asflod
    Ddname of the ASF dictionary definition load (DDLDCLOD) area
  • dccat
    Ddname of the system dictionary catalog (DDLCAT) area
  • dccatl
    Ddname of the system dictionary catalog load (DDLCATLOD) area
  • dccatx
    Ddname of the system dictionary catalog index (DDLCATX) area
  • dcdml
    Ddname of the system dictionary definition (DDLDML) area
  • dclod
    Ddname of the system dictionary definition load (DDLDCLOD) area
  • dclog
    Ddname of the system log (DDLDCLOG) area
  • dcmsg
    Ddname of the system message (DDLDCMSG) area
  • dcrun
    Ddname of the system queue (DDLDCRUN) area
  • dcscr
    Ddname of the system scratch (DDLDCSCR) area
  • dcucfsys
    Name assigned at link edit time to the executable module that starts up DC/UCF. This name is normally RHDCOMVS, which is linked in CAGJLOAD during the installation of CA IDMS.
  • dictdb
    Ddname of the application dictionary definition area
  • dirldb
    Ddname of the IDMSDIRL definition (DDLDML) area
  • dirllod
    Ddname of the IDMSDIRL definition load (DDLDCLOD) area
  • dloddb
    Ddname of the application dictionary definition load (DDLDCLOD) area
  • empdemo
    Ddname of the EMP-DEMO-AREA area
  • empldemo
    Ddname of the EMPLAREA area
  • idmsloga
    Ddname of the first sequential log file
  • idms.appldict.ddldclod
    Data set name of the application dictionary definition load (DDLDCLOD) area
  • idms.appldict.ddldml
    Data set name of the application dictionary definition (DDLDML) area
  • idms.asfdict.asfData
    Data set name of the ASF Data (IDMSR-AREA2) area
  • idms.asfdict.asfdefn
    Data set name of the ASF Data definition (IDMSR-AREA) area
  • idms.asfdict.ddldclod
    Data set name of the ASF dictionary definition load (DDLDCLOD) area
  • idms.asfdict.ddldml
    Data set name of the ASF dictionary definition (DDLDML) area
  • idms.cagjcics
    Name of the CA IDMS CICS library used by TPSORT.
    This library exists only if you installed the CICS option.
  • idms.cagjload
    Data set name of the load library containing the vanilla CA IDMS programs
  • idms.cagjmac
    Name of the CA IDMS macro library
  • idms.cagjsrc
    Name of the CA IDMS source library
  • idms.custom.jcllib
    Name of the JCL library created during configuration. Some members in this library are tailored to your site during the configuration phase of the install process. Others are samples that can be modified for later use during manual configuration.
  • idms.custom.loadlib
    Data set name of the library containing the load modules customized during configuration.
  • idms.custom.srclib
    Data set name of the library containing the source modules customized during configuration.
  • idms.dba.loadlib
    Data set name of the load library containing the DMCL, Database name table, and programs associated with demo databases.
  • idms.empdemo.emdemo
    Data set name of the EMP-DEMO-AREA area of the Commonweather Database
  • idms.empdemo.insdemo
    Data set name of the INS-DEMO-AREA area of the Commonweather Database
  • idms.empdemo.orgdemo
    Data set name of the ORG-DEMO-AREA area of the Commonweather Database
  • idms.j1jrnl / idms.j4jrnl
    Data set name of the first through fourth disk journal file
  • idms.projseg.projdemo
    Data set name of the PROJAREA area of the Commonweather (SQL-defined) Database
  • idms.sqldemo.empldemo
    Data set name of the EMPLAREA area of the Commonweather (SQL-defined) Database
  • idms.sqldemo.indxdemo
    Data set name of the INDXAREA area of the Commonweather (SQL-defined) Database
  • idms.sqldemo.infodemo
    Data set name of the INFOAREA area of the Commonweather (SQL-defined) Database
  • idms.startup.loadlib
    Data set name of the load library containing the IDMS startup module
  • idms.sysctl
    Data set name of the SYSCTL file
  • idms.systrk
    Data set name of the SYSTRK file
  • idms.sysdirl.ddldclod
    Data set name of the IDMSDIRL definition load (DDLDCLOD) area
  • idms.sysdirl.ddldml
    Data set name of the IDMSDIRL definition (DDLDML) area
  • idms.sysloc.ddlocscr
    Data set name of the local mode system scratch (SYSLOC.DDLOCSCR) area
  • idms.sysmsg.ddldcmsg
    Data set name of the system message (DDLDCMSG) area
  • idms.syssnap
    Data set name of the sequential log file
  • idms.syssql.ddlcat
    Data set name of the SQL catalog (DDLCAT) area
  • idms.syssql.ddlcatld
    Data set name of the SQL catalog (DDLCATLOD) area
  • idms.syssql.ddlcatx
    Data set name of the SQL catalog index (DDLCATX) area
  • idms.system.ddldccat
    Data set name of the system dictionary catalog (DDLCAT) area
  • idms.system.ddlcatld
    Data set name of the system dictionary catalog load (DDLCATLOD) area
  • idms.system.ddldcatx
    Data set name of the system dictionary catalog index (DDLCATX) area
  • idms.system.ddldclod
    Data set name of the system dictionary definition load (DDLDCLOD) area
  • idms.system.ddldclog
    Data set name of the system log (DDLDCLOG) area
  • idms.system.ddldcrun
    Data set name of the system queue (DDLDCRUN) area
  • idms.system.ddldcscr
    Data set name of the system scratch (DDLDCSCR) area
  • idms.system.ddldml
    Data set name of the system dictionary definition (DDLDML) area
  • idms.sysuser.ddlsec
    Data set name of the system user catalog (SYSUSER.DDLSEC) area
  • indxdemo
    Ddname of the INDXAREA area
  • infodemo
    Ddname of the INFOAREA area
  • insdemo
    Ddname of the INS-DEMO-AREA area
  • j1jrnl / j4jrnl
    Ddname of the first through fourth disk journal file
  • language.runtime.lib
    Data set name of the runtime support library for COBOL, PL/I, and so on.
  • orgdemo
    Ddname of the ORG-DEMO-AREA area
  • projdemo
    Ddname of the PROJDEMO area
  • region-size
    Size of the region in which the DC/UCF system is built; this amount should include the FREESTG storage reserved by the startup PARM statement or the default.
  • secdd
    Ddname of the system user catalog (SYSUSER.DDLSEC) area
  • sqldd
    Ddname of the SQL catalog (DDLCAT) area
  • sqllod
    Ddname of the SQL catalog load (DDLCATLOD) area
  • sqlxdd
    Ddname of the SQL catalog index (DDLCATX) area
  • sysctl
    Ddname of the SYSCTL file
  • systrk
    Ddname used for SYSTRK files (For more information on referencing SYSTRK files, see Change Tracking.)
  • userdb
    Ddname of the user Database or application dictionary file
  • user.userdb
    Data set name of the user Database or application dictionary
  • your.application.loalib
    Data set name of the load library containing user-written application programs.
  • your.authorized.loadllib
    Data set name of the authorized DC/UCF/CV Startup load library. This library is needed as the only library in the startup Steplib if any of the following are true:
    • The zIIP exploitation feature is in effect. See zIIP Exploitation for more information.
    • The z/OS parameter AllowUserKeyCSA(NO) is in effect. See Storage Key Considerations for z/OS CSA subpools for information.
    • The CA IDMS SVC is installed with parameter AUTHREQ=YES. See z/OS for more information.
  • your.custom.lib
    Data set name of the load or object library containing user-written programs, such as exits and built-in functions.
    This may be the same library that contains the load modules customized during configuration.
  • zOS.maclib
    Data set name of the z/OS macro library
z/OS Assemble and Link-Edit JCL
Use the following JCL to assemble and link-edit a module in z/OS.
//ASMCL   EXEC HLASMCL //C.SYSLIB   DD DISP=SHR,DSN=zOS.maclib //           DD DISP=SHR,DSN=idms.cagjmac //C.SYSIN    DD DISP=SHR,DSN=idms.custom.srclib(source-member) //L.SYSLMOD  DD DISP=SHR,DSN=idms.custom.loadlib //L.CAGJLOAD DD DISP=SHR,DSN=idms.cagjload //L.CUSTLIB  DD DISP=SHR,DSN=your.custom.lib //L.SYSIN DD *  binder-statements /*
Replace the variables in the JCL:
  • source-member
    Replace source-member with the name of the member containing the source to be assembled.
  • binder-statements
    Replace binder-statements with the binder input statements appropriate to the load module being created.
z/OS Link-Edit JCL
Use the following JCL to link-edit a module in z/OS:
//LNKUXIT EXEC PGM=HEWL, //             PARM=(XREF,MAP,LET,LIST,NCAL) //SYSPRINT DD  SYSOUT=* //SYSUT1   DD  DSN=&&SYSUT1,UNIT=VIO,SPACE=(1700,(600,100)) //SYSLMOD  DD  DISP=SHR,DSN=idms.custom.loadlib //CAGJLOAD DD  DISP=SHR,DSN=idms.cagjload //CUSTLIB  DD  DISP=SHR,DSN=your.custom.lib //SYSLIN   DD *  binder-statements /*
Replace the variables in the JCL:
  • binder-statements
    Replace binder-statements with the binder input statements appropriate to the load module being created.
z/OS DC/UCF Startup JCL
z/OS DC/UCF startup
//         EXEC PGM=dcucfsys,REGION=region-size //STEPLIB  DD DSN=your.authorized.loadlib,DISP=SHR Or  //STEPLIB  DD DSN=idms.cagjload,DISP=SHR //CDMSLIB  DD DSN=idms.dba.loadlib,DISP=SHR //         DD DSN=idms.custom.loadlib,DISP=SHR //         DD DSN=idms.cagjload,DISP=SHR //         DD DSN=your.application.loadlib,DISP=SHR //j1jrnl   DD DSN=idms.j1jrnl,DISP=SHR //j2jrnl   DD DSN=idms.j2jrnl,DISP=SHR //j3jrnl   DD DSN=idms.j3jrnl,DISP=SHR //j4jrnl   DD DSN=idms.j4jrnl,DISP=SHR //dcdml    DD DSN=idms.system.ddldml,DISP=SHR //dclod    DD DSN=idms.system.ddldclod,DISP=SHR //dccat    DD DSN=idms.system.ddldccat,DISP=SHR //dccatx   DD DSN=idms.system.ddldcatx,DISP=SHR //dccatl   DD DSN=idms.system.ddlcatld,DISP=SHR //secdd    DD DSN=idms.sysuser.ddlsec,DISP=SHR //dcmsg    DD DSN=idms.sysmsg.ddldcmsg,DISP=SHR //dclog    DD DSN=idms.system.ddldclog,DISP=SHR //dcrun    DD DSN=idms.system.ddldclrun,DISP=SHR //dcscr    DD DSN=idms.system.ddldcscr,DISP=SHR //sqldd    DD DSN=idms.syssql.ddlcat,DISP=SHR //sqllod   DD DSN=idms.syssql.ddlcatld,DISP=SHR //sqlxdd   DD DSN=idms.syssql.ddlcatx,DISP=SHR //dictdb   DD DSN=idms.appldict.ddldml,DISP=SHR //dloddb   DD DSN=idms.appldict.ddldclod,DISP=SHR //dirldb   DD DSN=idms.sysdirl.ddldml,DISP=SHR //dirllod  DD DSN=idms.sysdirl.ddldclod,DISP=SHR //asfdml   DD DSN=idms.asfdict.ddldml,DISP=SHR //asflod   DD DSN=idms.asfdict.ddldclod,DISP=SHR //asfdefn  DD DSN=idms.asfdict.asfdefn,DISP=SHR //asfdata  DD DSN=idms.asfdict.asfdata,DISP=SHR //empdemo  DD DSN=idms.empdemo.empdemo,DISP=SHR //insdemo  DD DSN=idms.empdemo.insdemo,DISP=SHR //orgdemo  DD DSN=idms.empdemo.orgdemo,DISP=SHR //empldemo DD DSN=idms.sqldemo.empldemo,DISP=SHR //infodemo DD DSN=idms.sqldemo.infodemo,DISP=SHR //indxdemo DD DSN=idms.sqldemo.indxdemo,DISP=SHR //projdemo DD DSN=idms.projseg.projdemo,DISP=SHR //userdb   DD DSN=user.userdb,DISP=SHR additional database file assignments, as necessary //SYSOUT   DD SYSOUT=A, //         DCB=(RECFM=VBA,LRECL=137,BLKSIZE=1370) //idmsloga DD DSN=idms.syssnap,DISP=SHR  << multitasking only //SYSUDUMP DD SYSOUT=A //sysctl   DD DSN=idms.sysctl,DISP=SHR   << optional if CA IDMS SVC is used //systrk   DD DSN=idms.systrk,DISP=SHR   << optional if change tracking is used teleprocessing network assignments, as necessary //SYSIDMS  DD  * SYSIDMS parameters, as required
A set of startup JCL tailored to your site is created in the STARTUP member of your custom JCL library during the configuration phase of the install process.