Sample KeyStroke Reports and Utilities

The IOA KSL and IOA SAMPLE libraries contain BMC-supported and customer-contributed examples of KSL scripts, respectively.

Sample KSL Report Outputs

Two types of reports are available:

Reports produced in batch by KSL scripts. These are listed later in this chapter, and samples of supported KSL scripts are located in the IOA KSL library.
Special reports that cannot readily be produced using the Online facility or KSL. These are produced by utilities that are described in the INCONTROL for z/OS Utilities Guide.

Some reports are produced from information in the IOA Log file. Other reports are produced from the Active Jobs file, Jobs Statistics file, Job Network file and from tables.

If you choose to modify an existing sample report or utility, BMC recommends that you save the changed report under a different name and keep the original report unchanged. This precaution can help in error detection if the altered KSL script does not run as expected.

Sample KSL Report OutputsLink copied to clipboard

The following sample outputs are the result of running job REPJBDEF (in the Control-M JCL library), which invokes sample KSLREPSCHED (in the IOA KSL library).

Output #1 from the sample KSL Script:

Figure 16 Output from KSL Library Sample KSLREPSCHED

Copy

KEYSTROKE REPORTING LANGUAGE   (REL PROD.)         DATE 06/06/01 TIME 10.08 PAGE 000001
           LIST OF JOBS  TABLE: PRODYH  LIB: CTM.PROD.SCHEDULE
           =============================================================================
---------------------------------------------------------------------------
       PRODYIDK   UPDATE # 1
       PRODYHST   UPDATE # 2
       PRODYJCL   CREATE INPUT FILES # 2
       PRODYBTL   REPORTS FOR BRANCHES
       PRODYHTK   PROCESS INPUT DATA FOR PRODYHST
       PRODYHC2   CREATE INPUT FILE # 2
       PRODYBCK   PROCESS INPUT DATA FOR PRODYIDK
       PRODYIZN   REPORTS FOR BRANCH MANAGERS 
       PRODYEND   REPORTS FOR MAIN OFFICE
       PROJYFOT   BEGIN OF EVENING PROCESS
       PROJYMRG   EVENING UPDATE PROCEDURE
       PROJYMTI   VERIFICATION PROCESS OF EVENING UPDATE
       PROJYHO1   SPECIAL CALCULATIONS FOR ACCOUNTING DEPARTMENT
       PROJYHO2   REPORTS FOR ACCOUTING DEPARTMENT
       PROJYDPY   UPDATE OF ON-LINE FILES
       PROJYDTK   REPORTS OF ON-LINE FILES
       PROJYDLI   CREATE DUAL ON-LINE FILE
       PROYH11    YH APPLICATION UPDATE
       PROJYFIN   CLEAN-UP FOR YH APPLICATION
       PROJYBNK   VERIFICATION OF BRANCH BALANCES
       PROJEND    FINAL YH APPLICATION PROCEDURE
       PROLYPAR   NIGHT INPUT COLLECTION # 1
       PROLYDOC   BACKUP FILES STATUS REPORTS
       PROLYFMZ   REPORTS FOR MAIN OFFICE
       PROLYDEL   DELETE TEMPORARY "REPORT" FILES
       PROLYBME   CREATE EXTERNAL TAPE
       PROLYDM2   ARCHIVE YH APPLICATION DATA SETS #2
       PROLYDM1   ARCHIVE YH APPLICATION DATA SETS #1
 ======= >>>>>>>>>>>>>>>>>>>    NO MORE JOBS IN TABLE      <<<<<<<<<<<<<<<< =======

Figure 17 Output #2 from the sample KSL Script:

Copy

BMC SOFTWARE, INC. IOA KEY-STROKE REPORTING LANGUAGE (REL PROD.)
DATE 06/06/01 TIME 10.12PAGE 000001

         SCHEDULE DEFINITION OF MEMBER PRODYBCK  IN TABLE PRODYH   LIBRARY CTM.PROD.SCHEDULE
         ======================================
 +-----------------------------------------------------------------------------+
 | MEMNAME PRODYBCK    MEMLIB   CTM.PROD.SCHEDULE                              |
 | OWNER   M44         TASKTYPE JOB    PREVENT-NCT2 Y DFLT  N                  |
 | APPL    APPL-L                      GROUP BKP-PROD-L                        |
 | DESC    DAILY BACKUP OF SPECIAL FILES FROM APPL-L                           |
 | OVERLIB CTM.OVER.JOBLIB                                                     |
 | SET VAR                                                                     |
 |.CTB STEP AT         NAME            TYPE                                    |
 | DOCMEM  BACKPL02    DOCLIB   CTM.PROD.DOC                                   |
 | =========================================================================== |
 | DAYS                                                          DCAL          |
 |                                                                    AND/OR   |
 | WDAYS                                                         WCAL          |
 | MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y      |
 | DATES                                                                       |
 | CONFCAL WORKDAYS SHIFT       RETRO N MAXWAIT 04  D-CAT                      |
 | MINIMUM          PDS                                                        |
 | =========================================================================== |
 | IN       START-DAILY-BACKUP   ODAT                                          |
 | CONTROL                                                                     |
 | RESOURCE INIT                 0001      CART                 0001           |
 | PIPE                                                                        |
 | TIME: FROM       UNTIL       PRIORITY     DUE OUT       SAC      CONFIRM    |
 | =========================================================================== |
 | OUT      BAKCKPL02-ENDED-OK   ODAT +                                        |
 | AUTO-ARCHIVE Y          SYSDB    Y      MAXDAYS      MAXRUNS                |
 | RETENTION:  # OF DAYS TO KEEP 030  # OF GENERATIONS TO KEEP                 |
 | SYSOUT OP   (C,D,F,N,R)                                              FROM   |
 | MAXRERUN     RERUNMEM                              INTERVAL       FROM      |
 | STEP RANGE         FR (PGM.PROC)          .          TO          .          |
 | ON PGMST          PROCST          CODES                                 A/O |
 |   DO                                                                        |
 | SHOUT WHEN                                       TO                  URGN   |
 |   MS                                                                        |
 ======= >>>>>>>>>>>>>>>>>>> END OF SCHEDULING PARAMETERS <<<<<<<<<<<<<<<< =====