The OMEGAMON for Db2 PE command stream

A JCL command stream consists of DD statements that determine the data sets used with reports and traces, and the commands, subcommands and subcommand options that determine the type of report or trace to be produced.

Usage

You can create OMEGAMON for Db2 PE reports and traces as follows:
  • Interactively, by choosing the Create and execute reporting commands option from the main menu. This invokes the Interactive Report Facility (IRF), which lets you interactively specify the type of report and further options and then composes and submits a corresponding batch report command stream. The IRF is described in the Reporting User's Guide.
  • Manually, by using the ISPF editor and creating JCL command streams to generate reports and traces. This method is described herein, together with the OMEGAMON for Db2 PE commands, subcommands, options and keywords that can be used in commands streams.

Usage notes

  • Most of the DD statements with a SYSOUT destination do not have to be specified because they are dynamically allocated by OMEGAMON for Db2 PE. See the individual DD statement descriptions for more information.
  • The final EXEC statement is required. If you do not include the EXEC statement in your JCL, no report is produced. All statements following the EXEC statement are ignored.
  • The syntax of your JCL is checked and written to the DPMLOG data set together with any information, warning, or error messages raised.

Example

Figure 1 shows a sample of the JCL required to produce OMEGAMON for Db2 PE reports and traces. In this sample, several place holders (in lower case, italic characters) are used. The place holders command, subcommand and option determine the type of report or trace to be produced. The actual OMEGAMON for Db2 PE commands are described in the relevant sections of this information. Other place holders (cc and x) are described in context in DD statements.
Figure 1. Sample JCL
 //        PEMAIN EXEC PGM=FPECMAIN
 //*  FOLLOWING ARE SYSTEM DDNAMES
 //STEPLIB  DD  DSN=FPE.FPELIB.RKANMOD,DISP=SHR
 //DPMPARMS DD  DSN=FPE.FPELIB.DPMPARMS,DISP=SHR
 //INPUTDD  DD  DSN=FPE.FPELIB.DPMIN,DISP=SHR
 //DPMLOG   DD  SYSOUT=*
 //SYSOUT   DD  SYSOUT=*
 //JOBSUMDD DD  SYSOUT=*
 //EXCPTDD  DD  DSN=FPE.EXCEPT.THRESH,DISP=OLD
 //EXTRCDD1 DD  SYSOUT=*
 //EXFILDD1 DD  DSN=FPE.EXCEPT.LOGFILE,DISP=OLD
 //SYSPRMDD DD  SYSOUT=*
 //DPMOUTDD DD  DSN=FPE.FPELIB.DPMOUT.DATA,DISP=OLD
 //JSSRSDD  DD  DSN=FPE.FPELIB.JSSRS.DATA,DISP=OLD
 //SYSUDUMP DD  DUMMY
 //* FOLLOWING ARE REPORT SET DDNAMES
 //ccWORK   DD  DSN=FPE.FPELIB.op.WORKDD,DISP=OLD
 //ccRPTDD  DD  SYSOUT=*
 //ccTRCDD1 DD  SYSOUT=*
 //ccSAVDD  DD  DSN=FPE.FPELIB.opSAV.DATA,DISP=OLD
 //ccRSTDD  DD  DSN=FPE.FPELIB.opRST.DATA,DISP=SHR
 //ccFILDDx DD  DSN=FPE.FPELIB.op.FILE,DISP=OLD
 //* FOLLOWING IS THE COMMAND STREAM
 //SYSIN   DD  *
command
   subcommand
      option
      option
   subcommand
      option
command
   subcommand
      option
      option
   subcommand
      option
EXEC