ARCHIVE LOG

The ARCHIVE LOG utility offloads the contents of the DC/UCF system log to an archive file.
idmscu19
The ARCHIVE LOG utility offloads the contents of the DC/UCF system log to an archive file.
This article describes the following information:
2
2
Authorization
To archive a system log you need DBAWRITE privileges in the SYSTEM.DDLDCLOG area in the dictionary associated with the DC/UCF system whose log you want to archive.
Syntax
  ►►─── ARCHIVE LOG ──┬────────────────────┬─────────────────────────►◄                     └─ PRINT ──┬───────┬─┘                                └─ UTC ─┘  
Parameters
  • PRINT
    Prints a copy of the contents of the archived log. If you do not specify PRINT, a copy of the archived log is
    not
    printed.
  • UTC
    Displays the time stamps of each print line as UTC time. If not specified, times are displayed in local time.
Usage
How to submit the ARCHIVE LOG statement
You submit an ARCHIVE LOG statement only through the batch command facility. You must be running CA IDMS/DB in local mode, without journaling.
When to use ARCHIVE LOG
Use the ARCHIVE LOG utility only when the system log is being written to the DDLDCLOG area.
When not to use ARCHIVE LOG
If the system log is assigned to one or two sequential files, you should use the appropriate operating system utility (for example, IEBGENER for z/OS systems or DITTO for z/VSE systems) to archive the contents of the log file.
Archiving the log for an active system
When you submit an ARCHIVE LOG statement while the DC/UCF system is active, CA IDMS/DB archives the contents of the DDLDCLOG area up to, but not including, the page to which the system is currently writing.
JCL Considerations
When you submit an ARCHIVE LOG statement through the batch command facility, the JCL to execute the facility must include statements to define the following:
  • Log area (DDLDCLOG)
  • Message area (DDLDCMSG)
  • Dummied journal file
  • Archive log file being created
For more information about the generic JCL used to execute the batch command facility, see the section for your operating system in this section.
Example
The following ARCHIVE LOG statement requests that the contents of the DC/UCF system log be offloaded to an archive file and to print the contents of the archived log.
archive log print;
Sample Output
The ARCHIVE LOG utility produces the following standard listing:
IDMSBCF                                              IDMS Batch Command Facility                            mm/dd/77   PAGE 1 ARCHIVE LOG; 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                                       mm/dd/yy   hh:mm:ss     1 *** PAGE 000030002 STATUS 0000 mmddyy  19.14.59  6 S *** PAGE 000031001 STATUS 0000 mmddyy  14.20.00  6 S *** PAGE 000031500 STATUS 0000 mmddyy  10.19.58  6 S *** PAGE 000031750 STATUS 0000 mmddyy  14.30.01  6 S *** PAGE 000031875 STATUS 0000 mmddyy  16.46.34  6 S *** PAGE 000031937 STATUS 0000 mmddyy  17.54.59  6 S *** PAGE 000031968 STATUS 0000 mmddyy  18.34.58  6 S *** PAGE 000031984 STATUS 0000 mmddyy  18.54.59  6 S *** PAGE 000031992 STATUS 0000 mmddyy  19.04.58  6 S *** PAGE 000031996 STATUS 0000 mmddyy  19.10.00  6 S *** PAGE 000031998 STATUS 0000 mmddyy  19.14.58  6 S *** PAGE 000031999 STATUS 0000 mmddyy  19.14.59  6 S *** PAGE 000032000 STATUS 0000 mmddyy  19.14.59  6 S *** PAGE 000030002 STATUS 0000 mmddyy  19.14.59  6 S *** PAGE 000032000 STATUS 0000 mmddyy  19.14.59  6 S *** PAGE 000031001 STATUS 0000 mmddyy  14.20.00  6 S *** PAGE 000031500 STATUS 0000 mmddyy  10.19.58  6 S *** PAGE 000031250 STATUS 0000 mmddyy  16.02.43  6 S *** PAGE 000031375 STATUS 0000 mmddyy  16.24.57  6 S *** PAGE 000031437 STATUS 0000 mmddyy  16.30.42  6 S *** PAGE 000031468 STATUS 0000 mmddyy  09.25.12  6 L *** PAGE 000031484 STATUS 0000 mmddyy  09.59.59  6 S *** PAGE 000031476 STATUS 0000 mmddyy  09.49.58  6 S *** PAGE 000031472 STATUS 0000 mmddyy  09.29.58  6 L *** PAGE 000031474 STATUS 0000 mmddyy  09.44.59  6 S *** PAGE 000031473 STATUS 0000 mmddyy  09.29.58  6 L *** PAGE 000031474 STATUS 0000 mmddyy  09.44.59  6 S *** PAGE 000031473 STATUS 0000 mmddyy  09.29.58  6 L *** PAGE 000031474 STATUS 0000 mmddyy  09.44.59  6 S *** PAGE 000030474 STATUS 0000 mmddyy  05.04.59  6 S *** PAGE 000030973 STATUS 0000 mmddyy  14.17.00  6 S *** PAGE 000031223 STATUS 0000 mmddyy  15.59.04  6 S *** PAGE 000031348 STATUS 0000 mmddyy  16.18.18  6 S *** PAGE 000031410 STATUS 0000 mmddyy  16.30.41  6 S *** PAGE 000031441 STATUS 0000 mmddyy  16.30.43  6 S *** PAGE 000031457 STATUS 0000 mmddyy  09.25.05  4 L *** PAGE 000031449 STATUS 0000 mmddyy  16.30.43  6 S *** PAGE 000031453 STATUS 0000 mmddyy  16.30.44  6 S *** PAGE 000031455 STATUS 0000 mmddyy  16.30.44  6 S *** PAGE 000031456 STATUS 0000 mmddyy  09.23.57  1 L *** PAGE 000031456 STATUS 0000 mmddyy  09.23.57  1 L *** PAGE 000031473 STATUS 0000 mmddyy  09.29.58  6 L *** PAGE 000031473 STATUS 0000 mmddyy  09.29.58  6 L *** PAGE 000031472 STATUS 0000 mmddyy  09.29.58  6 L *** DDLDCLOG AREA FROM PAGES 0030001 TO 0032000 *** FIRST AND LAST PAGES SELECTED ARE 0031456 AND 0031473 ARCHIVE LOG IS COMPLETE Status = 0 AutoCommit will COMMIT transaction Command Facility ended with no errors or warnings