CPUREC

Purpose

This statement begins an IBM Workload Scheduler workstation (CPU) definition. You must specify one CPUREC for each IBM Workload Scheduler workstation you intend to add to the end-to-end with fault tolerance capabilities network, with the exception of the controller that acts as master domain manager of the network.

CPUREC is defined in the member of the EQQPARM library, as specified by the TPLGYMEM keyword in the TOPOLOGY statement.

Format


1  CPUREC  CPUNAME ( cpu name )  CPUOS (
2.1 AIX
2.1 HPUX
2.1 POSIX
2.1 UNIX
2.1 WNT
2.1 OTHER
1 )  CPUNODE ( node name )?  CPUTCPIP (
2.1! 31111
2.1 port number
1 )?  CPUDOMAIN ( domain name )?  CPUHOST ( cpu name )?  CPUACCESS ( access method )  CPUTYPE (
2.1! FTA
2.1 SAGENT
2.1 XAGENT
1 )?  CPUAUTOLNK (
2.1! ON
2.1 OFF
1 )?  CPUFULLSTAT (
2.1! OFF
2.1 ON
1 )?  CPURESDEP (
2.1! OFF
2.1 ON
1 )?  CPUSERVER ( server ID  )?  CPULIMIT (
2.1! 1024
2.1 value
1 )?  CPUTZ (
2.1! UTC
2.1 timezone
1 )?  CPUUSER (
2.1! tws
2.1 default user
1 )?  SSLLEVEL (
2.1! OFF
2.1 ON
2.1 ENABLED
2.1 FORCE
1 )?  SSLPORT (
2.1! 31113
2.1 SSL port number
1 )?  FIREWALL (
2.1! NO
2.1 YES
1 )

Parameters

CPUNAME(cpu name)
The name of the IBM Workload Scheduler workstation consisting of up to four alphanumeric characters, starting with a letter.
CPUOS
The host CPU operating system related to the IBM Workload Scheduler workstation. The valid entries are: AIX®, HPUX, POSIX, UNIX™, WNT, and OTHER.
CPUNODE(node name)
The node name or the IP address of the CPU. Fully-qualified domain names up to 52 characters are accepted.
CPUTCPIP(port number|31111)
The TCP port number of NETMAN on this CPU. It consists of five numerals and, if omitted, uses the default value, 31111.
CPUDOMAIN (domain name)

The name of the IBM Workload Scheduler domain of the CPU. It can be up to 16 characters long and must start with a letter. It can be alphanumeric and contain dashes (-) and underscores (_).

For standard and fault-tolerant agents directly connected to the end-to-end server, this name must be set to MASTERDM.

CPUHOST (cpu name)
The name of the host CPU of the agent. It is required for standard and extended agents. The host is the IBM Workload Scheduler CPU with which the standard or the extended agent communicates and where its access method resides.

For standard agents directly connected to the end-to-end server, this name must be set to OPCMASTER.

Note: The host cannot be another standard or extended agent.
CPUACCESS (access method)
The name of the access method. It is valid for extended agents and must be the name of a file that resides in the IBM Workload Scheduler home/methods directory on the host CPU of the agent.
For details about the access methods, refer to IBM Workload Scheduler: Administration Guide.
CPUTYPE (SAGENT|XAGENT|FTA)
The CPU type specified as one of the following:
FTA
Fault-tolerant agent, including domain managers, and backup domain managers.
SAGENT
Standard agent. This includes also IBM Workload Scheduler agents that connect to Dynamic Workload Broker environments.
XAGENT
Extended agent.
The default type is FTA.
CPUAUTOLNK(OFF|ON)
Autolink is most effective during the initial startup sequence of each plan. Then, a new Symphony file is created and all the CPUs are stopped and restarted.

For a fault-tolerant agent or standard agent, specify ON so that, when the domain manager starts, it sends the new Production Control file (Symphony) to start the agent and open communication with it.

For the domain manager, specify ON so that, when the agents start, they open communication with the domain manager.

Specify OFF to initialize an agent when you submit a link command manually from the Modify Current Plan dialogs.

Note: If the extended agent workstation is manually set to Link, Unlink, Active, or Offline, the command is sent to its host CPU.
CPUFULLSTAT (ON|OFF)
It applies only to fault-tolerant agents that are not attached directly to the end-to-end server. If you specify ON for a directly connected fault-tolerant agent, the value is forced to OFF. If you specify OFF for a domain manager, the value is forced to ON.

Specify ON for the link from the domain manager to operate in Full Status mode. In this mode, the agent is kept updated about the status of jobs and schedules running on other CPUs in the network.

Specify OFF for the agent to receive status information only about the jobs and schedules on other CPUs that affect its own jobs and schedules. This can improve the performance by reducing network traffic.

To keep the Production Control file for an agent at the same level of detail as its domain manager, set CPUFULLSTAT and CPURESDEP to ON. Always set these modes to ON for backup domain managers.

CPURESDEP (ON|OFF)
It applies only to fault-tolerant agents. If you specify OFF for a domain manager, the value is forced to ON.

Specify ON to have the agent's Production Control process operate in Resolve All Dependencies mode. In this mode, the agent tracks dependencies for all its jobs and schedules, including those running on other CPUs.

Note: Note that CPUFULLSTAT must also be ON so that the agent is informed about the activity on other CPUs.

Specify OFF if you want the agent to track dependencies only for its own jobs and schedules. This reduces CPU usage by limiting processing overhead.

To keep the Production Control file for an agent at the same level of detail as its domain manager, set CPUFULLSTAT and CPURESDEP to ON. Always set these modes to ON for backup domain managers.

CPUSERVER(server ID)
It applies to fault-tolerant and to standard agents, regardless of whether they are attached directly to OPCMASTER or to a domain manager. Omit this option for domain managers.

This keyword can be a letter or a number (A-Z or 0-9) and identifies a server (Mailman) process on the domain manager that sends messages to the agent. The IDs are unique to each domain manager, so you can use the same IDs for agents in different domains without conflict. If more than 36 server IDs are required in a domain, consider dividing it into two or more domains.

If a server ID is not specified, messages to a fault-tolerant or standard agent are handled by a single Mailman process on the domain manager. Entering a server ID causes the domain manager to create an additional Mailman process. The same server ID can be used for multiple agents. The use of servers reduces the time required to initialize agents, and generally improves the timeliness of messages. However, it increases expenditure in local computer resources. As a guide, additional servers should be defined to prevent a single Mailman from handling more than eight agents.

CPULIMIT( value| 1024)
Specifies the number of jobs that can run at the same time in the workstation. The default value is 1024. The accepted values are integers from 0 to 1024. If you specify 0, no jobs are launched on the workstation.

For fault-tolerant and standard agents having a direct connection to the end-to-end server, changes in this value come into effect during the extension or replanning of the current plan, not during the renewal of the Symphony file.

CPUTZ (timezone|UTC)
Specifies the local time zone of the distributed agent. It must match the time zone of the operating system on which the distributed agent runs. If the time zone does not match that of the agent, the message AWSBHT128I is displayed in the log file of the distributed agent. The default is UTC (universal coordinated time).

To avoid inconsistency between the local date and time of the jobs and of the Symphony creation, use the CPUTZ keyword to set the local time zone of the fault-tolerant workstation. If the Symphony creation date is later than the current local date of the fault-tolerant workstation, Symphony is not processed.

In the end-to-end with fault tolerance capabilities environment, time zones are disabled by default when installing or upgrading IBM Z Workload Scheduler. If the CPUTZ keyword is not specified, time zones are disabled. For additional information on how to set the time zone in an end-to-end with fault tolerance capabilities network, see Enabling time zones. If the fault-tolerant workstation has the option of "Daylight saving changes" automatically set, the values that you must put in the CPUTZ parameter are the following, specified under the ../zoneinfo/ bin directory:
  • Africa/....
  • America/....
  • Antarctica/....
  • Arctic/....
  • Asia/....
  • Atlantic/....
  • Australia/....
  • Brazil/....
  • Canada/....
  • Chile/....
  • Europe/....
  • Indian/....
  • Mexico/....
  • Mideast/....
  • Pacific/....
  • US/....
where you can replace .... with the files that you find in every subdirectory previously mentioned (it depends on your geographical region). If the fault-tolerant-workstation does not have the option "Daylight saving changes" automatically set, see Enabling time zones.
CPUUSER (default user|tws)
Specifies the default user for the workstation. The maximum length is 47 characters. The default value is tws. If the operating system used by this CPU treats the user ID as case sensitive, then this parameter must be coded in the correct case. The value of this option is used only if you have not defined the user in the JOBUSR option of the SCRPTLIB JOBREC statement or using the EQQUX001 job-submit exit (for centralized scripts).
If you use this keyword to specify the name of the user who submits the specified script or command on a Windows™ fault-tolerant workstation, you can:
  • Associate the user name to the Windows™ workstation in the USRREC initialization statement.
  • Define the user name and password in a file locally stored in the Windows™ workstation and set LOCALPSW(YES) in the TOPOLOGY statement.
Note: IBM Z Workload Schedulerlooks for the USRREC statement first, then for the local file, if you set LOCALPSW(YES).
If you are defining a Windows™ domain user and the value contains a backslash (\), then the entire character string must be enclosed by single quotes, for example: 
CPUUSER('XXXXX\user1')
If you are defining a Windows™ user in the username@internet_domain format, that contains the at sign (@), for example administrator@mywindom.com, you must enclose the entire character string in single quotes: 
CPUUSER('administrator@mywindom.com')
SSLLEVEL(ON|OFF|ENABLED|FORCE)
Must have one of the following values:
ON
The workstation uses SSL authentication when it connects with its domain manager. The domain manager uses the SSL authentication when it connects with a domain manager of a parent domain. However, it refuses any incoming connection from its domain manager if the connection does not use SSL authentication.
OFF
The workstation does not support SSL authentication for its connections. This is the default.
ENABLED
The workstation uses SSL authentication only if another workstation requires it.
FORCE
The workstation uses SSL authentication for all of its connections. It refuses any incoming connection if it is not SSL.
If this attribute is set to off or omitted, the workstation is not intended to be configured for SSL. In this case, any value for SSLPORT will be ignored. You must also set the nm ssl port local option to 0 to be sure that this port is not opened by netman.
SSLPORT(SSL port number|31113)
Defines the port used to listen for incoming SSL connections. This value must match the one defined in the nm SSL port local option of the workstation. It must be different from the nm port local option that defines the port used for normal communications. If SSLLEVEL is specified but SSLPORT is missing, 31113 is used as the default value. If not even SSLLEVEL is specified, the default value of this parameter is 0 on fault-tolerant workstations, which indicates that no SSL authentication is required.
FIREWALL(YES| NO)

Specifies if the communication between a workstation and its domain manager must cross a firewall. If you set the FIREWALL keyword for a workstation to YES, it means that a firewall exists between that particular workstation and its domain manager, and that the link between the domain manager and the workstation (which can itself be another domain manager) is the only allowed link between the respective domains. Also, for all the workstations having this option set to YES, the commands to start (start wkstation) or stop (stop wkstation) the workstation or to get the standard list (showjobs) are transmitted through the domain hierarchy instead of opening a direct connection between the master (or domain manager) and the workstation. The default value for FIREWALL is NO, meaning that there is no firewall boundary between the workstation and its domain manager.

To specify that an extended agent is behind a firewall, set the FIREWALL keyword for the host workstation. The host workstation is the IBM Workload Scheduler workstation with which the extended agent communicates and where its access method resides.