Changes to CICS API

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.