Changes to CICS SPI

This section summarizes the changes to system programming interface commands across supported CICS® releases.

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, or removed SPI commands in each supported CICS TS release.

The links that are provided for new commands take you to their reference information in the product documentation.

The links that are provided for changed commands take you to the relevant tables below where brief descriptions of the changes are provided.

Tag Service indicates external changes introduced by service APARs.

Table 1. Highlights of CICS SPI changes across supported releases of CICS TS
5.5	5.6	6.1	6.2
NEW: INQUIRE FEATUREKEY INQUIRE NODEJSAPP	NEW: CREATE DUMPCODE PERFORM JVMSERVER	NEW: INQUIRE POLICY INQUIRE POLICYRULE INQUIRE SECRECORDING INQUIRE STORAGE64 THREADSAFE INQUIRE TAG SET ASSOCIATION USERCORRDATA SET SECRECORDING SET TAGS REFRESH	NEW: INQUIRE SECDISCOVERY THREADSAFE SET SECDISCOVERY THREADSAFE PERFORM SECDISCOVERY WRITE THREADSAFE
CHANGED: EXTRACT STATISTICS INQUIRE CFDTPOOL THREADSAFE INQUIRE ASSOCIATION Service INQUIRE CONNECTION INQUIRE MONITOR INQUIRE NETNAME INQUIRE SYSTEM INQUIRE TERMINAL INQUIRE WEBSERVICE INQUIRE XMLTRANSFORM PERFORM SHUTDOWN PERFORM STATISTICS SET CONNECTION SET MONITOR SET TASK	CHANGED: DISCARD TRANSACTION EXTRACT STATISTICS INQUIRE ASSOCIATION Service INQUIRE DUMPDS INQUIRE SYSDUMPCODE INQUIRE SYSTEM INQUIRE TCPIPSERVICE INQUIRE TRANDUMPCODE INQUIRE TSQUEUE / TSQNAME PERFORM STATISTICS SET DUMPDS SET SYSTEM SET TRANSACTION	CHANGED: CREATE DB2ENTRY ENABLE PROGRAM EXTRACT STATISTICS INQUIRE ASSOCIATION INQUIRE DB2ENTRY INQUIRE FEATUREKEY INQUIRE STORAGE INQUIRE SUBPOOL INQUIRE SYSTEM INQUIRE TASK PERFORM STATISTICS SET DB2ENTRY SET SYSTEM SET TASK SET TRANSACTION	CHANGED: COLLECT STATISTICS CREATE TRANSACTION EXTRACT STATISTICS INQUIRE SYSTEM INQUIRE TERMINAL INQUIRE TRANCLASS PERFORM SHUTDOWN SET TRANCLASS

Changes to CICS SPI commands by release of CICS TS

View changes by command:

COLLECT STATISTICS

5.5	5.6	6.1	6.2
			CHANGED: New NOTFND with RESP2 value of 3, which indicates that the performance class data for a task is not available. This new NOTFND with RESP2 value of 3 replaces the previous NOTFND with RESP2 value of 1 when the performance class data for a task is not available.

CREATE DB2ENTRY

5.5	5.6	6.1	6.2
		NEW OPTION: SHARELOCKS

CREATE TRANSACTION

5.5	5.6	6.1	6.2
			CHANGED: The default values of CMDSEC and RESSEC are changed to YES.

DISCARD TRANSACTION

5.5	5.6	6.1	6.2
	CHANGED: Transactions beginning with C can now be discarded as long as the name of the initial program does not begin with DFH, EYU, or CJ`x` (where `x` is A through J).

ENABLE PROGRAM

5.5	5.6	6.1	6.2
		NEW OPTIONS: GAEXECUTABLE TAEXECUTABLE

EXTRACT STATISTICS

5.5	5.6	6.1	6.2
NEW OPTION: NODEJSAPP	NEW OPTIONS: SECURITY USER	NEW OPTION: POLICY with new SUBRESTYPE option POLICYRULE	CHANGED: New NOTFND with RESP2 value of 3, which indicates that the performance class data for a task is not available. This new NOTFND with RESP2 value of 3 replaces the previous NOTFND with RESP2 value of 1 when the performance class data for a task is not available.

INQUIRE ASSOCIATION

5.5	5.6	6.1	6.2
CHANGED with APAR PH42306: Enhanced support for Liberty. The association data user ID value now reflects the final user ID value used in secure Liberty transactions, instead of the initial user ID.	CHANGED with APAR PH42306: Enhanced support for Liberty. The association data user ID value now reflects the final user ID value used in secure Liberty transactions, instead of the initial user ID.	CHANGED: Enhanced support for Liberty. The association data user ID value now reflects the final user ID value used in secure Liberty transactions, instead of the initial user ID.

INQUIRE CONNECTION

5.5	5.6	6.1	6.2
NEW OPTION: AIDCOUNT CHANGED: CONNECTION (`data-value`) now accepts the name of the local system. New CVDA value DYNAMIC added to options CHANGEAGENT and INSTALLAGENT. New CVDA value NOTAPPLIC added to options ACCESSMETHOD and SERVSTATUS.

5.5

5.6

6.1

6.2

NEW OPTION: AIDCOUNT

CHANGED:

CONNECTION (data-value) now accepts the name of the local system.

New CVDA value DYNAMIC added to options CHANGEAGENT and INSTALLAGENT.

New CVDA value NOTAPPLIC added to options ACCESSMETHOD and SERVSTATUS.

INQUIRE DB2ENTRY

5.5	5.6	6.1	6.2
		NEW OPTION: SHARELOCKS

INQUIRE DUMPDS

5.5	5.6	6.1	6.2
	CHANGED: New cvda SWITCHALL on SWITCHSTATUS option

INQUIRE FEATUREKEY

5.5	5.6	6.1	6.2
NEW: Retrieves the value of a feature toggle.		NEW OPTION: FILEPATH

INQUIRE MONITOR

5.5	5.6	6.1	6.2
NEW OPTIONS: URIMAPLIMIT WEBSERVLIMIT

INQUIRE NETNAME

5.5	5.6	6.1	6.2
NEW OPTIONS: TNADDR TNIPFAMILY TNPORT

INQUIRE STORAGE

5.5	5.6	6.1	6.2
		CHANGED: New values PCSDSA, EPCDSA, PUDSA, and EPUDSA on the DSANAME option

INQUIRE SUBPOOL

5.5	5.6	6.1	6.2
		CHANGED: New values PCSDSA, EPCDSA, PUDSA, and EPUDSA on the DSANAME option. ETDSA is removed.

INQUIRE SYSDUMPCODE

5.5	5.6	6.1	6.2
	NEW OPTIONS: CHANGEAGENT CHANGEAGREL CHANGETIME CHANGEUSRID DEFINESOURCE DEFINETIME INSTALLAGENT INSTALLTIME INSTALLUSRID

INQUIRE SYSTEM

5.5	5.6	6.1	6.2
NEW OPTIONS: AIDCOUNT LASTCOLDTIME LASTEMERTIME LASTINITTIME LASTWARMTIME PLTPIUSR	CHANGED: New value TABLEONLY returned for DUMPING option	NEW OPTIONS: EPCDSA EPUDSA PCSDSA PUDSA SDTMEMLIMIT SRRTASKS REMOVED OPTION: ETDSA	NEW OPTION: GRPLIST

5.5

5.6

6.1

6.2

NEW OPTIONS:

AIDCOUNT
LASTCOLDTIME
LASTEMERTIME
LASTINITTIME
LASTWARMTIME
PLTPIUSR

CHANGED:

New value TABLEONLY returned for DUMPING option

NEW OPTIONS:

EPCDSA
EPUDSA
PCSDSA
PUDSA
SDTMEMLIMIT
SRRTASKS

REMOVED OPTION: ETDSA

NEW OPTION: GRPLIST

INQUIRE TASK

5.5	5.6	6.1	6.2
		CHANGED: New SRRSTATUS option to show the security request recording status of SRRACTIVE or SRRINACTIVE.

INQUIRE TCPIPSERVICE

5.5	5.6	6.1	6.2
	NEW OPTION: OPTIONSPGM

INQUIRE TERMINAL

5.5	5.6	6.1	6.2
NEW OPTIONS: TNADDR TNIPFAMILY TNPORT			NEW OPTION: TNHOST

INQUIRE TRANCLASS

5.5	5.6	6.1	6.2
			NEW OPTION: PURGEACTION

INQUIRE TRANDUMPCODE

5.5	5.6	6.1	6.2
	NEW OPTIONS: CHANGEAGENT CHANGEAGREL CHANGETIME CHANGEUSRID DEFINESOURCE DEFINETIME INSTALLAGENT INSTALLTIME INSTALLUSRID

INQUIRE TSQUEUE / TSQNAME

5.5	5.6	6.1	6.2
	NEW OPTION: TSMODEL

INQUIRE WEBSERVICE

5.5	5.6	6.1	6.2
CHANGED: MAPPINGLEVEL and MINRUNLEVEL now accept 4.2 and 4.3.

INQUIRE XMLTRANSFORM

5.5	5.6	6.1	6.2
CHANGED: MAPPINGLEVEL and MINRUNLEVEL now accept 4.2 and 4.3

PERFORM SHUTDOWN

5.5	5.6	6.1	6.2
NEW OPTION: PLTNAME			CHANGED: PERFORM SHUTDOWN and PERFORM SHUTDOWN IMMEDIATE enhanced to support the shutdown of CMAS and MAS regions.

PERFORM STATISTICS

5.5	5.6	6.1	6.2
NEW OPTIONS: NODEJSAPP POLICY	NEW OPTIONS: SECURITY USER	NEW OPTION: CIPHER

SET CONNECTION

5.5	5.6	6.1	6.2
CHANGED: CONNECTION (`data-value`) now accepts the name of the local system. For the local system entry, the only valid options are CANCEL and FORCECANCEL.

SET DB2ENTRY

5.5	5.6	6.1	6.2
		NEW OPTION: SHARELOCKS CHANGED: New INVREQ RESP2 value of 20

SET DUMPDS

5.5	5.6	6.1	6.2
	CHANGED: New CVDA, SWITCHALL on SWITCHSTATUS option

SET MONITOR

5.5	5.6	6.1	6.2
NEW OPTIONS: URIMAPLIMIT WEBSERVLIMIT

SET SYSTEM

5.5	5.6	6.1	6.2
	CHANGED: New value TABLEONLY supported for DUMPING option.	NEW OPTION: SDTMEMLIMIT

SET TASK

5.5	5.6	6.1	6.2
CHANGED: CICS processing of a task purge or forcepurge request is enhanced to ensure that a Db2® cancel thread command is issued to cancel a thread that is active in Db2 at the time the task that is using the thread is purged or forcepurged.		CHANGED: New SRRSTATUS option to set the security request recording status to SRRACTIVE or SRRINACTIVE.

SET TRANCLASS

5.5	5.6	6.1	6.2
			NEW OPTION: PURGEACTION New INVREQ RESP2 value of 4, indicating that PURGEACTION has an invalid value.

SET TRANSACTION

5.5	5.6	6.1	6.2
	CHANGED: Transactions beginning with C can now be set disabled as long as the name of the initial program does not begin with DFH, EYU, or CJ`x` (where `x` is A through J).

SET XMLTRANSFORM

5.5	5.6	6.1	6.2
		CHANGED: New INVREQ RESP2 value of 8, indicating that the XML schema file for the XMLTRANSFORM cannot be found.