Configuring the autostart procedure for the Link3270 facility state cleanup programs

The CICS Service Flow Runtime Link3270 facility state cleanup has two programs: DFHMALSC and DFHMALFC.

About this task

DFHMALSC cleans up temporary storage queues (TSQs) for simple, nonpersistent Link3270 service flows.

DFHMALFC cleans up the VSAM file DFHMAL2F for the following types of Link3270 service flows:

  • Persistent and nonpersistent complex service flows
  • Persistent simple service flows

To start the cleanup programs in the final stages of CICS® initialization, use the program list table (PLT):

Procedure

  1. Define and assemble a PLT, specifying which program you want to execute at CICS startup. You can specify both if required. For example:
    DFHPLTPI TITLE 'DFHPLTPI - PROGRAM LIST TABLE STARTUP '                 
                	DFHPLT TYPE=INITIAL,SUFFIX=D1         
    *                                                                       
    	*------------------------------------------------------------------------------------------------* 
    	*  PHASE 2 PROGRAMS FOLLOW                                                                       * 
    	*------------------------------------------------------------------------------------------------* 
             		DFHPLT TYPE=ENTRY,                                                              x
                   		PROGRAM=DFHDELIM                                                           
    	*                                                                                              
    	*------------------------------------------------------------------------------------------------* 
    	*  PHASE 3 PROGRAMS FOLLOW DFHDELIM                                                              * 
    	*------------------------------------------------------------------------------------------------* 	
    	*------------------------------------------------------------------------------------------------* 
    	*  CICS SFR LINK3270 FACILITY STATE CLEANUP PROGRAM                                              * 
    	*------------------------------------------------------------------------------------------------* 
          		DFHPLT TYPE=ENTRY,                                                                 x
                   		PROGRAM=DFHMALSC                                         
              DFHPLT TYPE=FINAL     
              END 
    For programming information about writing PLT programs, see the CICS Customization Guide. For information on defining a PLT, see the CICS Resource Definition Guide.
  2. Define system initialization parameters PLTPI and INITPARM in the system initialization table (SIT). The PLTPI parameter specifies the suffix of the program list table, which contains the entry for DFHMALSC or DFHMALFC. The PLTPI parameter definition in the SIT for the above example would be PLTPI=D1. The INITPARM parameter is used to pass parameters to the program, in this example DFHMALSC, which is executed in the final stages of system initialization. The format of the parameter in the SIT is:
     INITPARM=(DFHMALSC='SI=300') 
    where SI=nnnnn is a numeric value in seconds and whose value can range from 300 to 99999 seconds. This value is converted to hhmmss and indicates the start interval for subsequent task starts of program DFHMALSC with transid CMAK.

    Setting too low a value for the SI parameter can affect the performance of the CICS region. To avoid affecting performance, if you set the parameter to less than 300 seconds, the parameter value is ignored and reset to the minimum value of 300 seconds. For more information about the system initialization parameters, see the CICS System Definition Guide.

What to do next

For a description of cleanup processing on TSQs see Facility state cleanup processing — TSQ. For a description of cleanup processing on the VSAM file, see Facility state cleanup processing — VSAM



dfhcr_config_auto.html | Timestamp icon Last updated: Sunday, 4 June 2017