DEFINE PROCESSGROUP command: Transfer Control: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Automatically generated page update)
 
m (misc formatting)
Line 18: Line 18:
<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>Iidentifies 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>
Line 46: Line 48:
<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 62:
<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]]

Revision as of 22:11, 28 March 2017

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] 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.

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.