DEFINE REMOTE command

From m204wiki
Revision as of 21:42, 6 April 2017 by ELowell (talk | contribs) (→‎Usage notes)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Summary

Privileges
User 0 or system manager
Function
Defines the remote partner node and associates it with the link specified in this command

Syntax

DEFINE REMOTE name WITH SCOPE=SYSTEM LINK=linkname REMOTEID=luname [LOGIN={TRUST | NOTRUST}] [GUESTUSER={ACCEPT | REJECT}]

Where:

name is the locally known name for this entity. It is used on DEFINE SESSIONGROUP commands to refer to this remote. The length of the name must be eight characters or less. ALL is a reserved word and cannot be used.
SCOPE=SYSTEM indicates that the definition is available to all users of the Model 204 system for the entire run.
LINK specifies the name of the link with which this remote is associated. This name must be the same as the link name specified on a local DEFINE LINK command.

Note: It must not be the name of a link specified in a local non-CNOS processgroup definition.

REMOTEID is the name of the LU at the remote node to which the CNOS link is connected. This name is the SNA Communications Server APPL definition name (applid value) of the remote node. This REMOTEID value must match the LOCALID value specified on the DEFINE LINK command at the remote node.
LOGIN specifies whether a local server process requires a password from the remote client at OPEN FILE time. Valid values are TRUST and NOTRUST:
TRUST specifies that the local system manager trusts the remote system to verify a user ID shipped in an inbound conversation request. Such a user is logged in without a password by the server process and assigned privileges from either CCASTAT or an external security package.
NOTRUST specifies that a valid password must be present in the inbound conversation request. NOTRUST is the default.
GUESTUSER specifies whether a trusted client with a user ID that is undefined in CCASTAT or in ACF2 can access the Model 204 SQL Server. The ACCEPT option allows an unknown user to access the SQL Server; REJECT, the default, does not.

Example

DEFINE REMOTE RMT1 WITH - SCOPE=SYSTEM - LINK=LINK1 - REMOTEID=LU01 - LOGIN=NOTRUST

Usage notes

You can define multiple remotes with the same link.

For more information, see Horizon CNOS connections.

For general syntax and usage notes that apply to all forms of the DEFINE command, see DEFINE command.