16.20 - Orderly Shutdown - IBM CICS Interface for Teradata

IBM CICS Interface for Teradata® Reference

prodname
IBM CICS Interface for Teradata
vrm_release
16.20
created_date
October 2018
category
Programming Reference
featnum
B035-2448-106K

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 Teradata 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 session(s) 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.