(ZOS) WSGrid job template

The WSGrid job template is an input to the WSGrid utility. The template contains the properties that the WSGrid utility uses to interact with a batch job.

• WSGrid job template
• Example JCL to submit a new job
• Example JCL to restart a job

WSGrid job template

//WSGRIDT JOB (),MSGCLASS=H
//RUN EXEC PGM=WSGRID
//*********************************************************************
//*
//* WSGrid Job Template
//*
//* WSGrid is a Java utility that runs under control of JZOS for the
//* purpose of sub-dispatching a batch job. The utility submits the
//* batch job, writes the batch joblog to STDOUT DD as the WCG job runs
//* and then ends with a return code indicating the RC of the batch job.
//*
//* RC codes
//* --------
//*
//* 0-3040 - user range
//*
//*   This is a user defined return code returned by a completed
//*   WCG job.
//*
//* 3041-4096 - system ran
//*
//*   This is a return codes set by system prior to completion of
//*   a WCG job.  The following return codes are defined:
//*
//*     4084 (-12) - WCG job ended in restartable state
//*     4080 (-16) - fatal system error
//*
//*********************************************************************
//*
//* Required settings:
//*
//* 1) WGCNTL symbol must be set to the path-qualified file
//*    containing the WSGRID control properties. See comment
//*    block near WGCNTL DD for further information.
//*
//* 2) WGSUB symbol must be set to the path-qualified file
//*    containing a WCG xJCL job definition.
//*
//* 3) WAS_HOME environment variable must be set to name of
//*    WAS home directory. Find this variable under the STDENV DD.
//*
//* Optional settings:
//*
//* 1) WGSUBS symbol is set to the path-qualified file
//*    containing WCG job substitution properties.
//*
//* 2) WGRSTRT symbol is set to the path-qualified file
//*    used for restart processing output/input.  See
//*    comment block near WGRSTRT DD for further information.
//*
//*********************************************************************
// SET WGCNTL=<path-qualified file name>
// SET WGJOB=<path-qualified file name>
//*SET WGSUBS=<path-qualified file name>
//*SET WGRSTRT=<path-qualified file name>
//*********************************************************************
//*
//* WSGrid Control Properties - required DD
//*
//* queue-manager-name=<MQ queue manager name>
//* scheduler-input-queue=<MQ input queue as defined during configuration>
//* scheduler-output-queue=<MQ output queue as defined during configuration>
//* timeout=<in milliseconds for WSGRID to wait for next outputmessage from job scheduler>
//* debug=<true|false>
//* 
//*********************************************************************
//WGCNTL DD PATH='&WGCNTL.'
//*
//*********************************************************************
//*
//* WSGrid Job Definition - required DD
//*
//* File must contain valid WCG JCL job definition.
//*
//*********************************************************************
//WGJOB  DD PATH='&WGJOB.'
//*
//*********************************************************************
//*
//* WSGrid Job Substitutions - optional DD
//*
//* Values are of form:
//*
//* substitution-prop.<property name>=<property value>
//*
//*********************************************************************
//*WGSUBS DD PATH='&WGSUBS.'
//*
//*********************************************************************
//*
//* WSGrid Restart Token - optional DD
//*
//* Note: restart token is written if and only if this job step ends
//*       with RC=4084 (-12).
//*
//*       The WGRSTRT DD takes precedence over the WGJOB DD, so
//*       if this job is restarted with a non-empty restart file
//*       the WCG job identified by the token will be restarted - a
//*       new job instance based on the job definition in WGJOB is
//*       not created.
//*
//* restart-job=<job_id of the job to restart. specify only when restart a job>
//*********************************************************************
//*WGRSTRT DD PATH='&WGRSTRT.'
//*             PATHOPTS=(ORDWR,OCREAT),
//*             PATHMODE=(SIRUSR,SIWUSR)
//*
//*********************************************************************

Example JCL to submit a new job

Use the following example when we want to submit a job through the WSGrid utility.

//WSGRIDCI JOB 1,'HUTCH',MSGCLASS=O
//SUBMIT EXEC PGM=WSGRID,REGION=0M
//STEPLIB DD DSN=B7CELL.WSGRID.LOAD,DISP=SHR
// DD DISP=SHR,DSN=SYS1.MQM.SCSQLOAD
// DD DISP=SHR,DSN=SYS1.MQM.SCSQAUTH
//*****************************************************
//SYSPRINT DD SYSOUT=*
//*****************************************************
//WGCNTL DD *
queue-manager-name=MQW1
scheduler-input-queue=WASIQCG
scheduler-output-queue=WASOQCG
timeout=5000
submit-timeout=30000
//WGJOB DD PATH='/u/hutch/cg/jcl/SimpleCIxJCL_Ebc.xml'
//WGSUBS DD *
substitution-prop.calctime=5
//* 

Example JCL to restart a job

Use the following example when we want to restart a job through the WSGrid utility.

//B7WSRST4 JOB 1,'Restart IVT',MSGCLASS=O,NOTIFY=?
//SUBMIT EXEC PGM=WSGRID,REGION=0M
//STEPLIB DD DSN=B7CELL.WSGRID.LOAD,DISP=SHR
// DD DISP=SHR,DSN=SYS1.MQM.SCSQLOAD
// DD DISP=SHR,DSN=SYS1.MQM.SCSQAUTH
//SYSPRINT DD SYSOUT=*
//WGCNTL DD *
queue-manager-name=MQW1
scheduler-input-queue=WASIQ
scheduler-output-queue=WASOQ
timeout=5000
restart-job=XDCGIVTtxt-Long:00004
//WGJOB DD PATH='/u/hutch/cg/jcl/EBCxJCL-XDCGIVT-Text_Long.xml' 

Related:

Job scheduler integration with external schedulers

Administer the batch environment