CICS Resource Definition Tables

The Attachmate CICS Web Interface Analyzer allows the TCP/IP feature of Services Builder for CICS to receive HTTP-based input over a defined TCP/IP port on the mainframe by analyzing the URI from the HTTP header and forwarding the request along, or it invokes a registered CWI Converter program, such as the converter included in this product, and ultimately forwards the input packet to a server program capable of providing the desired function. The specific CWI Converter and server invoked in response to traffic via a given URI are specified in the XTR5S000 macro.

The Attachmate CWI Analyzer is also capable of filtering out requests from clients and allowing only selected clients to exchange HTTP packets with their CICS counterparts. This IP filtering can allow specific IP addresses, IP addresses containing wildcard range designations, or any (all wildcard specifications) client IP address access to the host, depending upon the configuration of the Attachmate CWI Analyzer using the XTR5S000 macro.

Timeout values and cleanup transaction IDs to be invoked in the event of a Services Builder for CICS "Connect" with no further requests within the timeout period can also be configured.

Customization for the Attachmate CWI Analyzer load module can include specification of:

• a default CWI Analyzer to be called in the event the Universal Resource Indicator (URI) in a received HTTP request is unrecognized

• specific HTTP messages to be processed based upon their URI specification

• CWI Converter module name to handle HTTP requests associated with this URI

• a server module name to handle HTTP requests associated with this URI

• IP addresses that are authorized to exchange HTTP messages carrying a given URI with the target CICS region

A set of IP addresses can be specified with or without wildcard specifications, and these specifications can be attached to specific HTTP message traffic based upon the target URI specification contained in the HTTP packet. Alternately, an IP "pool" can be set up and referenced by multiple URI Analyzer definitions with each definition specifying its own converter and server program to handle the HTTP traffic. See Customizing the CWI Analyzer Module for more information.

A CICS transaction identification must be created for the server program. The name selected must match the cleanup transaction identified in the CTRAN parameter of both the Analyzer and the Server. See the CTRAN parameter as defined for XTR5S001 TYPE=ANALYZER in Customizing the CWI Analyzer Module and for XTR5S003 in Customizing the CWI Server Module.

CICS transaction resource definition

The TCP/IP Service must be defined to allow connection from the local Services Builder for CICS via a TCP port (in this example 2317) as follows:

Make sure the CICS transactions CWXN and CWBA have the appropriate resource level setting, as follows:

 TRANSACTIONS  CWXN and CWBA

   SECURITY
    RESSec         : No                 No | Yes
    CMdsec         : No                 No | Yes
    Extsec         : No                 No | Yes
    TRANSec        : 01                 1-64
    RSl            : 00                 0-24 | Public

CWXN, CWBA, and AQCC must have maximum tasks set to the highest number of anticipated concurrent tasks.

	Using the TCP/IP Connectivity Feature
	Installing from the CD on an OS/390 Server
	Installing from Tape or Disk
	Customizing the CWI Analyzer Module