DEFINE PROCESSGROUP command: Transfer Control

Summary

Privileges

User 0 or system manager

Function

Connects the Transfer Control process to a specific link; for SNA Communications Server transfers, it also specifies login security

Syntax

DEFINE PROCESSGROUP name [LIKE previousname] WITH SCOPE=SYSTEM LINK=linkname REMOTEID=luname MODENAME=logmode table entry name LOGIN={TRUST | NOTRUST}

Where:

name	Used on DEFINE PROCESS commands to refer to this group of processes. The length of the name must be 1 to 8 characters. ALL is a reserved word and cannot be used.
LIKE	Gives the current link the attributes of the link entity referred to by previousname.
SCOPE=SYSTEM	Indicates that the definition is available to all users of the Model 204 system for the entire run.
LINK	Associates the processgroup with a locally defined link and implies the transport type and conversation protocol. The linkname value must be the same as the link name specified on the DEFINE LINK command.
REMOTEID	Identifies the LU name (SNA Communications Server applid) of the SNA Communications Server application to which the user is transferred. REMOTEID is used with SNA Communications Server transfers, that is, when PROTOCOL=TRANSFER on the DEFINE LINK command, and MODE=PASS on the DEFINE PROCESS command for this process. During a trusted transfer — that is, when LOGIN=TRUST; see LOGIN description below — between Model 204 regions, the Model 204 region initiating the transfer sets REMOTEID to the SNA Communications Server applid of the destination Model 204 region. The destination region sets REMOTEID to the SNA Communications Server applid of the region initiating the transfer. The destination Model 204 region uses REMOTEID to verify that the transfer is from a trusted Model 204 region, as well as to transfer a user back to the initiating region.
MODENAME	Identifies the SNA Communications Server mode table entry to be used to establish the Transferred Session at the Transfer Target Remote Id. A mode table entry contains a collection of Session Parameters, such as Display Model, RU size, EDS support et al, that are used to Bind the Transferred Session at the Transfer Target and provides the User with a means of controlling the session characteristics in force following the Transfer. Specifying MODENAME=LOGON or MODENAME=LOGIN instructs Model 204 to Bind the Session at the Transfer Target with the LOGMODE used to Logon to the Source Online. If no MODENAME is specified, the VTAM default mode table entry associated with the REMOTEID value is used to establish the session. Otherwise, anything specified in a VTAM TRANSFER PROCESSGROUP MODENAME parameter will be assumed to be a valid VTAM LOGMODE and will be used to Bind the Transferred session at the Target. A failed Transfer consequent to an invalid LOGMODE or a LOGMODE unknown at the Target is flagged with: M204.2483 unknown-modename is not a valid LOGMODE name.
LOGIN	Specifies whether a valid password is required when transferring between Model 204 regions. LOGIN is used with SNA Communications Server transfers, that is, when PROTOCOL=TRANSFER on the DEFINE LINK command, and MODE=PASS on the DEFINE PROCESS command for this process. Valid values are TRUST and NOTRUST: TRUST Specifies that the transfer is to another Model 204 Online and that the receiving Online's system manager expects that the transferring Online has already verified this user's password. The transferred user is logged in without a password and assigned privileges from either CCASTAT or an external security package. If a password is passed with the transfer, however, it is used. For a trusted transfer, both partners must have LOGIN=TRUST. NOTRUST Specified for either partner, indicates that a transfer to another Model 204 region requires a password. NOTRUST is the default.