Changes to CICS API

This section summarizes the changes to the CICS® application interface of EXEC CICS commands across supported CICS releases. Use this information to plan the impact on applications of upgrading from one release to another.

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.

Table 1. Highlights of CICS API changes across supported releases of CICS TS
5.6 6.1 6.2 CICS TS 6.3
NEW: None NEW: None NEW: None NEW: None
CHANGED: CHANGED: CHANGED:
CHANGED (EXCI):
CHANGED:

Changes to EXEC CICS commands and macros, by release of CICS TS

View changes by command or macro:

ASSIGN
5.6 6.1 6.2 CICS TS 6.3
  NEW OPTION:
  • GMEXITOPT
    
CHANGE PASSWORD
5.6 6.1 6.2 CICS TS 6.3

CHANGED with APAR PH23078: New NOTAUTH with RESP2 value of 1

CHANGED with APAR PH31270: New NOTAUTH with RESP2 value of 17

CHANGED with APAR PH51378: New INVREQ with RESP2 value of 32

CHANGED with APAR PH59546: New options added:
  • CHANGETIME
  • DAYSLEFT
  • EXPIRYTIME
  • INVALIDCOUNT
  • LASTUSETIME
 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 with APAR PH59547: New options added:
  • CHANGETIME
  • DAYSLEFT
  • EXPIRYTIME
  • INVALIDCOUNT
  • LASTUSETIME

CHANGED: New INVREQ with RESP2 value of 32.

NEW OPTIONS:
  • CHANGETIME
  • DAYSLEFT
  • EXPIRYTIME
  • INVALIDCOUNT
  • LASTUSETIME
  
CHANGE PHRASE
5.6 6.1 6.2 CICS TS 6.3

CHANGED with APAR PH23078: New NOTAUTH with RESP2 value of 1

CHANGED with APAR PH31270: New NOTAUTH with RESP2 value of 17

CHANGED with APAR PH51378: New INVREQ with RESP2 value of 32

CHANGED with APAR PH59546: New options added:
  • CHANGETIME
  • DAYSLEFT
  • EXPIRYTIME
  • INVALIDCOUNT
  • LASTUSETIME
 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 with APAR PH59547: New options added:
  • CHANGETIME
  • DAYSLEFT
  • EXPIRYTIME
  • INVALIDCOUNT
  • LASTUSETIME

CHANGED: New INVREQ with RESP2 value of 32.

NEW OPTIONS:
  • CHANGETIME
  • DAYSLEFT
  • EXPIRYTIME
  • INVALIDCOUNT
  • LASTUSETIME
  
DEFINE TIMER
5.6 6.1 6.2 CICS TS 6.3
      CHANGED:

New upper limit of 2110 for YEAR option.
ENDBR
5.6 6.1 6.2 CICS TS 6.3
    THREADSAFE: The command is threadsafe if it refers to a shared data table.  
GETMAIN
5.6 6.1 6.2 CICS TS 6.3
  NEW OPTION:
  • EXECUTABLE
    
GETMAIN64
5.6 6.1 6.2 CICS TS 6.3
  NEW OPTION:
  • EXECUTABLE
    
INVOKE SERVICE
5.6 6.1 6.2 CICS TS 6.3

CHANGED with APAR PH61670: It is possible to automatically redirect the HTTP response to the information contained in DFHWS-LOCATION.

CHANGED with APAR PH63742: It is possible to automatically redirect the HTTP response to the information contained in DFHWS-LOCATION.

CHANGED with APAR PH63742: It is possible to automatically redirect the HTTP response to the information contained in DFHWS-LOCATION.

 CHANGED:

It is possible to automatically redirect the HTTP response to the information contained in DFHWS-LOCATION.
PUT CONTAINER (CHANNEL)
5.6 6.1 6.2 CICS TS 6.3
    NEW OPTION: PREPEND  
PUT CONTAINER (EXCI)
5.6 6.1 6.2 CICS TS 6.3
    NEW OPTION: PREPEND  
PUT64 CONTAINER
5.6 6.1 6.2 CICS TS 6.3
    NEW OPTION: PREPEND  
QUERY SECURITY
5.6 6.1 6.2 CICS TS 6.3
    CHANGED:
  • Enhanced protection. Monitoring and statistics are recorded for this command.
  • New INVREQ with RESP2 value of 13.
  
READ
5.6 6.1 6.2 CICS TS 6.3
    THREADSAFE: The command is threadsafe if it refers to a shared data table and the UPDATE option is not specified.  
READNEXT
5.6 6.1 6.2 CICS TS 6.3
    THREADSAFE: The command is threadsafe if it refers to a shared data table and the UPDATE option is not specified.  
READPREV
5.6 6.1 6.2 CICS TS 6.3
    THREADSAFE: The command is threadsafe if it refers to a shared data table and the UPDATE option is not specified.  
RESETBR
5.6 6.1 6.2 CICS TS 6.3
    THREADSAFE: The command is threadsafe if it refers to a shared data table.  
RUN TRANSID
5.6 6.1 6.2 CICS TS 6.3
    CHANGED:

New condition NOSTART with RESP2 value of 1

  
SIGNON
5.6 6.1 6.2 CICS TS 6.3
    NEW OPTIONS:
  • CHANGETIME
  • DAYSLEFT
  • EXPIRYTIME
  • INVALIDCOUNT
  • LASTUSETIME
  
START ATTACH
5.6 6.1 6.2 CICS TS 6.3
    CHANGED:

New condition NOSTART with RESP2 value of 1

  
START BREXIT
5.6 6.1 6.2 CICS TS 6.3
    CHANGED:

New condition NOSTART with RESP2 value of 1

  
START CHANNEL
5.6 6.1 6.2 CICS TS 6.3
  NEW OPTIONS:
  • NOCHECK
  • PROTECT
    
STARTBR
5.6 6.1 6.2 CICS TS 6.3
    THREADSAFE: The command is threadsafe if it refers to a shared data table.  
VERIFY PASSWORD
5.6 6.1 6.2 CICS TS 6.3

CHANGED with APAR PH23078: New NOTAUTH with RESP2 value of 1

CHANGED with APAR 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.6 6.1 6.2 CICS TS 6.3
CHANGED with APAR:

CHANGED with APAR PH23078: New NOTAUTH with RESP2 value of 1

CHANGED with APAR 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.6 6.1 6.2 CICS TS 6.3
CHANGED:

Enhanced to support JSON Web Tokens (JWTs) provided by RACF®.

      
WEB CONVERSE
5.6 6.1 6.2 CICS TS 6.3
CHANGED:

The PATCH method is supported.

      
WEB OPEN
5.6 6.1 6.2 CICS TS 6.3
  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.

  

NOT SUPPORTED:

The options for CIPHERS and NUMCIPHERS are no longer supported. The options are ignored and defaultciphers.xml is used instead with a warning message (DHWB0768).
WEB SEND (Client)
5.6 6.1 6.2 CICS TS 6.3
CHANGED:

The PATCH method is supported.

      
WRITE OPERATOR
5.6 6.1 6.2 CICS TS 6.3
  NEW OPTION: CONSNAME

CHANGED:

New INVREQs with RESP2 values of 7 and 8

New ERROR with RESP2 value of 1

    
WRITEQ TD
5.6 6.1 6.2 CICS TS 6.3
    CHANGED:

New NOTAUTH with RESP2 value of 103.

  
DFHEIENT macro
5.6 6.1 6.2 CICS TS 6.3
  NEW OPTION:

DATA_EXECUTABLE to request that dynamic storage is not protected from instruction execution.