Interface IURIMapDefinition

    • Method Detail

      • getChangeAgent

        IURIMapDefinition.ChangeAgentValue getChangeAgent()
        Getter for field CHANGEAGENT

        Last modification agent

        The change agent identifier that made the last modification.

        • CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
        • CSDBATCH - The resource was last changed by a DFHCSDUP job.
        • DREPAPI - Resource was last changed by a CICSPlex SM API command.
        • N_A - Resource was created or last updated prior to CICS TS Version 4 Release 1 and support for resource signatures.
      • getUserdata1

        java.lang.String getUserdata1()
        Getter for field USERDATA1

        User data area 1

        Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.

      • getUserdata2

        java.lang.String getUserdata2()
        Getter for field USERDATA2

        User data area 2

        Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.

      • getUserdata3

        java.lang.String getUserdata3()
        Getter for field USERDATA3

        User data area 3

        Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.

      • getStatus

        ICICSEnums.EnablementValue getStatus()
        Getter for field STATUS

        Enabled status

        The status of the URIMAP definition. The possible values are:

        • Enabled - The URIMAP definition can be accessed.
        • Disabled - The URIMAP definition cannot be accessed. A URIMAP definition with this status can be deleted.
        • Hdisabled - The URIMAP definition cannot be accessed because the virtual host of which it forms a part has been disabled. Use CEMT SET HOST to re-enable all the URIMAP definitions in the virtual host. A URIMAP definition with this status cannot be deleted.
      • getUsage

        IURIMapDefinition.UsageValue getUsage()
        Getter for field USAGE

        URI map usage type

        The usage for the URIMAP definition. The possible values are:

        • Server - The URIMAP definition is for CICS as an HTTP server. It is used to map the URL of an incoming HTTP request from a web client, to CICS application resources.
        • Client - The URIMAP definition is for CICS as an HTTP client. It is used when CICS makes a request for an HTTP resource on a remote server, so that you can avoid identifying the URL in your application program.
        • Pipeline - The URIMAP definition is for a web service. It is used to specify the processing that is to be performed on a request by which a client invokes a web service in CICS.
        • Atom - The URIMAP definition is for an Atom service. It is used to specify the processing that is to be performed on a request by which a client invokes an Atom service in CICS.
        • JVMSERVER - The URIMAP definition is for a JVM server. It is used to specify the processing that is to be performed on a request by which a client invokes a Java service in CICS.
      • getScheme

        IURIMapDefinition.SchemeValue getScheme()
        Getter for field SCHEME

        Scheme component of URI to which the map applies

        The scheme component of the URL. The possible values are:

        • HTTP - HTTP without Secure Sockets Layer (SSL).
        • HTTPS - HTTP with Secure Sockets Layer (SSL).
        • JMS - Liberty JMS (Message Driven Beans).
        • IIOP - Liberty IIOP (Enterprise Java Beans).
      • getHost

        java.lang.String getHost()
        Getter for field HOST

        Host component of URI to which the map applies

        The up to 116-character host name of the URI to which the map applies (for example, www.example.com), or its dotted decimal IPv4 address (for example, 9.20.181.3), or its colon hexadecimal IPv6 address (for example ABCD:EF01::2345:6789). If an IPv4 address is entered as an IPv4 compatible IPv6 address (deprecated) or an IPv4 mapped IPv6 address (for example ::FFFF:1.2.3.4) it is converted to a standard IPv4 dotted decimal address.

        The host name can be entered in any case, but if a character host name is specified instead of an IP address, the host name is converted to lowercase. If an IPV6 address is specified it will be converted to uppercase.

        If the definition is going to be used on CICS Transaction Server for z/OS, Version 3 Release 2 and earlier releases, IPv6 address formats should not be specified, and for USAGE(CLIENT) a non-standard port number for the SCHEME may be specified by following the name or address with a colon (:) and the port number, for example 'www.example.com:1234'. Otherwise, the PORT field is now the prefered method of specifying a non-standard port number.

        For a USAGE other than USAGE(CLIENT), a port number should not be specified, and an asterisk (*) may be used to make the URIMAP definition match any host name.

      • getPath

        java.lang.String getPath()
        Getter for field PATH

        Path component of URI to which the map applies

        The path component of the URL, which can be up to 255 characters.

      • getMediatype

        java.lang.String getMediatype()
        Getter for field MEDIATYPE

        Media type of CICS response to the HTTP request

        Specifies the media type (data content) of the static response that CICS provides to the HTTP request. This is for USAGE(SERVER), where a static response is to be provided and up to 56 characters can be used. The name for each formally recognized type of data content is defined by IANA.

      • getCharacterset

        java.lang.String getCharacterset()
        Getter for field CHARACTERSET

        Character set of CICS response to the HTTP request

        For USAGE(SERVER), the name of the character set for the static response, which can be up to 40 characters.

      • getHostcodepage

        java.lang.String getHostcodepage()
        Getter for field HOSTCODEPAGE

        Code page in which the static response is encoded

        For USAGE(SERVER), the IBM code page (EBCDIC) in which the text document that will form the static response is encoded; this can be up to 10 characters.

      • getTemplateName

        java.lang.String getTemplateName()
        Getter for field TEMPLATENAME

        Document template to form the static response

        For USAGE(SERVER), the name of a CICS document template whose contents are returned as the HTTP response.

      • getHFSFile

        java.lang.String getHFSFile()
        Getter for field HFSFILE

        Qualified zFS file to form the static response

        For USAGE(SERVER), the fully qualified or relative name of a file in the z/OS UNIX System Services zSeries File System (zFS), whose contents are returned as the HTTP response.

        • For a static response file for a URIMAP resource defined by online resource definition, the file path is either fully qualified, if prefixed with a forward slash (/), or is relative to the HOME directory of the CICS region user ID.
        • For a static response file for a URIMAP resource defined in a CICS bundle, the file path is relative to the root directory of the CICS bundle. The zFS file must be packaged in the CICS bundle with the URIMAP resource. The MEDIATYPE and HOSTCODEPAGE attributes must be specified, to inform CICS of the file type and the code page with which the file is encoded. When the file is defined in a CICS bundle and exported to zFS using CICS Explorer, the code page with which the file is encoded will be the same as the one used by CICS Explorer.
      • getTcpipservice

        java.lang.String getTcpipservice()
        Getter for field TCPIPSERVICE

        Inbound TCP/IP service relating to this URI map

        For USAGE(SERVER) or USAGE(PIPELINE), the TCPIPSERVICE to which this URIMAP definition applies. Only requests received on this TCPIPSERVICE are matched to this URIMAP definition. If no TCPIPSERVICE is specified, the URIMAP definition applies to all incoming HTTP requests.

      • getAnalyzer

        ICICSEnums.YesNoValue getAnalyzer()
        Getter for field ANALYZER

        Use an analyzer program to process HTTP request

        The analyzer program setting for the URIMAP definition. The possible values are:

        • Analyzer - The analyzer associated with the TCPIPSERVICE definition is to be used in processing the HTTP request.
        • Noanalyzer - The analyzer program is not to be used.
      • getConverter

        java.lang.String getConverter()
        Getter for field CONVERTER

        Converter program to process request content

        For USAGE(SERVER), the name of a converter program that is used to transform the HTTP request into a form suitable for the application program specified in PROGRAM.

      • getTransaction

        java.lang.String getTransaction()
        Getter for field TRANSACTION

        Alias transaction to run application for response

        For USAGE(SERVER), USAGE(JVMSERVER), or USAGE(PIPELINE), the name of the alias transaction that processes the incoming HTTP request.

      • getProgram

        java.lang.String getProgram()
        Getter for field PROGRAM

        Application program that will process the request

        For USAGE(SERVER), the name of the application program that processes the incoming HTTP request.

      • getPipeline

        java.lang.String getPipeline()
        Getter for field PIPELINE

        Pipeline that will process the request

        For USAGE(PIPELINE), the name of the PIPELINE resource definition for the web service that handles the incoming HTTP request.

      • getWebservice

        java.lang.String getWebservice()
        Getter for field WEBSERVICE

        Web service that will process the request

        For USAGE(PIPELINE), the name of the WEBSERVICE resource definition for the web service that handles the incoming HTTP request.

      • getUserid

        java.lang.String getUserid()
        Getter for field USERID

        The user ID to attach the alias transaction

        For USAGE(SERVER), USAGE(JVMSERVER), or USAGE(PIPLEINE), the 8 character user ID under which the alias transaction will be attached.

      • getCertificate

        java.lang.String getCertificate()
        Getter for field CERTIFICATE

        SSL client certificate for outbound HTTPS request

        For USAGE(CLIENT), the label of a certificate within the key ring that is to be used as a client certificate in the SSL handshake for outbound IIOP connections.

      • getCiphers

        java.lang.String getCiphers()
        Getter for field CIPHERS

        Cipher suite codes to be used for outbound SSL

        Specifies a string of up to 56 hexadecimal digits that is interpreted as a list of up to 28 2-digit cipher suite codes. When you define the resource, CICS automatically initializes the attribute with a default list of acceptable codes. You can reorder the cipher codes or remove them from the initial list. However, you cannot add cipher codes that are not in the default list for the specified encryption level. To reset the value to the default list of codes, delete all the cipher suite codes; the field is automatically repopulated with the default list. From CICS Transaction Server Version 5 this field can alternatively specify the name of an XML file residing on zFS which contains a list of ciphers. An XML file name can be up to 28 characters.

      • getLocation

        java.lang.String getLocation()
        Getter for field LOCATION

        URI to which to redirect the inbound HTTP request

        For USAGE(SERVER), or USAGE(PIPELINE), an alternate URL to which the web client will be redirected, if redirection is specified. REDIRECTYPE is used to define the type of redirection.

      • getRedirecttype

        IURIMapDefinition.RedirecttypeValue getRedirecttype()
        Getter for field REDIRECTTYPE

        Type of redirection

        The type of redirection for requests that match this URIMAP definition. The URL for redirection is specified by the Location option. The possible values are:

        • None - Requests are not redirected. Any URL specified by the Location option is ignored.
        • Temporary - Requests are redirected on a temporary basis. The status code used for the response is 302 (Found).
        • Permanent - Requests are redirected permanently. The status code used for the response is 301 (Moved Permanently).
      • getPort

        java.lang.Long getPort()
        Getter for field PORT

        Port number

        For USAGE(CLIENT) or USAGE(JVMSERVER) the decimal number of the port on which the remote CICS system is listening for incoming client requests in the range 1 through 65535. The well-known ports are those from 1 through 1023. It is advisable to use well known port numbers only for those services to which they are normally assigned. PORT need not be specified if the default port number for the SCHEME is to be used in which case it is set to NO.

        If a port number is optionally specified in the HOST field, the PORT field must either contain the same port number, or be set or allowed to default to NO. In this case the port number from the HOST field will be used when the URIMAP is installed.

        For a USAGE other than USAGE(CLIENT)or USAGE(JVMSERVER), PORT should not be specified and will be set to NO in any case.

      • getAtomservice

        java.lang.String getAtomservice()
        Getter for field ATOMSERVICE

        Atomservice that will process the request.

        This attribute is for USAGE(ATOM). When a client makes a request to CICS for an Atom feed using the URI specified by this URIMAP definition, ATOMSERVICE specifies the 1 - 8 character name of the ATOMSERVICE resource definition for the Atom feed. The ATOMSERVICE resource definition defines an Atom service, feed, collection, or category document, and identifies the Atom configuration file, CICS resource or application program, and Atom binding file that are used to supply the data for the feed.

      • getAuthenticate

        IURIMapDefinition.AuthenticateValue getAuthenticate()
        Getter for field AUTHENTICATE

        Authentication level

        The authentication and identification scheme to be used for URIMAPS.

        • NO - The client is not required to send authentication or identification information. However, if the client sends a valid certificate that is already registered to the security manager, and associated with a user ID, then that user ID identifies the client.
        • BASIC - HTTP Basic authentication is used to obtain a user ID and password from the client. If an invalid user ID and password are supplied, the process is repeated until valid information is supplied, or until the end user cancels the connection. When the end user has been successfully authenticated, the user ID supplied identifies the client. BASIC requires USAGE(CLIENT).
      • getSocketclose

        java.lang.String getSocketclose()
        Getter for field SOCKETCLOSE

        Time out for pooled sockets (HHMMSS)

        This attribute is for USAGE (CLIENT). SOCKETCLOSE specifies if, and for how long, CICS keeps a client HTTP connection open after the CICS application has finished using it. After use, CICS checks the state of the connection and then places it in a pool in a dormant state. A dormant connection can be reused by the same application or by another application that connects to the same host and port.

        • 0 - 240000 - The period of time (in HHMMSS format) after which CICS is to close the socket. Specifying 000000 closes the socket immediately and does not put sockets into a pool.