CONNECT statement with RD-node specification (Connect to distributed RD-node)
Function
The CONNECT statement with an RD-node specification reports an authorization identifier and a password to a distributed RD-node in order to connect the UAP to the distributed RD-node. When connection is made, the connected RD-node is designated as the current RD-node.
Privileges
For the authorization identifier that links to the specified RD-node, the user needs the privilege to connect to the system using the RD-node. For the privilege necessary to connect to the system using a specified RD-node, see the system manual for the RD-node.
Format
CONNECT TO {RD-node-name|:embedded-variable-1}
[USER:embedded-variable-2 [USING:embedded-variable-3]]
Operands
Specifies an embedded variable that contains as its value the authorization identifier for linking to the RD-node to which connection is to be made.
If the UAP is written in C, specify a fixed-length character string of up to 31 bytes, the final character of which is the null value. If the character string does not terminate with the null value, the character string occupying (area length - 1) is used as the authorization identifier.
If the UAP is written in COBOL, specify a fixed-length character string of up to 30 bytes; this character string need not terminate with the null value.
If all operands following USER are omitted, the same authorization identifier and password as were used for the existing RD-node connection will be reported to the RD-node to which connection is to be made.
If values are to be case-sensitive, they must be enclosed in double quotation marks (").
Specifies an embedded variable that contains as its value the password for linking to the RD-node to which connection is to be made.
If the UAP is written in C, specify a fixed-length character string of up to 31 bytes, the final character of which is the null value. If the character string does not terminate with the null value, the character string occupying (area length - 1) is used as the password.
If the UAP is written in COBOL, specify a fixed-length character string of up to 30 bytes; this character string need not terminate with the null value.
If passwords are not required for users, either omit the USING clause or specify any character string in the embedded variable.
Common rules
Note
Example
Report an authorization identifier (embedded variable USER2) and a password (embedded variable PSWD2) in order to connect to the RD-node named RDNODE10:
CONNECT TO RDNODE10 USER :USER2 USING :PSWD2