Changes to JCICS API

This section summarizes the changes to the packages, classes, and methods of the CICS® Java™ class library (JCICS) API across supported CICS releases.
See also the list of deprecated packages, classes, fields, exceptions, and methods in Deprecated JCICS API of your CICS release:

If you are upgrading from an end-of-service release, you can find information about the changes that are relevant to those releases in Summary of changes from end-of-service releases.

Highlights of changes across supported releases of CICS TS

Table 1 lists new, changed, deprecated, and removed classes in each supported CICS TS release.

The links provided take you to the relevant tables below where brief descriptions of the changes to specific classes are provided.

Table 1. Highlights of JCICS API changes across supported CICS TS releases
5.6 6.1 6.2 6.3 CICS TS beta
DEPRECATED METHODS in class:
DEPRECATED CLASS:
  • ContainerIterator
REMOVED CLASSES:
  • AbendError
  • ILongHolder
  • TerminalPrincipalFacilityExtended
  • UnknownCicsError
NEW METHODS introduced to classes:
DEPRECATED METHODS in class:
REMOVED FIELD from classes:
REMOVED METHODS from classes:
CHANGED CLASS:
NEW METHODS introduced to classes:
CHANGED CLASS:
NEW CLASS:
NEW METHOD introduced to class:
  • writeOperator() method to Task class
REMOVED CLASSES:

Changes to JCICS API by release of CICS TS

See changes by class:
Note: Classes and methods that are removed in a particular release are already deprecated in a previous release.

API

5.6 6.1 6.2 6.3 CICS TS beta
 
NEW METHOD:
  • getCicsServerApiVersion()
      

AsyncService and AsyncServiceImpl

5.6 6.1 6.2 6.3 CICS TS beta
   
CHANGED METHOD:
  • runTransactionId()
    

Channel

5.6 6.1 6.2   CICS TS beta
 
DEPRECATED METHOD:
  • containterIterator()
NEW METHOD:
  • getContainerNames()
      

Container

5.6 6.1 6.2 6.3 CICS TS beta
 
REMOVED METHOD:
  • put(String stringData)
NEW METHOD:
  • exists()
NEW METHODS:
  • prepend(byte[] byteArrayData)
  • prepend(byte[] byteArrayData, java.lang.String fromCodePage)
  • prependString(java.lang.String stringData)
    

CommAreaHolder, CWAHolder, DataHolder, ItemHolder, KeyHolder, RecordHolder, TCTUAHolder and TWAHolder

5.6 6.1 6.2 6.3 CICS TS beta
 
REMOVED FIELD:
  • value
      

ESDS

5.6 6.1 6.2 6.3 CICS TS beta
      CHANGED METHODS:
  • read(long byteAddress, Record Holder holder)
  • readForUpdate(long byte Address, Record Holder holder)
  • rewrite(byte[] data)
  • startBrowse(long byteAddress)
  • write(byte[] data)
  • write(byte[] alternateKey, byte[] data)
  

ESDS_Browse

5.6 6.1 6.2 6.3 CICS TS beta
      CHANGED METHODS:
  • ESDS_Browse(String fileName, String sysId, long byteAddress, boolean XRBA)
  • next(long inputRBA, RecordHolder record)
  • next(RecordHolder record)
  • previous(long inputRBA, RecordHolder record)
  • previous(RecordHolder record)
  • reset(long inputRBA)
  

KSDS

5.6 6.1 6.2 6.3 CICS TS beta
      CHANGED METHODS:
  • delete()
  • delete(byte[] key)
  • deleteGeneric(byte[] key)
  • write(byte[] key, byte[] data)
  

KeyedFile

5.6 6.1 6.2 6.3 CICS TS beta
      CHANGED METHODS:
  • read(byte[] key, RecordHolder holder)
  • read(byte[] key, SearchType searchType, RecordHolder holder)
  • readForUpdate(byte[] key, RecordHolder holder)
  • readForUpdate(byte[] key, SearchType searchType, RecordHolder holder)
  • readGeneric(byte[] key, RecordHolder holder)
  • readGeneric(byte[] key, SearchType searchType, RecordHolder holder)
  • readGenericForUpdate(byte[] key, RecordHolder holder)
  • readGenericForUpdate(byte[] key, SearchType searchType, RecordHolder holder)
  • rewrite(byte[] data)
  • KeyedFileBrowse startBrowse(byte[] key)
  • KeyedFileBrowse startBrowse(byte[] key, SearchType searchType)
  • KeyedFileBrowse startGenericBrowse(byte[] key, int fullKeyLength)
  • KeyedFileBrowse startGenericBrowse(byte[] key, int fullKeyLength, SearchType searchType)
  

KeyedFileBrowse

5.6 6.1 6.2 6.3 CICS TS beta
      CHANGED METHODS:
  • KeyedFileBrowse(String fileName, String sysId, int currentTaskId, byte[] key, int fullKeyLength, boolean generic, int searchType)
  • next(byte[] inputKey, RecordHolder record, KeyHolder outputKey)
  • next(RecordHolder record, KeyHolder outputKey)
  • previous(byte[] inputKey, RecordHolder record, KeyHolder outputKey)
  • previous(RecordHolder record, KeyHolder outputKey)
  • reset(byte[] key)
  • reset(final byte[] key, final SearchType theSearchType)
  • reset(byte[] key, boolean generic)
  • reset(final byte[] key, final boolean generic, final SearchType theSearchType)
  

RRDS

5.6 6.1 6.2 6.3 CICS TS beta
      CHANGED METHODS:
  • delete()
  • delete(long recordNumber)
  • read(long recordNumber, RecordHolder record)
  • readForUpdate(long recordNumber, RecordHolder record)
  • rewrite(byte[] data)
  • RRDS_Browse startBrowse(long recordNumber) write(long recordNumber, byte[] data)
  

RRDS_Browse

5.6 6.1 6.2 6.3 CICS TS beta
      CHANGED METHODS:
  • next(long inputRRN, RecordHolder record)
  • next(RecordHolder record)
  • previous(long inputRRN, RecordHolder record)
  • previous(RecordHolder record)
  • reset(long inputRRN)
  

Program

5.6 6.1 6.2 6.3 CICS TS beta
 
REMOVED METHODS:
  • link(com.ibm.record.IByteBuffer)
  • link(com.ibm.record.IByteBuffer, com.ibm.record.IByteBuffer)
      

Task

5.6 6.1 6.2 6.3 CICS TS beta
 
DEPRECATED FIELDS:
  • err
  • fixedErrForJVMLifetime
  • fixedOutForJVMLifetime
  • out
DEPRECATED METHOD:
  • getQNAME()
REMOVED METHODS:
  • disableTaskTrace()
  • enableTaskTrace()
NEW METHOD:
  • getStartCode()
  
NEW METHOD:
  • void writeOperator(java.lang.String data)
  

CICSSecurityManager

5.6 6.1 6.2 6.3 CICS TS beta
DEPRECATED METHODS:
  • checkAwtEventQueueAccess()
  • checkMemberAccess(Class<?> theClass, int)
  • checkSystemClipboardAccess()
  • checkTopLevelWindow(Object window)
REMOVED METHODS:
  • checkMultiCast(InetAddress, byte)
  • checkAwtEventQueueAccess()
  • checkMemberAccess(Class<?> theClass, int)
  • checkSystemClipboardAccess()
  • checkTopLevelWindow(Object window)
     This class is removed.

TerminalPrincipalFacility

5.6 6.1 6.2 6.3 CICS TS beta
 
REMOVED METHOD:
  • waitTerminal()
      

HttpHeader

5.6 6.1 6.2 6.3 CICS TS beta
 
REMOVED METHOD:
  • getHeader
      

IsCICS

5.6 6.1 6.2 6.3 CICS TS beta
 
NEW METHOD:
  • getApiStatus(boolean lateBind)
      

Security

5.6 6.1 6.2 6.3 CICS TS beta
     
KEY METHODS:
  • public static VerifyPhraseResponse verifyPhrase(java.lang.String userId, char[] phrase)
  • public static VerifyPhraseResponse verifyPhrase(java.lang.String userId, char[] phrase, java.lang.String groupId)
  

VerifyPhraseResponse

5.6 6.1 6.2 6.3 CICS TS beta
     
NEW METHODS:

The VerifyPhraseResponse class is a data holder object returned from making a Security.verifyPhrase() call. It contains status and data about the call that was made.