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.