Specifying URIMAP attributes for an application response to HTTP requests

Some of the attributes specified in a URIMAP apply only when an application program is used to supply the response to HTTP requests.

About this task

The URIMAP resource has a number of attributes that you can use when you use an application program to supply the response to an HTTP request.

Procedure

  1. Specify the name of the application program that provides the response, in the PROGRAM attribute. The HTTP request is passed to the program you specify. Alternatively, you can specify an analyzer or converter program that supplies the name of the application program. The analyzer or converter program can also change the name of the application program that you specify in this attribute.
  2. Specify the name of an alias transaction in the TRANSACTION attribute. The alias transaction is a transaction defined to CICS under which the program that provides the response is run. The default alias transaction is CWBA.

    If you use an analyzer program, it can supply or change the name of the alias transaction.

  3. Specify a default user ID under which the alias transaction can be attached, in the USERID attribute. When authentication is required for the connection, so that CICS requests an authenticated user ID directly from the client, the default user ID is not used. The authenticated user ID of the client is used instead, or if authentication fails, the request is rejected. If you use an analyzer program, it can replace a default user ID or an authenticated user ID with another user ID, or provide one. If no user ID is specified, the default user ID is the CICS® default user.
  4. Specifying ANALYZER(NO) is required for HTTP requests to be eligible to be processed by directly attaching the user transaction. Directly attaching the user transaction removes the web attach task from the processing and results in a reduction in CPU usage. For more information, see Bypassing the web attach task with the CSOL socket listener task.
  5. If you want to use an analyzer program, specify ANALYZER(YES). The analyzer program is specified in the URM attribute of the TCPIPSERVICE resources to which this URIMAP definition relates. If you use an analyzer program, you can still specify the PROGRAM, TRANSACTION, USERID and CONVERTER attributes. The values that you specify for these attributes are used as input to the analyzer program, but they can be overridden by it. Alternatively, you can omit these attributes and let the analyzer program specify them.
  6. If want to use a converter program, specify the name of the program in the CONVERTER attribute. Unlike the analyzer program, the converter program and the TCPIPSERVICE definition are not associated. If a converter program is used, you can still specify the PROGRAM attribute. The value that you specify for this attribute is used as input to the converter program. The converter program can change the PROGRAM attribute to specify a different application program to process the request.


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