unlink
Closes communication links between workstations.
You must have unlink access to the target workstation.
Syntax
unlink [domain!]workstation
[;noask]
Arguments
- domain
- Specifies the name of the domain in which to close links. It is not necessary to specify the domain name of a workstation in the master domain. Wildcard characters are permitted. Note: You must always specify the domain name when unlinking a workstation not in the master domain.This argument is useful when unlinking more than one workstation in a domain. For example, to unlink all the agents in domain stlouis, use the following command:
unlink stlouis!@If you do not specify domain, and workstation includes wildcard characters, the default domain is the one in which conman is running.
- workstation
- Specifies the name of the workstation to be unlinked. Wildcard characters are permitted.
This command is not supported on remote engine workstations.
- noask
- Specifies not to prompt for confirmation before taking action on each qualifying workstation.
Comments
Assuming that a user has unlink access to the workstations being unlinked, the following rules apply:
- A user running conman on the master domain manager can unlink any workstation in the network.
- A user running conman on a domain manager other than the master can unlink any workstation in its own domain and subordinate domains. The user cannot unlink workstations in peer domains.
- A user running conman on an agent can unlink any workstation in its local domain provided that the workstation is either a domain manager or host. A peer agent in the same domain cannot be unlinked.
For additional information see link.
Examples
Figure 1 and Table 1 show the links closed by unlink commands run by users in various locations in the network.
DMn are domain managers and Ann are agents.
Figure 1. Unlinked network workstations
| Command | Closed by User1 | Closed by User2 | Closed by User3 |
|---|---|---|---|
| unlink@!@ | All links are closed | DM1-DM2 |
DM2-A21 |
| unlink @ | DM1-A11 |
DM1-DM2 |
DM2-A21 |
| unlink DOMAIN3!@ | DM3-A31 |
Not allowed | Not allowed |
| unlink DOMAIN4!@ | DM4-A41 |
DM4-A41 |
Not allowed |
| unlink DM2 | DM1-DM2 | Not applicable | DM2-A21 |
| unlink A42 | DM4-A42 | DM4-A42 | Not allowed |
| unlink A31 | DM3-A31 | Not allowed | Not allowed |
See also
From the Dynamic Workload Console you can perform the same task as follows:
- In the navigation bar at the top, click .
- Select an engine.
- In Object Type, select Workstation.
- From the Query drop-down list, select a query to monitor workstations.
- Click Run to run the monitoring task.
- From the table containing the list of workstations, select a workstation and click Unlink.