Previous Topic: 7.3.2.5 OPEN StatementsNext Topic: 7.3.4 Turnaround Time Exit (TURNRTE)


7.3.3 JOBGROUP Exit (JOBGPRTE)

 
 The JOBGROUP exit routine assigns a value to the data element
 JOBGROUP for each batch job recorded in the database.  The
 routine DOES NOT have to consider the computation of job
 turnaround time or the determination of the JOBGROUP service
 received, as these tasks are handled automatically by CA MICS
 under the control of the parameters in
 prefix.MICS.PARMS(JOBGROUP).
 
 Code this exit in SAS and place it in
 prefix.MICS.PARMS(JOBGPRTE).  It is important that this
 routine assign the correct JOBGROUP to every job passed to
 it.  Testing is the responsibility of the user.
 
 Your JOBGROUP exit routine has available to it all the data
 elements in the Batch User Job Activity File (BATJOB).  These
 elements are documented in the CA MICS data dictionary. The
 data elements most often used to determine JOBGROUP
 classification are shown below:
 
     JOB      - Job Identification (job name)
     JOBCLASS - Job Input Class
     JOBPRTY  - Job Input Priority
     PERFGRP  - Performance Group Number
     JOBPRGNM - Job Programmer Name
 
 Note: Your code must not modify the values contained in the
 fields listed above under any circumstances.  The only field
 that should be modified is the data element JOBGROUP, which
 must be set to the correct value for the job that was
 executed.  No CA MICS user exit may issue a RETURN statement
 or exit in any fashion other than execution of the last
 statement in the exit.
 
 Consider the example of an installation that commits to
 turnaround times based on the job class specified for the
 service requested.  The following is the relevant portion of
 this shop's specification in prefix.MICS.PARMS(JOBGROUP):
 
  GROUP 1     10 ' 10 MIN BATCH SERVICE'      (class A)
  GROUP 3     30 ' 30 MIN BATCH SERVICE'      (class B)
  GROUP 5     60 ' 60 MIN BATCH SERVICE'      (class C)
  GROUP 6     90 ' 90 MIN BATCH SERVICE'      (class PRDTST)
  GROUP 7    240 ' 4 HOUR BATCH SERVICE'      (class D)
  GROUP 9   1440 '24 HOUR BATCH SERVICE'      (class E)
  GROUP 11 10080 ' 7 DAY BATCH SERVICE'       (class F)
  GROUP 13 10080 'OTHER'
 
 Assuming that the above job groups correspond to job classes
 A through F, the following SAS code would serve as this
 site's JOBGPRTE exit:
 
     IF JOBCLASS='A' THEN JOBGROUP=1 ;
     ELSE IF JOBCLASS='B' THEN JOBGROUP=3 ;
     ELSE IF JOBCLASS='C' THEN JOBGROUP=5 ;
     ELSE IF JOBCLASS='PRDTST' THEN JOBGROUP=6 ;
     ELSE IF JOBCLASS='D' THEN JOBGROUP=7 ;
     ELSE IF JOBCLASS='E' THEN JOBGROUP=9 ;
     ELSE IF JOBCLASS='F' THEN JOBGROUP=11;
     ELSE JOBGROUP=13;
 
 Note that JOBGROUP=13 was used to identify jobs not matching
 the standard six groups that were defined.  This "catch-all"
 technique should always be used.
 
 The JOBCLASS 'PRDTST' is an example of job class defined
 with a greater than one characters.