Controlling a z/OS system through a TCP/IP link

Controlling a z/OS system through a TCP/IP link shows a z/OS system connected to the HCL Workload Automation for Z host via a TCP/IP link.

You represent each system by a computer workstation. The destination field in the workstation description for System A is left blank. Work for this workstation is started on System A. The destination field for the System B workstation contains the destination name associated with the IP address of the tracker on this system. Work is transmitted from the host to the tracker and is then initiated on System B.

Figure 1. Controlling a z/OS system through a TCP/IP link

eqqi10ah The graphic shows a system that is controlled by another system via a TCP/IP link.

On System A, an event writer writes events to event data set A, which is read by an event reader subtask at the controller. On system B the tracker event-writer subtask is started with a reader function, EWSEQNO is defined in the EWTROPTS statement. This means that the event writer passes the events to NCF for transfer to the controller at the same time as they are written to the event data set.

Automatic workload restart can be used in this configuration if the controller cannot communicate with the tracker on system B. The status of the workstation for System B is set to offline if z/OS is stopped or fails, if the tracker is stopped or fails, or if the link is lost. WLR actions are taken according to the WSOFFLINE keyword of the JTOPTS initialization statement.

Example EQQPARM Members for the previous figure shows the initialization statements you can use to create the configuration in Controlling a z/OS system through a TCP/IP link.

Table 1. Example EQQPARM Members for the previous figure
EQQPARM members for System A
CONTROLR 
OPCOPTS  OPCHOST(YES)
         ERDRTASK(1)
         ERDRPARM(ERDR1)
TCPOPTS  TCPIPJOBNAME('TCPIP')
         HOSTNAME('9.12.134.1')
         TRKPORTNUMBER(8888)
ROUTOPTS TCPIP(DEST1:'1.111.111.111'/4444)
TRACKERA 
OPCOPTS OPCHOST(NO)
        ERDRTASK(0)
TRROPTS HOSTCON(DASD)
ERDR1 
ERDROPTS ERSEQNO(1)
TRKAEW 
EWTROPTS

EQQPARM members for System B

TRACKERB 
OPCOPTS OPCHOST(NO)
        ERDRTASK(0)
        EWTRTASK(YES)
        EWTRPARM(TRKBEW)
TCPOPTS  TCPIPJOBNAME('TCPIP')
         HOSTNAME('1.111.111.111')
         TRKPORTNUMBER(4444)
TRROPTS HOSTCON(TCP)
        TCPHOSTNAME('9.12.134.1')
        TCPPORTNUMBER(8888)
TRKBEW 
EWTROPTS EWSEQNO(1)
Note: In this example, the name of the destination is DEST1. The destination is defined also in the destination field of the workstation.