Changes to CICS API
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 and changed CICS API commands and macros in each supported CICS TS release.
The links provided for new commands take you to their reference information in the product documentation.
The links provided for changed commands and macros take you to the relevant tables below where brief descriptions of the changes are provided.
Tag Service indicates external changes introduced by service APARs.
Changes to EXEC CICS commands and macros, by release of CICS TS
View changes by command or macro:
- ASSIGN
-
5.5 5.6 6.1 6.2 NEW OPTIONS: - LOCALCCSID
- TNADDR
- TNIPFAMILY
- TNPORT
NEW OPTION: - GMEXITOPT
- CHANGE PASSWORD
-
5.5 5.6 6.1 6.2 CHANGED with APAR: PH23078: New NOTAUTH with RESP2 value of 1
PH31270: New NOTAUTH with RESP2 value of 17
CHANGED with APAR: PH23078: New NOTAUTH with RESP2 value of 1
PH31270: New NOTAUTH with RESP2 value of 17
PH51378: New INVREQ with RESP2 value of 32.
CHANGED: New NOTAUTH with RESP2 value of 1
New NOTAUTH with RESP2 value of 17
CHANGED with APAR:
PH51378: New INVREQ with RESP2 value of 32.
CHANGED: New INVREQ with RESP2 value of 32.
NEW OPTIONS:- CHANGETIME
- DAYSLEFT
- EXPIRYTIME
- INVALIDCOUNT
- LASTUSETIME
- CHANGE PHRASE
-
5.5 5.6 6.1 6.2 CHANGED with APAR: PH23078: New NOTAUTH with RESP2 value of 1
PH31270: New NOTAUTH with RESP2 value of 17
CHANGED with APAR: PH23078: New NOTAUTH with RESP2 value of 1
PH31270: New NOTAUTH with RESP2 value of 17
PH51378: New INVREQ with RESP2 value of 32.
CHANGED: New NOTAUTH with RESP2 value of 1
New NOTAUTH with RESP2 value of 17
CHANGED with APAR:
PH51378: New INVREQ with RESP2 value of 32.
CHANGED: New INVREQ with RESP2 value of 32.
NEW OPTIONS:- CHANGETIME
- DAYSLEFT
- EXPIRYTIME
- INVALIDCOUNT
- LASTUSETIME
- DELAY
-
5.5 5.6 6.1 6.2 CHANGED: New condition NORMAL with RESP2 value 23 - DELETE
-
5.5 5.6 6.1 6.2 THREADSAFE: The command is threadsafe if it refers to a coupling facility data table. - ENDBR
-
5.5 5.6 6.1 6.2 THREADSAFE: The command is threadsafe if it refers to a coupling facility data table. THREADSAFE: The command is threadsafe if it refers to a shared data table. - FREEMAIN
-
5.5 5.6 6.1 6.2 CHANGED: New INVREQ with RESP2 value of 3 - FREEMAIN64
-
5.5 5.6 6.1 6.2 CHANGED: New INVREQ with RESP2 value of 3 - GETMAIN
-
5.5 5.6 6.1 6.2 NEW OPTION: - EXECUTABLE
- GETMAIN64
-
5.5 5.6 6.1 6.2 NEW OPTION: - EXECUTABLE
- GETNEXT CONTAINER (CHANNEL)
-
5.5 5.6 6.1 6.2 CHANGED: The order in which containers are returned is changed. - PUT CONTAINER (CHANNEL)
-
5.5 5.6 6.1 6.2 NEW OPTION: PREPEND - PUT CONTAINER (EXCI)
-
5.5 5.6 6.1 6.2 NEW OPTION: PREPEND - PUT64 CONTAINER
-
5.5 5.6 6.1 6.2 NEW OPTION: PREPEND - QUERY SECURITY
-
5.5 5.6 6.1 6.2 CHANGED: Performance improvement. The number of TCB switches has been reduced if more than one access level is specified on the command. NEW OPTION: USERID
CHANGED: - Enhanced protection. Monitoring and statistics are recorded for this command.
- New INVREQ with RESP2 value of 13.
- READ
-
5.5 5.6 6.1 6.2 THREADSAFE: The command is threadsafe if it refers to a coupling facility data table. THREADSAFE: The command is threadsafe if it refers to a shared data table and the UPDATE option is not specified. - READNEXT
-
5.5 5.6 6.1 6.2 THREADSAFE: The command is threadsafe if it refers to a coupling facility data table. THREADSAFE: The command is threadsafe if it refers to a shared data table and the UPDATE option is not specified. - READPREV
-
5.5 5.6 6.1 6.2 THREADSAFE: The command is threadsafe if it refers to a coupling facility data table. THREADSAFE: The command is threadsafe if it refers to a shared data table and the UPDATE option is not specified. - RECEIVE
-
5.5 5.6 6.1 6.2 CHANGED: The command behavior after a TERMERR condition is changed. Any action, other than a FREE, on the conversation that caused the TERMERR condition results in another TERMERR condition instead of an ATCV abend. - RESETBR
-
5.5 5.6 6.1 6.2 THREADSAFE: The command is threadsafe if it refers to a coupling facility data table. THREADSAFE: The command is threadsafe if it refers to a shared data table. - REWRITE
-
5.5 5.6 6.1 6.2 THREADSAFE: The command is threadsafe if it refers to a coupling facility data table. - RUN TRANSID
-
5.5 5.6 6.1 6.2 CHANGED: New condition NOSTART with RESP2 value of 1 - SEND
-
5.5 5.6 6.1 6.2 CHANGED: The command behavior after a TERMERR condition is changed. Any action, other than a FREE, on the conversation that caused the TERMERR condition results in another TERMERR condition instead of an ATCV abend. - SIGNON
-
5.5 5.6 6.1 6.2 NEW OPTIONS: - CHANGETIME
- DAYSLEFT
- EXPIRYTIME
- INVALIDCOUNT
- LASTUSETIME
- SPOOLWRITE
-
5.5 5.6 6.1 6.2 CHANGED: New NOTAUTH with RESP2 value of 1 - START
-
5.5 5.6 6.1 6.2 CHANGED: - New condition INVREQ with RESP2 value 400®
- If the transaction to be started is defined as dynamic, the distributed router will be invoked
only if a valid distributed routing program name is specified. If omitted, the
DSRTPGM system initialization parameter assumes a value of NONE by default, and
the distributed router is not invoked; while in previous releases the START
command invoked the IBM®-supplied routing program DFHDSRP.
If the transaction is defined with DYNAMIC(YES), then it is eligible for dynamic routing without the need to specify ROUTABLE(YES).
- START ATTACH
-
5.5 5.6 6.1 6.2 CHANGED: New condition NOSTART with RESP2 value of 1 - START BREXIT
-
5.5 5.6 6.1 6.2 CHANGED: New condition NOSTART with RESP2 value of 1 - START CHANNEL
-
5.5 5.6 6.1 6.2 NEW OPTIONS: - NOCHECK
- PROTECT
- STARTBR
-
5.5 5.6 6.1 6.2 THREADSAFE: The command is threadsafe if it refers to a coupling facility data table. THREADSAFE: The command is threadsafe if it refers to a shared data table. - STARTBROWSE CONTAINER (CHANNEL)
-
5.5 5.6 6.1 6.2 CHANGED: The order in which containers are returned is changed. - VERIFY PASSWORD
-
5.5 5.6 6.1 6.2 NEW OPTION: GROUPID CHANGED with APAR:
PH23078: New NOTAUTH with RESP2 value of 1
PH31270: New NOTAUTH with RESP2 value of 17
CHANGED with APAR: PH23078: New NOTAUTH with RESP2 value of 1
PH31270: New NOTAUTH with RESP2 value of 17
CHANGED: New NOTAUTH with RESP2 value of 1
New NOTAUTH with RESP2 value of 17
- VERIFY PHRASE
-
5.5 5.6 6.1 6.2 CHANGED: New option: GROUPID CHANGED with APAR:
PH23078: New NOTAUTH with RESP2 value of 1
PH31270: New NOTAUTH with RESP2 value of 17
CHANGED with APAR: PH23078: New NOTAUTH with RESP2 value of 1
PH31270: New NOTAUTH with RESP2 value of 17
CHANGED: New NOTAUTH with RESP2 value of 1
New NOTAUTH with RESP2 value of 17
- VERIFY TOKEN
-
5.5 5.6 6.1 6.2 CHANGED: Enhanced to support JSON Web Tokens (JWTs) provided by RACF®. - WEB CONVERSE
-
5.5 5.6 6.1 6.2 CHANGED: The body of an HTTP client request can be received into, and sent from, 64-bit (above-the-bar) storage. CHANGED with APAR PH25067: The PATCH method is supported.
CHANGED: The PATCH method is supported. - WEB OPEN
-
5.5 5.6 6.1 6.2 CHANGED: WEB OPEN URIMAP uses the cached IP address and HTTP information obtained with the initial connection, for subsequent outbound web requests using the same URIMAP. DEPRECATED: CIPHERS option no longer allowed on new compiles. The CIPHERS option is deprecated for existing programs when MAXTLSLEVEL is TLS12 and ignored for existing programs when MAXTLSLEVEL is TLS13.
- WEB RECEIVE (Client)
-
5.5 5.6 6.1 6.2 CHANGED: The body of an HTTP client request can be received into 64-bit storage. - WEB SEND (Client)
-
5.5 5.6 6.1 6.2 CHANGED: The body of an HTTP client response can be sent from 64-bit storage. CHANGED with APAR PH25067: The PATCH method is supported.
CHANGED: The PATCH method is supported. - WRITE
-
5.5 5.6 6.1 6.2 THREADSAFE: The command is threadsafe if it refers to a coupling facility data table. - WRITE OPERATOR
-
5.5 5.6 6.1 6.2 NEW OPTION: CONSNAME CHANGED:
New INVREQs with RESP2 values of 7 and 8
New ERROR with RESP2 value of 1
- WRITEQ TD
-
5.5 5.6 6.1 6.2 CHANGED: New NOTAUTH with RESP2 value of 102 CHANGED: New NOTAUTH with RESP2 value of 103. - DFHEIENT macro
-
5.5 5.6 6.1 6.2 NEW OPTION: DATA_EXECUTABLE to request that dynamic storage is not protected from instruction execution.