HCL Workload Automation, Version 9.4

unlink

Closes communication links between workstations.

You must have unlink access to the target workstation.

Syntax

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.

See also

From the Dynamic Workload Console you can perform the same task as follows:
  1. In the navigation bar at the top, click System Status and Health > Workload Monitoring > Monitor Workload.
  2. Select an engine.
  3. In Object Type, select Workstation.
  4. From the Query drop-down list, select a query to monitor workstations.
  5. Click Run to run the monitoring task.
  6. From the table containing the list of workstations, select a workstation and click Unlink.