link

Opens communication links between workstations. In an HCL Workload Automation network, fault-tolerant and standard agents are linked to their domain managers, and domain managers are linked to their parent domain managers. Extended agents are not linked; they communicate through a host.

You must have link access to the target workstation.

The command requires that another workstation be present in your environment in addition to the master domain manager.

Syntax

Arguments

domain
Specifies the name of the domain in which links are opened. Wildcard characters are permitted.
This argument is useful when linking more than one workstation in a domain. For example, to link all the agents in domain stlouis, use the following command:
lk stlouis!@

The domain is not needed if you do not include wildcard characters in workstation.

If you do not include domain, and you include wildcard characters in workstation, the default domain is the one in which conman is running.

[folder/]workstation
Specifies the name of the workstation to be linked. 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

If the autolink option is set to on in a workstation definition, its link is opened automatically each time HCL Workload Automation is started. If autolink is set to off, you must use link and unlink commands to control linking. For information about autolink see Workstation definition.

Assuming that a user has link access to the workstations being linked, the following rules apply:
  • A user running conman on the master domain manager can link any workstation in the network.
  • A user running conman on a domain manager other than the master can link any workstation in its own domain and subordinate domains. The user cannot link workstations in peer domains.
  • A user running conman on an agent can link any workstation in its local domain provided that the workstation is a domain manager or host. A peer agent in the local domain cannot be linked.
  • To link a subordinate domain while running conman in a higher domain, it is not necessary that the intervening links be open.

Examples

Network links and Opened links show the links opened by link 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 Monitoring and Reporting > 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 Link.