CTMDSR - Recovery report for SYSOUT actions

The CTMDSR utility enables you to generate a recovery report that lists SYSOUT actions or DO SYSOUT actions with an indeterminate end status. Such SYSOUT actions might exist when Control-M runs in multi-SPY mode and the Control-M Monitor terminates abnormally.

In multi-SPY mode, SYSOUT actions are performed asynchronously. This can result in an update of job status to ENDED OK or ENDED NOTOK before the SYSOUT action has been performed. If the Control-M monitor terminates abnormally during that time, the job remains in ENDED status even though the SYSOUT action has not been performed. Note that if the job is in the post-processing phase during the abnormal termination of Control-M, the job will complete during the Control-M recovery process.

The CTMDSR utility detects SYSOUT actions with an indeterminate end status based on the messages in the IOA Log.

The following JCL sample for running CTMDSR can be found in the CTM JCL library:

//*********************************************************************

//*                            CTMDSR JOB                             *

//*                                                                   *

//*   THIS JOB RUNS THE CTMDSR UTILITY, TO CHECK THE IOA LOG FOR      *

//*   'SYSOUT' ACTIONS THAT MIGHT NOT HAVE COMPLETED BEFORE AN        *

//*   ABNORMAL TERMINATION OF THE CONTROL-M MONITOR.                  *

//*                                                                   *

//*   INPUT:                                                          *

//*   ======                                                          *

//*   SYSIN DD CARD -> REPSTART YYMMDDHHMM                            *

//*                    REPEND   YYMMDDHHMM                            *

//*                                                                   *

//*   REPSTART REPRESENTS THE START TIME, AND REPEND REPRESENTS THE   *

//*   END TIME. ENSURE THAT BOTH PARAMETERS APPEAR ON CONSECUTIVE     *

//*   LINES, WITH NO LINES IN BETWEEN.                                *

//*   WHEN THE DD CARD IS MISSING THE DEFAULT VALUES WILL BE USED.    *

//*                                                                   *

//*   DEFAULT VALUES:                                                 *

//*   REPSTART 0001010000 (BEGINNING OF THE YEAR 2000)                *

//*   REPEND CURRENT DATE AND TIME                                    *

//*                                                                   *

//*                                                                   *

//*   OUTPUT:                                                         *

//*   =======                                                         *

//*   THE PROGRAM PRINTS A REPORT OF ALL THE 'SYSOUT' ACTIONS THAT    *

//*   MIGHT NOT HAVE COMPLETED BEFORE AN ABNORMAL TERMINATION         *

//*   OF THE CONTROL-M MONITOR.                                       *

//*                                                                   *

//*   REQUIRED DD CARDS:                                              *

//*   ==================                                              *

//*   DALOG, DAREPORT                                                 *

//*                                                                   *

//*********************************************************************

//*

//         JCLLIB  ORDER=xxxx.xxxx.PROCLIB    <== Update the environment prefix    

//         INCLUDE MEMBER=IOASET

//CTMDSR   EXEC PGM=CTMDSR

//         INCLUDE MEMBER=&IOAENV

//DALOG    DD DISP=SHR,DSN=&DBPREFA..LOG

//DAREPORT DD SYSOUT=*

//SYSABEND DD SYSOUT=*

//SYSIN    DD *

REPSTART YYMMDDHHMM         <== Update the date & time the report start

REPEND   YYMMDDHHMM         <== Update the date & time the report end