Archive Data Sets

Only one NetView® program at a time can archive Canzlog data on an instance of the z/OS® system. All archive data sets for a particular collection have the same high level qualifier that is defined in the CNMSTYLE member.
Message data sets
Contains message data copied from the Canzlog log.

Each message data set is a sequential data set with fixed-length records. Each data set contains 8 megabytes (8M) of Canzlog data in 8192 1024-byte records.

A message data set is named after the first (oldest) record written to the file and has the following format:
hlq.CZYYMMDD.Thhmmssc
  • The name of a message data set begins with the high level qualifier (hlq) that you specify on the ARCHIVE.HLQ statement in the CNMSTYLE member.
  • The time stamp (Universal Time) includes the following information:
    • YY: year
    • MM: month
    • DD: day
    • hh: hour
    • mm: minute
    • ss: second
  • The suffix (c) is a single character suffix (A-Z, 0-9, $, @, #) that is included only when the second and subsequent message data sets contain an oldest message that occurred in the same second as the oldest message in a previous message data set. This is used to make the message data set name unique.
Usage note: You can delete message data sets. If you delete these data sets and then later restore them, NetView operators can browse the data by specifying date and time ranges (using the TO and FROM operands on the BROWSE command). You can also create named filters to assist operators with browsing the message data sets. For information about creating named filters, see the CANZLOG command in IBM Z® NetView Command Reference Volume 1 (A-N).
Index data sets
Contain records that describe message data sets in the archive.

An index data set is a sequential data set with fixed-length records. This data set contains no more than 4096 80-byte records.

Each record describes one message data set and includes the following information:
  • Version of the NetView program that wrote the data
  • STCK value that indicates the date and time at which the first (oldest) message in the file was produced
  • Low-level qualifier of the message data set
An index data set name has the following format:
hlq.DXyymmdd.HRhhMNmm
  • The name of an index data set begins with the high level qualifier that you specify on the ARCHIVE.HLQ statement.
  • The timestamp (Coordinated Universal Time, UTC) of the first (oldest) message that was written to the first message data set contained within the index data set:
    • yy: year
    • mm: month
    • dd: day
    • hh: hour
    • mm: minute
Usage notes:
  1. Do not edit or delete the index data set.
  2. Any index data sets that were created with the format hlq.DXyymmdd.HRhh are still valid and should not be deleted or edited, as with any other index data set.
Primary index data set
Describes the index data sets in the archive.

The primary index is a sequential data set with fixed-length records. It contains one 80-byte record for each index data set in the archive.

The primary index data set name has the following format:
hlq.NV.CANZLOG.INDEX
  • The name of the primary index data set begins with the high level qualifier that you specify on the ARCHIVE.HLQ statement.