|
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 XCICS System Management Guide contains information about URIMAP resource definition attributes that you will use during this process.
| 1. | Specify a "type" attribute of "application". |
| 2. | 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. |
| 3. | 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 XCICS; 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. |
| 4. | Specify the "transaction" attribute as the name of an alias transaction that is available in XCICS, which XCICS 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. |
| 5. | Specify the "userid" attribute as the user ID under which the alias transaction is attached. A user ID that you specify in the URIMAP definition is overridden by any user ID that is obtained from the Web client (specified by the AUTHENTICATE attribute of the TCPIPSERVICE definition for the connection). If "analyzer=yes" is specified, the analyzer program can change either of these user IDs, or provide one. If no user ID is specified by any of these means, the default user ID is the XCICS default user. |
| 6. | 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. |
Example
define urimap name=URIA,
usage=server,
type=application,
scheme=http,
analyzer=no,
tcpipservice=HTTPD,
host="*",
program=PMACAURI,
path="/prova/rrna";
define urimap name=URIB,
usage=server,
type=application,
analyzer=yes,
tcpipservice=HTTPD,
host="*",
program=PMX1YURI,
path="/prova/ax1";
|
