Start of change

Completing a URIMAP definition for an application response to an HTTP request for CICS as an HTTP server

If you are providing an application-generated response to an HTTP request, when you have started the URIMAP definition by specifying the components of the expected URL (scheme, host and path) and other basic information, complete the definition by providing information about the application or applications that should process the request and supply an HTTP response.

If you have not already planned how to provide a response to the HTTP request for CICS® as an HTTP server, Providing dynamic HTTP responses with Web-aware application programs tells you how to do this. Then you need to start your URIMAP definition as described in Starting a URIMAP resource definition for any requests for CICS as an HTTP server.
When you have planned your application-generated response and started your URIMAP definition, complete the definition following the instructions in this topic. The CICS Resource Definition Guide has information about the different methods of resource definition, and full reference information about all the URIMAP resource definition attributes that you will use during this process.
  1. If the analyzer program associated with the TCPIPSERVICE definition (or definitions) to which this URIMAP definition relates is to be involved in the processing path for this request, specify YES for the ANALYZER attribute to activate it. If an analyzer program is used, you can still specify the CONVERTER, TRANSACTION, USERID and PROGRAM 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 leave these attributes blank and let the analyzer program specify them.
  2. If you are using a converter program, specify the CONVERTER attribute as the name of the program. The program can be any converter program that is available in CICS; there is no association between the converter program and the TCPIPSERVICE definition, as there is for the analyzer program. 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.
  3. Specify the TRANSACTION attribute as the name of an alias transaction that is available in CICS, which CICS can use to run the application program that provides the response. The default alias transaction is CWBA. The transaction name can also be changed or provided by an analyzer program, if ANALYZER(YES) is specified.
  4. Specify the USERID attribute as a default user ID under which the alias transaction can be attached. Start of changeWhen 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.End of change
  5. Specify the PROGRAM attribute as the name of the application program that provides the response to the request. If no analyzer or converter program is specified in the URIMAP definition, the HTTP request is passed directly to this application program. If an analyzer or converter program is specified, you can leave this attribute blank and let the analyzer or converter program specify it.
End of change