Logo
Dnote

Logreader Notes

Jul 2023 630.01 Update for MCP 63

Mar 2019 600.01 Update for mcp60

Update for MCP 60. Some preparation for post 2035 time(6) changes.

Nov 2018 590.02 Fix possible seg array error @ 75446000

This change corrects a bug where Logreader could occasionaly fault with a seg array error.

Apr 2017 590.01 Fix release level

Mar 2015 580.01 Better handling of mutiple logs

When running to update the tape library there were problems when the time to be scanned covered more than one log. LogReader would scan from the beginning of any of the older logs, instead of from the requested time.

Jul 2011 540.03 Check for missing LOGGING options

The LOGREADER utility requires the following MCP LOGGING options to be set so that the retrospective handling of tape activity from system SUMLOGs is not affected:

LOGGING Major 1,  Minor Types 2,4,6    (Task EOT,EOJ and File CLOSE)
LOGGING Major 15, Minor Types 1,3,5,17 (Tape Volume entries)

For any LOGREADER run, the utility will now show a temporary waiting entry if any of these options are not active for Sumlog logging. If this message is seen these options should be turned on.

ACCEPT:WARNING:LOGGING options are reset: Major 15,Min=1+3

Note that LOGREADER will always check the current SUMLOG, after any restart, to ensure no tape notices have been missed.

May 2010 540.02 Reorg include step_dir

Internal change only.

Apr 2010 540.01 Fix multiple log tasking problem

Previously, it was possible for LOGREADER to send corrupted tape notices to SUPERVISOR, causing a SEG ARRAY fault at 86928000, if multiple SUMLOGs had been processed and a large number of tape events had been created. The problem was due to incorrect handling of job/task number collisions tracked from the various SUMLOG files.

Sep 2009 530.02 Fix COPYAUDIT problems and update timestamp

LOGREADER will again correctly handle COPYAUDIT tapes that have been created with either COPY or QUICKCOPY (either with or without the CHECK option). Also, tape scratches and 'New Vol' event entries will now be better handled.

Feb 2009 530.01 NEW LR

This is a major change to the LOGREADER utility. It no longer uses SUPERVISOR's FPORT port file interface to process missed tape notices that have been extracted from the SUMLOG. Further, LOGREADER cannot now be run standalone from MARC, CANDE or WFL; a new SUPERVISOR command called LR replaces this functionality. Please refer to SUPERVISOR DNote 531.22 for more information.

Dec 2007 520.02 Internal change

Use new INCLUDE/META

Sep 2006 520.01 Detect tape volume records for UNSTACK tapes

LOGREADER will now pass all tape log VOLUME ONLINE records for analysis by SUPERVISOR so that UNSTACK-ed tapes, created by the Unisys TAPESTACK utility as unlabelled tapes, can be updated in the database with the correct volumeid and fileid when the tape first goes on-line after being created.

Due to the way that TAPESTACK unstacks a virtual tape volume, multiple unlabelled tape notices would have been sent by LOGREADER, one for each file being written. This behaviour is detected BY LOGREADER and is automatically suppressed.

Mar 2005 510.01 UPDATE MCP 5.1 AND DEFAULT RUN MODE

Previously, running LOGREADER without any file-equation caused all SUMLOGS to be searched by default, including the current *SYSTEM/SUMLOG file. This behaviour has been changed; LOGREADER will now default to the current SUMLOG only if there has been no file-equation. For LOGREADER to search ALL Sumlogs, the utility must be now be run with the SW2 task option set.

The internal version for LOGREADER has been change to reflect MCP 5.1 compatibility.

Aug 2004 500.06 ELIMINATE DISGNOSTIC MESSAGE

Elimination of diagnostic DISPLAY message during SUMLOG scanning.

Jul 2004 500.05 CORRECT LAST TAPELIB TIMESTAMP

The fix applied in 500.04 to always update the timestamp of the last TRIM update did not work correctly under all circumstances. This behaviour has been corrected

Jun 2004 500.04 FIX LAST TAPELIB UPDATE TIMESTAMP

LOGREADER will now always inform SUPERVISOR of the timestamp of the last record in the current SUMLOG during a SUPERVISOR restart. This timestamp is used by SUPERVISOR to tell LOGREADER from which log time it should start reading on the next restart but was only being updated if no tapes were found during the run. This change helps to reduce the time that LOGREADER may take in subsequent restarts.

Jun 2004 500.03 DETECT COPYWRITE IMAGE AND FARM VOLUME ADDS

COPYWRITE now writes LOG VOLUME ADD (Major Type 15, Minor Type 6) records into the SUMLOG when a Disk Farm or CD image has been created by the Flex FAMILYMANAGER and MERGETAPE utilities. These log records are now automatically detected by LOGREADER during a SUPERVISOR restart or H/L.

The change documented in DNote 500.02 caused some normal tape creations to appear with the prefix 'APPENDED' instead of 'CREATED' in the tape log. This problem has now been fixed.

Mar 2004 500.02 DETECT LOG VOL TAPE APPENDS

LOGREADER will now detect log volume tape append operations (Major type 15, Minor type 17) and pass them to SUPERVISOR for processing.

Mar 2004 500.01 INCLUDE DUMPLOCK DECLARATION

Internal Metalogic Change.

Feb 2004 490.02 SEG ARRAY IF CONFIG REC HAS NO HOSTNAME

LOGREADER will usually automatically set the FILEID of any new library/maintenance tape detected in a SUMLOG to 'FILE000', even for continuation volumes. If a COPY dumped more than 999 files, LOGREADER would use the FILEID retrieved from the close record of the log (which always has the file count built into the FILEID e.g 'A/FILE24556') and not reset it to 'FILE000'. This effect had implications for Opal attributes such as TAPENAMESERIALS, which searches the METATAPELIB database for exact tape name matches.

This change also fixes a problem where a tape-tape COPY using the DUMPALL utility caused multiple tapelabel events generated after each file was copied.

May 2003 480.03 SEG ARRAY IF CONFIG REC HAS NO HOSTNAME

If LOGREADER was run against a SUMLOG with software configuration records that were created when the system did not have an established HOSTNAME, LOGREADER would fault with a SEG ARRAY error at 76508000. Since a SUMLOG may have several software configuration records, LOGREADER will just ignore these entries.

Dec 2002 480.02 HANDLE LOGS FROM FOREIGN HOSTS

Previously, running the LOGREADER utility required to be run with a parameter of the SUPERVISOR usercode under the Tape Librarian usercode. LOGREADER will now automatically determine Supervisor's usercode which eliminates the need for a parameter. Hence, LOGREADER can be run:

RUN *METALOGIC/SUPERVISOR/LOGREADER;
FILE SUMLOG=*SUMLOG/1/110802/000123 ON DEV

LOGREADER will abort if the calling usercode is not the Tape Librarian or Supervisor's usercode cannot be determined.

LOGREADER will now handle 'foreign' SUMLOGS correctly passing the system serial number and hostname from the SUMLOG instead of the calling machine. This means that hostname-based rules will now be correctly applied to tape notices extracted from foreign SUMLOGs when LOGREADER is run stand-alone.

Finally, when LOGREADER is processed by SUPERVISOR during a restart on either master or slave systems, only SUMLOGs which belong to the local system will be processed. Previously, LOGREADER would inspect all logs on the relevant families, regardless of source.

Mar 2002 480.01 CHANGE VERSION TO 48

This is only to change the version to 48. Version 470.01 is still valid on MCP 48.

Feb 2001 470.01 FIX DENSITY HANDLING BUG

Previously, LOGREADER would fault with an INVALID INDEX when processing tapes created with newer density formats e.g. DDS2, DDS4, FMTDLT20 etc. This problem is now fixed.

Jun 2000 460.03 SUPPORT FOR 5-DIGITS MIXNUMBERS

The LOGREADER utility now supports the Unisys MORETASKS implementation allowing the provision of mixnumbers up to 65535. This is achieved by setting the system options MORETASKS (OP+MORETASKS), halt-loading and changing the MAX command. In particular, this change supports the same implementation in OPAL and SUPERVISOR, see SUPERVISOR Dnote 460.12 or OPAL Dnote 460.02 for more information.

Mar 2000 460.02 FIX INVALID INDEX IF NO MIX INFO

Previously, LOGREADER could have faulted with an INVALID INDEX when scanning the SUMLOG, after a Supervisor restart, if no mix information was found for a new volume log entry.

This problem is now fixed.

Also, a BNA warning log entry concerning data truncation was also logged during LOGREADER's port file interchange with SUPERVISOR. Although no data was ever lost, the occurrence of such warnings has now been eliminated.

Feb 2000 460.01 FIX INCLUDE USED FOR DEBUG
This change only impacts special debug versions of Logreader.
Jan 1999 420.07 NEW LOG VOLUME HANDLING
Recent changes documented in SUPERVISOR DNote 450.05 discussed how VOLUME NEW log entries are tracked to provide the date and time when a new tape was first opened instead of its closure. LOGREADER now supports this implementation, passing relevant log volume records as necessary.