HIS: History Group

The fields in this group identify the object's owner and give the object's creation and expiration dates.

entryname—The name of the cataloged object. The entryname can be specified with the ENTRIES parameter of LISTCAT to identify a catalog entry.

HISTORY—This field includes the following fields:

CREATION—The Julian date (YYYY.DDD) on which the entry was created.
Note: For a currently migrated VSAM data set, CREATION will be the date the data set was migrated (because a new data set was created to encapsulate the original version of the data set, plus related control information). When the data set is later restored, CREATION will be set to the creation date of the original data set.
For a non-VSAM data set, CREATION will always be set to the creation date of the original data set, even if the data set is currently migrated.
DATASET-OWNER—Contents of the data set owner field in the BCS. Was formerly called OWNER-IDENT field.
LAST ALTER DATE—The julian date (YYYY.DDD) on which the GDG base was last altered, by adding or removing a GDS.
RELEASE—The release of VSAM under which the entry was created:
- 1 = OS/VS2 Release 3 and releases preceding Release 3
- 2 = OS/VS2 Release 3.6 and any later releases
STATUS—The possible values this field can contain are active, deferred, library, or rolled-off.
For generation data set entries, the status is indicated by active, deferred, or rolled-off.

For non-VSAM entries, a status of library indicates a partitioned data set extended (PDSE).
OAMDATA—For OAM entries, this field contains the following:
- DIRECTORYTOKEN—The OAM directory token (1-to-8 characters).
RLSDATA—For RLS/Recovery entries, this field has the following:
- FRLOG—Gives the value of the FRLOG parameter specified on the DEFINE CLUSTER.
- LOG—Gives the value of the LOG parameter specified on DEFINE CLUSTER.
- LOGSTREAMID—This gives you the value of the LOGSTREAMID parameter specified on DEFINE CLUSTER.
- LOGREPLICATE—This gives you the value of the LOGREPLICATE parameter specified on DEFINE CLUSTER.
- RECOVERY REQUIRED—Indicates whether the sphere is currently in the process of being forward recovered.
- RECOVERY TIMESTAMP—This gives the time the most recent backup was taken when the data set was accessed by CICS® using VSAM RLS.
- RLS IN USE—Indicates whether the sphere is using RLS. A sphere uses RLS if:
  - It was last opened for RLS processing.
  - It is not opened for RLS processing but is recoverable and either has retained locks protecting updates or is in a lost locks state.
- VSAM QUIESCED—Indicates that the sphere has been quiesced for RLS. You cannot open the sphere using RLS.
SMSDATA—For SMS-managed data sets, this field has:
- BWO—Data set is enabled for backup-while-open.
- BWO STATUS—Indicates the status of the data set. Status can be:
  - Data set is enabled for backup-while-open
  - Control interval or control area split in progress
  - Data set has been restored and is down level. It might need to be updated with forward recovery logs.
- BWO TIMESTAMP—A CICS timestamp that indicates the time from which forward recovery logs have to be applied to a restored copy of the data set.
- CA RECLAIM—The cataloged value for the CA reclaim attribute, as specified in the data class when the data set was defined or when modified with the ALTER command. CA reclaim specifies whether empty CA space will be reclaimed. This value does not reflect settings in PARMLIB member IGDSMSxx or SETSMS commands, which may disable CA reclaim. This line is not displayed for VSAM data set types that are ineligible for CA Reclaim: ESDS, RRDS, VRRDS, LDS and KSDS with the IMBED option.
- DATACLASS—The name of the data class assigned to the cluster.
- MANAGEMENTCLASS—The name of the management class assigned to the cluster.
- LBACKUP—The last date that the cluster was backed up. If this date is unavailable, this field will contain an entry of all "Xs" rather than an actual date.
- STORAGECLASS—The name of the storage class assigned to the cluster.