Performing job collection with ASG-Zeke

[ Bottom of Page | Previous Page | Next Page | Contents | Index ]

Performing job collection with ASG-Zeke

To use this job collection method, your installation must have ASG-Zeke installed and the jobs that comprise the application must run under the control of ASG-Zeke.

Before you begin

Before you perform job collection with ASG-Zeke, verify these values have been set for the ASG-Zeke keywords in the BKMINI PARMLIB member.

In the :ACDI section:

JOBCOLL_ZEKE_JCLLIB
JOBCOLL_ZEKE_JCLLIB02
JOBCOLL_ZEKE_JCLLIB03
JOBCOLL_ZEKE_VERSION
JOBCOLL_ZEKE_ZEKEUTL
JOBCOLL_ZEKE_ZEKEUTL02
JOBCOLL_ZEKE_ZEKEUTL03

In the :JCL_DEFAULTS section:

JOBSSPCE
ZEKEOUTF
ZEKEOUTP
ZEKEJOBS
ZEKESPCE

Procedure

From the Application AutoBuild Options panel, select the JOB COLLECT option. The APPLICATION JOB COLLECTION OPTIONS panel is displayed.
Select the ZEKE MVS option from the JOB COLLECTION OPTIONS menu. An ISPF Edit session is displayed to enable you to create the job collection criteria.

Specify the job collection criteria:

JOB — Job name or mask.
ENAME — Event name or mask.
ZAPL —Zeke application or mask.
GROUP —Group ID or mask.

For example:

JOB      AC1*E* AC1*F* AC1*G*                                           
JOB      AC2*                                                           
ENAME    DLYAC*                                                         
ZAPL     AP*                                                            
GROUP    GP1

Press F3. If it is applicable, a Zeke Extraction File panel indicates if ASG-Zeke interface data is available from a previous extraction and the date the data was created. To use the existing extraction file press Enter; otherwise, press F3 to re-extract ASG- Zeke jobs.

Note:

If updates have been made for the application since the last extraction, or if the ASG-Zeke interface has not been used for the current version of ASG-Zeke, press F3 to use the ASG-Zeke interface to extract ASG-Zeke jobs.
If multiple JOBCOLL_ZEKE_JCLLIB token values were specified in the BKMINI member, specify the JCL library to use.
If multiple JOBCOLL_ZEKE_ZEKEUTL token values were specified in the BKMINI member, specify the utility to use.
From the JOB Statement Verification For Batch Submit panel, review the job card specification and make any changes, if needed.
Press Enter to continue or press F3 to exit.
Select from these options to process the batch job:
- To edit the JCL prior to submitting the job, type S in the EDIT JCL Prior to Submit field and press Enter.
- To submit the batch job, type S in the SUBMIT JOB For Execution field and press Enter.
- Press F3 to exit without submitting the job.

Sample ASG-Zeke batch collection job

This information provides an example of the job collection procedure generated through the ZEKE MVS job collection option on the APPLICATION JOB COLLECTION OPTIONS panel.

Sample

 //APPLJRF4 JOB (ACCT),,'ABC                    
 R',CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID           
 //*                                            
 //*                                            
 //JCLL JCLLIB ORDER=(prefix.value.SBKMJCL) 
 //STEPA   EXEC PGM=IEFBR14                     
 //DD02     DD  DSN=ZEKEUTL.AMPZEKE.FILE,       
 //    DISP=(MOD,DELETE),                       
 //    UNIT=SYSALLDA,SPACE=(0,0)                
 //STEP1   EXEC ZEKEUTL                         
 //SYSIN    DD  DISP=SHR,                       
 //  DSN=prefix.value.SBKMPARM(ZEKEUTIL)      
 //AMPZEKE  DD  DISP=CATLG,                     
 //    DSN=ZEKEUTL.AMPZEKE.FILE,                
 //    UNIT=SYSALLDA,                           
 //    SPACE=(CYL,(10,10),RLSE)                          
 //*                                                     
 //*   APPL NAME = ABCRTST1                              
 //*   JOB TYPE = ZEKE JOB COLLECTION                    
 //*     SUBMIT BY PDUSER  ON 11/17/2009 13:22:16       
 //*                                                     
 //STEP2   EXEC BKMZI450,ZPGMI=BKMZI510                  
 // IF (RC < 5 ) THEN                                    
 //JOBZK   EXEC BKMJOBZK,                                
 //  ZPGM=BKMZK450,APPL=ABCRTST1                         
 // ENDIF                                                
 // IF (RC < 5 ) THEN                                    
 //JOBCOLL EXEC BKMJOBSQ                                 
 // ENDIF

Parameters

ZPGM: Specifies the program name to pass to PROC BKMJOBZK.
APPL appl: The name of the application.

Sample ASG-Zeke job collection reports

This information provides examples of ASG-Zeke job collection reports. The ASG-Zeke job collection report indicates the structure of the jobs.

In this example, job ABJOB03 is succeeded, in order, by jobs ABJOB02, ABJOB04 and ABJOB01. The ABJOB13 and ABJOB23 jobs are independent from ABJOB03 and have succeeding jobs:

ORIGINAL JOBS FOR APPLICATION: ABJOBS   2001/10/26 20:17:34       PAGE:  1 
                                                                           
 JOB NAME      ZEKE APPLICATION  ZEKE GROUPID  ZEKE EVENT NAME              
 -------      ----------------  ------------  ---------------              
                                                                           
 ABJOB03          ABJOBS1           AB1       AB1 ABJOB03                  
   ABJOB02        ABJOBS1           AB1       AB1 ABJOB02                  
   ABJOB04        ABJOBS1           AB1       AB1 ABJOB04                  
   ABJOB01        ABJOBS1           AB1       AB1 ABJOB01
 ABJOB03  HAS       3 SUCCESSOR JOBS                  
                                                                           
 ABJOB13          ABJOBS1           AB2       AB1 ABJOB13                  
   ABJOB12        ABJOBS1           AB2       AB1 ABJOB12                  
   ABJOB11        ABJOBS1           AB2       AB1 ABJOB11
 ABJOB13  HAS       2 SUCCESSOR JOBS                  
                                                                           
 ABJOB23          AB2               AB2       AB2 ABJOB23                  
   ABJOB22        AB2               AB2       AB2 ABJOB22                  
   ABJOB21        AB2               AB2       AB2 ABJOB21
 ABJOB23  HAS       2 SUCCESSOR JOBS

If job filters exist for the application, the JOBS AFTER FILTERING FOR APPLICATION report is also created. For example:

JOBS AFTER FILTERING FOR APPLICATION: ABJOBS   2001/10/26 20:17:34   PAGE:  1
                                                                            
 JOB NAME      ZEKE APPLICATION  ZEKE GROUPID  ZEKE EVENT NAME               
 -------      ----------------  ------------  ---------------               
                                                                            
 ABJOB03          ABJOBS1           AB1       AB1 ABJOB03                   
   ABJOB02        ABJOBS1           AB1       AB1 ABJOB02                   
   ABJOB01        ABJOBS1           AB1       AB1 ABJOB01
 ABJOB03  HAS        2 SUCCESSOR JOBS                   
                                                                             
 ABJOB23          AB2               AB2       AB2 ABJOB23                   
   ABJOB22        AB2               AB2       AB2 ABJOB22                   
   ABJOB21        AB2               AB2       AB2 ABJOB21
 ABJOB23  HAS        2 SUCCESSOR JOBS
                                                                           
 ABJOB12          ABJOBS1           AB2       AB1 ABJOB12                   
   ABJOB11        ABJOBS1           AB2       AB1 ABJOB11
  ABJOB12  HAS        1 SUCCESSOR JOBS

[ Top of Page | Previous Page | Next Page | Contents | Index ]