Obsolete commands and options

Table 19 shows the system programming interface commands and options that are now obsolete.

Table 19. Obsolete system programming commands and options
Command Options Comments / Explanation
CREATE CORBASERVER
PORT
SSL
SSLPORT
These port-related options, introduced in CICS® TS 2.1, are obsolete, and at run-time CICS ignores them. If you attempt to translate a program with these options, the translation succeeds, but the CICS translator ignores them with return code 4 and a warning message stating that they are obsolete.
CREATE PROGRAM
HOTPOOL
The CVDA values YES and NO were used with this option to specify whether or not the Java™ program object was to be run in a preinitialized Language Environment® enclave.
CREATE TYPETERM XRFSIGNOFF This XRF-specific attribute is replaced by RSTSIGNOFF, which acts for either signon retention for VTAM® persistent sessions or XRF. See Signon retention with XRF and VTAM persistent sessions for migration impact.
INQUIRE CORBASERVER
PORT
SSL
SSLPORT
 
STATE

The options PORT SSL AND SSLPORT , introduced in CICS TS 2.1, are obsolete, and at run-time CICS always returns the following values:

  • Zero for both PORT and SSLPORT
  • SSLNO for SSLPORT

If you attempt to translate a program with these options, the translation succeeds, but the CICS translator ignores them with return code 4 and a warning message stating that they are obsolete.

The option STATE is replaced by ENABLESTATUS.

INQUIRE DISPATCHER
ACTHPTCBS
MAXHPTCBS
ACTHPTCBS displayed the number of H8 mode open TCBs that were active, and MAXHPTCBS displayed the number that CICS was allowed to attach. H8 mode open TCBs no longer exist.
INQUIRE PROGRAM JVMDEBUG The JVMDEBUG option is obsolete and CICS always returns NODEBUG as the CVDA value if JVMDEBUG is specified.
INQUIRE PROGRAM
HOTPOOLING
HOTPOOL
NOTHOTPOOL
The values Hotpool and Nothotpool were used to show whether or not the Java program object was to be run in a preinitialized Language Environment enclave.
SET DISPATCHER MAXHPTCBS This option used to specify the maximum number of H8 mode open TCBs that CICS was allowed to attach. H8 mode open TCBs no longer exist.
SET PROGRAM
HOTPOOL
NOTHOTPOOL
The values Hotpool and Nothotpool were used to show whether or not the Java program object was to be run in a preinitialized Language Environment enclave.

Signon retention with XRF and VTAM persistent sessions

In earlier releases of CICS that support VTAM persistent sessions, CICS recovers only the terminal session, and not the user's signon status. With signon retention support, CICS catalogs the signon status of every user who signs on, enabling CICS to retain a terminal's signon in the event of either a CICS or VTAM failure. Thus, CICS regions using VTAM persistent sessions have the same signon retention capability as CICS regions using XRF. However, XRF and VTAM persistent sessions are mutually exclusive, and rather than have two parameters to control signon and signoff status, RSTSIGNOFF operates for both functions.

If you have application programs that specify the XRFSIGNOFF(FORCE) attribute on an EXEC CICS CREATE TYPETERM command, this attribute is ignored in a CICS TS 2.2 region, which does not recognize the XRFSIGNOFF attribute. To ensure such application programs have the same effect as before in CICS regions running with XRF support, modify the EXEC CICS CREATE command to specify RSTSIGNOFF(FORCE).

[[ Contents Previous Page | Next Page Index ]]