DEFINE PROCESSGROUP command: Transfer Control: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Automatically generated page update)
 
 
(9 intermediate revisions by 2 users not shown)
Line 10: Line 10:
   SCOPE=SYSTEM
   SCOPE=SYSTEM
   LINK=linkname
   LINK=linkname
   [REMOTEID=luname]
   REMOTEID=luname
  MODENAME=logmode table entry name
   LOGIN={TRUST | NOTRUST}
   LOGIN={TRUST | NOTRUST}
</p>
</p>
Line 18: Line 19:
<tr>
<tr>
<th>name</th>
<th>name</th>
<td> is 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.</td>
<td>Used on <var>DEFINE PROCESS</var> commands to refer to this group of processes. The length of the name must be 1 to 8 characters. <var>ALL</var> is a reserved word and cannot be used.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th><var>LIKE</var></th>
<th><var>LIKE</var></th>
<td> gives the current link the attributes of the link entity referred to by previousname.</td>
<td>Gives the current link the attributes of the link entity referred to by <var class="term">previousname</var>.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th><var>SCOPE=SYSTEM</var></th>
<th><var>SCOPE=SYSTEM</var></th>
<td> indicates that the definition is available to all users of the <var class="product">Model&nbsp;204</var> system for the entire run.</td>
<td>Indicates that the definition is available to all users of the <var class="product">Model&nbsp;204</var> system for the entire run.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th><var>LINK</var></th>
<th><var>LINK</var></th>
<td> is used to associate 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.</td>
<td>Associates the processgroup with a locally defined link and implies the transport type and conversation protocol. The <var class="term">linkname</var> value must be the same as the link name specified on the <var>DEFINE LINK</var> command.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th><var>REMOTEID</var></th>
<th><var>REMOTEID</var></th>
<td> 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.  
<td>Identifies the LU name (SNA Communications Server applid) of the SNA Communications Server application to which the user is transferred. <var>REMOTEID</var> is used with SNA Communications Server transfers, that is, when <code>PROTOCOL=TRANSFER</code> on the <var>DEFINE LINK</var> command, and <code>MODE=PASS</code> on the <var>DEFINE PROCESS</var> command for this process.  
<p>During a trusted transfer-that is, when LOGIN=TRUST; see LOGIN description below-between <var class="product">Model&nbsp;204</var> regions, the <var class="product">Model&nbsp;204</var> region initiating the transfer sets REMOTEID to the SNA Communications Server applid of the destination <var class="product">Model&nbsp;204</var> region. The destination region sets REMOTEID to the SNA Communications Server applid of the region initiating the transfer.</p>
<p>
<p>The destination <var class="product">Model&nbsp;204</var> region uses REMOTEID to verify that the transfer is from a trusted <var class="product">Model&nbsp;204</var> region, as well as to transfer a user back to the initiating region. </p>
During a trusted transfer &mdash; that is, when <code>LOGIN=TRUST</code>; see <var>LOGIN</var> description below &mdash; between <var class="product">Model&nbsp;204</var> regions, the <var class="product">Model&nbsp;204</var> region initiating the transfer sets <var>REMOTEID</var> to the SNA Communications Server applid of the destination <var class="product">Model&nbsp;204</var> region. The destination region sets <var>REMOTEID</var> to the SNA Communications Server applid of the region initiating the transfer.</p>
<p>
The destination <var class="product">Model&nbsp;204</var> region uses <var>REMOTEID</var> to verify that the transfer is from a trusted <var class="product">Model&nbsp;204</var> region, as well as to transfer a user back to the initiating region. </p>
</td>
</td>
</tr>
</tr>
   
   
<tr>
<th><var>MODENAME</var></th>
<td>Identifies the SNA Communications Server mode table entry used to establish the Transferred Session at the Transfer Target Remote Id and allows the User to control the characteristics of that session.
<p>
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.
</p>
<p>
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.
</p>
<p>
If no MODENAME is specified, the VTAM default mode table entry associated with the REMOTEID value is used to establish the session.
</p>
<p>
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.
</p>
<p>
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.
</p>
</td>
</tr>
<tr>
<tr>
<th><var>LOGIN</var></th>
<th><var>LOGIN</var></th>
<td> specifies whether a valid password is required when transferring between <var class="product">Model&nbsp;204</var> 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.  
<td>Specifies whether a valid password is required when transferring between <var class="product">Model&nbsp;204</var> regions. <var>LOGIN</var> is used with SNA Communications Server transfers, that is, when <code>PROTOCOL=TRANSFER</code> on the <var>DEFINE LINK</var> command, and <code>MODE=PASS</code> on the <var>DEFINE PROCESS</var> command for this process.  
<p>Valid values are <var>TRUST</var> and <var>NOTRUST</var>:</p>
<p>
Valid values are <var>TRUST</var> and <var>NOTRUST</var>:</p>
<table>  
<table>  
<tr>
<tr>
<th><var>TRUST</var></th>
<th><var>TRUST</var></th>
<td> specifies that the transfer is to another <var class="product">Model&nbsp;204</var> 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.  
<td>Specifies that the transfer is to another <var class="product">Model&nbsp;204</var> 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.  
<p>For a trusted transfer, both partners must have LOGIN=TRUST.</p>
<p>
For a trusted transfer, both partners must have <code>LOGIN=TRUST</code>.</p>
</td>
</td>
</tr>
</tr>
Line 58: Line 88:
<tr>
<tr>
<th><var>NOTRUST</var></th>
<th><var>NOTRUST</var></th>
<td>, specified for either partner, indicates that a transfer to another <var class="product">Model&nbsp;204</var> region requires a password.
<td>Specified for either partner, indicates that a transfer to another <var class="product">Model&nbsp;204</var> region requires a password.
<p>NOTRUST is the default.</p>
<p>
</td>
<var>NOTRUST</var> is the default.</p>
</tr>
</td></tr>
</table>
</table>
</td>
</td></tr>
</tr>
</table>
</table>
[[Category: System manager commands]]
[[Category: System manager commands]]
[[Category:Commands]]
[[Category:Commands]]

Latest revision as of 19:57, 29 March 2021

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 used to establish the Transferred Session at the Transfer Target Remote Id and allows the User to control the characteristics of that session.

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.