Sample procedures

The following procedures serve as examples for automating frequently recurring operations when the SM2 is used in normal computer center operation. They can also be found in the SYSLIB.SM2.<ver> library.

The first procedure starts short-term monitoring with output to a separate file, defining and starting monitoring programs.

The second procedure presupposes that the preceding monitoring operation has already been in progress for some time (e.g. 30 minutes). It terminates monitoring and closes the SM2 output file.

The third procedure makes the preparations for analysis with SM2R1 and updates the master output file. In the example it is assumed that the master output file is on disk. If it is on tape, the procedure has to be modified.

Input files Output file

Old master output file and the SM2 output file that was just closed. New master output file.

The fourth procedure causes the SM2 output file just closed to be analyzed.

Start short-term monitoring (SM2.START.MEASUREMENT)

/BEGIN-PROCEDURE LOGGING=C,PARAMETERS=YES(PROCEDURE-PARAMETERS=( -
/      &CYCLE  = 300,                       -
/      &SAMPLE = 500,                       -
/      &TSN    = '(BCAM,BCAT)',             -
/      &DEVICE = '(E018,E019,E01A)'         -
/      ),ESCAPE-CHARACTER=C'&')
/ASSIGN-SYSDTA TO-FILE=*SYSCMD
/
/REMARK   ====================================================
/REMARK   *** EXAMPLE 1                                    ***
/REMARK   *** DEFAULT FOR MONITORING CYCLE     = 300 S AND ***
/REMARK   *** FOR SAMPLING CYCLE               = 500 MS    ***
/REMARK   ====================================================
/
/REMARK   ====================================================
/REMARK   *** DEFINE SM2 OUTPUT FILE AND LOAD SM2          ***
/REMARK   ====================================================
/
/DELETE-FILE FILE-NAME=SM2.OUTPUT
/SET-JOB-STEP
/
/CREATE-FILE FILE-NAME = SM2.OUTPUT,                                -
/            SUPPORT   = PUBLIC-DISK (SPACE = RELATIVE (            -
/                                      PRIMARY-ALLOCATION   = 576,  -
/                                      SECONDARY-ALLOCATION = 576))
/
/ADD-FILE-LINK LINK-NAME     = SMLINK,          -
/              FILE-NAME     = SM2.OUTPUT,      -
/              ACCESS-METHOD = SAM,             -
/              OPEN-MODE     = OUTPUT
/
/START-SM2
 REMARK   =============================================================
 REMARK   ****   BRANCH TO ADMINISTRATION PART                     ****
 REMARK   =============================================================
 CALL-ADMINISTRATION-PART
 REMARK   =============================================================
 REMARK   ****   DEFINE SYSTEM MONITORING PROGRAM                  ****
 REMARK   ****   MONITOR ALL DISKS AND TAPES                       ****
 REMARK   =============================================================
 SET-SYSTEM-PARAMETERS DEVICES = *SPECIFIED(DEVICE = (*TAPE,*DISK))
 REMARK   =============================================================
 REMARK   ****   DEFINE TASK MONITORING PROGRAM                    ****
 REMARK   ****   MONITOR TASKS WITH TSNS 1111 AND 1112 AND         ****
 REMARK   ****   WITH THE JOB NAME TEST                            ****
 REMARK   ****   MONITOR DISK F00B ONLY                            ****
 REMARK   =============================================================
 SET-TASK-PARAMETERS TASK-SELECTION = *SPECIFIED(TSN      = &TSN,  -
                                                 JOB-NAME = TEST), -
                     DEVICES = *SPECIFIED(DEVICE = &DEVICE)
 REMARK   =============================================================
 REMARK   ****   DEFINE FILE MONITORING PROGRAM                    ****
 REMARK   =============================================================
 ADD-FILE FILE-NAME=:4V05:$TSOS.TSOSCAT
 REMARK   =============================================================
 REMARK   ****   DEFINE BCAM-CONNECTION MONITORING PROGRAM          ***
 REMARK   =============================================================
 SET-BCAM-CONNECTION-PARAMETERS  INWAIT-BUCKETS  = *STD-LIMITS, -
                                 REACT-BUCKETS   = *STD-LIMITS, -
                                 INPROC-BUCKETS  = *STD-LIMITS, -
                                 OUTPROC-BUCKETS = *STD-LIMITS
 ADD-BCAM-CONNECTION-SET                                   -
          SET-NAME=DIALOG,                                -
          CONNECTION-SELECTION = *BY-NEA-NAME(            -
                  CONNECTION-NAME = *SPECIFIED(           -
                          LOCAL-APPLICATION   = $DIALOG,  -
                          PARTNER-APPLICATION = *ANY)),   -
          HOST-SELECTION = *ANY
 REMARK   =============================================================
 REMARK   ****   OPEN SM2 FILE, SPECIFY MONITORING CYCLE AND       ****
 REMARK   ****   SAMPLING CYCLE                                    ****
 REMARK   =============================================================
 MODIFY-MEASUREMENT-PERIODS OFFLINE-PERIOD  = &CYCLE,   -
                            SAMPLING-PERIOD = &SAMPLE
 OPEN-LOG-FILE FILE = *BY-LINK-NAME
 REMARK   =============================================================
 REMARK   ****   START MONITORING PROGRAMS                         ****
 REMARK   =============================================================
 START-MEASUREMENT-PROGRAM TYPE=(*SYSTEM,*TASK,*FILE,*BCAM-CONNECTION)
 REMARK   =============================================================
 REMARK   ****   TERMINATE SM2 USER PROGRAM                        ****
 REMARK   ****   MONITORING CONTINUES IN THE BACKGROUND !!!        ****
 REMARK   =============================================================
 END
/
/END-PROCEDURE

Terminate short-term monitoring and resume former monitoring operations (SM2.STOP.MEASUREMENT)

It is assumed that SM2 was started with the preceding procedure.

/BEGIN-PROCEDURE LOGGING=C,PARAMETERS=YES(PROCEDURE-PARAMETERS=(       -
/      &CYCLE  = 300,                 -
/      &SAMPLE = 500                  -
/      ),ESCAPE-CHARACTER=C'&')
/ASSIGN-SYSDTA TO-FILE=*SYSCMD
/
/REMARK   ==========================================================
/REMARK   ***   EXAMPLE 2                                        ***
/REMARK   ***   DEFAULT FOR MONITORING CYCLE      = 300 S AND    ***
/REMARK   ***   FOR SAMPLING CYCLE                = 500 MS       ***
/REMARK   ==========================================================
/
/REMARK   ==========================================================
/REMARK   ***   DELETE NON-CATALOGED FILE                        ***
/REMARK   ==========================================================
/
/DELETE-FILE FILE-NAME=SM2.CHANGE
/SET-JOB-STEP
/
/REMARK   ==========================================================
/REMARK   ***   LOAD SM2 USER PROGRAM                            ***
/REMARK   ==========================================================
/
/START-SM2
 REMARK   =============================================================
 REMARK   ****   BRANCH TO ADMINISTRATION PART AND TERMINATE       ****
 REMARK   ****   ALL ACTIVE MONITORING PROGRAMS                    ****
 REMARK   =============================================================
 CALL-ADMINISTRATION-PART
 STOP-MEASUREMENT-PROGRAM TYPE=(*SYSTEM,*TASK,*FILE,*BCAM-CONNECTION)
 REMARK   =============================================================
 REMARK   ****   CLOSE SM2 FILE                                    ****
 REMARK   =============================================================
 CLOSE-LOG-FILE
 REMARK   =============================================================
 REMARK   ****   THE MONITORING PROGRAM DEFINITIONS ARE            ****
 REMARK   ****   STILL VALID                                       ****
 REMARK   =============================================================
 REMARK   =============================================================
 REMARK   ****   TERMINATE SM2 USER PROGRAM                        ****
 REMARK   ****   RENAME CLOSED FILE                                ****
 REMARK   =============================================================
 END
/
/MODIFY-FILE-ATTRIBUTES FILE-NAME = SM2.OUTPUT,                      -
/                       NEW-NAME  = SM2.CHANGE,                      -
/                       SUPPORT   = PUBLIC-DISK (SPACE=RELEASE(100))
/
/END-PROCEDURE

Prepare for SM2R1 analysis with the SM2U1 utility (SM2U1.PREPARE)

Update the master output file with all the records with the exception of those for the TASK monitoring program.

/BEGIN-PROCEDURE LOGGING=C,PARAMETERS=YES(PROCEDURE-PARAMETERS=(       -
/     &SM2UIN    = SM2.CHANGE,              -
/     &SM2UTASK  = SM2.SAM.TASK,            -
/     &SM2MASTER = SM2.MASTER               -
/     ),ESCAPE-CHARACTER=C'&')
/ASSIGN-SYSDTA TO-FILE=*SYSCMD
/
/REMARK   ==========================================================
/REMARK   ***   ASSIGN INPUT FILE                                ***
/REMARK   ==========================================================
/
/ADD-FILE-LINK LINK-NAME = SM2UI1,   -
/              FILE-NAME = &SM2UIN
/
/REMARK  ==========================================================
/REMARK  ***   ASSIGN OUTPUT FILE (SM2 MASTER FILE)             ***
/REMARK  ==========================================================
/
/CREATE-FILE FILE-NAME = &SM2MASTER
/SET-JOB-STEP
/
/ADD-FILE-LINK LINK-NAME = SM2UO,      -
/              FILE-NAME = &SM2MASTER
/
/REMARK   ==========================================================
/REMARK   ***   LOAD SM2U1, UPDATE SM2 MASTER FILE AND ALL       ***
/REMARK   ***   RECORDS EXCEPT THOSE FOR THE TASK AND DISK       ***
/REMARK   ***   MONITORING PROGRAMS                              ***
/REMARK   ==========================================================
/
/START-SM2U1
 SELECT-MEASUREMENT-GROUPS SELECTION = *ALL(EXCEPT = *TASK-STATISTICS)
 END
/
/REMARK   ==========================================================
/REMARK   ***   ASSIGN INPUT FILE                                ***
/REMARK   ==========================================================
/
/ADD-FILE-LINK LINK-NAME = SM2UI1,   -
/              FILE-NAME = &SM2UIN
/
/REMARK   ==========================================================
/REMARK   ***   ASSIGN OUTPUT FILE FOR TASK RECORDS              ***
/REMARK   ==========================================================
/
/DELETE-FILE FILE-NAME = &SM2UTASK
/SET-JOB-STEP
/
/CREATE-FILE FILE-NAME = &SM2UTASK
/
/ADD-FILE-LINK LINK-NAME = SM2UO,      -
/              FILE-NAME = &SM2UTASK
/
/REMARK   ==========================================================
/REMARK   ***   LOAD SM2U1, CREATE SM2 FILE FOR TASK             ***
/REMARK   ***   ANALYSIS.                                        ***
/REMARK   ==========================================================
/
/START-SM2U1
 SELECT-MEASUREMENT-GROUPS SELECTION=*TASK-STATISTICS
 END
/
/END-PROCEDURE

Perform analysis with SM2R1 (SM2R1.EVALUATION)

This procedure analyzes the SM2 output file just closed.

/BEGIN-PROCEDURE LOGGING=C,PARAMETERS=YES(PROCEDURE-PARAMETERS=(       -
/      &SM2OUT     = SM2.CHANGE,       -
/      &SM2R1OUT   = SM2R1.OUT,        -
/      &SM2UTASK   = SM2.SAM.TASK,     -
/      &SM2R1OTASK = SM2R1.OUT.TASK    -
/      ),ESCAPE-CHARACTER=C'&')
/
/MODIFY-TERMINAL-OPTIONS OVERFLOW-CONTROL = NO-CONTROL
/
/ASSIGN-SYSDTA TO-FILE = *SYSCMD
/
/DELETE-FILE FILE-NAME = &SM2R1OUT
/SET-JOB-STEP
/
/REMARK   ==========================================================
/REMARK   ***      LOAD SM2R1 AND ANALYZE SM2 FILE               ***
/REMARK   ==========================================================
/
/START-SM2R1 MONITOR-FILE-NAME = &SM2OUT,     -
/            LIST-FILE-NAME    = &SM2R1OUT
 PRINT-CONFIGURATION
 SET-TITLE TEXT='*** STANDARD STATISTICS ***'
 PRINT-REPORTS REPORT-LIST = (*STD, *FILE)
 PRINT-QUEUE-TRANSITION
 END
/
/REMARK   =========================================================='
/REMARK   ***      PRINT SM2R1 OUTPUT FILE                       ***'
/REMARK   =========================================================='
/
/PRINT-DOCUMENT FROM-FILE          = &SM2R1OUT,               -
/               DELETE-AFTER-PRINT = *YES,                    -
/               DOCUMENT-FORMAT    = *TEXT(                   -
/                                     LINE-SPACING=*BY-EBCDIC-CONTROL)
/
/REMARK   =========================================================='
/REMARK   ***              ANALYZE TASK                          ***'
/REMARK   =========================================================='
/
/DELETE-FILE FILE-NAME = &SM2R1OTASK
/SET-JOB-STEP
/
/REMARK   =========================================================='
/REMARK   ***     LOAD SM2R1 AND ANALYZE SM2 FILE                ***'
/REMARK   ***     (TASK RECORDS)                                 ***'
/REMARK   =========================================================='
/
/START-SM2R1 MONITOR-FILE-NAME = &SM2UTASK,      -
/            LIST-FILE-NAME    = &SM2R1OTASK
 SET-TITLE TEXT='*** TASKSTATISTIK ***'
 PRINT-TASK-STATISTICS INFORMATION=*HIGH
 END
/
/REMARK   =========================================================='
/REMARK   ***    PRINT SM2R1 OUTPUTFILE                          ***'
/REMARK   =========================================================='
/
/PRINT-DOCUMENT FROM-FILE          = &SM2R1OTASK,  -
/               DELETE-AFTER-PRINT = *YES,         -
/               DOCUMENT-FORMAT    = *TEXT(        -
/                                     LINE-SPACING=*BY-EBCDIC-CONTROL)
/
/MODIFY-TERMINAL-OPTIONS OVERFLOW-CONTROL=USER-ACKNOWLEDGE
/END-PROCEDURE