Delete storage class definition
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Functions
The DELETE-STORAGE-CLASS command enables systems support to delete storage classes from the storage class catalog. If more than one storage class is specified, the SELECT operand can be used to restrict the set of storage classes being deleted to those with specific attributes. The DIALOG-CONTROL operand defines the conditions under which a dialog is conducted to verify that objects are to be deleted.
The SM pubset must have been imported to the local system (in exclusive or shared mode).
Before deleting a storage class, note that references to that storage class may still exist. The following types of reference are possible:
The storage class is already assigned to existing files. You can find out which files these are with the SHOW-FILE-ATTRIBUTES command and the STORAGE-CLASS selection criterion. Before deleting the storage class you should assign these files to another class or cancel their storage class assignment. Otherwise, the files might be given an inappropriate storage location if migrated with HSMS and then recalled.
The storage class is assigned to user IDs as their default storage class (see the MODIFY-USER-PUBSET-ATTRIBUTES command). You can find out which user IDs these are with the SHOW-USER-ATTRIBUTES command. Before deleting the storage class you should assign these user IDs a different default storage class or cancel the default storage class assignment. Otherwise, the users affected will have to specify a storage class or the file attributes explicitly when creating files in the pubset in question.
Format
DELETE-STORAGE-CLASS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
STORAGE-CLASS-NAME = *ALL / <composed-name 1..8 with-wild>
Specifies which storage classes to delete.
STORAGE-CLASS-NAME = *ALL
The storage classes to delete are all those which are assigned to the pubset specified in the PUBSET operand and which also meet the selection criteria defined in the SELECT operand.
STORAGE-CLASS-NAME = <composed-name 1..8 with-wild>
Name of the storage class that is to be deleted. Wildcards can be used to select more than one storage class.
The storage classes to delete are all those specified here which are assigned to the pubset specified in the PUBSET operand and which also meet the selection criteria defined in the SELECT operand.
PUBSET = <cat-id 1..4>
Catalog ID of the associated SM pubset. The SM pubset must have been imported to the local system (in exclusive or shared mode).
SELECT = *ALL / *PARAMETERS(...)
Specifies whether the set of storage classes specified in the STORAGE-CLASS-NAME operand is to be restricted by selection criteria.
SELECT = *ALL
There is no restriction on the set of storage classes specified in the STORAGE-CLASS-NAME operand.
SELECT = *PARAMETERS(...)
Defines selection criteria to restrict the set of storage classes specified in the STORAGE-CLASS-NAME operand. Only those storage classes which possess all the attributes specified next are to be deleted.
The default value, *ANY, means that the attribute in question is not a selection criterion.
FILE-ATTRIBUTES = *ANY / *PARAMETERS(...)
Specifies whether the selection of storage classes to delete is to be based on the file attributes defined in them.
FILE-ATTRIBUTES = *ANY
The file attributes are not a selection criterion.
FILE-ATTRIBUTES = *PARAMETERS(...)
The storage classes which are to be deleted are selected on the basis of the file attributes specified next.
IO-ATTRIBUTES = *ANY / *PARAMETERS(...)
Specifies whether the performance attributes are to be a selection criterion.
IO-ATTRIBUTES = *PARAMETERS(...)
The storage classes which are to be deleted must have definitions containing the performance attributes specified next.
PERFORMANCE = *ANY / list-poss(3): *STD / *HIGH / *VERY-HIGH
Deletes all storage classes which possess one of the specified performance attributes.
PERFORMANCE = *ANY
The performance attribute is not a selection criterion.
PERFORMANCE = *STD
Deletes only those storage classes which have their performance attribute set to *STD (no special performance requirement).
PERFORMANCE = *HIGH
Deletes only those storage classes which have their performance attribute set to *HIGH (high performance requirement).
PERFORMANCE = *VERY-HIGH
Deletes only those storage classes which have their performance attribute set to *VERY-HIGH (highest performance requirement).
USAGE = *ANY / list-poss(3): *READ-WRITE / *WRITE / *READ
Deletes all storage classes which have the performance attribute set for one of the specified I/O operations.
USAGE = *ANY
The I/O operation mode is not a selection criterion.
USAGE = *READ-WRITE
Deletes only those storage classes which have their performance attribute set for read/write operations.
USAGE = *WRITE
Deletes only those storage classes which have their performance attribute set for write operations.
USAGE = *READ
Deletes only those storage classes which have their performance attribute set for read operations.
DISK-WRITE = *ANY / list-poss(3): *STD / *IMMEDIATE / *BY-CLOSE
Specifies whether the attribute governing the time when data consistency is required after write operations is to be a selection criterion.
DISK-WRITE = *ANY
The point at which data consistency is required is not a selection criterion.
DISK-WRITE =*STD
Deletes only those storage classes which have their consistency point defined as DISK-WRITE=*STD.
DISK-WRITE = *IMMEDIATE
Deletes only those storage classes which have their consistency point defined as immediately after completion of write operations.
DISK-WRITE = *BY-CLOSE
Deletes only those storage classes which have their consistency point defined as only after CLOSE processing.
AVAILABILITY = *ANY / list-poss(2): *STD / *HIGH
Specifies whether the availability attribute is to be a selection criterion.
AVAILABILITY = *ANY
The required availability is not to be a selection criterion.
AVAILABILITY = *STD
Deletes only those storage classes for which no special availability requirements are defined.
AVAILABILITY = *HIGH
Deletes only those storage classes for which high availability requirements are defined.
FILE-PREFORMAT = *ANY / list-poss(4): *BY-PUBSET-DEFAULT / *K / *NK2 / *NK4
Specifies whether the attribute for preferred file format is to be a selection criterion.
FILE-PREFORMAT = *ANY
The preferred file format is not to be a selection criterion.
FILE-PREFORMAT = *BY-PUBSET-DEFAULT
Deletes only those storage classes for which the preferred file format is defined as the pubset-global default.
FILE-PREFORMAT = *K
Deletes only those storage classes in which files are set to be created as K files.
FILE-PREFORMAT = *NK2
Deletes only those storage classes in which files are set to be created as NK2 files.
FILE-PREFORMAT = *NK4
Deletes only those storage classes in which files are set to be created as NK4 files.
WORK-FILE = *ANY / list-poss(2): *NO / *YES
Specifies whether the work file attribute is to be a selection criterion.
WORK-FILE = *ANY
The work file attribute is not to be a selection criterion.
WORK-FILE = *NO
Deletes only those storage classes in which files are created as normal files.
WORK-FILE = *YES
Deletes only those storage classes in which files are created as work files.
VOLUME-SET-LIST = *ANY / *NONE / <composed-name 1..8>
Specifies whether the storage classes are to be selected on the basis of volume set list assignment.
VOLUME-SET-LIST = *ANY
Volume set list assignment is not to be a selection criterion.
VOLUME-SET-LIST = *NONE
Deletes only those storage classes to which no volume set list is assigned.
VOLUME-SET-LIST = <composed-name 1..8>
Deletes only those storage classes to which the specified volume set list is assigned.
DIALOG-CONTROL = *STD / *NO / *ERROR / *CLASS-CHANGE / *MORE-THAN-ONE-CLASS
Specifies whether and under what conditions a verification dialog is to be conducted with the user during the deletion process.
The verification dialog mechanism is available only in interactive mode, though that does include procedures. In batch mode, all values have the same effect as *NO.
Systems support can intervene with the following inputs:
Y | the specified storage class or storage class set will then be deleted. |
N | the specified storage class or storage class set will not be deleted. |
T | processing of the command will be terminated. |
S | the specified storage class or storage class set will be displayed. The verification dialog will then be repeated. |
? | the possible responses will be listed, with an explanation of each. |
DIALOG-CONTROL = *STD
The default *STD setting is equivalent to *MORE-THAN-ONE-FILE in an interactive dialog (when SYSCMD is connected to the terminal) and to *NO in procedures and in batch mode.
DIALOG-CONTROL = *NO
Systems support cannot intervene in DELETE-STORAGE-CLASS processing; all the specified files will be deleted (without a verification dialog).
DIALOG-CONTROL = *ERROR
If deletion of the selected storage classes proceeds without error, all the storage classes will be deleted immediately, as when *NO is specified (i.e. no verification dialog). However, if a correctable error occurs during deletion, then a verification dialog takes place for each storage class which it was not possible to delete.
In batch mode, this value has the same effect as *NO.
DIALOG-CONTROL = *CLASS-CHANGE
A verification dialog is conducted for each storage class selected. In batch mode this value has the same effect as *NO.
DIALOG-CONTROL = *MORE-THAN-ONE-CLASS
If exactly one storage class is specified or identified by the selection criteria, this will be deleted immediately. If more than one storage class is to be deleted, a verification dialog is conducted for the set which is to be deleted. In batch mode, this value has the same effect as *NO.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No errors | |
1 | CMD0202 | Syntax error in command | |
32 | CMD0221 | Internal system error | |
64 | CMD0216 | No authorization to issue command | |
64 | DMS1481 | Error accessing storage class catalog | |
64 | DMS1483 | Storage class catalog invalid | |
64 | DMS1485 | Pubset not known | |
64 | DMS1486 | Pubset is not a system-managed pubset | |
64 | DMS1487 | Pubset not available | |
64 | DMS148A | Storage class not defined | |
64 | DMS1490 | Storage class management not available for this pubset | |
64 | DMS149A | No storage classes meet the selection criteria | |
64 | DMS149C | No storage class exists for the specified pubset | |
129 | DMS148D | Not enough class 4/5 memory | |
129 | DMS148E | Error on MSCF connection to master | |
129 | DMS148F | GCF subsystem not ready |