Customizing OMEGAMON for CICS (3270) to display your screen space at initialization

You can customize the dedicated mode OMEGAMON for CICS (3270) initialization.

The first screen space can be used to perform various functions of your choice prior to displaying the Main Menu.

There are several reasons for customizing OMEGAMON for CICS (3270) to display your screen space. The most common reasons are:

You want to use the OMEGAMON for CICS (3270) product-provided screen spaces, but want to issue some commands first
You do not want to use OMEGAMON for CICS (3270) product-provided screen spaces; you want to run your own customized screen space or spaces.

The OMEGAMON for CICS (3270) first screen space member, KOCIDED, in the rhilev.RKANSAMU library, is a series of commands that are used to start the OMEGAMON® Main Menu:

Figure 1. Starting a dedicated OMEGAMON AI for CICS session

*                                                                           
*     START A DEDICATED OMEGAMON II FOR CICS SESSION.                       
*                                                                           
*     KEYWORD       DESCRIPTION                                             
*    -----------------------------------------------------------------      
*     MODE=CN1      MUST BE CN1 FOR DEDICATED                               
*     CICS=XXXXXXXX JOBNAME OF THE CICS TO BE MONITORED.                    
*  *  COLS=N        NUMBER OF COLUMNS.                                      
*  *  LROWS=N       NUMBER OF LOGICAL LROWS.                                
*  *  PFKS=N        NUMBER OF INCORE PFKS.                                  
*  *  ROWS=N        NUMBER OF PHYSICAL ROWS.                                
*     UNIT=XXX      327X UNIT ADDRESS.                                      
*  *  USER=XX       USER PROFILE SUFFIX.                                    
*  *  FSCR=XXXXXXXX FIRST SCREEN OMEGAMON DISPLAYS.                         
*                                                                           
*  *  OPTIONAL KEYWORDS; THE REST ARE REQUIRED.                             
*                                                                           
 START KOCCICS CICS=CICSPROD,                                          X    
              MODE=CN1,                                                X    
              UNIT=,                                                   X    
              COLS=80,                                                 X    
              ROWS=24,                                                 X    
              LROWS=99

The FSCR= xxxxxxxx parameter specifies which screen space should be displayed first. You can create the MYSCR screen space example using the following instructions, then update the KOCIDED member:

Figure 2. Using the FSCR=xxxxxxxx parameter

*                                                                           
*     START A DEDICATED OMEGAMON FOR CICS SESSION.                       
*                                                                           
*     KEYWORD       DESCRIPTION                                             
*    -----------------------------------------------------------------      
*     MODE=CN1      MUST BE CN1 FOR DEDICATED                               
*     CICS=XXXXXXXX JOBNAME OF THE CICS TO BE MONITORED.                    
*  *  COLS=N        NUMBER OF COLUMNS.                                      
*  *  LROWS=N       NUMBER OF LOGICAL LROWS.                                
*  *  PFKS=N        NUMBER OF INCORE PFKS.                                  
*  *  ROWS=N        NUMBER OF PHYSICAL ROWS.                                
*     UNIT=XXX      327X UNIT ADDRESS.                                      
*  *  USER=XX       USER PROFILE SUFFIX.                                    
*  *  FSCR=XXXXXXXX FIRST SCREEN OMEGAMON DISPLAYS.
*                                                                           
*  *  OPTIONAL KEYWORDS; THE REST ARE REQUIRED.                             
*                                                                           
 START KOCCICS CICS=CICSPROD,                                          X    
              MODE=CN1,                                                X    
              UNIT=,                                                   X    
              COLS=80,                                                 X    
              FSCR=MYSCR,        X    
              ROWS=24,                                                 X    
              LROWS=99

If for example, you want to see the result of a storage display, use the following XMLS statement:

<XMLS   $,CSA,100

To create the MYSCR screen space with the preceding XMLS command, follow these steps at a OMEGAMON for CICS (3270) session:

Clear your screen. See Clearing the screen in Screen control.
Type /DEFON on the top line of the screen and press Enter. This puts your system in definition mode, which inhibits automatic updating of a dedicated mode session so you can define a screen space.
Enter the commands that you want to run on your screen space. For example:
```
  <XMLS   $,CSA,100
  .FGO ZMENUI
```
Type /SAVE MYSCR on the top line of the screen space and press Enter.

The MYSCR screen space name that you designated as an example is saved in the rhilev.RKOCPROC library. When you start OMEGAMON for CICS (3270) in dedicated mode, the output from the XMLS command is displayed.

The .FGO command is required to run the original or default unaltered first screen sequence when you want to use the default OMEGAMON for CICS (3270).

IMPORTANT: If the command that you want to run is a security protected command, then the AUTHLIB=statement in the RKANPARU(KOMSUPDI) member needs to be commented out and pointed to the authorized screen space library. This option allows you to run protected commands as part of the initialization screen without entering a password. Verify that the authorized screen space library is concatenated into your rhilev.PROC DD statement. The authorized screen space library is not an APF-authorized data set, rather it is an AUTHLIB data set.