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.
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.
- 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.
- 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.
- 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.
- Specify the USERID attribute as a default user ID under
which the alias transaction can be attached.
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.
- 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.