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 IBM® Z Workload Scheduler 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.