Using the session indicator number in SREPORTS

Products

• IDMS
• IDMS - Database

Issue/Introduction

The SREPORTS use the date/time and session indicator number parameters in narrowing down the selection of records from the archive log file. This document will attempt to clarify the use of the session indicator number.

Questions have arisen as to when and how to use the session indicator number. The Statistics reports use the date/time and session indicator number parameters in narrowing down the selection of records from the archive log file. For SREPORTs 001, 003, and 012 through 016, the use of the date/time and session indicator number parameters is required whereas for SREPORTs 002, 005 through 011 the parameters are optional.

Environment

Release: All supported releases.

Resolution

The session indicator number spans a specified time period that the requested reports are to cover for an occurrence of a DC/UCF session. A DC/UCF session is the period of time from one system startup to the next. The first session within a specified time period begins with the first startup record. SREPORT 000 lists each startup record that exists in the archive log file and when the record was logged.

Therefore in the SREPORT report below, there are 4 startup records and therefore 4 session indicator numbers. The first session indicator number covers the date/time period 12268 04:03; the second 12289 05:20, and so on.

USE 'SREPORT 000' (12268 0001 12365 2400 4)                                   
REPORT NO. 00                 IDMS STATISTICS  -  CONTROL REPORT  -  R19.0    
                                                      START-UP RECORDS READ   
   THE FILE BEGINS AT THE FOLLOWING DATE AND TIME: 12267   23:45              
                    RECORD NUMBER             JULIAN DATE         TIME
                         6,213                   12268           04:03
                     1,728,514                   12289           05:20
                     2,229,206                   12296           04:54
                     3,241,918                   12309           03:50
  C750009 RECORDS WRITTEN FOR REPORT 00 --          10             
REPORT NO. 09                             IDMS-DC ERUS TASK STATIST
          SELECTED FROM:  12308  00:01      TO:  12365  24:00      
                 ACTUAL:  12309  03:50      TO:  12309  22:39      
PROGRAM NAME:   IDMSBCF                                            
          3        NUMBER TASK EXECUTIONS         
         32        NUMBER PROGRAMS CALLED      
 

The session-indicator-number must be in the range 0 through 9999. If the session-indicator-number is not specified or is equal to zero, the requested reports will cover the entire date period.

To verify what session indicator number has been used, look for the "ACTUAL" date in the heading. In this example, the begin date is Julian date 12309 (year 2012, Julian day 309 (November 5th) time 03:50.

     ACTUAL: 12309 03:50      TO: 12309 22:39 
 

If the ACTUAL heading contains "00000 00 00" for the begin date/time period, it means the archive log file is missing the beginning session record. Check that the archive log file includes the files created when the IDMS region first started up.

REPORT NO. 09                    IDMS-DC ERUS TASK STATISTICS BY PGM
          SELECTED FROM:  12001  00:01      TO:  12365  24:00                
                 ACTUAL:  00000  00:00      TO:  12331  23:09