Previous Topic: Batch Processing OverviewNext Topic: Commands for z/VM

Batch Processing › JCL for z/OS

JCL for z/OS

Use the following JCL for an IDMSBCF session that will run under the central version.

IDMSBCF (z/OS)

//stepname EXEC PGM=IDMSBCF,REGION=1024K
//STEPLIB  DD   DSN=idms.dba.loadlib,DISP=SHR
//         DD   DSN=idms.custom.loadlib,DISP=SHR
           DD   DSN=idms.cagjload,DISP=SHR
//sysctl   DD   DSN=idms.sysctl,DISP=SHR
//dcmsg    DD   DSN=idms.sysmsg.ddldcmsg,DISP=SHR
//SYSLST   DD   SYSOUT=A
//SYSIDMS  DD   *
DMCL=dmcl-name
DICTNAME=dictionary-name
Other SYSIDMS parameters, as appropriate
/*
//SYSIPT   DD   *
Statements (including optional SET OPTIONS statements)
/*

Note: For more information about SYSIDMS parameters, see SYSIDMS Parameter File.

Stepname

Name of the job step

idms.dba.loadlib

 

Data set name of the load library containing the DMCL and database name table load modules

idms.custom.loadlib

Data set name of the load library containing customized CA IDMS executable load modules

idms.cagjload

 

Data set name of the load library containing the CA IDMS executable modules that do not require customization

sysctl

 

Ddname of the SYSCTL file

idms.sysctl

 

Data set name of the SYSCTL file (the link to the central version)

dcmsg

 

Ddname of the system message (DDLDCMSG) area

idms.sysmsg.ddldcmsg

Data set name of the system message (DDLDCMSG) area

dmcl-name

 

Name of the DMCL

dictionary-name

 

Name of the dictionary to access

You can specify DICTNAME as a SYSIDMS parameter or you can use the CONNECT TO dictname statement. CONNECT TO supersedes the SYSIDMS parameter.
If You Submit a PUNCH Statement

If you are going to submit any PUNCH statements, include a SYSPCH statement in JCL, for example:

//SYSPCH  DD DSN=dsname, DISP=(NEW,KEEP,DELETE),
             DCB=(RECFM=FB,BLKSIZE=9040,LRECL=80),
                  SPACE=space-specification,
                  UNIT=unit,VOL=SER=nnnnnn
If You Submit Physical DDL Statements

If you are going to submit any physical DDL statements, include the following DD statements:

//dccat    DD   DSN=idms.system.ddlcat,DISP=SHR
//dccatl   DD   DSN=idms.system.ddlcatlod,DISP=SHR
//dccatx   DD   DSN=idms.system.ddlcatx,DISP=SHR

dccat

Ddname of the system dictionary catalog (DDLCAT) area

idms.system.ddlcat

Data set name of the system dictionary catalog (DDLCAT) area

dccatl

Ddname of the system dictionary catalog load (DDLCATLOD) area

idms.system.ddlcatlod

Data set name of the system dictionary catalog load (DDLCATLOD) area

dccatx

Ddname of the system dictionary catalog index (DDLCATX) area

idms.system.ddlcatx

Data set name of the system dictionary catalog index (DDLCATX) area
If You Submit SQL Statements

If you are going to submit any SQL DDL or SQL DML statements, include the following DD statements:

//sqldd    DD DSN=idms.syssql.ddlcat,DISP=SHR
//sqllod   DD DSN=idms.syssql.ddlcatlod,DISP=SHR
//sqlxdd   DD DSN=idms.syssql.ddlcatx,DISP=SHR
//userdb   DD DSN=user.userdb,DISP=SHR

sqldd

Ddname of the SQL catalog area

idms.syssql.ddlcat

Data set name of the SQL catalog area

sqllod

Ddname of the SQL catalog load area

idms.syssql.ddlcatlod

Data set name of the SQL catalog load area

sqlxdd

Ddname of the SQL catalog index area

idms.syssql.ddlcatx

Data set name of the SQL catalog index area

userdb

Ddname of the user database file

user.userdb

Data set name of the user database file
If You Submit Utility Statements

For more information about the file assignments specific to utility statements, see the CA IDMS Utilities Guide.

Executing in Local Mode

To specify that an IDMSBCF job stream is executing in local mode, remove the SYSCTL DD statement from the job stream and replace it with the following DD statements, as needed:

//dclscr   DD   DSN=idms.sysloc.ddlocscr,DISP=SHR
//secdd    DD   DSN=idms.sysuser.ddlsec,DISP=SHR
//dictdb   DD   DSN=idms.appldict.ddldml,DISP=SHR
//dloddb   DD   DSN=idms.appldict.ddldclod,DISP=SHR
//sysjrnl  DD   DSN=idms.tapejrnl,DISP=SHR

dclscr

Ddname of the local mode scratch (DDLOCSCR) area

idms.sysloc.ddlocscr

Data set name of the local mode scratch (DDLOCSCR) area

secdd

Ddname of the system user catalog (DDLSEC) area

idms.sysuser.ddlsec

Data set name of the system user catalog (DDLSEC) area

dictdb

Ddname of the application dictionary definition (DDLDML) area

idms.appldict.ddldml

Data set name of the application dictionary definition (DDLDML) area

dloddb

Ddname of the application dictionary definition load (DDLDCLOD) area

idms.appldict.ddldclod

Data set name of the application dictionary definition load (DDLDCLOD) area

sysjrnl

Ddname of the tape journal file

idms.tapejrnl

Data set name of the tape journal file
Output File Attributes

If you are putting the SYSLST output from IDMSBCF to a file, the attributes of that file must be as follows: