x

The ddname SYSCTL must be allocated to the SYSCTL data set corresponding to the Central Version desired. No allocation of IDMS data sources or subschema/DMCL load modules is needed when running CV.

The IDMS functions will take place in the IDMS CV address space. The subschema load modules are located and retrieved in the following order:

1. CV primary load area (DDLDCLOD area).
2. CDMSLIB ddname from the IDMS Central Version job.
3. STEPLIB ddname from the IDMS Central Version job.

The global DMCL of the CV is used, but may be overridden by the DMCL assigned in the SYSIDMS ddname.

Note:

• When accessing data from secondary dictionaries, the primary load area is not searched to retrieve the subschema/DMCL modules.
• In most cases, there are two CA-IDMS load libraries that must be allocated to STEPLIB.

Top of page

Example: Sample JCL for Central Version Access to IDMS

You can use the following sample JCL as a template for CV access. Add a valid job card and edit it to conform to the standards and naming conventions at your site:

//job card goes here
//IDMSCV   EXEC PGM=FOCUS
//STEPLIB  DD  DSN=highlvl.DBA.LOADLIB,DISP=SHR
//         DD  DSN=highlvl.LOADLIB,DISP=SHR
//         DD  DSN=prefix.IDMS.LOAD,DISP=SHR
//         DD  DSN=prefix.FOCLIB.LOAD,DISP=SHR
//ERRORS   DD  DSN=prefix.ERRNLS.DATA,DISP=SHR
//         DD  DSN=prefix.ERRORS.DATA,DISP=SHR
//MASTER   DD  DSN=prefix.MASTER.DATA,DISP=SHR
//         DD  DSN=userid.MASTER.DATA,DISP=SHR
//FOCIDMS  DD  DSN=prefix.ACCESS.DATA,DISP=SHR
//FOCEXEC  DD  DSN=prefix.FOCEXEC.DATA,DISP=SHR 
//         DD  DSN=userid.FOCEXEC.DATA,DISP=SHR 
//SYSCTL   DD  DSN=highlvl.SYSCTL,DISP=SHR
//SYSIDMS  DD  DSN=highlvl.SYSIDMS,DISP=SHR
//SYSIN    DD   *
? REL
TABLE FILE EMPFILE
PRINT EMP_NAME_0415
END
FIN

where:

highlvl

Is the high-level qualifier for Computer Associates supplied data sets.

prefix

Is the high-level qualifier for FOCUS production data sets.

userid

Is the high-level qualifier for a private data set belonging to the user.

Top of page

Example: Sample CLIST for CV Access to IDMS

You can use the following sample CLIST as a template for CV access. Edit it to conform to the standards and naming conventions at your site:

ALLOC DD(STEPLIB) DA('highlvl.DBA.LOADLIB'-
                     'highlvl.LOADLIB') SHR REUSE
ALLOC F(FOCEXEC) DA('prefix.FOCEXEC.DATA' -
                    'userid.FOCEXEC.DATA') SHR REUSE
ALLOC F(MASTER)  DA('prefix.MASTER.DATA' -
                    'userid.MASTER.DATA') SHR REUSE
ALLOC F(FOCIDMS) DA('prefix.ACCESS.DATA') SHR REUSE
ALLOC F(USERLIB) DA('prefix.IDMS.LOAD') SHR REUSE
ALLOC F(FOCLIB)  DA('prefix.FOCLIB.LOAD') SHR REUSE
ALLOC F(ERRORS)  DA('prefix.ERRNLS.DATA' -
                    'prefix.ERRORS.DATA') SHR REUSE
ALLOC F(SYSCTL)  DA('highlvl.SYSCTL') SHR REUSE
ALLOC F(SYSIDMS) DA('highlvl.SYSIDMS') SHR REUSE
CALL 'prefix.FOCLIB.LOAD(FOCUS)'                

where:

highlvl

Is the high-level qualifier for Computer Associates supplied data sets.

prefix

Is the high-level qualifier for FOCUS production data sets.

userid

Is the high-level qualifier for a private data set belonging to the user.

x

The user must allocate all IDMS database files. These files must be allocated to the ddnames that are assigned in the IDMS/DB Schema.

All journal file allocations must be made available along with the default local mode journal, SYSJRNL, assigned to DD DUMMY.

In some cases, the libraries containing the subschema, DMCL, and IDMSINTB load modules may not be authorized. If STEPLIB cannot be used for unauthorized IDMS libraries, in a local mode job you can allocate these unauthorized modules to ddname CDMSLIB. With CDMSLIB allocated, IDMS will search the CDMSLIB before STEPLIB to obtain all IDMS/DB specific load modules.

x

The IDMS load modules IDMS and IDMSINTB must be made available at run-time, allocated to the ddname STEPLIB.

When running a CLIST, the STEPLIB ddname is not valid. These members must be allocated to either the link list or in the TSO logon procedure. Contact your Systems Programmer to add these members.

The member names of the FOCUS Master Files and Access Files to read the subschema must be identically named and made available at run time.

SYSIDMS can be allocated to identify the DMCL for both CV and LOCAL modes.