Attributes of the object storage group

To define an object storage group you specify the following attributes:

Description

This is an optional description of the object storage group. It can be up to 120 characters.

Qualifier

This identifies a DB2® database on DASD that contains table spaces, one of which contains the object directory for this object storage hierarchy. The qualifier attribute also points to the DB2 object storage tables on DASD that have been defined for the object storage hierarchy. You can use one-to-eight alphanumeric characters as qualifiers.

This qualifier must be defined as a package in the CBRPBIND job to create the necessary DB2 package for the application plans.

Cycle Start Time

This identifies the beginning of a window of time. Use this field in association with Cycle End Time to specify a specific window of time in which object processing can be started for this storage group. Specify a value from 0 to 23, or NONE. A value from 0 to 23 represents an hour of the day.

For example, specify 00 for midnight; 01 for 1 a.m.; or 23 for 11 p.m.

Specify NONE if you do not want automatic processing for the storage group.

The value for Cycle Start Time must be different from the value for Cycle End Time. When you specify NONE, the value for Cycle End Time must be blank.

Recommendation: If you are running in an OAMplex and specify a cycle start time, specify an OSMC processing system name. Otherwise, object processing for that object storage group will start on all systems in the OAMplex at cycle start time.

Cycle End Time

Identifies the end of a window of time when object processing can be started for this storage group.

The function of the cycle end time depends on which cycle window mode is in effect when OAM initializes. The cycle window mode can be specified by using the CYCLEWINDOW keyword for the SETOSMC statement in the CBROAMxx parmlib member (refer to z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support). In Start Only mode, the cycle end time identifies the end of a window of time when object processing can be started for this storage group. In Start Stop mode, when the cycle end time has been reached, processing is the same as if a STOP command had been issued for that storage group. No new work will be scheduled, all work in progress is allowed to complete.

Specify a value from 0 to 23, or blank. A value from 0 to 23 represents an hour of the day, and is required when a value from 0 to 23 was specified for Cycle Start Time.

For example, specify an hour of the day as 00 for midnight; 01 for 1 a.m.; or 23 for 11 p.m.

The value for Cycle End Time must be different from the value for Cycle Start Time. Leave the field blank if you specified NONE for Cycle Start Time.

OSMC Processing System

Specifies an OSMC processing system name. This is the one that identifies which OAM system in the sysplex performs OSMC processing for this object storage group. This prevents multiple systems from trying to process the same storage group at the same time, especially when the Cycle Start Time is used for automatically starting storage group processing.

Library Names

You can specify either one-to-eight real library names that represent optical libraries, or one-to-eight pseudo library names. The libraries you specify are used to process write requests to the storage group. Names must be valid real or pseudo optical library names that are defined in the SCDS.

Volume Full Threshold

This is the number of free KB that triggers volume full processing for an optical volume within the object storage group. When the number of free KB falls below the threshold, the object access method marks the optical volume as being full. If the threshold is reached while OAM is writing an object, it continues writing that object until finished. OAM then writes no more objects to that volume. Valid values are from 0 to 9999.

Drive Start Threshold

This is the maximum number of object write requests that are 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 drives currently processing write requests for this storage group, exceeds this threshold, the object access method attempts to start an additional optical drive. Valid values are from 0 to 9999.

This field is optional. If no value is specified, the default is 17.

Volume Full at Write Error

This field indicates when to mark as "full" optical or tape volumes within this object storage group. If Y, the object access method marks an optical or tape volume full the first time an attempt to write an object on the volume fails because not enough space remains on the volume. If N, OAM marks a volume full only when the number of available KB in the user data area falls below the Volume Full Threshold for optical or the TAPEFULL THRESHOLD for tape. An optical volume is also marked full if the optical volume table of contents area is full, regardless of how many KB are remaining in the user data area.

DEFINE SMS Storage Group Status

Indicates whether you want to change the storage group status. The values are:

Y: Change the status. When you complete the current panel, you will see the SMS Storage Group Status Define panel. For more information, see Defining object or object backup storage group status. If you are defining a storage group, Y is the default value.
N: Do not change the status. If you are altering a storage group, N is the default value.

You must define object storage group system statuses on the SMS Storage Group Status Define panel before the object storage group definition can be saved. After you define the status of the systems, issue the END command to save the defined object backup storage group and return to the Storage Group Application Selection panel.

OAM Deletion Protection

This field specifies the deletion-protection mode for all objects in this object storage group. When deletion-protection is enabled, objects in this object storage group cannot be deleted prior to their expiration date. Deletion-protection does not restrict any changes to an object's expiration date.

You must have also specified DP=P in the IEFSSNxx PARMLIB member. This field is ignored when no value is specified for DP in PARMLIB member IEFSSNxx, and when DP=A or DP=N is specified.

OAM Retention Protection

This field indicates whether new objects stored into an object storage group are flagged as retention-protected for the entire life of the objects. A retention-protected object cannot be deleted prior to its expiration date, and its expiration date can never move to an earlier date.

OAM Retention Protection is used by OAM to set the retention-protection mode for an object at the time that the object is stored. If OAM Retention Protection is enabled at the time that the object is stored, then the object is in retention-protection mode for the life of the object. Setting OAM Retention Protection to disabled affects the retention-protection mode of subsequent objects stored into this object storage group, but does not impact the retention-protection mode of objects that were previously stored