Creating a workstation using the Dynamic Workload Console

About this task

How to create a workstation definition for supported agents using the Dynamic Workload Console.
Dynamic agents and HCL Workload Automation Agents
The agents are automatically registered to the HCL Workload Automation network. For further information about the dynamic agents registration, see User's Guide and Reference.
Extended agents
To define an extended agent workstation using the Dynamic Workload Console, perform the following steps:
  1. From the Dynamic Workload Console portfolio, click Administration > Workload Environment Design > Create Workstations.
  2. Select an engine, distributed or z/OS®, from the list and click Create Workstation.
  3. In the Workstations properties panel, specify the attributes for the extended agent workstation you are creating. For all the details about available fields and options, see the online help by clicking the "?" in the top-right corner. In the workstation definition, specify the access method and other properties, as shown in How to complete the extended agents definition. For further information about the workstation definition properties, see User's Guide and Reference
  4. To assign the workstation to an existing domain or to create a new domain, click Assign to Domain.
  5. Click Save.
The following table shows how to complete some specific fields of the workstation properties panel for extended agents.
Table 1. How to complete the extended agents definitionThis table shows how to complete the extended agents definition
Field Description by Access Method
PeopleSoft z/OS® SAP R/3
Name The name for the extended agent workstation. For all access methods (except for z/OS®, which has a limit of 8 characters), the name must start with a letter and can contain alphanumeric characters, dashes, and underscores. The maximum length is 16 characters. Workstation names must be unique and cannot be the same as workstation class and domain names. Double-byte character set (DBCS), single-byte character set (SBCS), and bidirectional text are not supported. If a workstation name contains these characters and, as a result, the options file name contains the same name, the workstation cannot be validated by the SAP system.

For all the access methods, the name of the options file associated with the extended agent workstation must contain the unique identifier of the extended agent workstation, XA_Unique_ID_<accessmethod>.opts. That is, if the unique identifier for the extended agent workstation named /SAPBUS/S4HANAR3BW is 07756YBX76Z6AFX2, then the options file name must be 07756YBX76Z6AFX2_r3batch.opts. For information about retrieving the unique identifier for an extended agent workstation, see UNIQUE_ID.

Node Name null The node name or IP address of the z/OS® system. Fully qualified domain names are accepted. null
TCP Port Any number other than 0. The TCP/IP address (port number) of the z/OS® gateway on the z/OS® system. Enter the same value as the SYSTSIN variable PORT. Any number other than 0.
Access Method psagent Depending on your job scheduling interface, one of the following:
mvsjes
To launch and monitor z/OS® jobs using JES2 or JES3.
mvsopc
To launch and monitor z/OS® jobs using HCL Workload Automation for Z.
Note: In UNIX operating systems, the name is case sensitive and must be lowercase.
r3batch
Note: In UNIX the name is case sensitive and must be lowercase.