DEFINE PROCESSGROUP command: Transfer Control

From m204wiki
Revision as of 17:59, 29 March 2021 by SteveS (talk | contribs) (→‎Syntax)
Jump to navigation Jump to search

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 Iidentifies 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 Iidentifies the SNA Communications Server mode table entry to be used to establish the Transferred Session at the Transfer Target Remote Id.

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.

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.

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.