OMEGAMON for Db2 PE VSAM Data Sets

This section explains the VSAM Data Sets of OMEGAMON for Db2® PE.

OMEGAMON for Db2 PE uses the following VSAM data sets:
  • A VSAM-Save data set is written when the job stream contains a SAVE subcommand without the CONVERT option.
  • A physical sequential data set is written when the job stream contains a SAVE subcommand with a CONVERT option.
  • Job summary data sets are written when new data is processed.

All VSAM data sets used in an OMEGAMON for Db2 PE job must exist before OMEGAMON for Db2 PE is executed. Preallocate the data sets using the IDCAMS command. You can run IDCAMS as an initial step in the OMEGAMON for Db2 PE job. The required attributes for VSAM data sets are shown in Table 1. An example of the required IDCAMS commands is shown in IDCAMS Commands.

For more information about IDCAMS, see z/OS® DFSMS.
Note:
  1. When the SAVE subcommand is specified, the save data set should be empty. If it is not empty, all existing records are deleted. If save and restore use the same physical data set, the restored data is rewritten during save.
  2. You need not prime OMEGAMON for Db2 PE VSAM data sets.
Table 1. Attributes for OMEGAMON for Db2 PE VSAM Data Sets
Data Set Key Length (bytes) Maximum Record Length (bytes) Average Record Length (bytes) Buffer Space (bytes) Data Control Interval Size (bytes) Index Control Interval Size (bytes)
Accounting SAVE (ACSAVDD) 255 6900 4000 40 960 8192 4096
Statistics SAVE (STSAVDD) 92 8192 2400 40 960 8192 4096
Job Summary (JSSRSDD) 52 2462 160 40 960 8192 4096
Note: Buffer space and control interval size are suggestions only. You can modify them to suit the requirements of your installation.

IDCAMS Commands

In this example, the job deletes the cluster if it already exists, then defines a new cluster with the specified attributes.

 //ALCVSAM  EXEC PGM=IDCAMS
 //SYSPRINT DD SYSOUT=*
 //SYSIN    DD *
   DELETE (cluster.name)
   DEFINE -
     CLUSTER ( -
       NAME (cluster.name) -
       TRACKS (as required) -
       VOLUMES (as required) -
       KEYS (keylength 0) -
       RECORDSIZE (average maximum) -
       BUFFERSPACE (40960) -
       REUSE -
       ) -
    DATA ( -
       CONTROLINTERVALSIZE (8192) -
       ) -
    INDEX ( -
       CONTROLINTERVALSIZE (4096) -
       )
 /*