| Keyword | Description |
|---|---|
| Urimap (name) | Name of the URI Map record. Can be up to eight characters in length. Acceptable characters are A through Z, 0 through 9, $, @ and #. |
| Group(groupname) | Names the group the URIMAP definition belongs to. Mandatory. groupname can be up to eight characters in length. Acceptable characters are A through Z, 0 through 9, $, @ and #. Do not specify a group name starting with DFH, as Mainframe Subsystem Support (MSS) uses that prefix for system groups. |
| Description(text) | Describes the bundle. Optional. text can be up to 60 characters in length, with no restrictions except that if you use a left parenthesis you must ensure that there is a matching right parenthesis. |
| STatus (ENABLED|DISABLED) | Specifies if the URIMAP is to be enabled when installed. |
| HOST(name) The host name of the URI or its IPv4 or IPv6 address. | PAth(string) The full path of the URI the resource definition applies to. An asterisk can be used as a wildcard character to match more than one path. |
| PAth(string) | The full path of the URI the resource definition applies to. An asterisk can be used as a wildcard character to match more than one path. |
| SCheme(HTTP|HTTPS) | The scheme of the URI the resource definition applies to. |
| USAge (SERVER|CLIENT|PIPELINE) | Specifies whether this resource definition is for a HTTP server, HTTP client, or PIPELINE. |
| Mediatype | The media type of the static response provided to the HTTP request. (For USAGE(SERVER)) |
| CHaracterset(string) | Character set which CICS converts the static response body into. Default is iso-8859-1. (For USAGE(SERVER)) |
| HOSTCodepage(value) | Code page in which the document that forms the static response is encoded. Default is 037. (For USAGE(SERVER)) |
| TEmplatename(name) | Specifies the name of the CICS document template for the static response body. (For USAGE(SERVER)) |
| HFsfile(name) | The HFS file that will be sent as part of the static response to the HTTP request. (For USAGE(SERVER)) |
| ANalyzer(NO|YES) Whether an analyzer program is used in processing the HTTP request. It must be associated with the given tcpipservice. (For USAGE(SERVER)) | Whether an analyzer program is used in processing the HTTP request. It must be associated with the given tcpipservice. (For USAGE(SERVER)) |
| COnverter(name) | The program used to convert on the request and response. (For USAGE(SERVER)) |
| TRansaction(name) | The transaction alias used to run the application or start the pipeline. Default is CWBA for USAGE(SERVER), CPIH for USAGE(PIPELINE)) |
| PRogram(name) | The user application program that composes the HTTP request. (For USAGE(SERVER)) |
| USErid(id) The user ID to be used in the transaction. (For USAGE(SERVER)) | The user ID to be used in the transaction. (For USAGE(SERVER)) |
| CErtificate(label) | The certificate to use for the SSL handshake. (For USAGE(CLIENT)) |
| CIphers(value) | Used when encrypting inbound messages, can be a string of up to 56 hexadecimal digits interpreted as a list of 28 2-digit cipher codes or the name of an SSL cipher suite specification file. Default is 050435363738392F303132330A1613100D0915120F0C03060201 (For USAGE(CLIENT)) |
| PIpeline(name) | The pipeline from the inbound web service request made by the client. (For USAGE(PIPELINE)) |
| Webservice(name) | The inbound web service request made by the client. (For USAGE(PIPELINE)) |
| AUthenticate(NO|BASIC) | Whether to send basic authentication information in the HTTP response. (For USAGE(CLIENT)) |
| POrt(NO|value) | The port used by the application when communicating with the server. (For USAGE(CLIENT)) |
| SOcketclose(NO|hhmmss) | Specifies if and how long CICS keeps a client connection open after the CICS application finishes using it. (For USAGE(CLIENT)) |
Example
DEFINE URIMAP(SAMPURI) GROUP(SAMPGRP)
DESCRIPTION(Sample URIMAP for a server application response)
STATUS(ENABLED) USAGE(SERVER) SCHEME(HTTPS) HOST(localhost)
PATH(/tests/*) TCPIPSERVICE(TCPNOURM) ANALYZER(NO)
CONVERTER(CICS) TRANSACTION(CWBA) PROGRAM(MYPROG) USERID(FREE)