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


Performing job collection with CONTROL-M

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

Before you begin

Before you perform job collection with CONTROL-M, verify these values have been set for the CONTROL-M keywords in the BKMINI product parameter library member.

In the :ACDI section:

About this task

Automated Critical Data Identification uses the CTMRFLW CONTROL-M utility EXEC to create a job flow report based upon input scheduling files and table member names specified on the Application SETUP Options panel. Automated Critical Data Identification automatically constructs the appropriate job to complete the job collection event.

The scheduling files and their table member names are defined by the CONTROL-M product coordinator. They can contain multiple scheduling files (as input) for any application defined to Automated Critical Data Identification. You can also define standard scheduling files through definitions in the BKMINI product parameter library member.

Procedure

  1. From the Application AutoBuild Options panel, select the JOB COLLECT option. The APPLICATION JOB COLLECTION OPTIONS panel is displayed.
  2. From the APPLICATION JOB COLLECTION OPTIONS menu, select the CONTROL-M option. The Supply Application CTL/M Information Fields panel is displayed.
  3. In the CTL/M Scheduling File Names and the Table Member Names fields, type the names of the scheduling files and table members that correspond to the CONTROL-M job entries you want to collect. You can specify a total of 15 entries.
    Note:
    If this is the initial job collection event, the scheduling file names are either blank or contain the names of the data sets defined using the CTLM_SCHEDFILES value specified in the BKMINI PARMLIB member. If job entries have been previously collected, the scheduling file names and table members shown are the current and previous values specified for the application.
  4. Press Enter to save and activate your entries.
  5. From the JOB Statement Verification For Batch Submit panel, review the job card specification and make any changes, if needed.
  6. Press Enter to continue or press F3 to exit.
  7. Select from these options to process the batch job:

Sample CONTROL-M batch collection job

The CONTROL-M job scheduling product requires you to submit an Automated Critical Data Identification constructed job, (generated through the CONTROL-M job collection option on the APPLICATION JOB COLLECTION OPTIONS panel) which produces a CONTROL-M job flow report. The output of the job flow report is used as input to the second step to save the job entries in the Automated Critical Data Identification Application Data Inventory database.

Sample

 //JCLL JCLLIB ORDER=(prefix.value.SBKMJCL)               
 //         INCLUDE MEMBER=IOASET                                        
 //CTMRFLW  PROC                                                         
 //STEP1    EXEC PGM=CTMRFLW,REGION=&REG                                 
 //         INCLUDE MEMBER=&IOAENV                                       
 //DAALOCIN DD DISP=SHR,DSN=&DAALOCIN(ALCMRFLW)                          
 //SCHOUT   DD SPACE=(TRK,(300,300)),UNIT=&WORKUNIT                      
 //DAJOB    DD DDNAME=&SOURCE                                            
 //SCHEDULE DD DISP=SHR,DSN=&OLPREFM..SCHEDULE(&FLOWMEM)                 
 //CKP      DD DISP=SHR,DSN=&DBPREFM..CKP                                
 //SYSPRINT DD SYSOUT=&OUT                                               
 //DAFLWPRM DD DDNAME=SYSIN                                              
 //DAREPORT DD SYSOUT=&OUT            REPORTS SYSOUT                     
 //DACHART  DD SYSOUT=&OUT            FLOW CHART SYSOUT                  
 //DACHART1 DD SYSOUT=&OUT,DCB=(OPTCD=J),                                
 //            CHARS=(&CHARSET,&CHARST2)                                 
 //DACHART4 DD SYSOUT=&OUT,DCB=(OPTCD=J),                                
 //            CHARS=GT24             VERY SMALL LETTERS                 
 //DACHART9 DD SYSOUT=&OUT,DCB=(OPTCD=J),                                
 //            CHARS=(&CHARSET,FM99)  BOLD BOX ELEMENTS                  
 //SYSOUT   DD SYSOUT=&OUT                                               
 //DATRACE  DD SYSOUT=&OUT                                               
 //SYSABEND DD SYSOUT=&OUTDUMP                                           
 // PEND                                                                 
 //          EXEC  CTMRFLW                                               
 //DAREPORT DD DISP=SHR,DSN=PDUSER.APPL.CLMOUTPT                        
 //DAJOB    DD DISP=SHR,DSN=FILE1(NAME1)                                 
 //         DD DISP=SHR,DSN=FILE2(NAME2)                                        
 //         DD DISP=SHR,DSN=FILE3(NAME3)                                        
 //*                                                                     
 //*   APPL NAME = APPL                                                  
 //*    JOB TYPE = CLM JOB COLLECTION                                    
 //*     SUBMIT BY PDUSER  ON 12/01/2009 09:30:29                       
 //*                                                                     
 // IF (RC < 5 ) THEN                                                    
 //JOBCM   EXEC BKMCM606,APPL=APPL,                                      
 // MPGMI=BKMCM606,                                                      
 // RPT=PDUSER.APPL.CLMOUTPT                                            
 // ENDIF                                                                
 // IF (RC < 5 ) THEN                                                    
 //JOBCOLL EXEC BKMJOBSQ                                                 
 // ENDIF                                                                

In the example, three scheduling files and their table members have been concatenated as the DAJOB DDname. The pre-allocated output file is assigned to the DAREPORT DDname.

Note:
The CTMRFLW utility JCL used should not contain the DAREPORT and DAJOB DDname statements. If they exist, they will be overridden by the Automated Critical Data Identification constructed statements shown above.

Parameters

APPL appl
The application name.
MPGMI
The job collection procedure.
RPT
The location of the job collection output.

Sample CONTROL-M application job list

This example shows a sample CONTROL-M application job list. You can display the application job list using the STATUS option on the Application AutoBuild Options panel.

When you select the Display Current JOB List option from the APPLICATION Display Selections panel, the Application JOB Sequence List panel is displayed. The Misc Descriptive Info field on the Application JOB Sequence List panel shows the contents of the CONTROL-M Table Job Flow report output as extracted for each job entry listed on the left. The job name entries in the first column are the current contents of the scheduling files and table members used as input and generated from the CTMRFLW utility program. For example:

Row 1 to 14 of 582 
   Command ==>                   Application ==> CTLMAPPL                        
                           Collection Method ==> CONTROL-M Table Entries         
                               
                                                                           
  -- Jobname -- -- Misc Descriptive Info -------------                     
                                                                           
     ADABKUAT    1 ADABKUAT          ODATE 010725   TIME FROM 1900 UNTIL   
     ADABKUCJ    1 ADABKUCJ          ODATE 010725   TIME FROM 0400 UNTIL   
     ADABKUHS    1 ADABKUHS          ODATE 010725   TIME FROM 0200 UNTIL   
     BACKUPM     1 BACK UPM          ODATE 010723                          
     BECIDOWN    3 BECIDOWN BECISHUT ODATE 010725                          
     BECIJRN4    2 BECIJRN4 BECISHUT ODATE 010725                          
     BECISHUT    1 BECISHUT          ODATE 010725   TIME FROM 2209 UNTIL   
     BECIUP      1 BECIUP            ODATE 010725   TIME FROM 0601 UNTIL   
     BELLAS01    1 BELLAS01          ODATE 010725   TIME FROM 0130 UNTIL   
     BELLAT00    1 BELLAT00          ODATE 010725   TIME FROM 0745 UNTIL   
     BEMASSCT    2 BEMASSCT BECISHUT ODATE 010725                          
     BEMASSS1    1 BEMASSS1          ODATE 010725   TIME FROM 0159 UNTIL   
     BEMASS1T    1 BEMASS1T          ODATE 010722   TIME FROM 0603 UNTIL

Sample CONTROL-M application anchor job structures list

This example shows a sample application anchor job structure list. You can display the anchor job structure list using the STATUS option on the Application AutoBuild Options panel.

When you select the Display Current JOB Anchor Chains option from the APPLICATION Display Selections panel, the Application ANCHOR Job Structures panel is displayed. The Job Structure Elements field on the Application ANCHOR Job Structures panel lists the successor jobs for the job named in the JOB/Anchor field. This information is extracted from the CTMRFLW output report using the DEPEND ON field.

Note:
Job entries that have the same name as a successor are assigned a name by Automated Critical Data Identification.
Command ==>                                        Row 183 to 196 of 625 
   Valid Commands => NOte, SAVE and SORT(c)  APPLICATION ==> CTLMAPPL         
                                                                              
   - JOB/Anchor - - Type - -- JOB Structure Elements -----------------        
                                                                              
      FINETD        CTL/M   FINETD                                            
      FIPANBKP      CTL/M   FIPANBKP                                          
      FIPAYCD       CTL/M   FIPAYCD                                           
      FIPAYEXC      CTL/M   FIPAYEXC                                          
      FIPDTANK      CTL/M   FIPDTANK                                          
      FIREOLED      CTL/M   GFSBGNDF                                          
      FISCHED       CTL/M   FISCHED                                           
      FISHOUT       CTL/M   FISHOUT                                           
      FISTD         CTL/M   FISTD                                             
      FIVERIFY      CTL/M   FIBKUPD2 FIBKUPD3 FIBKUPD4 FIBKUPD5 FIBKUPD6      
                            FIBKUPD7                                          
      FIVERIF1      CTL/M   FIBKUPD0 FIBKUPD1 XIBKUPD1                        
      FIVERIF2      CTL/M   FIBKUPI0 FIBKUPI1                                 
      FIVP8J02      CTL/M   FILISTD2

Sample CONTROL-M batch SYSPRINT report

This example shows sample job entries in the CONTROL-M batch SYSPRINT file.

Sample job entries

An example of the job entries in the batch SYSPRINT file from the last collection job is shown below. Information contained in the file has been extracted from the CTMRFLW output report.

CURRENT DATE = 11/15/01  CURRENT TIME = 09:46:32                 PAGE = 2  
                                                                             
                      J O B S C A N   Output  Summary:                     
                                                                             
                                                                             
 Locating JOB List For Application: CTLMAPPL                                 
 Job Collection Type: REPLACE                                                
             Options: NONE                                                   
   Job Entries Saved: By ALL Jobs                                            
    Filtering Status: ENABLED                                                
  Initial Anchor Job: CDINV04                                                
                                                                             
JOB NAMES REMOVED BY FILTERING: WEU00617 WEU00301 WEU00461 WEU0461Y          
                                                                             
                                                                             
  Job Name:    CONTROL-M Scheduling ( Job Flow Report ) Data:                
  ---------    ----------------------------------------------                
                                                                             
  HLPCO041     1 HLPCO041          ODATE 010421   TIME FROM 0040 UNTIL 0500  
  SWTOM13      1 SWTOM13           ODATE 010723   TIME FROM 0700 UNTIL
  SWTOM14      1 SWTOM14           ODATE 010723   TIME FROM 0700 UNTIL   
  LMCS         1 LMCS              ODATE 010725   TIME FROM 1100 UNTIL   
  CCRF         1 CCRF              ODATE 010725   TIME FROM 1130 UNTIL   
  CASCHED      1 CASCHED           ODATE 010725                          
  CDSCHED      1 CDSCHED           ODATE 010725                          
  CELSCHED     1 CELSCHED          ODATE 010725                          
  CRSCHED      1 CRSCHED           ODATE 010725                          
  BESCHED      1 BESCHED           ODATE 010725                          
  DBSCHED      1 DBSCHED           ODATE 010725                          
  DPACFSCH     1 DPACFSCH          ODATE 010725                          
  DPCOTSCD     1 DPCOTSCD          ODATE 010725                          
  DPJSCHED     1 DPJSCHED          ODATE 010725                          
  FICTMSCH     1 FICTMSCH          ODATE 010725                          
  SWSCHED      1 SWSCHED           ODATE 010725                          
  DPJHABND     1 DPJHABND          ODATE 010725                          
  TESTJOB2     1 TESTJOB2          ODATE 010725   TIME FROM 1000 UNTIL   
  SMSBKLRG     1 SMSBKLRG          ODATE 010725   TIME FROM 0300 UNTIL   
  WEDB2WEP     1 WEDB2WEP          ODATE 010725                          
  TESTJOB3     1 TESTJOB3          ODATE 010725   TIME FROM 1105 UNTIL   
  SMSBKSTD     1 SMSBKSTD          ODATE 010725   TIME FROM 0300 UNTIL

Sample anchor structure entries

An example of the anchor structure entries in the batch SYSPRINT file from the last collection job is shown below. Information contained in the file has been extracted from the CTMRFLW output report.

J O B  SCHEDULING - Anchor/DEP Job List                      
                                                                              
 DEP Job:     Successor Job/Member Name List:                                 
 ---------    ----------------------------------------------                  
                                                                              
 CDINV04     CDLOC03                                                          
 DPPM2CAT    DPPM2DLY                                                         
 HLPNITLY    HLPCS007                                                         
 BYSERIAL    SORTSERL                                                         
 SORTSERL    SER#LIST                                                         
 SER#LIST    FTPJCLT                                                          
 FTPJCLT     EISEDIT                                                          
 BECISHUT    BECIJRN4 BE14RQPO BE22R2BA BEMASSCT BECIDOWN                     
 BEMASSCT    BECIDOWN                                                         
 CDCICSCL    CDDAILY                                                          
 CDDAILY     CDCICSOP                                                         
 COTMSDLY    VAULT                                                            
 KMDVAL      KMDUJIGF                                                         
 CIMSDCO2    CIMSBULK CIMSDISK                                                
 KMDADST9    KMDADSTM                                                         
 KMDADSTM    KMDADSTG                                                         
 KMDLZR      KMDDAMS                                                          
 KMDCCIR     KMDBKUPW                                                         
 KMDBKUPW    KMDWKRPT ADAROLL                                                 
 KICKOFF     FIREOLED                                                         
 STARTUP     XIMIS    XISHOUT  XILDPAJV XILDEMP  XILDVINT XILDERIS XIGS8JW0   
             XFSEPNY  XFSINDR  XFSLEAV  XFSSHOP  XFSNCPR  XIAD1JIC XIADVSM    
             XIADCGM  XFSFADP  XFSX002  XFSFALS  XFSX003  XIBKUPI2 XFSEQPT    
             XFSIN91  XFSINF3  XFSINRP  XIBKUPMB XFSMBILL XFSRBILL XFSSR50    
             XFSSR51  XIBKUPFB XFSFBILL XFSFHWT  XFSSR52  XFSSR54  XFSAM82    
             XFSA656  XFSA601  XFSIN40  XFSIN70  XIIATADD FIBKUPD1 FIMIS      
             FISHOUT  FILDSUSF FILDPAJV FILDEMP  FILDVINT FILDERIS FIIATADD   
             FIGS8JW0 GFSINR2  GFSEPNY  GFSINDR  GFSLEAV  GFSSHOP  GFSRECJ    
             GFSARCH  GFSNCP   GFSNCPR  FIAD1JIC FIADVSM  FIADCGM  GFSFADP    
             GFSX002  GFSFALS  GFSX003  FIBKUPI2 GFSEQPT  GFSRESJ  GFSINB2    
             GFSIN91  GFSINF3  GFSINRP  FIBKUPMB GFSMBILL GFSRBILL GFSSR50    
             GFSSR51  FIBKUPFB GFSFBILL GFSFHWT  GFSSR52  GFSSR54  GFSAM82    
             GFSA656  GFSA601  GFSIN40  GFSIN70                              
 FIREOLED    GFSBGNDF

Sample CONTROL-M job collection reports

This information shows an example of CONTROL-M job collection reports which display the structure of the jobs.

In this example, job ABCJOB03 is succeeded by the ABCJOB02, ABCJOB04, and ABCJOB01 jobs. Jobs ABCJOB13 and ABCJOB23 are independent from ABCJOB03 and have successor jobs:

         ORIGINAL JOBS FOR APPLICATION: CONTROLM1  2012/05/13 08:31:18    
                                                                        
 JOBNAME          CTLM GROUP           PREDECESSOR                      
 -------          ----------           -----------                      
                                                                        
 ABCJOB03         XXXDMN1                                               
   ABCJOB02       XXXDMN1              ABCJOB03                         
   ABCJOB04       XXXDMN1              ABCJOB02                         
   ABCJOB01       XXXDMN1              ABCJOB04
 ABCJOB03 HAS        3 SUCCESSOR JOBS                         
                                                                        
 ABJOB13          XXXDMN2                                              
   ABCJOB14       XXXDMN2              ABCJOB13
 ABJOB13  HAS        1 SUCCESSOR JOBS                         

 ABJOB23          XXXDMN3                                       
   ABCJOB24       XXXDMN3              ABCJOB23
 ABJOB23  HAS        1 SUCCESSOR JOBS                
 

If job filters exist for the application, a report is also created. The following figure shows an example of this type of report.

        JOBS AFTER FILTERING FOR APPLICATION: CONTROLM1  2012/05/13 08:31:18    
                                                                        
 JOBNAME          CTLM GROUP           PREDECESSOR                      
 -------          ----------           -----------                      
                                                                        
 ABCJOB03         XXXDMN1                                               
   ABCJOB02       XXXDMN1              ABCJOB03                         
   ABCJOB04       XXXDMN1              ABCJOB02
 ABCJOB03 HAS          2 SUCCESSOR JOBS                         
                                                                        
 ABJOB13          XXXDMN2                                              
   ABCJOB14       XXXDMN2              ABCJOB13
 ABJOB13  HAS          1 SUCCESSOR JOBS                         

 ABJOB23          XXXDMN3
                                     
   ABCJOB24       XXXDMN3              ABCJOB23
 ABJOB23  HAS          1 SUCCESSOR JOBS


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