Changed resource definition attributes

Table 8 shows changes to resource definition attributes.

Table 8. Changed resource definition attributes
Resource type Affected attributes Explanation
DB2CONN
DB2ID
TCBLIMIT
TCBLIMIT is treated differently, depending on the release of DB2® to which CICS® is connected, and DB2ID is mutually exclusive with DB2GROUPID.
PROFILE RTIMOUT Now, in addition to specifying the terminal read time-out feature as in earlier releases, this also specifies the time-out value for IIOP request processor tasks that are waiting for method requests.

Users migrating from CICS TS 1.3 may already be aware of the following change if they applied the PTF for APAR PQ58283.

  1. The value of RTIMOUT is given as minutes and seconds (mmss) in the range 1--7000. The rounding of this value that was performed by earlier releases of CICS no longer happens. CICS acts upon the RTIMOUT value exactly as it appears in the PROFILE definition. See 1 for more information.
  2. The READ TIMEOUT value on the transaction profile definition for MRO sessions is now observed by CICS. The field in the profile already exists. CICS honours it for ISC but used to ignore it for MRO. See 2 for more information.
PROGRAM
CONCURENCY
EXECKEY
JVM
JVMPROFILE

  • There is a new significance to the CONCURRENCY(THREADSAFE) attribute if your transactions invoke task-related user exits that are enabled with the OPENAPI option, such as the CICS DB2 adaptor when connected to DB2 Version 6 or later.
  • The EXECKEY attribute now applies to programs that run in a JVM. You can use the same JVM profile to invoke a JVM in either of the keys.
  • For JVM, the DEBUG option is removed, leaving YES or NO as the only options.
  • The JVM profiles that you specify using the JVMPROFILE attribute are now files in the HFS directory that is specified by the system initialization parameter JVMPROFILEDIR, and you need to specify the name using the same combination of upper and lower case characters that is present in the HFS file name.
TCPIPSERVICE
PORTNUMBER
TRANSACTION
The description of the PORTNUMBER attribute has been extended, with information regarding the use of well-known IIOP port numbers and port sharing within an MVS™™ image.

CIEP, for an ECI over TCP/IP TCPIPSERVICE definition, is added to the CICS transactions you can specify on the TRANSACTION attribute.

TRANSACTION SHUTDOWN The meaning of this parameter is changed. It now applies to ALL transactions whether the transaction is associated with a terminal or not. Therefore, SHUTDOWN(ENABLED) should be specified on all TRANSACTIONS that you want to run during shutdown. Alternatively, specify them on the XLT used at shutdown.
TYPETERM RSTSIGNOFF Specifies the sign-on characteristics of a group of terminals in the event of a persistent sessions restart or an XRF takeover. RSTSIGNOFF replaces XRFSIGNOFF, which is retained for compatibility purposes with earlier releases.
Notes:
  1. In earlier releases, CICS rounded this value up to an exact multiple of 16.78 seconds, for all communications methods. This rounding is now removed, CICS acts upon the RTIMOUT value exactly as it appears in the PROFILE definition. If you have set particular RTIMOUT values, to take account of the rounding up to a multiple of 16.78 seconds, in order to achieve a particular behavior in your CICS region, you may need to reconsider the values that you have set.
  2. In earlier Releases of CICS, read time-out is ignored for MRO sessions, tasks waiting on an MRO connection can hang indefinitely. If, for example, transactions in an AOR stall or deadlock for any reason the corresponding relay transactions in an MRO-connected TOR are left hanging. Eventually a problem in an AOR can cause the TOR to stall completely. Although you can prevent new transactions from being routed to, or queued for, the offending AOR, there has not been, until now, an easy way to purge every task that is in flight. This change to CICS enables the READ TIMEOUT value on the transaction profile definition for MRO sessions. The field in the profile already exists. CICS honours it for ISC but used to ignore it for MRO. CICS now checks this RTIMOUT value for MRO sessions. A new abend code is issued if the RTIMOUT value is exceeded for MRO sessions. By enabling the READ TIMEOUT value on the transaction profile definition for MRO sessions, a cause of intersystem queuing (sometimes referred to as "sympathy sickness") is eliminated. The situations which may benefit from this change include some which, because they result from stalls or deadlocks elsewhere, are unlikely to resolve themselves unaided.
Start of change

DBCS languages: EPI and terminal emulator, change to server code pages

In CICS TS 2.2, for languages that use double-byte character sets (DBCS), changes were made to the server code pages supported for the EPI and the client terminal emulator function.

The server code page is determined from value 2 of the CGCSGID attribute of the TYPETERM definition used to install the virtual terminal definition. For DBCS languages, you need to specify a different server code page from that used in releases before CICS TS 2.2, in order to provide the correct SBCS and DBCS translation. This change is required for EPI clients and client terminal emulators to work correctly.

CICS Family: Communicating from CICS on System/390® lists the new server code pages supported for the EPI and terminal emulator for DBCS languages.

End of change [[ Contents Previous Page | Next Page Index ]]