Tracker for VM

The sample library members EQQCVM2, EQQUX9N can be used to create a tracker for VM operating environments. When installed, the tracker enables you to schedule an operation on a computer workstation to initiate and track processing in a VM environment. The request to start the processing is communicated to VM using NJE. Status is reported back to the Z controller from VM.

To install a VM tracker in your environment, follow these steps:
  • Specify a symbolic destination ID in the USER keyword of the ROUTOPTS initialization statement.
  • Create a computer automatic workstation which specifies the same destination ID.
  • Workstations that specify a user-defined destination are initially set to unknown status every time the Z controller is started. You are responsible for setting the status of the VM workstation to ACTIVE status. You can use the WSSTAT command, the EQQUSINW subroutine or the HCL Workload Automation for Z modify current plan (MCP) dialog. You should consider setting the workstation to ACTIVE status in EQQUX000, the start/stop exit. The sample library member EQQUX0N contains a sample EQQUX000 to set workstation status using the EQQUSINW subroutine.
  • The sample library member EQQUX9N contains an operation-initiation exit (EQQUX009), written in PL/I which is loaded by the Z controller. The exit is called by the external router subtask when an operation is ready to be started at a workstation which specifies a user-defined destination ID. You need to update the sample to define the destination ID, the receiving VM user and a nonheld SYSOUT class. This sample assumes that the VM execs are stored on VM and that a one line member in EQQJBLIB describes the name of the EXEC and any required parameters.
  • Specify EXITS CALL00(YES) LOAD(EQQUX0N) and CALL09(YES) LOAD(EQQUX9N) for the Z controller.
  • Modify the JCL procedure for the Z controller to include:
    • A ddname UX09LOG to get a log of all transmissions to VM
    • A ddname SYSPRINT if you want a message from EQQUX0N to be written, or delete the PUT statements in EQQUX0N.
  • The sample library member EQQCVM2 contains the components required on VM. It consists of 2 CMS EXECs OPCWATCH and OPCSTAT. OPCWATCH is a REXX EXEC to drive a VM AUTOLOG machine. When operations are received from the Z controller by EQQUX9N, OPCWATCH starts the required VM EXEC. The OPCSTAT EXEC reports status back to the Z controller by submitting batch jobs via NJE. The batch jobs execute the EQQEVPGM program.