Utility Statements (z/VSE)

File assignments for the batch command facility (z/VSE)
idmscu19
ARCHIVE JOURNAL
File assignments for the batch command facility (z/VSE)
// TLBL    SYS
nnn
,'
idms.archive
',,
nnnnnn
,,f // ASSGN   SYS
nnn
,
x'cuu
'
Additional archive journal file assignments, as required
idms.archive
File-ID of the tape archive file as defined in the DMCL
 
ARCHIVE LOG
File assignments for the batch command facility (z/VSE)
// DLBL    
dclog
,'
idms.system.ddldclog
',,DA // EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // TLBL    SYS002,'
idms.archive
',,
nnnnnn
,,f // ASSGN   SYS002,
x'cuu'
dclog
File-ID of the database log file
idms.archive
File-ID of the archive log file
 
ARCHIVE TRACE
The CA IDMS installation media contains the following sample JCL (intended for demonstration purposes only):
  • ATRCJCL -- Contains a skeleton of the JCL required to run the ARCHIVE TRACE utility.
BACKUP
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional file assignments, as required
// TLBL    SYS001,
'user.bkpfile'
,,
nnnnnn
,,f // ASSGN   SYS001,
x'cuu'
userdb
Filename of the user file
user.userdb
File-ID of the user file
user.bkpfile
File-ID of the tape backup file
 
BUILD
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    
userload
,'
user.load
',,SD // EXTENT  SYS002,
nnnnnn
// ASSGN   SYS002,DISK,VOL=
vvvvvv
,SHR // DLBL    
userbuild
,'
user.build
',,SD // EXTENT  SYS003,
nnnnnn
// ASSGN   SYS003,DISK,VOL=
vvvvvv
,SHR
Sort files are only needed when performing a complete BUILD
// DLBL    SORTWK1,'
sort.work.file
' // EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional sort files, as required
userdb
Filename of the user file
user.userdb
File-ID of the user file
user.load
File-ID of the input (SYS002) file; for sizing information see discussion of SYS003 in LOAD.
user.build
File-ID of the output (SYS003) file; for sizing information see BUILD.
When running a complete BUILD, SYS002 and SYS003 must pointto the
same
intermediate file. When running a stepped BUILD, SYS002 and SYS003 must point to
different
intermediate files.
CLEANUP
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional database file assignments, as required
userdb
Filename of the user file
user.userdb
File-ID of the user file
Central version
To execute CLEANUP SEGMENT under the central version:
  • Remove the TLBL and ASSGN statements for the tape journal file from the previous JCL.
  • Insert the following statement:
// DLBL SYSCTL,
file-id
,0,SD // EXTENT 
SYSnnn,vvvvvv
,1,0,1,1 // ASSGN 
SYSnnn
,DISK,VOL=
vvvvvv
,SHR
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
CONVERT CATALOG
DD statements for the batch command facility (z/VSE)
//DLBL       
ddlcat
,'
ucat.ddlcat
',,DA //EXTENT     SYS
nnn
,
nnnnnn
//ASSIGN     SYS
nnn
,DISK,VOL=
vvvvvv
,SHR //DLBL       
ddlcatx
,'
ucat.ddlcatx
',,DA //EXTENT     SYS
nnn
,
nnnnnn
//ASSIGN     SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
ddlcat
Filename of the file containing the DDLCAT area of the dictionary to be converted
ucat.ddlcat
File-ID of the file containing the DDLCAT area of the dictionary to be converted
ddlcatx
Filename of the file containing the DDLCATX area of the dictionary to be converted
ucat.ddlcatx
File-ID of the file containing the DDLCATX area of the dictionary to be converted
Central version
To execute CONVERT CATALOG under the central version:
  • Optionally remove any journal and database file statements
  • Insert the following statement:
    //DLBL SYSCTL,
    file-id
    ,_,SD //EXTENT SYSCTL
    nnn,vvvvvv
    ,1,_,1,1 //ASSGN SYS
    nnn
    ,DISK,VOL=
    vvvvvv
    ,SHR
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
CONVERT PAGE
File assignments for the batch command facility (z/VSE)
//DLBL       
userdb
,'
user.userdb
',,SD //EXTENT     SYS
nnn
,
nnnnnn
//ASSIGN     SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional database file assignments as needed.
//DLBL       
newdb
,'
user.newdb
',,SD //EXTENT     SYS
nnn
,
nnnnnn
//ASSIGN     SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional new converted database file assignments as needed.
userdb
Filename of the input database file
user.userdb
File-ID of the input database file
newdb
Filename of the output converted database file
user.newdb
File-ID of the output converted database file
 
EXPAND PAGE
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional database file assignments, as required
// DLBL    
userxb
,'
user.xbase
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional expanded database file assignments, as required
user.userdb
File-ID of the existing database file
user.xbase
File-ID of the expanded database file
 
EXTRACT JOURNAL
File assignments for the batch command facility (z/VSE)
// DLBL   SYS001,'
archive
',,SD // EXTENT SYS001,
nnnnnn
// ASSGN  SYS001,DISK,VOL=
vvvvvv
,SHR // DLBL   
extract,'jrnl.extract
',,SD // EXTENT 
sysnnn,nnnnnn
// ASSGN  
sysnnn
,DISK,VOL=
vvvvvv
,SHR
Add sort work files
Add SYSIDMS parameters
FILENAME=SYS
nnn
,BLKSIZE=
bbbbb
archive
File name of the complete archive or journal file. It can be on tape or disk as specified through the SYSIDMS parameter file.
extract
DDname of the extract journal file. If not specified, it defaults to SYS002. It can be on tape or disk as specified through the SYSIDMS parameter file.
jrnl.extract
Data set name of the extract journal file.
bbbbb
Block size of the extract journal file. Specify a size as large as the largest block size on the journal or archive files being processed.
 
FASTLOAD
File assignments for the batch command facility (z/VSE)
// DLBL   SORTWK1,'
sort.work.file
' // EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional sort files, as required
// DLBL   
userdb,'user.userdb'
,,DA // EXTENT SYS
nnn,nnnnnn
// ASSGN  SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional database file assignments, as required
// DLBL   RELDCTL.'
user.reldctl
',,SD // EXTENT SYS
nnn
,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS001,'
sort.unload
',,SD // EXTENT SYS001,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS001,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS002,'
user.dbl001
',,SD // EXTENT SYS002,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS002,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS004,'
dbl004.name
',,SD // EXTENT SYS004,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS004,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS005,'
user.dbl005
',,SD // EXTENT SYS005,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS005,DISK,VOL=
vvvvvv
,SHR // TLBL   SYS009,'
user.dbl009
',,
nnnnnn
,,f // ASSGN  SYS009,
x'cuu'
// DLBL   SYS010,'
user.dbl010
',,SD // EXTENT SYS010,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS010,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS011,'
user.dbl011
',,SD // EXTENT SYS011,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS011,DISK,VOL=
vvvvvv
,SHR
sort.unload
File-ID of the sort parameters created by IDMSTBLU
user.reldctl
Data set name of the reload control file containing control and set information. Blocksize of the RELDCTL file should be a multiple of 60 with a maximum size of 32,760. Blocksize is controlled through the BLKSIZE SYSIDMS parameter. For a complete description of SYSIDMS parameters, see the
CA IDMS Common Facilities Section
.
user.dbl001
File-ID of the file generated by the format program
user.dbl004
File-ID of the intermediate work file containing the output from SORT1. Record and block size should be the same as SYS001.
user.dbl005
File-ID of the intermediate work file containing a control record and set membership information from IDMSDBL2.
user.dbl009
File-ID of the intermediate work file containing the sorted contents of SYS005.
user.dbl010
File-ID of the intermediate work file containing pointer information from IDMSDBL3.
user.dbl011
File-ID of the intermediate work file containing sorted pointer information from SORT4.
userdb
Filename of the database file.
user.userdb
File-ID of the database file.
 
FIX ARCHIVE
File assignments for the batch command facility (z/VSE)
// TLBL    SYS001,'
idms.tjrnlold
',,
nnnnnn
,,f // ASSGN   SYS001,
x'cuu'
// TLBL    SYS002,'
idms.tjrnlfix
',,
nnnnnn
,,f // ASSGN   SYS002,
x'cuu'
idms.tjrnlold
File-ID of the input tape journal file
f
File number of the tape journal file
idms.tjrnlfix
File-ID of the output tape journal file
 
FIX PAGE
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional file assignments, as required
userdb
Filename of the user file
user.userdb
File-ID of the user file
Central version
To execute FIX PAGE under the central version:
  • Remove the TLBL and ASSGN statements for the tape journal file from the previous JCL.
  • Insert the following statement:
    // DLBL SYSCTL,
    file-id
    ,0,SD // EXTENT 
    SYSnnn,vvvvvv
    ,1,0,1,1 // ASSGN 
    SYSnnn
    ,DISK,VOL=
    vvvvvv
    ,SHR
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
FORMAT
File assignments for the batch command facility (z/VSE)
To format a new database file:
// DLBL    
userdb
,'user.userdb',,
tt
// EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
rrrr
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
To reformat an existing database file:
// DLBL    
userdb
,'user.userdb',,
tt
// EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
To format a new disk journal file:
// DLBL    
j1jrnl
,'idms.j1jrnl',,
SD
// EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
rrrr
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
To reformat an existing disk journal file:
// DLBL    
j1jrnl
,'idms.j1jrnl',,
SD
// EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional database and journal file assignments, as required
To format a new SYSTRK file:
// DLBL ffff.,'idms.systrk1',,xx // EXTENT SYSnnn,nnnnnn,,,ssss,rrrr // ASSGN SYSnnn,DISK,VOL=vvvvvv,SHR
To reformat an existing SYSTRK file:
// DLBL ffff,'idms.systrk1',,xx // EXTENT SYSnnn,nnnnnn // ASSGN SYSnnn,DISK,VOL=vvvvvv,SHR
userdb
Filename of the database file
user.userdb
File-ID of the database file
idms.j1jrnl
File-ID of the disk journal file
j1jrnl
Filename of the disk journal file
rrrr
Number of tracks (CKD) or blocks (FBA) in the disk extent; must be at least one more than the number of BDAM blocks or VSAM control intervals in the database
tt
File type of the file being formatted:
SD (sequential) if formatting by file or segment (unless it is a VSAM file)
DA (direct access) if reformatting by area
VSAM if formatting or reformatting a CA IDMS/DB VSAM file
Omit if reformatting by file
ffff
File name of the SYSTRK file
idms.systrk1
FILE-ID of the SYSTRK file
xx
File type of the file being formatted
SD (sequential) if INITIAL is specified
DA (direct access) if INITIAL is not specified
VSAM if formatting a VSAM file
Multiple extents
You can format a CA IDMS/DB VSAM file with multiple extents under z/VSE. However, you cannot format a BDAM file with multiple extents.
The SIZE parameter on the EXEC statement
The SIZE parameter on the EXEC statement enables the IBM rotational sensing (RPS) feature. When formatting CA IDMS/DB VSAM files, you should specify SIZE=AUTO on the EXEC statement for IDMSBCF.
Do not use the SIZE parameter at all when formatting BDAM files or files allocated on 3344 disk devices with RPS implemented within the hardware. When you use the SIZE parameter in these cases, CA IDMS/DB cannot access the required current updated copy of the DTF.
Central version
To execute FORMAT AREA or FORMAT SEGMENT under the central version:
  • Remove the TLBL and ASSGN statements for the tape journal file from the previous JCL.
  • Insert the following statement:
    // DLBL SYSCTL,
    file-id
    ,0,SD // EXTENT 
    SYSnnn,vvvvvv
    ,1,0,1,1 // ASSGN 
    SYSnnn
    ,DISK,VOL=
    vvvvvv
    ,SHR
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
INSTALL STAMPS
Local mode
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'user.userdb',,
tt
// EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
rrrr
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    
userdict
,'user.userdict',,
tt
// EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
userdb
Filename of the user file
user.userdb
File-ID of the user file
user.userdict
File-ID of the dictionary containing the table definitions
Central version
To execute INSTALL STAMPS under the central version:
  • Remove the TLBL and ASSGN statements for the tape journal file from the previous JCL.
  • Insert the following statement:
    // DLBL SYSCTL,
    file-id
    ,0,SD // EXTENT 
    SYSnnn,vvvvvv
    ,1,0,1,1 // ASSGN 
    SYSnnn
    ,DISK,VOL=
    vvvvvv
    ,SHR
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
LOAD
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    
userdict
,'user.userdict',,
tt
// EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS001,'
user.input
',,SD // EXTENT  SYS001,
nnnnnn
,,,
ssss,llll
// ASSGN   SYS001,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS002,'
user.loadin
',,SD // EXTENT  SYS002,
nnnnnn
,,,
ssss,llll
// ASSGN   SYS002,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS003,'
user.loadout
',,SD // EXTENT  SYS003,
nnnnnn
,,,
ssss,llll
// ASSGN   SYS003,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS
nnn,'sort.load
',,SD // EXTENT  SYS
nnn,nnnnnn
,,,
ssss,llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Sort files are only needed when performing a complete LOAD
// DLBL    SYS
nnn,'sort.work
',,SD // EXTENT  SYS
nnn,nnnnnn
,,,
ssss,llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional sort files, as required
userdb
Filename of the user file
user.userdb
File-ID of the user file
user.userdict
File-ID of the dictionary containing the table definitions
user.input
File-ID of the input file
user.loadin
File-ID of the input SYS002 file; for sizing information see LOAD.
user.loadout
File-ID of the output SYS003 file; for sizing information see LOAD.
sort.load
File-ID of the SYSPCH file
When performing a complete LOAD, you must preallocate the file referenced by SYS002 and SYS003 (the same file is used for both assigns in a complete LOAD). Do not use a temporary data set for these files.
LOCK
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
user.userdb
File-ID of the user database file
Central version
To execute LOCK AREA under the central version:
  • Remove the TLBL and ASSGN statements for the tape journal file from the previous JCL.
  • Insert the following statement:
    // DLBL SYSCTL,
    file-id
    ,0,SD // EXTENT 
    SYSnnn,vvvvvv
    ,1,0,1,1 // ASSGN 
    SYSnnn
    ,DISK,VOL=
    vvvvvv
    ,SHR
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
MAINTAIN INDEX
File assignments for the batch command facility (z/VSE)
// DLBL    SORTWK1,'
sort.work.file
' // EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional sort files, as required
// DLBL    
userdb
,'
user.olddb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional existing database file assignments, as required
// DLBL    RELDCTL.'
user.reldctl
',,SD // EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss,llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS003,'
user.dbl003
',,SD // EXTENT  SYS003,
nnnnnn
,,,
ssss,llll
// ASSGN   SYS003,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS004,'
user.dbl004
',,SD // EXTENT  SYS004,
nnnnnn
,,,
ssss,llll
// ASSGN   SYS004,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS005,'
user.dbl005
',,SD // EXTENT  SYS005,
nnnnnn
,,,
ssss,llll
// ASSGN   SYS005,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS006,'
user.dbl006
',,SD // EXTENT  SYS006,
nnnnnn
,,,
ssss,llll
// ASSGN   SYS006,DISK,VOL=
vvvvvv
,SHR
user.olddb
File-ID of the existing database file
user.reldctl
Data set name of the reload control file containing control and set information. Block size of the RELDCTL file should be a multiple of 60 with a maximum size of 32,760. Block size is controlled through the BLKSIZE SYSIDMS parameter. For a complete description of SYSIDMS parameters, see the
CA IDMS Common Facilities Section
.
user.dbl003
File-ID of the intermediate work file containing index descriptors from IDMSTABX.
user.dbl004
File-ID of the intermediate work file containing the output from SORT3.
user.dbl005
File-ID of the intermediate work file containing pointers for user-owned index sets from IDMSDBL3.
user.dbl006
File-ID of the intermediate work file containing sorted pointers for user-owned index sets from SORT4.
 
PRINT INDEX
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional file assignments, as required
userdb
Filename of the user file
user.userdb
File-ID of the user file
 
PRINT JOURNAL
File assignments for the batch command facility (z/VSE)
// DLBL    SYS001,'
idms.archjrnl
',,SD // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
SYS001
Filename of the archive journal file
idms.archjrnl
File-ID of the archive journal file
 
PRINT LOG
File assignments for the batch command facility (z/VSE)
To print from the DDLDCLOG area:
// DLBL    
dclog
,'
idms.system.ddldclog
',,DA // EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
To print from the archive log file:
// TLBL    SYS001,'
idms.archive
',,
nnnnnn
,,f // ASSGN   SYS001,
x'cuu
'
idms.archive
File-ID of the archive log file
 
PRINT PAGE
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb1
,'
user.userdb1
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    
userdb2
,'
user.userdb2
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional file assignments, as required
userdb1
Filename of the user file
user.userdb1
File-ID of the user file
Central version
To execute PRINT PAGE under the central version:
  • Remove the TLBL and ASSGN statements for the tape journal file from the previous JCL.
  • Insert the following statement:
    // DLBL SYSCTL,
    file-id
    ,0,SD // EXTENT 
    SYSnnn,vvvvvv
    ,1,0,1,1 // ASSGN 
    SYSnnn
    ,DISK,VOL=
    vvvvvv
    ,SHR
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
PRINT SPACE
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb1
,'
user.userdb1
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    
userdb2
,'
user.userdb2
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional file assignments, as required
userdb1
Filename of the user file
user.userdb1
File-ID of the user file
Central version
To execute PRINT SPACE FOR AREA or PRINT SPACE FOR SEGMENT under the central version:
  • Remove the TLBL and ASSGN statements for the tape journal file from the previous JCL.
  • Insert the following statement:
    // DLBL SYSCTL,
    file-id
    ,0,SD // EXTENT 
    SYSnnn,vvvvvv
    ,1,0,1,1 // ASSGN 
    SYSnnn
    ,DISK,VOL=
    vvvvvv
    ,SHR
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
PRINT TRACE
The CA IDMS installation media contains the following sample JCL (intended for demonstration purposes only):
  • PTRCJCL - Contains a skeleton of the JCL required to run the PRINT TRACE utility.
PUNCH
Local mode
File assignments for the batch command facility (z/VSE)
// DLBL    
usercat
,'
user.ddlcat
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    
usercatl
,'
user.ddlcatl
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    
usercatx
,'
user.ddlcatx
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // TLBL    SYS
nnn
,'
idms.sysjrnl
',,
nnnnnn
,,f // ASSGN   SYS
nnn
,
x'cuu'
Additional dummied journals, as required
user.ddlcat
File-ID of the dictionary file containing the DDLCAT area of the dictionary
user.ddlcatl
File-ID of the dictionary file containing the DDLCATLOD area of the dictionary
user.ddlcatx
File-ID of the dictionary file containing the DDLCATX area of the dictionary
idms.sysjrnl
File-ID of the user file
Central version
To execute INSTALL STAMPS under the central version, remove the USERCAT, USERCATL, USERCATX, and SYSJRNL statements.
RELOAD
File assignments for the batch command facility (z/VSE)
// DLBL   SORTWK1,'
sort.work.file
' // EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional sort files, as required
// DLBL   
userdb,'.user.userdb
',,DA // EXTENT SYS
nnn,nnnnnn
// ASSGN  SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional existing database file assignments, as required
// DLBL   RELDCTL.'
user.reldctl
',,SD // EXTENT SYS
nnn
,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS001,'
sort.unload
',,SD // EXTENT SYS001,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS001,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS002,'
user.dbl002
',,SD // EXTENT SYS002,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS002,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS003,'
user.dbl003
',,SD // EXTENT SYS003,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS003,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS004,'
user.dbl004
',,SD // EXTENT SYS004,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS004,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS005,'
user.dbl005
',,SD // EXTENT SYS005,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS005,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS006,'
user.dbl006
',,SD // EXTENT SYS006,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS006,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS007,'
user.dbl007
',,SD // EXTENT SYS007,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS007,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS008,'
user.dbl00
8',,SD // EXTENT SYS008,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS008,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS009,'
user.dbl009
',,SD // EXTENT SYS009,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS009,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS010,'
user.dbl010
',,SD // EXTENT SYS010,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS010,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS011,'
user.dbl011
',,SD // EXTENT SYS011,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS011,DISK,VOL=
vvvvvv
,SHR
sort.unload
File-ID of the sort parameters created by UNLOAD
user.reldctl
Data set name of the reload control file containing control and set information. Blocksize of the RELDCTL file should be a multiple of 60 with a maximum size of 32,760. Blocksize is controlled through the BLKSIZE SYSIDMS parameter. For a complete description of SYSIDMS parameters, see the
CA IDMS Common Facilities Section
.
user.dbl002
File-ID of the file generated by UNLOAD as SYS001.
user.dbl003
File-ID of the file generated by UNLOAD as SYS003.
user.dbl004
File-ID of the intermediate work file containing the output from SORT1.
user.dbl005
File-ID of the intermediate work file containing member descriptors for chained sets from IDMSDBL2.
user.dbl006
File-ID of the intermediate work file containing member descriptors for user-owned index sets from IDMSDBL2.
user.dbl007
File-ID of the intermediate work file containing the output of SORT2.
user.dbl008
File-ID of the intermediate work file containing the reformatted index information from IDMSDBLX.
user.dbl009
File-ID of the intermediate work file containing the sorted index set descriptors from SORT3.
user.dbl010
File-ID of the intermediate work file containing prefix pointer information from IDMSDBL3.
user.dbl011
File-ID of the intermediate work file containing sorted prefix pointer information from SORT4.
userdb
Filename of the database file.
user.userdb
File-ID of the database file.
 
REORG
DD statements for the batch command facility (z/VSE)
Defining the REORG control file, all jobs and job steps
// DLBL RORGCTL,
'user.rorgctl'
,,SD // EXTENT SYS
nnn
,
vvvvvv
,,,
sssss
,
llll
// ASSGN SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Defining the REORG JCL file, required when submitting jobs
// DLBL RORGJCL,
'user.jclfile'
,,SD // EXTENT SYS
nnn
,
vvvvvv
,,,
sssss
,
llll
// ASSGN SYSnnn,DISK,VOL=
vvvvvv
,SHR
Manual definition of work files, when not using DSMODELs
// DLBL 
wxnnnnn
,
'user.workfile'
,,SD 
llll
// EXTENT SYS
nnn
,
vvvvvv
,,,
sssss
, // ASSGN SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional work file definitions, as required
DB File definitions when running the unload phase, if not using dynamic allocation
// DLBL 
unlddb
,
'user.unlddb'
,,DA // EXTENT SYS
nnn
,
vvvvvv
// ASSGN SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional unload database file definitions, as required
DB File definitions when running the reload phase, if not using dynamic allocation
// DLBL 
relddb
,
'user.relddb'
,,DA // EXTENT SYS
nnn
,
vvvvvv
// ASSGN SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional reload database file definitions, as required
SORT work file assignments when running the reload phase
// DLBL SORTWK1,
'sort.work.file'
// EXTENT SYS
nnn
,
vvvvvv
,,,
sssss
,
llll
// ASSGN SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional sort work file definitions, as required
  • user.reldctl
    File-ID of the REORG control file containing control information. The block size is 8192 bytes, and must be specified in SYSIDMS using the FILENAME=RORGCTL RECFM=F BLKSIZE=8192 parameters.
    For more information about SYSIDMS parameters, see the
    CA IDMS Common Facilities Section.
  • user.jclfile
    File-ID of the file containing JCL for automatic job submission. The block size must be a multiple of 80 bytes, and must be specified in SYSIDMS using the FILENAME=RORGJCL RECFM=F BLKSIZE= parameters.
  • wxnnnnn
    File name of the DLBL for a work file. It must match the name generated in the Unload/Reload Work File Summary report.
  • user.workfile
    File-ID of a work file when sectionly allocating work files.
  • unlddb
    File name of the DLBL for an unload database file.
  • user.unlddb
    File-ID of the unload database file, this is source database file.
  • relddb
    File name of the DLBL for a reload database file.
  • user.relddb
    File-ID of the reload database file, this is the target database file.
RESTORE
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb1
,'
user.userdb1
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    
userdb2
,'
user.userdb2
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // TLBL    SYS001,'
user.bkpfile
' // ASSGN   SYS001,x'cuu'
Additional file assignments, as required
userdb1
Filename of the user file
user.userdb1
File-ID of the user file
user.bkpfile
File-ID of the backup file
 
RESTRUCTURE
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb1
,'
user.userdb1
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    
userdb2
,'
user.userdb2
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS001,'
user.spill
',,DA // EXTENT  SYS001,
nnnnnn
// ASSGN   SYS001,DISK,VOL=
vvvvvv
,SHR
Additional file assignments, as required
userdb1
Filename of the user file
user.userdb1
File-ID of the user file
user.spill
File-ID of the spill file; for sizing information see RESTRUCTURE CONNECT.
 
RESTRUCTURE CONNECT
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS001,'
user.spill
',,DA // EXTENT  SYS001,
nnnnnn
// ASSGN   SYS001,DISK,VOL=
vvvvvv
,SHR // DLBL    SORTWK1,'
sort.work.file
' // EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional sort files, as required
user.userdb
File-ID of the user database file
user.spill
File-ID of the spill file; for sizing information see RESTRUCTURE CONNECT  .
 
ROLLBACK
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional database file assignments, as required
// TLBL    SYS001,'
archive
' // ASSGN   SYS001,x'cuu'
If using the SORT option, add sort files
userdb
Filename of the user file
archive
File-ID of the complete archive or tape journal file
 
ROLLFORWARD
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Add database file assignments, as required
If recovering from a standard journal file
// TLBL    SYS
nnn
,'
archive
' // ASSGN   SYS
nnn
,X'cuu'
If recovering from a journal extract file
// DLBL    
extract
,'
jrnl.extract
',,SD // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
If using the SORT option or processing a journal extract file, add sort files
as required
userdb
Filename of the user file.
archive
File-ID of the complete archive or tape journal file.
extract
File name of the extract journal file. If you do not specify, it defaults to SYS002.
jrnl.extract
File-ID of the extract journal file.
 
SYNCHRONIZE STAMPS
Local mode
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'user.userdb',,
tt
// EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
rrrr
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    
userdict
,'user.userdict',,
tt
// EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
userdb
Filename of the user file
user.userdb
File-ID of the user file
user.userdict
File-ID of the dictionary containing the table definitions
Central version
To execute SYNCHRONIZE STAMPS under the central version:
  • Remove the TLBL and ASSGN statements for the tape journal file from the previous JCL.
  • Insert the following statement:
    // DLBL SYSCTL,
    file-id
    ,0,SD // EXTENT 
    SYSnnn,vvvvvv
    ,1,0,1,1 // ASSGN 
    SYSnnn
    ,DISK,VOL=
    vvvvvv
    ,SHR
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
TUNE INDEX
File assignments for the batch command facility (z/VSE)
//DLBL      userdb,'user.userdb',,DA //EXTENT    SYSnnn,nnnnnn //ASSIGN    SYSnnn,DISK,VOL=vvvvvv,SHR
userdb
Filename of the user file
user.userdb
File-ID of the user file
Central version
To execute TUNE INDEX under the central version:
  • Remove the TLBL and ASSGN statements for the tape journal file from the previous JCL.
  • Insert the following statement:
    // DLBL SYSCTL,file-id,0,SD // EXTENT SYSnnn,vvvvvv,1,0,1,1 // ASSGN SYSnnn,DISK,VOL=vvvvvv,SHR
 
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
UNLOCK
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
user.userdb
File-ID of the user database file
 
UNLOAD
File assignments for the batch command facility (z/VSE)
// DLBL   SORTWK1,'
sort.work.file
' // EXTENT  SYS
nnn
,
nnnnnn
,,,
ssss
,
llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
Additional sort files, as required
// DLBL   RELDCTL.'
user.reldctl
',,SD // EXTENT SYS
nnn
,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS002,'
user.dbl002
',,SD // EXTENT SYS002,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS002,DISK,VOL=
vvvvvv
,SHR // DLBL   SYS003,'
user.dbl003
',,SD // EXTENT SYS003,
nnnnnn
,,,
ssss,llll
// ASSGN  SYS003,DISK,VOL=
vvvvvv
,SHR // DLBL   IJSYSPCH,'
sort.unload
' // EXTENT SYSPCH,
nnnnnn
,,,
ssss,llll
   ASSGN  SYSPCH,DISK,VOL=
vvvvvv
,SHR
user.reldctl
File-ID of the reload control file containing control and set information. Blocksize of the RELDCTL file should be a multiple of 60 with a maximum size of 32,760. Blocksize is controlled through the BLKSIZE SYSIDMS parameter. For a complete description of SYSIDMS parameters, see the
CA IDMS Common Facilities Section
.
user.dbl002
File-ID of the SYS002 output file.
user.dbl003
File-ID of the SYS003 output file.
sort.unload
File-ID of the file containing sort parameters created by UNLOAD.
 
UPDATE STATISTICS
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // TLBL    SYS
nnn
,'
idms.tapejrnl
',,
nnnnnn
,,f // ASSGN   SYS
nnn
,
x'cuu'
userdb
Filename of the user file
Central version
To execute UPDATE STATISTICS under the central version:
  • Remove the TLBL and ASSGN statements for the tape journal file from the previous JCL.
  • Insert the following statement:
    // DLBL SYSCTL,
    file-id
    ,0,SD // EXTENT 
    SYSnnn,vvvvvv
    ,1,0,1,1 // ASSGN 
    SYSnnn
    ,DISK,VOL=
    vvvvvv
    ,SHR
file-id
Data set name of the sysctl file
SYSnnn
Logical unit of the volume for which the extent is effective
vvvvvv
Volume serial number
 
VALIDATE
File assignments for the batch command facility (z/VSE)
// DLBL    
userdb
,'
user.userdb
',,DA // EXTENT  SYS
nnn
,
nnnnnn
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS002,'
user.valin
',,DA // EXTENT  SYS002,
nnnnnn
// ASSGN   SYS002,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS003,'
user.valout
',,DA // EXTENT  SYS003,
nnnnnn
// ASSGN   SYS003,DISK,VOL=
vvvvvv
,SHR // DLBL    SYS
nnn,'sort.load
',,SD // EXTENT  SYS
nnn,nnnnnn
,,,
ssss,llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
If performing a complete VALIDATE, add sort files as necessary
// DLBL    SYS
nnn,'sort.work
',,SD // EXTENT  SYS
nnn,nnnnnn
,,,
ssss,llll
// ASSGN   SYS
nnn
,DISK,VOL=
vvvvvv
,SHR
user.userdb
File-ID of the database file
user.valin
File-ID of the input SYS002 file; for sizing information see VALIDATE.
user.valout
File-ID of the SYS003 output file; for sizing information see VALIDATE.
sort.load
File-ID of the SYSPCH file
When running a complete VALIDATE, SYS002 and SYS003 must point to the
same
intermediate file. When running a stepped VALIDATE, SYS002 and SYS003 must point to a
different
intermediate file.