Changing the topology of the network

About this task

You can change the topology of your end-to-end network, for example, to migrate from a network where fault-tolerant agents are connected to master domain managers, which in turn are connected to the IBM Z Workload Scheduler connector, to a network where fault-tolerant agents and standard agents are directly connected to the IBM Z Workload Scheduler connector.

To change your topology, perform the following procedure:

Note: This procedure does not cause any loss of events related to jobs currently scheduled in the fault-tolerant agents' current plan, because the jobs will be normally submitted after you complete the steps.

Procedure

Ensure that all the fault-tolerant agents in your network are connected and active.
Stop the job submission by selecting option 9 (SERVICE FUNCTIONS) from the IBM Z Workload Scheduler main menu.
Ensure that the jobs defined on the fault-tolerant agent workstations have one of the following statuses:
- Complete
- Error
- Arriving, with extended status Job submission is deactivated
- Ready, with extended status Job submission is deactivated
This step is optional, but it is required to make sure that none of the events related to the job submission is lost.

Change your network topology by modifying the CPUREC statement as required. For example, suppose that your current topology includes master domain managers and fault-tolerant agents as follows:

DOMREC   DOMAIN(DM1DOM)                                    
         DOMMNGR(DM1)                                      
         DOMPARENT(MASTERDM)                               
CPUREC   CPUNAME(DM1)                                      
         CPUOS(UNIX)                                       
         CPUNODE('XXX.YYY.ZZZ')            
         CPUTCPIP(31111)                                   
         CPUDOMAIN(DM1DOM)                                 
         CPUTYPE(FTA)                                      
         CPUAUTOLNK(ON)                                    
         CPUFULLSTAT(ON)                                   
         CPULIMIT(10)                                      
         CPUTZ(SST)                                        
         CPUUSER(domuser)                  
CPUREC   CPUNAME(FTA1)                                     
         CPUOS(UNIX)                                       
         CPUNODE('YYY.ZZZ.XXX')            
         CPUTCPIP(31111)                                   
         CPUDOMAIN(MASTERDM)                               
         CPUTYPE(FTA)                                      
         CPUAUTOLNK(ON)                                    
         CPUFULLSTAT(OFF)                                  
         CPULIMIT(10)                                      
         CPUSERVER(A)                                      
         CPUTZ(SST)                                        
         CPUUSER(ftauser)

To modify it so that the fault-tolerant agents are directly connected to the end-to-end server, change the CPUREC statement as follows:

CPUREC   CPUNAME(DM1)                                      
         CPUOS(UNIX)                                       
         CPUNODE('XXX.YYY.ZZZ')            
         CPUTCPIP(31111)                                   
         CPUDOMAIN(MASTERDM)                                 
         CPUTYPE(FTA)                                      
         CPUAUTOLNK(ON)                                    
         CPUFULLSTAT(OFF)                                   
         CPULIMIT(10)                                      
         CPUTZ(SST)                                        
         CPUUSER(domuser)                  
CPUREC   CPUNAME(FTA1)                                     
         CPUOS(UNIX)                                       
         CPUNODE('YYY.ZZZ.XXX')            
         CPUTCPIP(31111)                                   
         CPUDOMAIN(DM1DOM)                                 
         CPUTYPE(FTA)                                      
         CPUAUTOLNK(ON)                                    
         CPUFULLSTAT(OFF)                                  
         CPULIMIT(10)                                      
         CPUSERVER(A)                                      
         CPUTZ(SST)                                        
         CPUUSER(ftauser)

Note: To connect a fault-tolerant agent to the end-to-end server, the CPUTYPE must be set to FTA. To connect a standard agent to the end-to-end server, the CPUTYPE must be set to SA.

Renew the Symphony file and then verify that the agents are connected and active.
Reactivate the job submission by selecting option 9 (SERVICE FUNCTIONS) from the IBM Z Workload Scheduler main menu.