Active Universal Resource Identifier Map

General

Name

The name of this URIMAP definition.

Enabled

Check this field to specify that the installed definition is in an enabled state.

Usage

Specifies whether this URIMAP definition is for:

Server: CICS as an HTTP server.
Client: CICS as an HTTP client.

Universal Resource Identifier

Scheme: The scheme component of the URI.
Port: The number of the port used by the user application when it communicates with a server.
Host: The host name, or IPv4 or IPv6 address, of the URI.
Path: The path component of the URI.
Socket Close: The duration for which the HTTP connection is held for once Enterprise Server has finished using it. Enter 0 for immediate release, or a figure corresponding to hhmmss. For example, 011230 corresponds to 1 hour, 12 minutes, and 30 seconds.

Associated CICS Resources

TCP/IP Service: The name of a TCPIPSERVICE resource definition that defines an inbound port.
Analyzer: Indicates whether an analyzer program is used in processing the HTTP request.
Converter: The name of a converter program used to convert (or perform other processing) on the request and response.
Transaction: The name of an alias transaction used either to run the user application that composes the HTTP response, or to start the pipeline.
Program: The name of the user application program that composes the HTTP response.
Pipeline: The pipeline from the inbound web service request made by the client.
WebService: The inbound web service request made by the client.

Security Attributes

User ID

The user ID to be used in the transaction.

Ciphers

This is specified in one of the following ways:

A string of up to 56 hexadecimal digits that is interpreted as a list of up to 28 2-digit cipher suite codes.
The name of the SSL cipher suite specification file name can be up to 28 characters long including the extension which must be .xml. The file name can only contain the characters A-Z a-z 0-9 # - . @ _.

Note: The location of the SSL cipher suite specification file is specified by the USSCONFIG environment variable. See USSCONFIG for more information.

Certificate

The label of the X.509 certificate that is used as the SSL client certificate during the SSL handshake.

Authenticate

Specifies whether to send basic authentication information in the HTTP response. Basic authentication can only be set when the ES region itself is secure.

Static Document Properties

Media Type: The media type (data content) of the static response that CICS provides to the HTTP request.
Character Set: The 1 to 40 character name of the character set into which CICS converts the entity body of the response that is sent to the web client.
Host Codepage: The 1 to 10 character name of the IBM code page (EBCDIC) in which the text document that forms the static response is encoded.
Template Name: The 1 to 48 character name of a CICS document template that forms the body of the static response that is sent to the HTTP request from the web client.
HFS File: The fully qualified (absolute) or relative name of a z/OS UNIX System Services zFS file that forms the body of the static response that is sent to the HTTP request from the web client. This can be up to 255 characters long.

Redirection

Redirect Type

The type of redirection for requests that match this URIMAP definition. The URL specified by the LOCATION attribute is used for redirection when required:

NONE: The requests are not redirected. Any URL specified by the LOCATION attribute is ignored.
TEMPORARY: The requests are redirected on a temporary basis. The URL specified by the LOCATION attribute is used for redirection, and the status code that is used for the response is 302 (Found).
PERMANENT: The requests are redirected permanently. The URL specified by the LOCATION attribute is used for redirection, and the status code that is used for the response is 301 (Moved Permanently).

Location

A URL of up to 255 characters to which the client request is redirected. The URL must be complete, including scheme, host, path components, and appropriate delimiters.