/SET command

If the terminal is in conversation, the /SET command also sets the destination of only the next message to the specified transaction.

Subsections:

• Environment
• Syntax
• Keywords
• Usage notes
• Examples

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the commands and keywords.

Syntax

>>-/SET--+-CONVERSATION--tranname--+------------+-+------------><
         |                         '-(password)-' |   
         +-LTERM--ltermname-----------------------+   
         '-TRANSACTION--tranname--+------------+--'   
                                  '-(password)-'      

Keywords

The following keywords are valid for the /SET command:

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:

/CLSDST NODE
/SIGN
/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:

/CLSDST NODE
/SIGN
/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.

Usage notes

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.

A transaction name can be defined with password protection in SAF for the CONVERSATION and TRANSACTION keywords. If the resource is not defined to SAF, or is defined and is authorized to the user, the command is processed. If the resource is defined to SAF but not authorized for use, the command is rejected with a DFS2469W message.

A period that is specified in the password brackets is not treated as a delimiter.