SET CONNECTION statement (Set current RD-node)
Function
The SET CONNECTION statement sets the current RD-node.
Privileges
Format
SET CONNECTION {RD-node-name| :embedded-variable|DEFAULT}
Operands
- {RD-node-name| :embedded-variable|DEFAULT}
- RD-node-name
- Specifies the name of the distributed RD-node that is to become the current RD-node.
- embedded-variable
- Specifies the embedded variable that contains as its value the name of the distributed RD-node that is to become the current RD-node.
- If the UAP is written in C, the data type of the variable must be a fixed-length character string not exceeding 31 bytes in length and terminating with the null value. If the character string does not terminate with the null value, that portion of the character string whose length is (area length -1) is used as the RD-node name.
- If the UAP is written in COBOL, this operand must be a fixed-length character string not exceeding 30 bytes in length, but it need not terminate with the null value.
- DEFAULT
- Specifies that the default RD-node is to be set as the current RD-node.
Common rules
- An RD-node that is not connected to the distributed RD-node that is currently set as the RD-node cannot be specified.
- DEFAULT is specified when the existing RD-node is to be set as the current RD-node. The name of the existing RD-node (the RD-node name of the local RD-node specified in the single server or front-end server definition) cannot be specified.
- When execution of a SET CONNECTION statement terminates with an error, the current RD-node is not changed.
Examples
- Set the RD-node named RDNODE10 as the current RD-node:
SET CONNECTION RDNODE10
- Set the existing RD-node as the current RD-node:
SET CONNECTION DEFAULT