Workstation definition

In an HCL Workload Automation network, a workstation is a scheduling object that runs jobs. You create and manage the scheduling object workstation in the HCL Workload Automation database by using a workstation definition. A workstation definition is required for every object that runs jobs. Typically, a workstation definition is used to represent a physical workstation but, in the case of extended agents for example, it represents a logical definition that must be hosted by a physical workstation.

The composer command cannot perform a full validation of the workstation definition. If you need a validation on the workstation, use the Dynamic Workload Console to create it.

Note: You can add workstation definitions to the database at any time, but you must run JnextPlan -for 0000 again to be able to run jobs on newly created workstations. Every time you run JnextPlan, all workstations are stopped and restarted.

When creating a scheduling object, you can define it in a folder. If no folder path is specified, then the object definition is created in the current folder. By default, the current folder is the root (\) folder, but you can customize it to a different folder path. You can also use the composer rename command to move and rename objects in batch mode that use a naming convention to a different folder using part of the object name to assign a name to the object.

Note: When the workstation or pool is renamed, the application creates a new name with a renamed value while preserving the old. The old name is no longer required. The workstation or pool can be deleted using the standard command.

When defining a new workstation, you can choose the licensing type to be applied to it. The licensing type determines the criteria by which the workload run by HCL Workload Automation on the workstation is accounted for and license consumption is evaluated. .

You can include multiple workstation definitions in the same text file, together with workstation class definitions and domain definitions. A workstation definition has the following syntax:

Syntax

cpuname [folder/]workstation [description "description"]
[licensetype type]
[vartable table_name]
os os-type
[node hostname]  [tcpaddr port]
[secureaddr port]  [timezone|tz tzname]
[domain domainname]
[for maestro   [host [folder/]workstation [access method | agentID agentID ]]
     [type fta | s-agent | x-agent | manager | broker | agent | rem-eng |
      pool | d-pool]
     [ignore]
     [autolink on | off]
     [behindfirewall on | off]
     [securitylevel enabled | on | force | force_enabled]
     [fullstatus on | off]
     [server serverid]]
     [protocol http | https]
     [members [[folder/]workstation] [...]]
[requirements jsdl_definition]]
end

[cpuname ...]

[cpuclass ...]

[domain ...]

Arguments

Table 1. Attribute settings for management workstation types
Attributes Master domain manager Domain manager Backup domain manager
cpuname The name of the workstation.
description A description for the workstation enclosed within double quotation marks. This attribute is optional.
licensetype Specifies the licensing type to be applied to the workstation.
vartable The name of a variable table associated with the workstation. Variables used with the workstation are defined in this table. This attribute is optional.
os The operating system installed on the system. Specify one of the following values:

UNIX
WNT
OTHER
IBM_i

node The system host name or IP address.
tcpaddr The value to be assigned to nm port in the localopts file. For multiple workstations on a system, enter an unused port number. The default value is 31111.
secureaddr The value to be assigned to nm ssl port in the localopts file. Specify it if securitylevel is set to on, force, enabled, or force_enabled.
timezone | tz The time zone in which the system is located. It is recommended that the value matches the value set on the operating system.
domain MASTERDM The name of the managed domain.
host Not applicable
access Not applicable
type manager fta
ignore Use this attribute if you do not want this workstation to be included in the next production plan.
autolink It indicates if a link between workstations is automatically opened at startup time. Specify one of the following values:

ON
OFF

This is an optional attribute. The default value is ON.
behindfirewall This setting is ignored. It indicates if there is a firewall between the workstation and the master domain manager. Specify one of the following values:

ON
OFF

The default value is OFF.
securitylevel The type of SSL authentication to use:

enabled
on
force
force_enabled

fullstatus ON
server Not applicable This setting is ignored.
protocol Not applicable
members Not applicable
requirements Not applicable

Attribute settings for target workstation types describes the values that you set for each attribute for target workstation types. Following the table you find additional details about each attribute.

Table 2. Attribute settings for target workstation types
Attribute Fault-tolerant agent and standard agent Workload broker workstation Extended agent Agent Remote engine workstation Pool Dynamic pool
cpuname The name of the workstation.
description A description for the workstation enclosed within double quotation marks. This attribute is optional.
licensetype Specifies the licensing type to be applied to the workstation. This property applies to the following workstation types:
  • Fault-tolerant agent
  • Standard agent
  • Agent
vartable The name of a variable table associated with the workstation. Variables used with the workstation are defined in this table. This attribute is optional.
os The operating system installed on the system. Specify one of the following values:

UNIX
WNT
OTHER
IBM_i

Specify OTHER for IBM i systems running as limited fault-tolerant agents.

OTHER The operating system installed on the machine. Specify one of the following values:

UNIX
WNT
OTHER
IBM_i

This value setting is discovered on the system. The operating system installed on the machine. Specify one of the following values:

UNIX
WNT
ZOS

The operating system installed on the machine. Specify one of the following values:

UNIX
WNT
OTHER
IBM_i

node The system host name or IP address. The system host name or IP address. Specify NULL when host is set to $MASTER, or when defining an extended agent for PeopleSoft, SAP or Oracle. Agent host name or IP address. Remote engine host name or IP address. Not applicable
tcpaddr The value to be assigned to nm port in the localopts file. When defining multiple workstations on a system, enter an unused port number. The default value is 31111. The value to be assigned to nm port in the localopts file. When defining multiple workstations on a system, enter an unused port number. The default value is 41114. See the selected access method specifications. The port number to communicate with the agent when the protocol is http. The port number to communicate with the remote engine when the protocol is http. Not applicable
secureaddr The value to be assigned to nm ssl port in the localopts file. Specify it if securitylevel is set to on, force, enabled.or force_enabled Not Applicable Not Applicable The port number to communicate with the agent when the protocol is https. The port number to communicate with the remote engine when the protocol is https. Not applicable
timezone | tz The time zone in which the system is located. It is recommended that the value matches the value set on the operating system. The time zone set on the workstation specified in the host attribute. The time zone set on the agent. The time zone set on the remote engine. The time zone set on the pool agents. The time zone set on the dynamic pool agents.
domain Specify an existing domain. The default value for fault-tolerant agents is MASTERDM. This setting is mandatory for standard agents. Specify an existing domain. This setting is mandatory. This setting is needed only if the value assigned to host is $MANAGER. Not applicable
host Not Applicable The host workstation. It can be set to $MASTER or $MANAGER. The broker workstation.
access Not Applicable Select the appropriate access method file name. Not Applicable
agentID The unique identifier of the agent
type

fta
s-agent

The default value is fta.

Specify fta for IBM isystems running as limited fault-tolerant agents.

broker x-agent agent rem-eng pool d-pool
ignore Use this attribute if you do not want this workstation to appear in the next production plan.
autolink It indicates if a link between workstations is automatically opened at startup. Specify one of the following values:

ON
OFF

This is an optional attribute. The default value is ON.
OFF Not applicable
behindfirewall It indicates if there is a firewall between the workstation and the master domain manager. Specify one of the following values:

ON
OFF

The default value is OFF.
OFF Not applicable
securitylevel The type of SSL authentication to use:

enabled
on
force       force_enabled

Not applicable for IBM i systems running as limited fault-tolerant agents.
Not Applicable
fullstatus It indicates if the workstation is updated about job processing status in its domain and subdomains. Specify one of the following values:

ON
OFF

Specify OFF for standard agents.
OFF Not applicable
server 0-9, A-Z. When specified, it requires the creation of a dedicated mailman processes on the parent workstation. Not Applicable
protocol Not applicable Specify one of the following values:

http
https

This attribute is optional. When not specified, it is automatically determined from the settings specified for tcpaddr and secureaddr.
Not applicable
members Not applicable Required value Not applicable
requirements Not applicable Required value
The following list gives additional details for the workstation definition attributes:
cpuname [folder/]workstation
Specifies the name of the folder within which the workstation is defined, if any, and the workstation name. Workstation names must be unique and cannot be the same as workstation class names.

The name must start with a letter, and can contain alphanumeric characters, dashes, and underscores. It can contain up to 16 characters.

Do not use in this field any of the reserved words specified in List of reserved words when defining jobs and job streams.

Note: Renaming any kind of domain manager, such as master domain manager, dynamic domain manager, or their backups is not a supported operation and might lead to unpredictable results.
description ”description
Provides a description of the workstation. The description can contain up to 120 alphanumeric characters. The text must be enclosed within double quotation marks.
licensetype type
Specifies the licensing type to be applied to the workstation. Use this keyword when you set the licenseType optman keyword to byWorkstation. The licensing type determines the criteria by which the workload run by HCL Workload Automation on the workstation is accounted for and license consumption is evaluated.. Supported values are as follows:
perJob
Your license consumption is evaluated based on the number of jobs that run on the workstation each month.
perServer
Your license consumption is evaluated based on the number of chargeable HCL Workload Automation components installed on the workstation.

If you install a dynamic agent and a fault-tolerant agent on the same workstation in the same path, the agents share the same license file. As a result, only the license type which is defined later in time is applied. For this reason, it is advisable to define the same license type for both agent workstations.

vartable table_name
Specifies the name of the variable table that you want to associate with the workstation. Variables used with the workstation are defined in this table.

The name must start with a letter, and can contain alphanumeric characters, dashes, and underscores. It can contain up to 80 characters.

os os_type
Specifies the operating system of the workstation. When used in remote engine workstation definitions it represents the operating system of the HCL Workload Automation remote engine.
Valid values are:
UNIX
For supported operating systems running on UNIX-based systems, including LINUX systems.
WNT
For supported Windows operating systems.
OTHER
Mandatory value for: dynamic workload broker workstations, and IBM i systems running as limited fault-tolerant agents. Optional value for other types of workstations.
ZOS
Used with remote engine workstations that are defined to communicate with HCL Workload Automation for Z remote engine.
IBM_i
For supported IBM i operating systems.
Note: For an up-to-date list of supported operating systems, see HCL Workload Automation Detailed System Requirements.
node hostname
Specify the host name or the TCP/IP address of the workstation. Fully-qualified domain names are accepted.

For host names, valid characters are alphanumeric, including dash (-). The maximum length is 51 characters.

Specify NULL when:
  • Defining an extended agent for PeopleSoft, SAP or Oracle.
  • host is set to $MASTER

If you are defining a remote engine workstation, specify the host name of the system where the remote engine is installed.

tcpaddr port
Specifies the netman TCP/IP port number that HCL Workload Automation uses for communicating between workstations.
For workload broker workstations
Specify the value of the TWS.Agent.Port property of the TWSAgentConfig.properties file.
For remote engine workstations using HTTP protocol to communicate with the remote engine
Specify the HTTP port number of the remote engine.
For other types of workstations
Specify the value assigned in the localopts file for variable nm port.

The default value for this field is 31111. Specify a value in the range from 1 to 65535.

secureaddr
Defines the port used to listen for incoming SSL connections. This value is read when the securitylevel attribute is set.
For workload broker workstations
Ignore this attribute.
For remote engine workstations using HTTPS protocol to communicate with the remote engine
Specify the HTTPS port number of the remote engine.
For other types of workstations
Specify the value assigned in the localopts file for variable nm ssl port. The value must be different value from the value assigned to nm port variable in the localopts file.

If securitylevel is specified, but this attribute is missing, the default value for this field is 31113. Specify a value in the range from 1 to 65535.

See Setting local options for information about SSL authentication and local options set in the TWS_home/localopts configuration file.
timezone|tz tzname
Specifies the time zone of the workstation. To ensure the accuracy of scheduling times, this time zone must be the same as the computer operating system time zone.

When used in remote engine workstation definitions it represents the time zone set on the HCL Workload Automation remote engine.

See Managing time zones for valid time zone names.

domain domainname
Specifies the name of HCL Workload Automation domain the workstation belongs to. The default value for fault-tolerant workstation is MASTERDM.

HCL Workload Automation ignores domain setting when defined for extended agents, except when the host attribute is set to $MASTER.

This setting is mandatory for standard agent and dynamic workload broker workstations.

host host-workstation
This attribute is mandatory for extended agents and remote engine workstations and specifies:
For remote engine workstations, agents, pools and dynamic pools:
The broker workstation hosting the workstation. This field cannot be updated after the remote engine workstation creation.
For extended agents
The workstation with which the extended agent communicates and where its access method is installed. The hosting workstation cannot be another extended agent.
If the hosting workstation is a domain manager for which you have defined a backup, you can specify one of the following values to ensure the extended agent is not isolated if the hosting workstation becomes unavailable:
$MASTER
To indicate that the host workstation for the extended agent is the master domain manager.
$MANAGER
To indicate that the host workstation for the extended agent is the domain manager. In this case you must specify the domain where the agent is located.
In this case make sure that the extended agent methods are installed also on the backup workstation. You can enable and disable the automatic resolution of the $MASTER key using the mm resolve master option in the localopts file.
For more information about the options available in the localopts file, see HCL Workload Automation Administration Guide.
access method
Specifies an access method for extended and network agents. It corresponds to the name of a file that is located in the TWS_home/methods directory on the hosting workstation.

Specify NULL when defining an extended agent for PeopleSoft, SAP, or Oracle.

agentID agentID
The unique identifier of the agent.
type
Specifies the type of the workstation. If you plan to change the workstation types, consider the following rules:
  • You can change fault-tolerant agent, standard agent, extended agent, domain manager and dynamic workload broker workstations to any workstation type, with the exception of dynamic agent, pool, dynamic pool, and remote engine.
  • You cannot change the type of dynamic agent, pool, dynamic pool, and remote engine.
Enter one of the following values:
fta
If you define a fault-tolerant agent, that is an agent workstation that launches jobs and resolves local dependencies without a domain manager. This is the default value for this attribute.

You must specify fta if you want to assign the workstation the role of backup domain manager or backup master domain manager.

Specify fta for IBM isystems running as limited fault-tolerant agents.

s-agent
If you define a standard agent, that is an agent workstation that launches jobs only under the direction of its domain manager.
x-agent
If you define an extended agent, that is an agent workstation that launches jobs only under the direction of its hosting workstation. Extended agents can be used to interface HCL Workload Automation with non-HCL systems and applications. To create an extended agent for SAP, define an r3batch access method. Consider the following example:
CPUNAME XA_R3
  OS OTHER
  NODE na TCPADDR 32111
  FOR MAESTRO HOST LONDON ACCESS "r3batch"
    TYPE X-AGENT
    AUTOLINK OFF
    BEHINDFIREWALL OFF
    FULLSTATUS OFF
END

For more information, see Scheduling Applications with HCL Workload Automation.

manager
If you define a domain manager, that is a workstation that manages a domain. When defining this type of workstation, specify:
Server
NULL
Domain
The name of the domain the workstation manages, if different from MASTERDM domain.
You specify that a workstation is a manager also in the manager field of the Domain definition. HCL Workload Automation automatically checks that the values specified in these fields are consistent.
broker
If you define a dynamic workload broker workstation, that is a workstation that runs both existing job types and job types with advanced options. It is the broker server installed with the master domain manager and the dynamic domain manager. It hosts the following workstations:
  • Extended agent
  • Remote engine
  • Pool
  • Dynamic pool
  • Agent. This definition includes the following agents:
    • agent
    • HCL Workload Automation Agent
    • agent for z/OS

    For more information about the agent for z/OS, see HCL Workload Automation: Scheduling with the Agent for z/OS.

agent
If you define a dynamic agent, that it is a workstation that manages a wide variety of job types, for example, specific database or file transfer jobs, in addition to traditional job types. It is hosted by the workload broker workstation. The workstation definition is automatically created and registered when you install the dynamic agent component. In its definition you can edit only the following attributes:
  • Description
  • Vartable
Note: If you have the enAddWorkstation global option set to "yes", the dynamic agent workstation definition is automatically added to the Plan after the installation process creates the dynamic agent workstation in the database.
rem-eng
If you define a remote engine workstation, that it is a workstation used to communicate with a remote engine when binding a locally defined job, named shadow job, to a specific job running on the remote engine, named remote job. When the two jobs are bound, the shadow job status transition maps the remote job status transition. This mapping is useful also to define and monitor dependencies of local jobs on jobs running on the remote engine; such dependencies are called cross dependencies.

For more information about shadow jobs and cross dependencies, see Defining and managing cross dependencies.

When defining this type of workstation, specify the following fields:
os
The operating system of the remote engine.
host
The name of the hosting broker workstation.
node
The hostname or the IP address of the remote engine.
When specifying the port number to use to communicate with the remote engine, use secureaddr if the protocol used is HTTPS, tcpaddr if the protocol used is HTTP. It is recommended that you specify in the timezone field the time zone set on the remote engine.
pool
If you define a pool, that is a set of dynamic agents with similar hardware or software characteristics to submit jobs to. This workstation is hosted by the workload broker workstation. In its definition you can edit only the following attributes:
  • Description
  • Vartable
  • Members
d-pool
If you define a dynamic pool, that is a set of dynamic agents which is dynamically defined based on the requirements listed in the JSDL file specified in the resources attribute. This workstation is hosted by the workload broker workstation. In its definition you can edit only the following attributes:
  • Description
  • Vartable
  • Requirements
ignore
Specifies that the workstation definition must not be added to the production plan. If you specify this setting, job streams scheduled to run on this workstation are not added to the production plan.
autolink
Specifies whether to open the link between workstations at startup. Depending on the type of the workstation, when you set its value to on:
On a fault-tolerant agent or on a standard agents
It means that the domain manager open the link to the agent when the domain manager is started.
On a domain manager
It means that its agents open links to the domain manager when they are started.

This setting is particularly useful when a new production plan is created on the master domain manager: As part of the production plan generation all workstations are stopped and then restarted. For each agent with autolink turned on, the domain manager automatically sends a copy of the new production plan and then starts the agent. If autolink is turned on also for the domain manager, the agent opens a link back to the domain manager.

If the value of autolink is off for an agent, you can open the link from its domain manager by running the conman link command on the agent's domain manager or the master domain manager.

behindfirewall
If set to on, it means there is a firewall between the workstation and the master domain manager. In this case only a direct connection between the workstation and its domain manager is allowed and the start workstation, stop workstation, and showjobs commands are sent following the domain hierarchy, instead of making the master domain manager or the domain manager open a direct connection with the workstation.

Set this attribute to off if you are defining a workstation with type broker.

fullstatus
Specify this setting when defining a fault-tolerant agent workstation. For domain managers this keyword is automatically set to on. Specify one of the following values:
on
If you want the fault-tolerant agent workstation to operate in full status mode, meaning that the workstation is updated with the status of jobs and job streams running on all other workstations in its domain and subordinate domains, but not on peer or parent domains. The copy of the production plan on the agent is kept at the same level of detail as the copy of the production plan on its domain manager.
off
If you want the fault-tolerant agent workstation to be informed about the status of jobs and job streams only on other workstations that affect its own jobs and job streams. Specifying "off" can improve performance by reducing network activity.
securitylevel
Specifies the type of SSL authentication for the workstation. Do not specify this attribute for a workstation with type broker. It can have one of the following values:
enabled
The workstation uses SSL authentication only if its domain manager workstation or another fault-tolerant agent below it in the domain hierarchy requires it.
on
The workstation uses SSL authentication when it connects with its domain manager. The domain manager uses SSL authentication when it connects to its parent domain manager. The fault-tolerant agent refuses any incoming connection from its domain manager if it is not an SSL connection.
force
The workstation uses SSL authentication for all of its connections and accepts connections from both parent and subordinate domain managers.
force_enabled
The workstation uses SSL authentication for all of its connections to all target workstations which are set to this value. The workstation tries to establish a connection in FULLSSL mode and, if the attempt fails, it tries to establish an unsecure connection. If you plan to set different security levels between master domain manager and fault-tolerant agents, ensure all these components are at version 95 Fix Pack 4 or later. For versions earlier than 95 Fix Pack 4, the same security level is required for master domain manager and fault-tolerant agents.

If this attribute is omitted, the workstation is not configured for SSL connections and any value for secureaddr is ignored. Make sure, in this case, that the nm ssl port local option is set to 0 to ensure that netman process does not try to open the port specified in secureaddr. See Setting local options for information about SSL authentication and local options set in the TWS_home/localopts configuration file.

The following table describes the type of communication used for each type of securitylevel setting.
Table 3. Type of communication depending on the security level value
Value set on the Fault-tolerant Agent (or the Domain Manager) Value set on its Domain Manager (or on its Parent Domain Manager) Type of connection established
Not specified Not specified TCP/IP
Enabled Not specified TCP/IP
On Not specified No connection
Force Not specified No connection
Not specified On TCP/IP
Enabled On TCP/IP
On On SSL
Force On SSL
Not specified Enabled TCP/IP
Enabled Enabled TCP/IP
On Enabled SSL
Force Enabled SSL
Not specified Force No connection
Enabled Force SSL
On Force SSL
Force Force SSL
The value for securitylevel is not specified for dynamic workload broker workstations or for workstations with an IBM Workload Scheduler agent V8.2 or earlier.
server ServerID
Use the server attribute in the fault-tolerant agent workstation definition to reduce the time required to initialize agents and to improve the timeliness of messages. By default, communications with the fault-tolerant agent are handled by a mailman process running on the domain manager. The server attribute allows you to start a mailman process on the domain manager to handle communications with this fault-tolerant agent workstation only.

If you are defining a fault-tolerant agent that can work as a backup domain manager, the ServerID is used only when the workstation works as a fault-tolerant agent; the setting is ignored when the workstation works as a backup domain manager.

Within the ServerID, the ID is a single letter or a number (A-Z and 0-9). The IDs are unique to each domain manager, so you can use the same IDs in other domains without conflict. A specific ServerID can be dedicated to more than one fault-tolerant agent workstation.

As best practices:
  • If more than 36 server IDs are required in a domain, consider to splitting the domain into two or more domains.
  • If the same ID is used for multiple agents, a single server is created to handle their communications. Define extra servers to prevent a single server from handling more than eight agents.
If a ServerID is not specified, communications with the agent are handled by the main mailman process on the domain manager.
protocol http | https
Specifies the protocol to use to communicate with:
The broker workstation
If the workstation is an agent workstation.
The remote engine
If the workstation is a remote engine workstation.
members [workstation] [...]
Use this value for a pool workstation to specify the agents that you want to add to the pool.
requirements jsdl_definition
Use this value for a dynamic pool workstation to specify the requirements, in JSDL format; the agents that satisfy the requirement automatically belong to the dynamic pool. You use the following syntax:
˂jsdl_definition:>
˂jsdl:resources>
˂jsdl:logicalResource subType="MyResourceType"/>
˂/jsdl:resources>
For more information about JSDL syntax, see Job Submission Description Language schema reference.

Examples

The following example creates a master domain manager named hdq-1, and a fault-tolerant agent named hdq-2 in the master domain. Note that a domain argument is optional in this example, because the master domain defaults to masterdm.
cpuname hdq-1 description “Headquarters master DM”
     os unix
     tz America/Los_Angeles
     node sultan.ibm.com
     domain masterdm
     for maestro type manager
          autolink on
          fullstatus on
end
cpuname hdq-2
     os wnt
     tz America/Los_Angeles
     node opera.ibm.com
     domain masterdm
     for maestro type fta
          autolink on
end
The following example creates a domain named distr-a with a domain manager named distr-a1 and a standard agent named distr-a2:
domain distr-a
     manager distr-a1
     parent masterdm
end
cpuname distr-a1 description “District A domain mgr”
     os wnt
     tz America/New_York
     node pewter.ibm.com
     domain distr-a
     for maestro type manager
          autolink on
          fullstatus on
end 
cpuname distr-a2
     os wnt
     node quatro.ibm.com
     tz America/New_York
     domain distr-a
     for maestro type s-agent
end
The following example creates a fault-tolerant workstation with SSL authentication. The securitylevel security definition specifies that the connection between the workstation and its domain manager can be only of the SSL type. Port 32222 is reserved for listening for incoming SSL connections.
cpuname ENNETI3
     os WNT
     node apollo
     tcpaddr 30112
     secureaddr 32222
     for maestro
          autolink off
          fullstatus on
          securitylevel on
end
The following example creates a broker workstation. This workstation manages the lifecycle of HCL Workload Automation workload broker type jobs in dynamic workload broker.
cpuname ITDWBAGENT
       vartable TABLE1
       os OTHER
      node itdwbtst11.ibm.com TCPADDR 41114
      timezone Europe/Rome
      domain MASTERDM
      for MAESTRO
          type  BROKER
          autolink  OFF
          behindfirewall OFF
          fullstatus OFF
end
The following example creates a remote engine workstation to use to manage cross dependencies and communicate with a remote engine installed on a system with hostname London-hdq using the default HTTPS port 31116. The remote engine workstation is hosted by the broker workstation ITDWBAGENT
cpuname REW_London
     description "Remote engine workstation to communicate with London-hdq"
     os WNT
     node London-hdq secureaddr 31116
     timezone Europe/London
     for maestro host ITDWBAGENT
        type rem-eng
        protocol HTTPS
end
The following example shows how to create a dynamic pool of agents. All agents in the dynamic pool must have the HP-UX or Linux operating systems installed:
CPUNAME DPOOLUNIX
  DESCRIPTION "Sample Dynamic Pool Workstation"
  VARTABLE table1
  OS OTHER
  TIMEZONE Europe/Rome
  FOR MAESTRO HOST MAS86MAS_DWB
    TYPE D-POOL
  REQUIREMENTS
    ˂?xml version="1.0" encoding="UTF-8"?>
˂jsdl:resourceRequirements
      xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl">
  ˂jsdl:resources>
    ˂jsdl:candidateOperatingSystems>
      ˂jsdl:operatingSystem type="HPUX"/>
      ˂jsdl:operatingSystem type="LINUX"/>
    ˂/jsdl:candidateOperatingSystems>
  ˂/jsdl:resources>
˂/jsdl:resourceRequirements>
END
The following example shows how to create a dynamic pool of agents. All agents in the dynamic pool must have the Windows 2000 operating system installed:
CPUNAME DPOOLWIN
  DESCRIPTION "Sample Dynamic Pool Workstation"
  OS WNT
  TIMEZONE Europe/Rome
  FOR MAESTRO HOST MAS86MAS_DWB
    TYPE D-POOL
  REQUIREMENTS
 ˂?xml version="1.0" encoding="UTF-8"?>   
˂jsdl:resourceRequirements xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl">>
  ˂jsdl:resources>
    ˂jsdl:candidateOperatingSystems>
      ˂jsdl:operatingSystem type="Windows 2000"/>
    ˂/jsdl:candidateOperatingSystems>
  ˂/jsdl:resources>
˂/jsdl:resourceRequirements>
END
The following example shows how to create a pool of agents with name POOLUNIX and containing two agents: NC121105 and NC117248:
CPUNAME POOLUNIX
  DESCRIPTION "Sample Pool Workstation"
  OS OTHER
  TIMEZONE Europe/Rome
  FOR MAESTRO HOST MAS86MAS_DWB
    TYPE POOL
  MEMBERS
    NC121105
    NC117248
END
The following example shows how to create a standard agent on which license consumption is evaluated based on the number of jobs that run on the workstation each month:
CPUNAME SA1
  DESCRIPTION "Sample Standard Agent"
  LICENSETYPE PERJOB
  VARTABLE TABLE1
  OS UNIX
  NODE sa1.mycompany.com TCPADDR 31111
  SECUREADDR 31113
  TIMEZONE Europe/Rome
  DOMAIN MASTERDM
  FOR MAESTRO
    TYPE S-AGENT
    IGNORE
    AUTOLINK ON
    BEHINDFIREWALL ON
    SECURITYLEVEL FORCE
    FULLSTATUS OFF
    SERVER B
END

See also

For information about how to perform the same task from the Dynamic Workload Console, see:

Creating a workstation.