Implementing the OLTHCICS program


You must use the DFHPLT macro to create a new entry in the PLT to implement the OLTHCICS program.

Insert the new entry after the entry for OLTFSET and before any entries for processing that should not start before the BMC agents are initialized.

The following 2 figures show examples of the PLT macro placement where one uses the standard DFHPLT macro and the other uses the CMRPLT macro.

Example 1: PLT macro placement with DFHPLT macro

DFHPLT TYPE=INITIAL,SUFFIX=BB                
DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM           
DFHPLT TYPE=ENTRY,PROGRAM=OLTFSET            
DFHPLT TYPE=ENTRY,PROGRAM=OLTHCICS           
DFHPLT TYPE=FINAL                            
END

Example 2: PLT macro placement with CMRPLT macro

DFHPLT TYPE=INITIAL,SUFFIX=BB                 
DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM            
CMRPLT MODE=AUTO                              
DFHPLT TYPE=ENTRY,PROGRAM=OLTHCICS            
DFHPLT TYPE=FINAL                             
END

If your site is running with program autoinstall active (PGAIPGM=ACTIVE SIT), you do not have to create and install a program definition. Otherwise, you should add a CSD entry for the OLTHCICS program to your BMC installed group, using the following set of attributes:

DEFINE PROGRAM(OLTHCICS)   GROUP(BMCMVOLT)    EXECKEY(CICS)    
       LANGUAGE(ASSEMBLER) RELOAD(NO)         RESIDENT(NO)     
       USAGE(NORMAL)       USELPACOPY(NO)     DATALOCATION(ANY)
       STATUS(ENABLED)     CEDF(NO)                            
       DESCRIPTION(BMC CICS PLT DELAY PROGRAM)

You can control how long the OLTHCICS program waits for communications to be established (before returning control to CICS and allowing PLT processing to continue) with the INITPARM parameter in the SIT. By default, OLTHCICS will wait up to 60 seconds for the communications link to be established; you can change the default to any value from 10 to 150 seconds.

The following figure shows an example of the INITPARM parameter specification that modifies the wait time to 30 seconds.

Modify the wait time with the INITPARM parameter

...
INITPARM=(OLTHCICS='30')
...

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*