IMS Version 9

/SET

Format

Read syntax diagramSkip visual syntax diagram>>-/SET--+-CONVERSATION--tranname--+------------+-+------------><
         |                         '-(password)-' |
         +-LTERM--ltermname-----------------------+
         '-TRANSACTION--tranname--+------------+--'
                                  '-(password)-'

Environments and Keywords

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

Table 149. Valid Environments for the /SET Command and Keywords
Command / Keywords DB/DC DBCTL DCCTL
/SET X X
CONVERSATION X X
LTERM X X
TRANSACTION X X

Usage

/SET establishes the destination of all messages entered into this terminal to another terminal or to a particular transaction code. If the terminal is in conversation, the /SET command also sets the destination of only the next message to the specified transaction.

The status fields of /DISPLAY LINE PTERM, /DISPLAY NODE, or /DISPLAY USER indicate if a physical terminal, node, or user is in preset destination mode (PRST), and display the destination transaction code or logical terminal name.

CONVERSATION
Directs the next input message to a selected transaction. The terminal being used must be in a conversation that is waiting for an input message. For example, the response message must have been received.

In an IMSplex, if global resource information is kept in Resource Manager, the /SET command sets a transaction for the next input message both globally and locally. If global resource information is not kept in Resource Manager, the /SET command sets the transaction just locally.

LTERM
Specifies the logical terminal that is the destination of all messages entered into this terminal.

The mode established by /SET LTERM is called preset mode. If the preset mode is established from a 3270 and user-defined formats are not being used, input message must be entered from a cleared screen. Preset mode can be reset by:

/IAM
/STOP LINE PTERM
/STOP NODE command
/STOP USER command
/RESET
/STOP NODE
/STOP LINE
/STOP USER

Once a destination is preset, the terminal operator cannot enter the destination (logical terminal name) as the first part of the message.

In a multiple systems configuration, the name of a remote logical terminal can be specified. If the preset destination is to be deleted (/RESET) or changed (/SET), the command must be entered from some other valid component.

TRANSACTION
Specifies the transaction code that is the destination of all messages entered into this terminal. The mode established by /SET TRANSACTION is called preset mode. If the preset mode is established from a 3270 and user-defined formats are not being used, input messages must be entered from a cleared screen. Preset mode can be reset by:
/IAM
/START LINE PTERM
/RESET
/STOP NODE
/STOP LINE
/STOP USER

Once a destination is preset, the terminal operator cannot enter the destination (transaction code) as the first part of the message. In a multiple systems configuration, the name of a remote transaction can be specified. The terminal cannot be in conversation.

Examples

Example 1 for /SET Command

Entry ET:

  /SET CONVERSATION CONVTRAN(password)

Response ET:

  DFS058I  SET COMMAND COMPLETED

Explanation: Any message entered from this terminal is sent to conversation CONVTRAN.

Example 2 for /SET Command

Entry ET:

  /SET LTERM CNTRL

Response ET:

  DFS058I  SET COMMAND COMPLETED

Explanation: Any message entered from this terminal is sent to LTERM CNTRL.

Example 3 for /SET Command

Entry ET:

  /SET TRANSACTION IMS(password)

Response ET:

  DFS058I  SET COMMAND COMPLETED

Explanation: Any message entered from this terminal is sent to transaction IMS.

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