Orderly Shutdown - IBM CICS Interface for Teradata

IBM CICS Interface for Teradata® Reference

Product
IBM CICS Interface for Teradata
Release Number
17.00
Published
June 2020
Language
English (United States)
Last Update
2020-06-19
dita:mapPath
xhj1544831946672.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
B035-2448
Product Category
Teradata Tools and Utilities
An orderly shutdown results from one of the following:
  • DBCDSCN is invoked by PLTSD during normal CICS termination.
  • The DSCN command, with IMM (immediate) set to N, is issued by an authorized CICS terminal operator.

The following message is issued to the terminal from which the shutdown is invoked:

DCI0150:  DBCCICS INTERFACE IS SHUTTING DOWN

The following stages occur during an orderly shutdown:

  1. Currently active CICS transactions accessing the database are allowed to run to completion.
    Shutdown proceeds once resources owned by these transactions are released, either:
    • explicitly by application request, or
    • implicitly by transaction or conversation termination.

      If these transactions already have a session logged on at the time that interface shutdown is initiated, the transactions can do any of the following things:

      • issue new requests,
      • logon new sessions, or
      • perform other actions.
  2. CLIv2 or Preprocessor2 resources owned by terminals that are involved in a pseudo-conversation but which do not have a CICS transaction active are released.

    The sessions are logged off and the memory is released.

  3. It is not possible to release CLIv1 or Preprocessor1 resources owned by idle terminals within a pseudo-conversation because of differences in CLIv1 and Preprocessor 1 implementation.

    Thus, interface shutdown will not complete until these resources are explicitly released by a transaction executing from the terminal or implicitly by termination of the pseudo-conversation.

    DLGF can be used to log off the sessions but it will not release the resources.

  4. The 2PC (two-phase commit) connections are stopped after all resources are released.
  5. The task-related user exit is disabled for task start.

    Any transaction that attempts to use the CICS Interface following an orderly shutdown is rejected with a non-zero return code, indicating that the interface is inactive.