The TCL command, SET-CIRCUIT, establishes a virtual circuit, connecting a line on a source mvBase Server to a line on a target mvBase Server.
Format
|
SET-CIRCUIT servername {linenum { - linenum}} |
The mvBase Server, where the SET-CIRCUIT command is executed, is known as the source server. The servername parameter is required and specifies the computer name of the target server. The source and target servers are the same or different mvBase servers.
The linenum parameters are optional. If both linenum parameters are specified, the parameters are separated by a dash (-).
The first parameter specifies the Line Number on the target server (target line) and the second parameter specifies the Line Number on the source server (source line).
If only one linenum parameter is specified, it specifies the Line Number on the target server. In this case, the next available line on the source server is assigned as the source line. If no linenum parameters are specified, the next available line on the source server is assigned as the source line and the next available line on the target server is assigned as the target line.
When the SET-CIRCUIT command is executed, it attempts to establish a virtual circuit connection between the source line on the source server to the target line on the target server. If the target server does not exist or the source or target line is unavailable, an appropriate error message is displayed. If a successful virtual circuit connection is established, a successful connection message is displayed.
The table below gives examples of using the SET-CIRCUIT command on a system called SVRONE.
|
Syntax |
Description |
Response |
|
SET-CIRCUIT |
Missing Server Arguments |
Error Message |
|
SET-CIRCUIT mashugana |
Invalid Server Argument |
Error Message |
|
SET-CIRCUIT SRVONE X |
Invalid Local Line X |
Error Message |
|
SET-CIRCUIT 9 SRVONE |
Invalid Order of Arguments |
Error Message |
|
SET-CIRCUIT SRVONE (Local Virtual Circuit Only) |
Connect a wild target line on SRVONE to a wild source line on SRVONE. |
Connect |
|
SET-CIRCUIT SRVONE 9 (Local Virtual Circuit Only) |
Connect target line 9 on SRVONE to a wild source line on SRVONE. |
Connect |
|
SET-CIRCUIT SRVONE 9-10 (Local Virtual Circuit Only) |
Connect target line 9 on SRVONE to source line 10 on SRVONE. |
Connect |
|
SET-CIRCUIT SRVTWO (Remote Virtual Circuit Only) |
Connect a wild target line on SRVTWO to a wild source line on SRVONE |
Connect |
|
SET-CIRCUIT SRVTWO 9 (Remote Virtual Circuit Only) |
Connect target line 9 on SRVTWO to a wild source line on SRVONE. |
Connect |
|
SET-CIRCUIT SRVTWO 9-10 (Remote Virtual Circuit Only) |
Connect target line 9 on SRVTWO to source line 10 on SRVONE. |
Connect |