PRINT LOG

The PRINT LOG utility prints all or selected portions of the DC/UCF system log or an archive log file created by the ARCHIVE LOG statement.
idmscu19
The PRINT LOG utility prints all or selected portions of the DC/UCF system log or an archive log file created by the ARCHIVE LOG statement.
You can select portions for printing based on:
  • Type of information
  • Logical terminal identifier
  • Date and time
This article describes the following information:
2
2
Authorization
To
You Need This Privilege
On
To print a system or archive log
DBAREAD
The SYSTEM.DDLDCLOG area of the database associated with the DC/UCF system whose log you want to print
Syntax
  ►►─── PRINT LOG ──────────────────────────────────────────────────────────────►  ►─┬────────────────────────┬─────────────────────────────────────────────────►    └─ FROM ─┬─ DATABASE ──┬─┘             └─ ARCHIVE ◄──┘  ►─┬──────────────────────┬───────────────────────────────────────────────────►    │ ┌──────────────────┐ │    └─▼─┬─ DUMPS ──────┬─┴─┘        ├─ MESSAGES ───┤        ├─ STATISTICS ─┤        └─ TRACES ─────┘    ►─┬─────────┬────────────────────────────────────────────────────────────────►    └─ UTC────┘  ►─┬─────────────────────────┬────────────────────────────────────────────────►    │       ┌───── , ───────┐ │    └─ FOR ─▼─ terminal-id ─┴─┘  ►─┬──────────────────────────────────┬───────────────────────────────────────►    └─ START AT ' ─┬─ date ──────┬─ ' ─┘                   ├─ date-time ─┤                   └─ time ──────┘  ►─┬─────────────────────────────────┬────────────────────────────────────────►◄    └─ STOP AT ' ─┬─ date ──────┬─ ' ─┘                  ├─ date-time ─┤                  └─ time ──────┘  
Parameters
  • FROM
    Specifies whether print log information is to be printed from the SYSTEM.DDLDCLOG area or from an archive log file.
  • DATABASE
    Prints log information from the SYSTEM.DDLDCLOG area.
  • ARCHIVE
    Prints log information from an archive log file.
  • DUMPS
    Includes snap dumps in the printed information.
  • MESSAGES
    Includes DC/UCF system messages in the printed information.
  • STATISTICS
    Includes DC/UCF system statistics in the printed information.
  • TRACES
    Includes user traces in the printed information.
    If you specify one or more of DUMPS, MESSAGES, STATISTICS, and TRACES, only the specified type of information is printed. If you do not specify any of these options, all types of information are printed.
  • FOR
    Prints only log information associated with one or more specified logical or physical terminals.
    By default, if you do not specify FOR, log information associated with all logical or physical terminals is printed.
  • terminal-id
    • logical
      -- The identifier of a logical terminal defined to the DC/UCF system.
    • physical
      -- The identifier of a physical terminal defined to the DC/UCF system. This parameter will direct the system to select only SYSTEM STATISTICS PTERM records.
    You can specify up to 32 logical or physical terminals.
  • START AT
    Prints only log information recorded at or after the specified time.
    By default, if you do not specify START AT, information from the beginning of the system log or archive log file is printed.
  • STOP AT
    Prints only log information recorded at or before the specified time.
    By default, if you do not specify STOP AT, all information recorded in the system log or archive log file (starting at the time specified in the START parameter, if any) is printed.
  • date
    Specifies the date, in one of the following formats:
    • yyyy-mm-dd
    • mm/dd/yyyy
    In these formats, the following rules apply:
    • yyyy
      specifies the year.
      yyyy
      must be an integer in the range 0001 through 9999. Leading zeros are optional.
    • mm
      specifies the month within the year.
      mm
      must be an integer in the range 01 through 12. Leading zeros are optional.
    • dd
      specifies the day within the month.
      dd
      must be an integer in the range 01 through 31. Leading zeros are optional.
    The combined values of
    yyyy
    ,
    mm
    , and
    dd
    must represent a valid date. For example, 1988-02-29 is a valid date. 1989-02-29 is not.
  • date-time
    Specifies the date and time, where:
    • The format for specifying the DATE-TIME is:
      yyyy-mm-dd-hh.mm.ss.ffffff
    • The rules for specifying the DATE component of DATE-TIME are the same as for DATE described previously. The rules for specifying the TIME component of DATE-TIME are:
      • hh:
        specifies the hour on a 24-hour clock.
        hh
        must be an integer in the range 00 through 23. Leading zeros are optional.
      • mm
        specifies the number of minutes past the hour.
        mm
        must be an integer in the range 00 through 59. Leading zeros are optional.
      • ss
        specifies the number of seconds past the minute.
        ss
        must be an integer in the range 00 through 59. Leading zeros are optional.
      • ffffff
        specifies the number of millionths of a second past the specified second.
        ffffff
        is optional; if you include it, it must be an integer in the range 000000 through 999999. The default value is 000000. Trailing zeros are optional.
  • time
    Specifies the time in the following format:
    • hh:mm:ss
    The rules for specifying TIME are the same as those listed for DATE-TIME shown previously.
    When specifying only the TIME option, the date defaults to the current date.
  • UTC
    Specifies that Start and Stop times are interpreted as UTC times instead of local times. If coded, all times the utility writes are also displayed as UTC times instead of local times.
Usage
How to submit the PRINT LOG statement
You submit a PRINT LOG statement only through the batch command facility. You can run the batch command facility only in local mode.
When to use PRINT LOG
Use the PRINT LOG utility only when the system log is being written to the DDLDCLOG area of the data dictionary.
When not to use PRINT LOG
If the system log is assigned to one or more sequential files, you should use the appropriate operating system utility (for example, IEBGENER for z/oS systems or DITTO for z/VSE systems) to print the contents of the log file.
JCL Considerations
When you submit a PRINT LOG statement through the batch command facility, the JCL to execute the facility must include statements to define:
  • The system log area (DDLDCLOG) if you specify FROM DATABASE
  • The archive log file whose contents you want to print if you specify FROM ARCHIVE
  • The system message area (DDLDCMSG)
  • The dummied journal file
For more information about the generic JCL used to execute the batch command facility, see the section for your operating system.
Examples
Printing everything except dumps
The following PRINT LOG statement requests printing of all messages, statistics, and user traces currently in the data dictionary log area.
print log from database    messages    statistics    traces;
Printing all information for a specified time period
The following PRINT LOG statement requests printing of all information recorded in the system log from January 18, 1999, at 8:00 p.m. until just before 3:00 a.m. on January 19, 1999. The PRINT LOG utility will retrieve this information from the archive log file.
print log from archive    start at '1999-1-18-20.00.00'    stop at '1999-1-19-02.59.59.999999';
Printing user traces for a logical terminal
The following PRINT LOG statement requests printing of all user traces for logical terminal LTVTM05 beginning at 2:30 p.m. on the current day. The PRINT LOG utility will retrieve this information from the data dictionary log area.
print log from database    traces    for ltvtm05    start at '14.30.00';
Sample Output
The following PRINT LOG report requests the printing of all information recorded in the system log from September 19, 1999, at 8:10 a.m. until just after 2:20 p.m. on September 19, 1999. The PRINT LOG utility will retrieve this information from the archive log file.
IDMSBCF                                              IDMS Batch Command Facility                            09/19/99   PAGE 1 PRINT LOG FROM DATABASE START AT '1999-09-19-08.10.00.00000'     STOP AT '1999-09-19-14.20.10.00000'; *** PAGE 000030002 STATUS 0000 091699  19.14.59  6 S *** PAGE 000031001 STATUS 0000 091799  14.20.00  6 S *** PAGE 000031500 STATUS 0000 091699  10.19.58  6 S *** PAGE 000031750 STATUS 0000 091699  14.30.01  6 S *** PAGE 000031875 STATUS 0000 091699  16.46.34  6 S *** PAGE 000031937 STATUS 0000 091699  17.54.59  6 S *** PAGE 000031968 STATUS 0000 091699  18.34.58  6 S *** PAGE 000031984 STATUS 0000 091699  18.54.59  6 S *** PAGE 000031992 STATUS 0000 091699  19.04.58  6 S *** PAGE 000031996 STATUS 0000 091699  19.10.00  6 S *** PAGE 000031998 STATUS 0000 091699  19.14.58  6 S *** PAGE 000031999 STATUS 0000 091699  19.14.59  6 S *** PAGE 000032000 STATUS 0000 091699  19.14.59  6 S *** PAGE 000030002 STATUS 0000 091699  19.14.59  6 S *** PAGE 000032000 STATUS 0000 091699  19.14.59  6 S *** PAGE 000031001 STATUS 0000 091799  14.20.00  6 S *** PAGE 000031500 STATUS 0000 091699  10.19.58  6 S *** PAGE 000031250 STATUS 0000 091799  16.02.43  6 S  .  .  . *** PAGE 000031469 STATUS 0000 091999  09.25.55  6 L *** PAGE 000031468 STATUS 0000 091999  09.25.12  6 L *** DDLDCLOG AREA FROM PAGES 0030001 TO 0032000 *** FIRST AND LAST PAGES SELECTED ARE 0031456 AND 0031469 CA IDMS-DB/DC  Print Log Utility              CA IDMS-DB/DC is a Proprietary Software Product         DATE       TIME    PAGE volser         Release nn.n                   Licensed from CA                                      09/19/99   09:26:36     2 091999 09.23.57 IDMS DC013002 V72 T0 ATTACHING DATABASE RESOURCE CONTROLLER 091999 09.23.57 IDMS DC200131 V72 T1 Lock Manager Initialization Complete 091999 09.23.57 IDMS DC200007 V72 T1 3005 Error Accessing Area - Not Available. SYSDEF.DDLDCLSCR 091999 09.23.57 IDMS DC201001 V72 T1 CA IDMS/DB: 72 Started 091999 09.23.57 IDMS DC200009 V72 T1 CA IDMS/DB Active 09:23:41 91.262 091999 09.23.57 IDMS DC013003 V72 T0 OPENING SYSTEM RUN UNITS 091999 09.23.57 IDMS DC013014 V72 T0 ATTACHING TASK FOR SERVICE DRIVER RHDCRUSD 091999 09.23.57 IDMS DC013014 V72 T0 ATTACHING TASK FOR SERVICE DRIVER RHDCRUSD 091999 09.23.57 IDMS DC013014 V72 T0 ATTACHING TASK FOR SERVICE DRIVER RHDCRUSD 091999 09.23.57 IDMS DC013014 V72 T0 ATTACHING TASK FOR SERVICE DRIVER RHDCRUSD 091999 09.23.57 IDMS DC013014 V72 T0 ATTACHING TASK FOR SERVICE DRIVER RHDCRUSD 091999 09.23.57 IDMS DC013014 V72 T0 ATTACHING TASK FOR SERVICE DRIVER RHDCRUSD 091999 09.23.57 IDMS DC013014 V72 T0 ATTACHING TASK FOR SERVICE DRIVER RHDCLGSD 091999 09.23.57 IDMS DC013014 V72 T0 ATTACHING TASK FOR SERVICE DRIVER RHDCLGSD 091999 09.23.57 IDMS DC050001 V72 T0 DCLOG IS 00% FULL  .  .  . CA IDMS-DB/DC  Print Log Utility              CA IDMS-DB/DC is a Proprietary Software Product         DATE       TIME    PAGE volser         Release nn.n                   Licensed from CA                                      09/19/99   09:26:36     3 091999 09.24.03 IDMS DC021010 V72 LOAD OF RESIDENT MODULE RHDCUX28 FAILED -- CODE 20 091999 09.24.03 IDMS DC021010 V72 LOAD OF RESIDENT MODULE F100D11S FAILED -- CODE 20 091999 09.24.03 IDMS DC013016 V72 T0 SECURITY SYSTEM INITIALIZATION BEGINNING 091999 09.24.04 IDMS DC013017 V72 T0 SECURITY SYSTEM INITIALIZATION COMPLETION CODE 091999 09.24.04 SYSTEM INITIALIZED ON 91262 AT 09:24:04.35 091999 09.24.04 MAP OF REGION 091999 09.24.04 RHDCOS00 000066E8  IDMSDBIO 00020060  IDMSDBMS 0002F030  OPT      00045870 091999 09.24.04 CSA      00045D70  CCE      0004E560  SCAAREA  00050280  RUA      00050700 091999 09.24.04 DDT      00053340  LTT      00053380  PTT      00055360  QDT      000582A0 091999 09.24.04 TDT      00058420  PDT      0005CBC0  TRCEBUFS 000D5860  TCA      000E5280 091999 09.24.04 DCEAREA  000E52B0  TCEAREA  000E5EB0  MPMODTBL 0013DDC0  ECBLIST  0013E3C0 091999 09.24.04 RCA      0013E640  RLEAREA  0013E6A0  RCEAREA  0014D3E8  DPEAREA  001679C8 091999 09.24.04 ILEAREA  0016CE28  SCT      0016D460  CSVCAREA 0016F200  PGMPOOL  00173000 091999 09.24.04 RENTPOOL 00180000  RHDCD04W 001D2E00  RHDCD05V 001D3400  RHDCD01B 001D6E00 091999 09.24.04 RHDCD06E 001D7C00  RHDCD0ZU 001D9A00  RHDCD0LV 001DBE00  STGPOOL  0045E000 091999 09.24.04 XALODBUF 0065E000  ABENDSTG 00666000  HIADDR   00666320  NLT      00960AA8  .  .  .
More Information