Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods

Deprecated Interfaces

Interface and Description
com.ibm.cics.server.pipeline.ApplicationHandler You are encouraged to use the Java API for XML Web Services (JAX-WS) facilities in the Liberty JVM server.

Deprecated Classes

Class and Description
com.ibm.cics.server.CicsSecurityManager in CICS TS v6.3 (JCICS v2.200). This class will be removed in a future version of the API.
com.ibm.cics.server.ContainerIterator This class is deprecated in CICS TS version 6.1, and may be removed in future versions of CICS. The functionality it provides is duplicated by using the Channel.getContainerNames() method to get the names of containers, and then using Channel.getContainer(java.lang.String,boolean) (with existence checking false), to get the container object. This new mechanism performs faster than using a ContainerIterator.
com.ibm.cics.server.Message class deprecated at release 6.1. Will be removed at next release

Deprecated Exceptions

Exceptions and Description
com.ibm.cics.server.TransferOfControlException Program.xctl() was removed in CICS TS v5.3.

Deprecated Fields

Field and Description
com.ibm.cics.server.Task.err in 6.1 Direct access to this data member is not recommended and will be removed in future releases. Use Task.setErr( PrintWriter ) or Task.getErr() instead.
com.ibm.cics.server.Task.fixedErrForJVMLifetime in 6.1 Direct access to this data member is not recommended and will be removed in future releases. Use Task.setFixedErrForJVMLifetime( PrintWriter ) or Task.getFixedErrForJVMLifetime() instead.
com.ibm.cics.server.Task.fixedOutForJVMLifetime in 6.1 Direct access to this data member is not recommended and will be removed in future releases. Use Task.setFixedOutForJVMLifetime( PrintWriter ) or Task.getFixedOutForJVMLifetime() instead.
com.ibm.cics.server.Task.out in 6.1 Direct access to this data member is not recommended and will be removed in future releases. Use Task.setOut( PrintWriter ) or Task.getOut() instead.

Deprecated Methods

Method and Description
com.ibm.cics.server.Channel.containerIterator() Deprecated in CICS TS version 6.1. Use the Channel.getContainerNames() method instead, followed by Channel.getContainer(java.lang.String,boolean) (with the existence checking flag having a value of false).
com.ibm.cics.server.Task.containerIterator() This call is deprecated in CICS TS v6.1 and may be removed in future releases of CICS TS. Applications should replace uses of this method with Task.getCurrentChannel(), and if that returns a non-null Channel object, use the Channel.getContainerNames() method. Use the Channel.getContainer(java.lang.String,boolean) method with the boolean existence checking value of false to turn the container name into a Container object.
com.ibm.cics.server.Region.disableTrace() since CICS 6.1. This method has been disabled in previous releases and will be removed entirely in a future release of CICS.
com.ibm.cics.server.Region.disableTrace(BitSet) since CICS 6.1. This method has been disabled in previous releases and will be removed entirely in a future release of CICS.
com.ibm.cics.server.Region.enableTrace() since CICS 6.1. This method has been disabled in previous releases and will be removed entirely in a future release of CICS.
com.ibm.cics.server.Region.enableTrace(BitSet) since CICS 6.1. This method has been disabled in previous releases and will be removed entirely in a future release of CICS.
com.ibm.cics.server.ApplicationContext.getApplication() Use ApplicationContext.getApplicationName().
com.ibm.cics.server.ContainerIterator.getOwner() As of release 6.1, replaced by the more strongly-typed equivalent ContainerIterator.getChannel()
com.ibm.cics.server.Task.getQNAME() in 6.1 This method has never worked, always returned null. It will be removed in a future release of CICS.
com.ibm.cics.server.Task.getSTARTCODE() in 6.1. Use Task.getStartCode() instead. This method will be removed in future releases of CICS.
com.ibm.cics.server.Document.retrieve(String, boolean) in 6.3 - characterSet does not apply to a DATAONLY retrieve
com.ibm.cics.server.TerminalPrincipalFacility.waitTerminal() All methods operating on this class are synchronous so there is no need to wait for them to complete.
com.ibm.cics.server.Message.write(int, int, String, String, String, String, String) write method deprecated at release 6.1. Will be removed at next release