Step 4. Defining the topology to IBM Z Workload Scheduler

About this task

In a normal IBM Workload Scheduler network, you define the sub-domains, the domain managers, and the agents in a database that resides in the master domain manager. In the end-to-end with fault tolerance capabilities environment, you make these definitions to IBM Z Workload Scheduler because the controller acts as the master.

If you have not done it before, now that you have planned the architecture of your distributed network and you have installed the agents, it is time to complete this task. On IBM Z Workload Scheduler, follow these steps:
  1. Use the CPUREC statement to define each agent and the DOMREC statement to define every domain and its corresponding manager. These initialization statements are explained in Defining the distributed agents and domains.

    If you installed agents that run on Windows™, define the user IDs and passwords for the Windows™ users either in the USRREC statement or in a local file on the Windows™ workstation. If you define the users locally, you must also set LOCALPSW(YES) in the TOPOLOGY statement.

    See Defining user IDs and passwords for Windows users for a complete description of this statement.

    CPUREC parameters summarizes the CPUREC keywords:
    Table 1. CPUREC parameters
    CPUREC parameters Description
    CPUNAME Name of the IBM Workload Scheduler workstation.
    CPUOS Host CPU operating system related to the IBM Workload Scheduler workstation.
    CPUNODE Node name or the IP address of the CPU.
    CPUTCPIP TCP/IP port number of netman on the current CPU.
    CPUDOMAIN Name of the IBM Workload Scheduler domain of the CPU or MASTERDM for directly connected fault-tolerant agents.
    CPUHOST Name of the host CPU of the agent.
    CPUACCESS Name of the access method.
    CPUTYPE Agent type.
    CPUAUTOLNK Autolink between the agent and the domain manager.
    CPUFULLSTAT Link from the domain manager operates in Full Status mode.
    CPURESDEP Agent's production control process operates in Resolve All Dependencies mode.
    CPUSERVER A mailman server process on the end-to-end server or a domain manager that sends messages to the agent.
    CPULIMIT Number of jobs that can run at the same time in a CPU.
    CPUTZ Local time zone of the fault-tolerant workstation.
    CPUUSER Default user for the workstation.
    SSLLEVEL The workstation uses SSL authentication when it connects with its domain manager.
    SSLPORT Port used to listen for incoming SSL connections.
    FIREWALL The communication between a workstation and its domain manager must cross a firewall.
    Some notes about CPUREC are:
    • The value of CPUNAME, the four-character workstation name, is the name you entered in the This CPU field at installation time and that you will also enter in the next step when you define the fault-tolerant workstations in the IBM Z Workload Scheduler workstations database.
    • The netman port number in CPUTCPIP is the number you entered in the TCP/IP Port Number field at installation time.
    • The name in CPUDOMAIN is one of the following:
      • The name of one of the domains you define with the DOMREC statement
      • MASTERDM for directly connected fault-tolerant agents
    • The value of CPUTYPE specifies the type of agent, fault-tolerant, standard, or extended, as specified by your installation. You determine which of the fault-tolerant agents are to be the domain managers by specifying their CPUNAME in the DOMREC statement.
    • The value of CPUACCESS is one of the access methods you installed for the extended agent. Use it only if you defined CPUTYPE as XAGENT.
    • The values of CPUFULLSTAT and CPURESDEP must be ON for the fault-tolerant agents you intend to be domain managers and backup domain managers. Leave the values as OFF for all other fault-tolerant agents to limit network traffic and processing overhead.
    DOMREC parameters summarizes the DOMREC keywords:
    Table 2. DOMREC parameters
    DOMREC parameters Description
    DOMAIN Name of the domain that you are defining.
    DOMMNGR Name of the fault-tolerant agent that is to be the manager of this domain.
    DOMPARENT Name of the parent domain.
    Some notes about DOMREC are:
    • The fault-tolerant agents specified in DOMMNGR must have the CPUFULLSTAT and CPURESDEP switches turned to ON.
    • In DOMPARENT write MASTERDM, if you are defining a primary domain. If you are defining a secondary or greater level domain, specify the name of the domain immediately above.
    USRREC parameters summarizes the USRREC keywords:
    Table 3. USRREC parameters
    Keywords Description
    USRCPU The workstation on which the user can launch jobs.
    USRNAM The user name.
    USRPWD The user password.
  2. Define all the agents you specified with the CPUREC statement as fault-tolerant workstations in the IBM Z Workload Scheduler workstations database. Use either the ISPF dialogs or the Dynamic Workload Console linked to the controller to accomplish this task. Settings for fault-tolerant workstations summarizes the attributes required for defining these workstations:
    Table 4. Settings for fault-tolerant workstations
    Field Value Value Description
    Workstation type C Computer
    Reporting attribute A Automatic
    Started task, STC N No
    Destination Blank –
    Server Usage N Neither
  3. Activate the definitions by running the replan, extend plan, or Symphony renew programs in IBM Z Workload Scheduler. With either of these programs IBM Z Workload Scheduler creates the Symphony file and distributes it to the primary domain managers. These in turn distribute the file to their subordinate domain managers and agents. The process is repeated by all levels of domain managers until the plan is distributed to the entire network.