 |
The following command syntax displays storage group status:
>>-+-DISPLAY-+-------------------------------------------------->
'-D-------'
>--SMS,-+-STORGRP-+-(-+-group-name-+-)-,DETAIL-+----------------+-><
'-SG------' '-ALL--------' '-,L=-+-a------+-'
+-name---+
'-name-a-'
- DISPLAY
- Specifies the OAM display command.
- STORGRP(group-name | ALL)
- Displays the status of an Object or Object Backup storage group.
If group-name is specified, one data line
displays the status of the requested storage group. If ALL is selected,
a data line will be displayed for each Object Backup storage group,
and for each Tape Storage Group defined in the active configuration.
If group-name is ALL, you must enclose the
ALL parameter in two sets of parentheses, as follows:
D SMS,STORGRP((ALL))
- DETAIL
- Displays detailed object-group status.
- L={a | name | name-a}
- Specifies the location where the results of the inquiry are to
be displayed, where name is the console
name, and a is the display area on the console
screen.
To display Object or Object Backup storage group status, enter
the following command: DISPLAY SMS,STORGRP(object-group),DETAIL
This results in F OAM,D,GROUP,groupname command
being issued. Specifying the previous command displays the status of the requested
storage group: CBR1130I OAM storage group status:
OBJECT TY REQ OSMC BACKUP BACKUP RET DEL
STORGRP COUNT SYSTEM STORGRP1 STORGRP2 PRO PRO
sgname a bbbbb sysname objbusg1 objbusg2 n o
TAPE DATA L2TAPE L2DATA
UNIT CLASS UNIT CLASS
unitname dataclass unitname2 dataclass2
Library Names: libname1 libname2 libname3 libname4
libname5 libname6 libname7 libname8
DSL2 Directory: dsl2dir
DSL2 Type: dsl2type
TAPE LIBRARY
STORGRP NAMES
sgname libname1 libname2 libname3 libname4
libname5 libname6 libname7 libname8
...
If the command issued was:
DISPLAY SMS,STORGRP(storage-group-name),DETAIL
and the storage group that is requested is an object storage group
or an object backup storage group, additional data lines are
displayed as follows:
OPTICAL TAPE TSL1 TSL2
ALL VOLUMES FULL: c d u v
WRITABLE VOLUMES: eeeee fffff wwwww xxxxx
FULL VOLUMES: sssss ttttt yyyyy zzzzz
DRIVE START THRESHOLD: ggggg hhhhh
Volume Full Threshold: iiiii jjjjj
Reinit / Recycle Mode: kkkkkkkk pppppppp
# of Active Drives: lllll mmmmm
Recall Status: qqqqqqqq rrrrrrrr
Recall to disk sublevel s
…
c Indicates whether all of the optical volumes
that belong to this storage group are marked
full. Valid values are:
Y All optical volumes are full
N At least one optical volume has
available space
- There are no optical volumes in this
storage group
d Indicates whether all of the tape volumes that
belong to this storage group are marked full.
Valid values are:
Y All tape volumes are full
N At least one tape volume has
available space
- There are no tape volumes in this
storage group
n Indicates whether retention-protection is enabled
for this object storage group.
Valid Values are:
Y Retention-protection is enabled for this object
storage group. Objects stored in this storage group
will have a retention-protected attribute associated
with them for the life of the object. Retention-
protected objects can not be deleted prior to their
expiration date, and additionally, their expiration
dates can be moved out to a later date, but can never
be brought in to an earlier date.
N Retention-protection is disabled for this object
storage group. Objects stored into this storage group
will not have a retention-protected attribute associated
with them for the life of the object. Note: even if a
given object is not being protected from premature
deletion by the retention-protection attribute
specifically, it could possibly be protected by another
mechanism such as deletion-protection or deletion-hold.
- A dash is displayed for object backup storage groups
since retention-protection only applies to object
storage groups.
Note: Retention-protection status is determined by the OAM
Retention Protection parameter in the SMS object storage group
definition.
o Indicates whether deletion-protection is enabled
for this object storage group.
Valid values are:
Y Deletion-protection is enabled for this object
storage group. Objects in this storage group can
not be deleted prior to their expiration date.
However, unlike retention-protection, deletion-
protection does not provide any safeguards for
preventing an object's expiration date from being
brought into an earlier date. Note: retention-
protection takes precedence over deletion-protection.
For example; If a given object is both retention-
protected and deletion-protected, then it defaults
to retention-protection for the life of the object,
and the expiration date could not be manipulated to
an earlier date.
N Deletion-protection is disabled for this object
storage group. Objects in this storage group are
not currently subject to deletion-protection. Note:
Although, in this case, the objects are not being
protected from premature deletion by the deletion-
protection attribute specifically, but they could
possibly be protected by another mechanism such as
retention-protection or deletion-hold.
- A dash is displayed for object backup storage groups
since deletion-protection only applies to object
storage groups.
u Indicates whether all of the tape sublevel 1 volumes that
belong to this storage group are marked full.
Valid values are:
Y All tape sublevel 1 volumes are full
N At least one tape sublevel 1 volume has
available space
- There are no tape sublevel 1 volumes in this
storage group
N/A Not applicable if this storage group is a
backup group
v Indicates whether all of the tape sublevel 2 volumes that
belong to this storage group are marked full.
Valid values are:
Y All tape sublevel 2 volumes are full
N At least one tape sublevel 2 volume has
available space
- There are no tape sublevel 2 volumes in this
storage group
N/A Not applicable if this storage group is a
backup group
eeeee Number of optical volumes in this storage
group that have space available for writes and
the volume writable indicator set to 'Y'.
fffff Number of total tape volumes in this storage group
that have space available for writes and the
volume writeable indicator set to 'Y'.
wwwww Number of tape sublevel 1 volumes in this storage group
that have space available for writes and the
volume writeable indicator set to 'Y'. If the storage
group is a backup group, then 'N/A' is displayed.
xxxxx Number of tape sublevel 2 volumes in this storage group
that have space available for writes and the
volume writeable indicator set to 'Y'. If the storage
group is a backup group, then 'N/A' is displayed.
sssss Number of optical volumes in this storage
group that have been marked full or permanently
full with the volume full indicator set to 'Y' or 'P'.
ttttt Number of total tape volumes in this storage group
that have been marked full or permanently full
with the volume full indicator set to 'Y' or 'P'.
yyyyy Number of tape sublevel 1 volumes in this storage group
that have been marked full or permanently full
with the volume full indicator set to 'Y' or 'P'. If the
storage group is a backup group, then 'N/A' is displayed.
zzzzz Number of tape sublevel 2 volumes in this storage group
that have been marked full or permanently full
with the volume full indicator set to 'Y' or 'P'. If the
storage group is a backup group, then 'N/A' is displayed.
…
lllll Number of active optical drives, currently
processing work for this storage group.
mmmmm Number of tape tasks actively processing
requests for this storage group.
The fields displayed in each data line are as follows: - sgname
- Name of the Object storage group or Object Backup storage group
being displayed.
- a
- Object storage group type:
- B
- Object Backup storage group
- G
- Object storage group
- N
- Nongroup. Not used.
- S
- Scratch
- bbbbb
- Number of write requests for the storage groups that are pending
in OAM.
- sysname
- Name of the system where OSMC processing is run for the Object
or Object Backup storage group. This system name is defined in the
storage group definition in the active SMS configuration. OSMC processes
storage groups automatically when the cycle start window occurs, or
manually when a user requests a full OSMC cycle on that system. This
field is blank if you do not define a specific OSMC system name. If
this field is blank, OSMC processes storage groups when the cycle
window starts, or manually when a user requests a full OSMC cycle
on any system where OAM and OSMC are active.
- objbusg1
- Name of the Object Backup storage group that is specified in the
CBROAMxx member of PARMLIB, where the first backup copies of
objects in this object storage group are stored. This field is --N/A-- if the displayed storage group is an Object
Backup storage group. This field contains hyphens if the displayed
Object storage group does not have a defined first backup storage
group.
- objbusg2
- Name of the Object Backup storage group that is specified in the
CBROAMxx member of PARMLIB, where the second backup copies
of objects in this object storage group are stored. This field is --N/A-- if the displayed storage group is an Object
Backup storage group. This field contains hyphens if the displayed
Object storage group does not have a defined second backup storage
group.
- unitname
- MVS esoteric or generic assigned to this storage group that OAM
uses for tape sublevel 1 when allocating a tape drive for a scratch
volume during a write request to this storage group. This field is
defined using the SETOAM statements in the CBROAMxx member
of PARMLIB or SETOAM update operator commands. This field contains
hyphens if the displayed storage group does not have a tape sublevel
1 unit name that is associated with it.
- unitname2
- MVS esoteric or generic assigned to this storage group that OAM
uses for tape sublevel 2 when allocating a tape drive for a scratch
volume during a write request to this storage group. This is defined
using the SETOAM statements in the CBROAMxx member of PARMLIB
or SETOAM update operator commands. If no L2TAPEUNITNAME is specified
for this storage group and the group is not a backup storage group,
this field contains hyphens. For a backup storage group, this field
contains '--N/A--'.
- libname1–libname8
- Names of one-to-eight real optical libraries or a single pseudo
library that is associated with the storage group.
- dataclass
- The data class that is associated with this sublevel 1 object
tape volume. The data class is defined using the SETOAM statements
in the CBROAMxx member of PARMLIB or SETOAM update operator
commands. This field contains hyphens if this storage group does not
have a tape sublevel 1 data class (DATACLASS) associated with it.
- dataclass2
- The data class that is associated with this sublevel 2 object
tape volume. The data class is defined using the SETOAM statements
in the CBROAMxx member of PARMLIB. This field contains hyphens
if no L2DATACLASS is specified for this storage group and the group
is not a backup storage group. For a backup storage group, this field
contains --N/A--.
- c
- Indicates whether all optical volumes associated with this storage
group are full. Valid values are:
- Y
- All optical volumes are full.
- N
- At least one optical volume has available space.
- -
- There are no optical volumes in this storage group.
- d
- Indicates whether all tape volumes associated with this storage
group are full. Valid values are:
- Y
- All tape volumes are full.
- N
- At least one tape volume has available space.
- -
- There are no tape volumes in this storage group.
- n
- Indicates whether retention-protection is enabled for this object
storage group. Valid values are:
- Y
- Retention-protection is enabled for this object storage group.
Objects stored in this storage group will have a retention-protected
attribute associated with them for the life of the object. Retention-protected
objects can not be deleted prior to their expiration date, and additionally,
their expiration dates can be moved out to a later date, but can never
be brought in to an earlier date.
- N
- Retention-protection is disabled for this object storage group.
Objects stored into this storage group will not have a retention-protected
attribute associated with them for the life of the object.
Note: Even
if a given object is not being protected from premature deletion by
the retention-protection attribute specifically, it could possibly
be protected by another mechanism such as deletion-protection or deletion-hold
- -
- A dash is displayed for object backup storage groups since retention-protection
only applies to object storage groups.
Note: Retention-protection status is determined by
the OAM Retention Protection parameter in the SMS object storage group
definition.
- o
- Indicates whether deletion-protection is enabled for this object
storage group. Valid values are:
- Y
- Deletion-protection is enabled for this object storage group.
Objects in this storage group can not be deleted prior to their expiration
date. However, unlike retention-protection, deletion-protection does
not provide any safeguards for preventing an object's expiration date
from being brought into an earlier date.
Note: Retention-protection
takes precedence over deletion-protection. For example; If a given
object is both retention-protected and deletion-protected, then it
defaults to retention-protection for the life of the object, and the
expiration date could not be manipulated to an earlier date.
- N
- Deletion-protection is disabled for this object storage group.
Objects in this storage group are not currently subject to deletion-protection.
Note: Although, in this case, the objects are not being protected from
premature deletion by the deletion-protection attribute specifically,
but they could possibly be protected by another mechanism such as
retention-protection or deletion-hold.
- -
- A dash is displayed for object backup storage groups since deletion-protection
only applies to object storage groups.
- u
- Indicates whether all of the tape sublevel 1 volumes that belong
to this storage group are marked full. Valid values are:
- Y
- All tape sublevel 1 volumes are full.
- N
- At least one tape sublevel 1 volume has available space.
- -
- There are no tape sublevel 1 volumes in this storage group.
- N/A
- Not applicable if this storage group is a backup group.
- v
- Indicates whether all of the tape sublevel 2 volumes that belong
to this storage group are marked full. Valid values are:
- Y
- All tape sublevel 2 volumes are full.
- N
- At least one tape sublevel 2 volume has available space.
- -
- There are no tape sublevel 2 volumes in this storage group.
- N/A
- Not applicable if this storage group is a backup group.
- eeeee
- Number of optical volumes in this storage group that have space
available for writes and the volume writeable indicator set to 'Y'.
- fffff
- Number of total tape volumes in this storage group that have space
available for writes and the volume writeable indicator set to ’Y’.
- wwwww
- Number of tape sublevel 1 volumes in this storage group that have
space available for writes and the volume writeable indicator
set to 'Y'. If the storage group is a backup group, then 'N/A' is
displayed.
- xxxxx
- Number of tape sublevel 2 volumes in this storage group that have
space available for writes and the volume writeable indicator
set to 'Y'. If the storage group is a backup group, then 'N/A' is
displayed.
- sssss
- Number of optical volumes in this storage group that have been
marked full or permanently full with the volume full indicator set
to 'Y' or 'P'.
- ttttt
- Number of total tape volumes in this storage group that have been
marked full or permanently full with the volume full indicator set
to 'Y' or 'P'.
- yyyyy
- Number of tape sublevel 1 volumes in this storage group that have
been marked full or permanently full with the volume full indicator
set to 'Y' or 'P'. If the storage group is a backup group, then 'N/A'
is displayed.
- zzzzz
- Number of tape sublevel 2 volumes in this storage group that have
been marked full or permanently full with the volume full indicator
set to 'Y' or 'P'. If the storage group is a backup group, then 'N/A'
is displayed.
- ggggg
- Optical drive startup threshold for this storage group. When the
number of requests per active optical drive exceeds the threshold,
a new optical drive can be started for this storage group.
- hhhhh
- Tape drive startup threshold for this storage group. When the
number of requests for this storage group exceeds this threshold,
a new tape drive task can be started for this storage group.
- iiiii
- Optical volume full threshold. When the number of kilobytes that
are free on an optical volume belonging to this storage group drops
below this threshold value, the volume is marked full.
- jjjjj
- Tape volume full threshold. When the number of kilobytes that
are free on a tape volume belonging to this storage group drops below
this threshold value, the volume is marked full.
- kkkkkkkk
- The optical reinitialization mode for this storage group. When
a reusable optical cartridge expires or is recycled using the RECYCLE
option on a MOVEVOL command, both volumes on that cartridge are reinitialized.
The volumes can be returned to scratch, or remain assigned to their
current storage group. Valid values are:
- GROUP
- Remain in the currently assigned storage group.
- SCRATCH
- Return to scratch.
- pppppppp
- Tape recycle mode. When the tape cartridge in this storage group
no longer contains active objects because the volume is expired, or
is recycled using the START RECYCLE command or the RECYCLE option
on a MOVEVOL command. The tape volumes can be returned to MVS scratch,
OAM scratch, or remain assigned to their current storage group. Valid
values are:
- GROUP
- Remain in the currently assigned storage group.
- OAMSCR
- Return to OAM scratch.
- MVSSCR
- Return to MVS scratch.
- lllll
- The number of optical drives actively processing requests for
this storage group.
- mmmmm
- The number of tape tasks actively processing requests for this
storage group.
- qqqqqqqq
- Optical Immediate Recall to Disk (IRD) Status. Indicates the current
IRD setting for objects residing on optical media. These values are
based on SETOSMC statements in the CBROAMxx Parmlib member. Valid
values are:
- nnn
- Implicit recalls are enabled as a result of RECALLOPTICAL or RECALLALL
keywords specified in a SETOSMC statement. When an object from this
storage group is retrieved from optical, it will be recalled to DB2
sublevel or file system sublevel. nnn represents the number
of days an implicitly recalled object will reside on DB2.
- EXPLICIT
- Implicit recalls disabled due to RECALLNONE specified and/or RECALLOPTICAL
or RECALLALL keywords NOT specified in a SETOSMC statement. Recalls
will occur only by OSREQ invocation.
- DISABLED
- Implicit and explicit recalls disabled as a result of RECALLOFF(ON)
or MAXRECALLTASKS(0) specified in a SETOSMC Statement.
If the storage group displayed is an object backup
storage group, this field will contain "--N/A--".
- rrrrrrrr
- Tape Immediate Recall to Disk (IRD) Status. Indicates the current
IRD setting for objects residing on tape media. These values are based
on SETOSMC statements in the CBROAMxx Parmlib member. Valid values
are:
- nnn
- Implicit recalls are enabled as a result of RECALLTAPE or RECALLALL
keywords specified in a SETOSMC statement. When an object from this
storage group is retrieved from optical, it will be recalled to DB2
sublevel or file system sublevel. nnn represents
the number of days an implicitly recalled object will reside on DB2.
- EXPLICIT
- Implicit recalls disabled due to RECALLNONE specified and/or RECALLTAPE
or RECALLALL keywords NOT specified in a SETOSMC statement. Recalls
will occur only by OSREQ invocation.
- DISABLED
- Implicit and explicit recalls disabled as a result of RECALLOFF(ON)
or MAXRECALLTASKS(0) specified in a SETOSMC Statement.
If the storage group displayed is an object backup
storage group, this field will contain "--N/A--".
- s
- Disk sublevel in which recalled objects will be written. The disk
sublevel is defined using the SETOSMC statement in the CBROAMxx member
of PARMLIB or SETOSMC update operator command. For Object Backup storage
groups this value will contain "--N/A--".
The following is a sample of DISPLAY SMS,STORGRP(GROUP01),DETAIL: CBR1130I OAM storage group status:
OBJECT TY REQ OSMC BACKUP BACKUP RET DEL
STORGRP COUNT SYSTEM STORGRP1 STORGRP2 PRO PRO
GROUP01 G 0 SYSTEM1 IMAFIRST IMSECOND N N
TAPE DATA L2TAPE L2DATA
UNIT CLASS UNIT CLASS
3490 VTSM2CU 3490 VTSM2CU
Library Names: PEA15
DSL2 Directory: /u/group01
DSL2 Type: ZFS
OPTICAL TAPE TSL1 TSL2
All Volumes Full: - N N N
Writable Volumes: 0 2 1 1
Full Volumes: 0 0 0 0
Drive Start Threshold: 200 9999
Volume Full Threshold: 900 0
Reinit / Recycle Mode: SCRATCH OAMSCR
# of Active Drives: 0 0
Recall Status: EXPLICIT EXPLICIT
Recall to disk sublevel 2
The following is a sample of DISPLAY SMS,STORGRP(IMAFIRST),DETAIL,
where IMAFIRST is a backup storage group: CBR1130I OAM storage group status:
OBJECT TY REQ OSMC BACKUP BACKUP RET DEL
STORGRP COUNT SYSTEM STORGRP1 STORGRP2 PRO PRO
IMAFIRST B 0 SYSTEM1 --N/A-- --N/A-- - -
TAPE DATA L2TAPE L2DATA
UNIT CLASS UNIT CLASS
3490 VTSM2CU --N/A-- --N/A--
Library Names: PEA15
DSL2 Directory: --N/A--
DSL2 Type: --N/A--
OPTICAL TAPE TSL1 TSL2
All Volumes Full: - N N/A N/A
Writable Volumes: 0 2 N/A N/A
Full Volumes: 0 5 N/A N/A
Drive Start Threshold: 99 9999
Volume Full Threshold: 1 0
Reinit / Recycle Mode: SCRATCH OAMSCR
# of Active Drives: 0 0
Recall Status: --N/A-- --N/A--
Recall to disk sublevel --N/A--
The following is a sample of DISPLAY SMS,STORGRP(ALL),DETAIL: OBJECT TY REQ OSMC BACKUP BACKUP RET DEL
STORGRP COUNT SYSTEM STORGRP1 STORGRP2 PRO PRO
GROUP01 G 0 SYSTEM1 IMAFIRST IMSECOND N N
TAPE DATA L2TAPE L2DATA
UNIT CLASS UNIT CLASS
3490 VTSM2CU 3490 VTSM2CU
Library Names: PEA15
DSL2 Directory: /u/group01
DSL2 Type: ZFS
OBJECT TY REQ OSMC BACKUP BACKUP RET DEL
STORGRP COUNT SYSTEM STORGRP1 STORGRP2 PRO PRO
GROUP02 G 0 SYSTEM1 IMAFIRST IMSECOND N N
TAPE DATA L2TAPE L2DATA
UNIT CLASS UNIT CLASS
3490 VTSM2CU 3490 VTSM2CU
Library Names: PEA15
DSL2 Directory:
DSL2 Type:
OBJECT TY REQ OSMC BACKUP BACKUP RET DEL
STORGRP COUNT SYSTEM STORGRP1 STORGRP2 PRO PRO
IMAFIRST B 0 SYSTEM1 --N/A-- --N/A-- - -
TAPE DATA L2TAPE L2DATA
UNIT CLASS UNIT CLASS
3490 VTSM2CU --N/A-- --N/A--
Library Names: PEA15
DSL2 Directory: --N/A--
DSL2 Type: --N/A--
OBJECT TY REQ OSMC BACKUP BACKUP RET DEL
STORGRP COUNT SYSTEM STORGRP1 STORGRP2 PRO PRO
IMSECOND B 0 SYSTEM1 --N/A-- --N/A-- - -
TAPE DATA L2TAPE L2DATA
UNIT CLASS UNIT CLASS
3490 VTSM2CU --N/A-- --N/A--
Library Names: PEA15
DSL2 Directory: --N/A--
DSL2 Type: --N/A--
TAPE LIBRARY
STORGRP NAMES
SGATL ATL10001
SGATLOBJ ATL10001 ATLCA030
SGMIXED ATL10001
SGMTL MTL13590
SGMTLOBJ MTL13590
SGVTS ATLBA999
SGVTSOBJ ATLBA999 ATLCA030
|
z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support
Copyright IBM Corporation 1990, 2014