IMS Version 9

/EXIT

Format

Read syntax diagramSkip visual syntax diagram>>-+-/EXIT-+---------------------------------------------------->
   '-/EXI--'

>--+-----------------------------------------------------+-----><
   '-CONV--conv#--+------------------------------------+-'
                  +-LINE--line#--PTERM--pterm#---------+
                  +-NODE--nodename--+----------------+-+
                  |                 '-USER--username-' |
                  '-USER--username---------------------'

Environments and Keywords

Table 60 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.

Table 60. Valid Environments for the /EXIT Command and Keywords
Command / Keywords DB/DC DBCTL DCCTL
/EXIT X X
CONVERSATION X X
LINE X X
NODE X X
PTERM X X
USER X X

Usage

The /EXIT command ends conversations between users and application programs. The conversation can be either active or in hold status at the time /EXIT is entered. Depending upon the conversational processing options selected for the IMS system, the application program might or might not be notified of the conversation termination.

|Transactions that are queued for processing when |the /EXIT command is issued are discarded. If a transaction is being |processed or was sent to a remote system for processing when /EXIT is issued, the command is still processed; however, the conversation |will be terminated, but the conversational transaction will still |be issued. When the conversational response is received, the Conversational |Abnormal Termination exit (DFSCONE0) is called and the response |message is queued to the response terminal.

The /EXIT command with no keywords can only be used if the conversation is active.

If global resource information is kept in Resource Manager (RM), /EXIT NODE or /EXIT USER terminates the conversation in RM. If global resource information is not kept in RM, /EXIT NODE or /EXIT USER terminates a conversation on the IMS where the /EXIT command is entered or routed to by the OM SPOC.

/EXIT is not valid from an LU 6.2 device or OTMA device. DEALLOCATE the APPC conversation after receiving all output from an iteration. When the /EXIT command specifies only the CONVERSATION keyword, the command can be entered only from the terminal that owns the conversation.

CONVERSATION
Terminates the specified conversation. The conversation is terminated whether it was active or held. The conversation identifier (conv#) must be specified as a 4-digit number, including leading zeros.
LINE PTERM
Terminates the conversation on the physical terminal specified, regardless of whether the conversation was active or held. The line specified must be in stopped and idle status.
NODE
Terminates the conversation on the node specified, regardless of whether the conversation was active or held. The node specified must be stopped or idle. This form of the command does not support dynamic nodes or LU 6.2 nodes defined with users.

The NODE USER combination applies only to the specified half-session of the ISC parallel session node allocated to USER The half-session must have been stopped and idled. The command must be issued from a terminal or node other than the one in the conversation.

USER
Terminates the conversation associated with the specified user. The user must not be signed on to a node. The user must be dynamic.

Examples

Example 1 for /EXIT Command

Entry ET:

  /EXIT

Response ET:

  DFS058I  EXIT COMMAND COMPLETED

Explanation: The active and not held conversation associated with the entering terminal is terminated.

Example 2 for /EXIT Command

Entry ET:

  /EXIT

Response ET:

  DFS576I  EXIT COMPLETED, TRANSACTION DISCARDED

Explanation: /EXIT processing found the conversational transaction enqueued for an application or transmission across an MSC link, but it has not yet been scheduled for processing. The transaction has been discarded.

Example 3 for /EXIT Command

Entry ET:

  /EXIT

Response ET:

  DFS577I  EXIT COMPLETED, TRANSACTION STILL ACTIVE

Explanation: /EXIT processing found the conversational transaction had been or is in the process of being transmitted across an MSC link.

Example 4 for /EXIT Command

Entry ET:

  /EXIT CONVERSATION 0001

Response ET:

  DFS058I  EXIT COMMAND COMPLETED

Explanation: The active or held conversation (0001) is terminated if the terminal is in conversation.

Example 5 for /EXIT Command

Entry ET:

  /EXIT CONVERSATION 0001 LINE 10 PTERM 2

Response ET:

  DFS058I  EXIT COMMAND COMPLETED

Explanation: Used from another PTERM or master terminal when a PTERM in conversation is "locked," waiting for a response. /EXIT CONVERSATION should be used before a /START LINE command that resets all conversations active on the line.

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004