Storage Group Construct Field
This is the section for Storage Group Construct information. These
records are collected when SMSDATA is selected, and Storage Group
constructs are defined to the control data set selected. The record
type for this record is 'SG'.
- Name
- Description
- DSGNMFLD
- The Storage Group Construct name.
- DSGNMLEN
- The length of this construct name.
- DSGNAME
- The name of this construct.
- DSGUSER
- The USERID of the last person to make a change to this construct.
- DSGDATE
- The date that this construct was last changed. The format is "YYYY/MM/DD" in EBCDIC.
- DSGTIME
- The time that this construct was last changed. The format is "HH:MM" in EBCDIC.
- DSGDESC
- The description of this construct.
- DSGEXNLN
- Length of storage group extend name from 0 to 30. Valid only when DCUVERS is two or higher.
- DSGEXNM
- Storage group extend name, valid only when DCUVERS is two or higher, and DSGEXNLN is nonzero.
- DSGSBKPT
- The EAV breakpoint value. The breakpoint value is used in determining whether a data set can be allocated in a cylinder-managed space.
- DSGSHTHR
- High threshhold percent for the track-managed portion of the volume.
- DSGSLTHR
- Low threshhold percent for the track-managed portion of the volume.
- DSGDATAE
- The end of the storage group data.
- DSGFLAGS
- Storage Group Flags. The following are indicated if the specified
bit is '1'.
- DSGFABUP
- This bit indicates that the data sets on the volumes in this Storage Group are eligible for automatic backup.
- DSGFAMIG
- This bit indicates that the data sets on the volumes in this Storage Group are eligible for automatic migration.
- DSGFADMP
- This bit indicates that this Storage Group can be automatically backed up using DFSMShsm, or a comparable product. Dumping whole volumes instead of individual data sets speeds up the process of restoring data sets to volumes.
- DSGFTHRS
- This flag indicates that thresholds have been specified for this Storage Group.
- DSGFGBKU
- This flag indicates that the maximum number of days between backups has been specified.
- DSGGBNOL
- This flag indicates that the maximum number of days between backups has no limit.
- DSGFIMIG
- This flag indicates that the data sets in this Storage Group are eligible for interval migration. DSGFHTHR and DSGFLTHR must be specified.
- DSGFPSM
- This flag indicates systems features. See constants for DBCSYSFT in Table 13.
- DSGFTYPE
- This field denotes the type of storage group to which the volumes
belong. This field is mapped by the constants DSGPOOL, DSGVIO, DSGDUMMY,
DSGOBJ, and DSGOBJBK.
- 0
- Storage Group type is POOL.
- 1
- Storage Group type is VIO.
- 2
- Storage Group type is DUMMY.
- 3
- Storage Group type is OBJECT.
- 4
- Storage Group type is OBJECT BACKUP.
- DSGFHTHR
- This field is the high threshold, or the percentage of a single volume in the Storage Group at which DFSMShsm will migrate data sets off all the volumes if any of them meet or exceed this value. Processing continues on each volume until either the volume occupancy meets or goes below the value in DSGFLTHR or no more data sets on the volume are eligible for migration. This value is not used during automatic migration. Possible values range from 0 to 99.
- DSGFLTHR
- This field is the low threshold value. During interval and automatic migration, this value is used as the target for the percentage of space allocated on each volume in the storage group. DFSMShsm will migrate eligible data sets off a volume until either the space allocated on the volume drops to or below this value, or no more data sets on the volume are eligible to be migrated. This value is ignored if DSGFAMIG is '0'. Possible values range from 0 to 99.
- DSGFVMAX
- This field shows the largest size of a virtual input/output (VIO) data set, in kilobytes, that you can create for this storage group. You cannot allocate data sets that exceed this field in this Storage Group. This value applies to VIO storage groups only.
- DSGFVUNT
- The value in this field shows the type of physical device that will be simulated by the Storage Group. At least one unit of the device type shown must be physically connected to each system that has access to the storage group. This value appears for VIO Storage Groups only.
- DSGDMPCL
- The five elements in this array show the names of the dump classes assigned to this Storage Group.
- DSGFRPST
- The 32 elements in this array show status of this Storage Group
by processor. Each element can be referenced by using DSGSTAT.
- DSGSTAT
- This field shows the status of the Storage Group on a given processor
and is mapped by the constants DSG0, DSGENBL, DSGQUI, DSGQUIN, DSGDIS
and DSGDISN.
- 0
- No status is specified.
- 1
- Storage Group status is enabled. A relationship that allows a system to allocate and access data sets in a VIO Storage Group, a pool Storage Group, or individual volumes within a pool Storage Group.
- 2
- Storage Group status is quiesce all. A relationship that prevents a system from scheduling jobs that allocate or access data sets in a VIO Storage Group, a pool Storage Group, or individual volumes within a pool Storage Group.
- 3
- Storage Group status is quiesce new. A relationship that prevents a system from scheduling jobs that allocate new data sets or modify existing ones in a VIO Storage Group, a pool Storage Group, or individual volumes within a pool Storage Group.
- 4
- Storage Group status is disable all. A relationship that prevents a system from allocating or accessing data sets in a VIO Storage Group, a pool Storage Group, or individual volumes within a pool Storage Group.
- 5
- Storage Group status is disable new. A relationship that prevents a system from allocating new data sets in a VIO Storage Group, a pool Storage Group, or individual volumes within a pool Storage Group.
- DSGABSYS
- This field shows the name of the system on which automatic backup of the volumes in this Storage Group will take place.
- DSGADSYS
- This field shows the name of the system on which automatic dumping of the volumes in this Storage Group will take place.
- DSGAMSYS
- This field shows the name of the system that will perform automatic migration and space management of the volumes in this Storage Group.
- DSGCNFRM
- The eight elements of this array show the confirmed SMS status
of this Storage Group. Each element can be referenced by DSGCSMSS.
- DSGCSMSS
- This field shows the confirmed SMS status of the storage group and maps to the same values as DSGSTAT.
- DSGGBKUF
- The value in this field indicates the maximum number of days between backups. During this backup period, a copy of each data set in the Storage Group is available. This field is valid only for Pool Storage Groups.
- DSGTBLGR
- This field shows the OAM table space identifier for this Storage Group in the form GROUPnn.
- DSGOAMFL
- This field shows the OAM flags for this Storage Group.
- DSGFCYS
- This flag indicates whether or not the start and end times when
the OAM Storage Management Component (OSMC) can automatically start
its storage management processing for this Storage Group.
- 1
- These values have been given, see DSGCYLST and DSGCYLED.
- 0
- These values have not been given.
- DSGFVLFT
- This flag indicates whether or not the number of free sectors
required for an optical volume within this Storage Group has been
specified.
- 1
- This value has been given, see DSGVOLFT.
- 0
- This value has not been given.
- DSGFDRST
- This flag indicates whether or not the maximum number of object
write requests outstanding for an optical drive in this Storage Group
has been given.
- 1
- This value has been given, see DSGDRVST.
- 0
- This value has not been given.
- DSGVFFER
- This flag indicates whether or not a "mark volume full on first
write failure" criteria has been specified for this Storage Group.
- 1
- This value has been specified, see DSGVFERR.
- 0
- This value has not been specified.
- DSGVFERR
- This flag indicates whether or not a "mark volume full on first
write failure" criteria applies to optical volumes in this Storage
Group.
- 1
- This value indicates that OAM marks an optical volume full the first time an attempt to write an object on the optical volume is unsuccessful because there is not enough space remaining.
- 0
- This value indicates that OAM marks an optical volume full only when the number of available sectors in the user data area falls below the volume full threshold specified in DSGVOLFT.
- DSGFRETP
- This flag indicates whether ‘Retention Protection’ is enabling
for a given object. When it is enabled, OAM will not allow that object
to be deleted prior to its expiration date. Additionally, OAM will
not allow the expiration date to be changed to an earlier date. It
will, however, allow the expiration date to change to a later date.
- 1
- The Retention Protection is enabling.
- 0
- The Retention Protection is disabling.
- DSGFDELP
- This flag indicates whether ‘Deletion Protection’ is enabling
for a given object. When it is enabled, OAM will not allow that object
to be deleted prior to its expiration date. Deletion-Protection is
differs from Retention-Protection in that the Deletion-Protection
can be turned on and off by the installation, and Deletion-Protection
has no restriction on the expiration date changing.
- 1
- The Deletion-Protection is enabling.
- 0
- The Deletion-Protection is disabling.
- DSGCYLST
- This field shows the beginning of a window of time in which the Object Access Method can begin storage management processing. The actual value this field represents is an hour of the day on a 24-hour scale. This value is valid only for the OBJECT Storage Group type. Possible values range from 0 to 23.
- DSGCYLED
- This field shows the end of a window of time in which the Object Access Method can begin storage management processing. The actual value this field represents is an hour of the day on a 24-hour scale. This value is valid only for the OBJECT Storage Group type. Possible values range from 0 to 23.
- DSGVOLFT
- This field shows the number of free sectors required for an optical volume within this storage group. When the number of free sectors falls below the threshold, the Object Access Method marks the optical volume as full. This value is valid only for the OBJECT and OBJECT BACKUP Storage Group types.
- DSGDRVST
- This field shows the maximum number of object write requests outstanding for an optical drive in this storage group. When the number of object write requests to this storage group divided by the number of optical disk drives currently processing requests for this storage group exceeds this threshold, the Object Access Method attempts to start an additional optical disk drive. This value is valid only for the OBJECT and OBJECT BACKUP Storage Group types.
- DSGOLIBS
- These eight array elements list the library names that represent
defined optical drive configurations available for this storage group,
or a pseudo-library name that represents stand-alone optical drives
and shelf-resident optical volumes. This array is valid for OBJECT
and OBJECT BACKUP Storage Group types only. Each element can be referenced
by DSGOLBNL and DSGOLBNM.
- DSGOLBNL
- Optical library name length.
- DSGOLBNM
- Optical library name.
- DSGSSTAT
- This field shows status by processor, and can have up to 32 system
status entries.
- DSGSYSST
- Requested system status. Similiar to DSGSTAT.
- DSGCNSMS
- Confirmed SMS status. Similar to DSGCSMSS.