Administering the adapter

Careful use of task-related user exits can allow your application programmers to be unaffected by the invocation of non-CICS® resource managers from CICS application programs. Enabling and disabling task-related user exit programs for an installation should be the responsibility of one or more supervisory or main terminal operators.

Before you begin

Before you use the adapter, a task-related user exit program must be both enabled and started before it is available for execution.

  1. Use the CEDA INSTALL PROGRAM command to define the task-related user exit program to the system.
  2. Use the EXEC CICS ENABLE PROGRAM command to enable the task-related user exit program and to define its working storage needs. By using the INDOUBTWAIT, SHUTDOWN, and SPI command options of ENABLE PROGRAM, you can cause your exit program to be started at specific events (see Enabling for specific invocation-types for details).
Example: 
EXEC CICS ENABLE PROGRAM('EP9')
     TALENGTH(750) GALENGTH(200) SHUTDOWN

EXEC CICS ENABLE PROGRAM('EP9')
     START

The first command loads the task-related user exit program, EP9, and causes a global work area of 200 bytes to be obtained and associated with it. To locate the global work area in 31-bit storage, specify the CVDA LOC31 for the GALOCATION option of the command. The first command also schedules the allocation of a local work area of 750 bytes for each task that later starts EP9, and for the invocation of EP9 at CICS termination.

The second command starts the exit program: that is, it makes its entry point capable of being started.

The administration routines

As well as enabling task-related user exit programs before they can be used, you should disable them when you have finished using them.

You should prepare procedures (the administration routines) for enabling and disabling your task-related user exit programs, using the EXEC CICS ENABLE and DISABLE commands, and for resynchronizing between sessions or after a system failure. Your enabling routines could be PLT initialization programs or online programs. Your disabling routines could, for example, be started by a TRUE invoked at CICS termination.

The EXTRACT EXIT command obtains the address and the length of a global work area that is owned by, or shared by, a named task-related user exit program.

For programming information about these system commands, and the rules governing them, and also about resynchronization, see Introduction to System programming commands.

CICS issues a trace entry just before control is passed to the task-related user exit and just after returning from the exit. You can control these trace entries using the RI option of the CETR trace control transaction or the EXEC CICS SET TRACETYPE command.