Previous Topic: z/VSE File AssignmentsNext Topic: Sample z/VM EXEC--USJEXEC


Execution JCL (z/VSE)

// OPTION PARTDUMP,LOG
*     **** CREATE A SYSIDMS PARAMETER FILE  *****
// UPSI  1
// DLBL     anyname,'work.file.sysidms',0,SD
// EXTENT   SYS041,sysidms-extent
// ASSGN    SYS041,DISK,VOL=volser,SHR
// EXEC     DITTO
$$DITTO CSQ FILEOUT=anyname
  ECHO=ON
  JOURNAL=OFF
  LOCAL=ON-OR-OFF
  TESTDBN=ON-OR-OFF
  DMCL=dmclname
  DBN=dbname
/*
/*     CARD AND PRINT FILES
// ASSGN  SYS016,SYSIPT                         PARAMETER FILE
// ASSGN  SYS017,SYSLST                         AUDIT REPORT
// ASSGN  SYS018,printer                        JOURNAL REPORTS
// ASSGN  SYS019,printer                        JOURNAL DISPLAYS
/*
/*     IDMS FILES
// UPSI   upsi-byte
// ASSGN  SYS005,disk
// DLBL   DICTDB,'idms-dictionary',,DA
// EXTENT SYS005,dictionary-extent
// ASSGN  SYS009,ign
/*     SORTWORK FILES FOLLOW
// ASSGN  SYS001,DISK,VOL=volser,SHR
// DLBL   SORTWK1,'sort.work.1',0,SD
// EXTENT SYS001,sort-extent
// ASSGN  SYS002,DISK,VOL=volser,SHR
// DLBL   SORTWK2,'sort.work.2',0,SD
// EXTENT SYS002,sort-extent
// ASSGN  SYS003,DISK,VOL=volser,SHR
// DLBL   SORTWK3,'sort.work.3',0,SD
// EXTENT SYS003,sort-extent
// ASSGN  SYS004,DISK,VOL=volser,SHR
// DLBL   SORTWK4,'sort.work.4',0,SD
// EXTENT SYS004,sort-extent /*
/*     Journal Analyzer WORK FILES
// ASSGN  SYS012,DISK,VOL=volser,SHR
// DLBL   EXTRACT,'jnla.extract',0,SD           EXTRACT FILE - OUTPUT
// EXTENT SYS012,extract-extent
// DLBL   EXTRAC1,'jnla.extract',0,SD           EXTRACT FILE - INPUT
// EXTENT SYS012
// ASSGN  SYS013,DISK,VOL=volser,SHR
// DLBL   DISPLAY,'jnla.display',0,SD           DISPLAY FILE - OUTPUT
// EXTENT SYS013,display-extent
// DLBL   DISPLA1,'jnla.display',0,SD           DISPLAY FILE - INPUT
// EXTENT SYS013
// ASSGN  SYS014,DISK,VOL=volser,SHR
// DLBL   RANKING,'jnla.ranking',0,SD           RANKING FILE - OUTPUT
// EXTENT SYS014,ranking-extent
// DLBL   RANKIN1,'jnla.ranking',0,SD           RANKING FILE - INPUT
// EXTENT SYS014
/*
/*     ARCHIVE JOURNAL FILE
// ASSGN  SYS011,tape
// TLBL   ARCHIVE,'archive.journal',,volser     ARCHIVE JOURNAL FILE
/*
/*     PRIVATE CORE IMAGE LIBRARY(S)
// DLBL   CILIB1,'your-journal-corelib'         Journal Analyzer LIBRARY
// EXTENT ,VOL=volser
// DLBL   CILIB2,'your-idms-corelib'            IDMS LIBRARY
// EXTENT ,VOL=volser
// LIBDEF CL,SEARCH=(CILIB1,CILIB2),TEMP
/*
// DLBL SYSIDMS,'work.file.sysidms',0,D
// EXTENT SYS041,volser
// ASSGN SYS041,DISK,VOL=volser,SHR
/*
// EXEC USJMAIN,SIZE=(USJMAIN,#k)
*
 your-journal-analyzer-control-statements
*
/*
printer

An appropriate unit address/device class for printing reports and displays. This should be different than SYSLST.

anyname

Any suitable name for your SYSIDMS file. The name chosen must be identical to the fileout value in the DITTO copy step.

sysidms-extent

Specify extent information for the SYSIDMS file. One track is adequate.

upsi-byte

The UPSI byte settings appropriate to the IDMSOPTI module that you have linked with CA IDMS Journal Analyzer, and appropriate to whether you will be accessing CA IDMS in local mode or central version.

ASSGN SYS005,disk

Specify the proper ASSGN information for logical unit SYS005, your CA IDMS dictionary, if running in local mode. Omit this statement if running through central version.

idms-dictionary

Required for local mode processing. Specify the filename and file ID of your local CA IDMS dictionary's DDLDML area. Omit this statement if running through central version.

dictionary-extent

Specify the proper extent information for logical unit SYS005, your IDMS dictionary, if running in local mode. Omit this statement if running through central version.

ASSGN SYS009,ign

Specify an ASSGN for logical unit SYS009, your CA IDMS local journal file, if running in local mode. Since CA IDMS Journal Analyzer accesses your CA IDMS dictionary in retrieval mode only, it is necessary to journal that activity. Omit this statement if running through central version.

sort.work.1/sort.work.4

Specify the file ID of your sortwork files. Note that CA IDMS Journal Analyzer should be run with sort options that specify printing of critical messages, not abending if there is an unsuccessful sort and sorting into EBCDIC sequence.

volser

The volume serial number of the disk or tape to be used for the file.

jnla.extract

Specify the file ID of the extract file. This statement may specify 'IGN' if PROCESS=DISPLAY. The retention period for the extract file depends on your use of PROCESS options. Specify a retention period that will allow you to fully generate desired reports from the extract file. If you never intend to specify PROCESS=REPORTS, your retention period may define this as a temporary file. If you specify PROCESS=REPORTS, this file must already exist.

extract-extent

Specify extent information adequate to hold all of the records extracted from the archive journal file. If PROCESS=ALL, or PROCESS=EXTRACTS, is specified, CA IDMS Journal Analyzer extracts archive records for each report type that is not suppressed. All reports use the BGIN, AREA, COMT, ABRT, and ENDJ records present for each run-unit. DBAREA and DBRECD reports also use the BFOR and AFTR records present for each run-unit. The amount of space will depend on the number of run-units on the archive file, the number of areas readied, and the number of COMMITs issued by those run-units (and if DBAREA and DBRECD reports are not suppressed, the number of database records processed by each run-unit).

jnla.display

Specify the file ID of the display file. This statement may specify 'IGN' if you do not request journal displays. The display file is created each time you request journal displays, so the retention period may define this as a temporary file.

display-extent

Specify extent information adequate to hold all of the records selected from the archive journal file. If journal displays are requested, CA IDMS Journal Analyzer writes a record to the display file for each BFOR/AFTR record that meets selection criteria for DISPLAY=DBKEY or for DISPLAY=RECORD and for each BFOR/AFTR record for every run-unit that needs selection criteria for DISPLAY=PROGRAM. Each ABRT record will also be written for each display requested. The amount of space will depend on the number and size of these BFOR/AFTR/ABRT records.

jnla.ranking

Specify the file ID of the ranking file. This statement may specify 'IGN' if you do not request rank reports. The ranking file is created each time you request rank reports, so the retention period may define this as a temporary file.

ranking-extent

Specify extent information adequate to hold all of the records selected from the extract file if REPORT=RANK was specified. CA IDMS Journal Analyzer writes a record to the ranking file for every run-unit that meets the selection criteria for each REPORT=RANK request. The amount of space will depend on the number of requests for rank reports and the number of run-units that satisfy the selection criteria. Since the ranking file is created each time you request REPORT=RANK, the retention period may define this as a temporary file.

archive.journal

Specify the file ID of your archive journal file. This file should come from ARCHIVE JOURNAL utility, or from a batch job that ran in local mode. Do not use the output from IDMSJFIX. This statement may specify 'IGN' if PROCESS=REPORTS.

tape

Specify an appropriate unit address for your archive journal file. This must be a tape device.

your-journal-corelib—Specify the file ID of the core image library containing your IDMSINTB module.

#k

The amount of your partition to reserve for program storage. The remainder of the partition is used for GETVIS. #k designates additional program storage to be made available for CA IDMS Journal Analyzer programs (about 800K) and for your sort.

The total partition requirements will be between 1300K and 2100K.

LOCAL ON/OFF — Specify LOCAL=ON if you want journal displays processing to access the CA IDMS dictionary in local mode. Specify LOCAL=OFF for CV mode.

dmclname

Specify the name of the DMCL that should be used when accessing the dictionary for information about records represented by the BFOR and AFTR images of the CA IDMS archive journal being processed.

dbname

Specify the DBNAME needed to access the appropriate DDLDML area of the dictionary for the DMCLNAME used.

your.idms.dictionary

Required for local mode when the correct data set name is not supplied in the DMCL. Specify the correct DDNAME and data set name for the DDLDML area of your CA IDMS dictionary.

your-journal-analyzer-control-statements

Specify a PROCESS statement and other statements as desired.