WBUR gate, ADD_REPLACE_URIMAP function

The ADD_REPLACE_URIMAP function adds or replaces a URIMAP resource into the Web domain. The parameters correspond to attributes specified on the URIMAP definition.

Input Parameters

HOST
The host name of the URI to which the URIMAP resource applies, or its IPv4 or IPv6 address.
PATH
The path component of the URI to which the URIMAP resource applies.
URIMAP
The name of the URIMAP resource.
ANALYZER
Optional Parameter
A binary value that specifies whether an analyzer program is to be used in processing HTTP requests.
Values for the parameter are:
  • NO
  • YES
CERTIFICATE_LABEL
Optional Parameter
The label of the X.509 certificate that is to be used as the SSL client certificate during the SSL handshake.
CHARACTERSET
Optional Parameter
The character set into which CICS converts the entity body of the response that is sent to the web client.
CIPHER_COUNT
Optional Parameter
The number of cipher suites encoded in the CIPHER_SUITES parameter.
CIPHER_SUITES
Optional Parameter
A string of up to 56 hexadecimal digits that is interpreted as a list of up to 28 2-digit cipher suite codes.
CONVERTER
Optional Parameter
The name of a converter program that is to be run to perform conversion or other processing on the request and response.
HFSFILE
Optional Parameter
The fully qualified or relative name of a zFS file that forms the body of the static response that is sent to the HTTP request from the web client.
HOSTCODEPAGE
Optional Parameter
The EBCDIC code page in which the text document that forms the static response is encoded.
MEDIATYPE
Optional Parameter
The media type of the static response that CICS provides to the HTTP request, for example image/jpg, text/html, or text/xml.
PIPELINE_NAME
Optional Parameter
The PIPELINE resource used by web service requests for the URIMAP resource.
PORT
Optional Parameter
The decimal number of the port used by a CICS application when it communicates with a server using the URIMAP resource.
PROGRAM
Optional Parameter
The name of the user application program that composes the HTTP response for the URIMAP resource.
REDIRECTION_LOCATION
Optional Parameter
A URL to which the client's request should be redirected.
REDIRECTION_TYPE
Optional Parameter
The type of redirection for requests that match the URIMAP resource. When redirection is required, the REDIRECTION_LOCATION parameter specifies the URL to which the request should be redirected.
Values for the parameter are:
  • NONE
  • PERMANENT
  • TEMPORARY
SCHEME
Optional Parameter
The scheme component of the URI to which the URIMAP resource applies.
Values for the parameter are:
  • HTTP
  • HTTPS
  • WMQ
SOCKETCLOSE
Optional Parameter
The length of time for which CICS keeps a client HTTP connection open after the CICS application has finished using it.
STATUS
Optional Parameter
The enabled or disabled state of the URIMAP resource.
Values for the parameter are:
  • DISABLED
  • DISABLEDHOST
  • ENABLED
TCPIPSERVICE
Optional Parameter
The name of the TCPIPSERVICE resource that defines the inbound port to which the URIMAP resource relates.
TEMPLATENAME
Optional Parameter
The 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.
TRANSACTION
Optional Parameter
The name of an alias transaction that is to be used to run the user application that composes the HTTP response, or to start the pipeline.
USAGE
Optional Parameter
Specifies how the URIMAP resource is used.
Values for the parameter are:
  • ATOM
  • CLIENT
  • PIPELINE
  • SERVER
USERID
Optional Parameter
The user ID under which requests for the URIMAP resource are initially processed.
WEBSERVICE_NAME
Optional Parameter
The name of a WEBSERVICE resource associated with the URIMAP resource.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOOP
The following values are returned when RESPONSE is EXCEPTION:
  • BROWSE_END
  • CCNV_ERROR
  • CONFLICTING_ATTRIBUTES
  • DIRECTORY_ERROR
  • DUPLICATE_MAPPING
  • GETMAIN_FAILED
  • INVALID_BROWSE_TOKEN
  • INVALID_CHARACTERSET
  • INVALID_HOSTCODEPAGE
  • INVALID_HOSTNAME
  • INVALID_PATHNAME
  • LOCATION_INVALID
  • NO_REDIRECTION_LOCATION
  • NOT_FOUND
  • NOT_POSSIBLE
  • SECURITY_FAILED
  • SSL_INACTIVE
  • URIMAP_ENABLED
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
  • CONFLICTING_ATTRIBUTES
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
DUPLICATE_URIMAP
Optional Parameter
The name of a URIMAP resource that already exists and would be duplicated by this request.


dfhs3_WBURadd_replace_urimap.html | Timestamp icon Last updated: Monday, 5 June 2017