Interface IURIMapDefinition
-
- All Superinterfaces:
ICICSDefinition
,ICICSObject
,IDefinition
,com.ibm.cics.model.meta.ITypedObject
public interface IURIMapDefinition extends ICICSDefinition
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static class
IURIMapDefinition.AuthenticateValue
Enumeration type for field AUTHENTICATEstatic class
IURIMapDefinition.ChangeAgentValue
Enumeration type for field CHANGEAGENTstatic interface
IURIMapDefinition.PortValue
Long constants interface for field PORTstatic class
IURIMapDefinition.RedirecttypeValue
Enumeration type for field REDIRECTTYPEstatic class
IURIMapDefinition.SchemeValue
Enumeration type for field SCHEMEstatic class
IURIMapDefinition.UsageValue
Enumeration type for field USAGE
-
Field Summary
-
Fields inherited from interface com.ibm.cics.model.ICICSDefinition
COPYRIGHT
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description ICICSEnums.YesNoValue
getAnalyzer()
Getter for field ANALYZERjava.lang.String
getAtomservice()
Getter for field ATOMSERVICEIURIMapDefinition.AuthenticateValue
getAuthenticate()
Getter for field AUTHENTICATEjava.lang.String
getCertificate()
Getter for field CERTIFICATEIURIMapDefinition.ChangeAgentValue
getChangeAgent()
Getter for field CHANGEAGENTjava.lang.String
getCharacterset()
Getter for field CHARACTERSETICICSDefinitionReference<IURIMapDefinition>
getCICSObjectReference()
java.lang.String
getCiphers()
Getter for field CIPHERSjava.lang.String
getConverter()
Getter for field CONVERTERjava.lang.String
getHFSFile()
Getter for field HFSFILEjava.lang.String
getHost()
Getter for field HOSTjava.lang.String
getHostcodepage()
Getter for field HOSTCODEPAGEjava.lang.String
getLocation()
Getter for field LOCATIONjava.lang.String
getMediatype()
Getter for field MEDIATYPEICICSType<IURIMapDefinition>
getObjectType()
java.lang.String
getPath()
Getter for field PATHjava.lang.String
getPipeline()
Getter for field PIPELINEjava.lang.Long
getPort()
Getter for field PORTjava.lang.String
getProgram()
Getter for field PROGRAMIURIMapDefinition.RedirecttypeValue
getRedirecttype()
Getter for field REDIRECTTYPEIURIMapDefinition.SchemeValue
getScheme()
Getter for field SCHEMEjava.lang.String
getSocketclose()
Getter for field SOCKETCLOSEICICSEnums.EnablementValue
getStatus()
Getter for field STATUSjava.lang.String
getTcpipservice()
Getter for field TCPIPSERVICEjava.lang.String
getTemplateName()
Getter for field TEMPLATENAMEjava.lang.String
getTransaction()
Getter for field TRANSACTIONIURIMapDefinition.UsageValue
getUsage()
Getter for field USAGEjava.lang.String
getUserdata1()
Getter for field USERDATA1java.lang.String
getUserdata2()
Getter for field USERDATA2java.lang.String
getUserdata3()
Getter for field USERDATA3java.lang.String
getUserid()
Getter for field USERIDjava.lang.String
getWebservice()
Getter for field WEBSERVICE-
Methods inherited from interface com.ibm.cics.model.ICICSDefinition
getChangeAgentRelease, getChangeTime, getChangeUserID, getCICSContainer, getCreateTime, getCSDGroup, getDescription, getVersion
-
Methods inherited from interface com.ibm.cics.model.ICICSObject
getCICSType, getName
-
-
-
-
Method Detail
-
getObjectType
ICICSType<IURIMapDefinition> getObjectType()
- Specified by:
getObjectType
in interfaceICICSDefinition
- Specified by:
getObjectType
in interfaceICICSObject
- Specified by:
getObjectType
in interfaceIDefinition
- Specified by:
getObjectType
in interfacecom.ibm.cics.model.meta.ITypedObject
-
getChangeAgent
IURIMapDefinition.ChangeAgentValue getChangeAgent()
Getter for field CHANGEAGENTLast 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 USERDATA1User 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 USERDATA2User 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 USERDATA3User 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 STATUSEnabled 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 USAGEURI 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 SCHEMEScheme 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 HOSTHost 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 PATHPath 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 MEDIATYPEMedia 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 CHARACTERSETCharacter 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 HOSTCODEPAGECode 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 TEMPLATENAMEDocument 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 HFSFILEQualified 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 TCPIPSERVICEInbound 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 ANALYZERUse 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 CONVERTERConverter 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 TRANSACTIONAlias 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 PROGRAMApplication 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 PIPELINEPipeline 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 WEBSERVICEWeb 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 USERIDThe 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 CERTIFICATESSL 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 CIPHERSCipher 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 LOCATIONURI 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 REDIRECTTYPEType 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 PORTPort 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 ATOMSERVICEAtomservice 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 AUTHENTICATEAuthentication 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 SOCKETCLOSETime 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.
-
getCICSObjectReference
ICICSDefinitionReference<IURIMapDefinition> getCICSObjectReference()
- Specified by:
getCICSObjectReference
in interfaceICICSDefinition
- Specified by:
getCICSObjectReference
in interfaceICICSObject
- Specified by:
getCICSObjectReference
in interfaceIDefinition
-
-