Creating TRANSACTION resource definitions for CICS web support

TRANSACTION resource definitions define alias transactions for CICS® web support. An alias transaction handles the later stages of processing for an HTTP request, including receiving the request, executing the application business logic, construction of the HTTP response, and code page conversion of the HTTP response. Alias transactions can also be used for processing non-HTTP requests.

About this task

CICS supplies a resource definition for a default alias transaction, CWBA. You might want to use alternative alias transaction names for these purposes:
  • Auditing, monitoring, or accounting
  • Resource and command checking for security
  • Allocating initiation priorities
  • Allocating DB2® resources
  • Assigning different runaway values to different CICS application programs
  • Transaction class limitation
You can set up any number of alias transaction definitions. You can use the URIMAP definition or an analyzer program to specify the alias transaction that is required for a particular request.
Important: Make sure that the priorities of the alias transactions used for application-generated responses (like CWBA) are equal to, or higher than, the priority of the transactions associated with web attach tasks (like CWXN or CWXU). See Priorities for CICS web support transactions (CWXN, CWXU, CWBA, CW2A).

TRANSACTION resource definitions has instructions for this type of resource definition. In addition, note these points:

Procedure

  • Base your alias transaction definition on the definition of CWBA, making any changes that you require, such as changes to priority.
    The definition of CWBA is:
    DEFINE TRANSACTION(CWBA)   GROUP(DFHWEB)
       PROGRAM(DFHWBA)     TWASIZE(0)
       PROFILE(DFHCICST)   STATUS(ENABLED)
       TASKDATALOC(BELOW)  TASKDATAKEY(USER)
       RUNAWAY(SYSTEM)     SHUTDOWN(ENABLED)
       PRIORITY(1)         TRANCLASS(DFHTCL00)
       DTIMOUT(NO)         INDOUBT(BACKOUT)
       SPURGE(YES)         TPURGE(NO)
       RESSEC(NO)          CMDSEC(NO)
  • Your alias transaction definition must use the CICS-supplied alias program DFHWBA.
    The alias program calls the user application program that you have specified to process the request.
  • Your alias transaction definition must be a local transaction.