Define storage class for SM pubset
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Function
The CREATE-STORAGE-CLASS command allows systems support to define a new storage class for an SM pubset. The SM pubset must have been imported to the local system (in exclusive or shared mode).
An entry for the new storage class is added to the current storage class catalog (f ile :<sm-pubset-catid>:$TSOS.SYSCAT.STORCLS). The storage class definition contains a list of file attributes. If it is assigned a volume set list, it also includes the name of the list. The user can assign a storage class to a file in the CREATE-FILE and MODIFY-FILE-ATTRIBUTES commands. The file is then implicitly given all the file attributes defined in the storage class. If there is a volume set list assigned to the storage class, the file will if possible be stored in a volume set from the assigned volume set list.
The SHOW-STORAGE-CLASS command can be used to list the attributes of a storage class.
A storage class can be modified with the MODIFY-STORAGE-CLASS command, and its entry can be removed from the storage class catalog with the DELETE-STORAGE-CLASS command.
Systems support can use the CHANGE-STORAGE-CLASS-CATALOG command to change or, in the event of an error, dynamically load the storage class catalog.
Format
CREATE-STORAGE-CLASS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
STORAGE-CLASS-NAME = <composed-name 1..8>
Defines a name for the new storage class.
PUBSET = <cat-id 1..4>
Specifies the catalog ID of the pubset for which the storage class is being created. The pubset must be an SM pubset which has been locally imported (in exclusive or shared mode).
FILE-ATTRIBUTES = *STD / *PARAMETERS(...)
Specifies pubset management requirements which can be represented in the form of file attributes. The file attributes apply to all files to which the user assigns the storage class instead of explicit attributes (see the STORAGE-CLASS operand of the CREATE-FILE or MODIFY-FILE-ATTRIBUTES command).
FILE-ATTRIBUTES = *STD
Files assigned this storage class are allocated standard pubset management requirements. These correspond to the default values in the FILE-ATTRIBUTES=*PARAMETERS(...) structure.
FILE-ATTRIBUTES = *PARAMETERS(...)
Specifies which file attributes are allocated to files in this storage class.
IO-ATTRIBUTES = *STD / *PARAMETERS(...)
Specifies which performance requirements apply to files in this storage class.
IO-ATTRIBUTES = *STD
The default values in the *PARAMETERS(...) structure apply.
IO-ATTRIBUTES = *PARAMETERS(...)
Performance attributes are determined by the specifications in the PERFORMANCE and USAGE operands.
PERFORMANCE = *STD / *HIGH / *VERY-HIGH
Specifies the performance attribute for files in this storage class. It indicates the priority required for the I/O operations selected in the USAGE operand.
PERFORMANCE = *STD
No performance requirements are defined for files in this storage class. In this case the USAGE operand has no impact on the processing of the file.
PERFORMANCE = *HIGH
A cache should be used to process files in this storage class (high performance priority).
PERFORMANCE = *VERY-HIGH
A cache should be used to process files in this storage class, and if possible the entire file should be kept permanently in the cache (highest performance priority, only available in the GS cache medium).
USAGE = *READ-WRITE / *WRITE / *READ
Specifies the I/O operations for which enhanced performance (caching) is required. The default is *READ-WRITE, i.e. the requirement applies to both read and write operations.
The requirement may also be applied only to write operations (*WRITE) or only to read operations (*READ).
If the file has no special performance attribute (PERFORMANCE=*STD), the USAGE operand has no impact on processing.
DISK-WRITE = *STD / *IMMEDIATE / *BY-CLOSE
Specifies the time at which data consistency is required for files in this storage class after a write operation.
DISK-WRITE = *STD
The default setting of *STD is equivalent to *IMMEDIATE for permanent files and to *BY-CLOSE for temporary files.
DISK-WRITE = *IMMEDIATE
The data in a file must be in a consistent state immediately on completion of a write operation, so a volatile write cache should not be used to process files in this storage class.
DISK-WRITE = *BY-CLOSE
The data in a file does not have to be in a consistent state until after CLOSE processing, so a volatile write cache may be used to process files in this storage class.
AVAILABILITY = *STD / *HIGH
Specifies availability requirements for files in this storage class.
AVAILABILITY = *STD
There are no special availability requirements.
AVAILABILITY = *HIGH
Files in this storage class are required to have high availability (e.g. storage on mirrored disks).
FILE-PREFORMAT = *BY-PUBSET-DEFAULT / *K / *NK2 / *NK4
Governs the preferred file format for files in this storage class. This specification only applies when the catalog entry is created; it is used to automatically determine the storage location.
As long as the file does not yet have a creation date (CRE-DATE=NONE), the storage location is provisional and may still change in the course of OPEN processing.
FILE-PREFORMAT = *BY-PUBSET-DEFAULT
The pubset-global default applies.
FILE-PREFORMAT = *K
File in this storage class are to be created as K files.
FILE-PREFORMAT = *NK2
File in this storage class are to be created as NK2 files.
FILE-PREFORMAT = *NK4
File in this storage class are to be created as NK4 files.
WORK-FILE = *NO / *YES
Governs whether files in this storage class are work files.
WORK-FILE = *NO
Files in this storage class are created as normal files.
WORK-FILE = *YES
Files in this storage class are created as work files. Systems support can delete work files at appointed times.
STORAGE-CLASS-INFO = *NONE / <c-string 1..720 with-low>
Systems support can compose a brief text describing storage class attributes. It will typically relate to special pubset management requirements which are defined by systems support but cannot be represented in the form of file attributes. This brief text is included in the output of the SHOW-STORAGE-CLASS command to inform the user of any special properties of the storage class.
STORAGE-CLASS-INFO = *NONE
There is to be no explanatory text for the storage class.
STORAGE-CLASS-INFO = <c-string 1..720 with-low>
A brief text describing special properties of the storage class as defined by systems support.
PROTECTION = *NONE / *BY-GUARDS(...)
Specifies whether access to the storage class is to be controlled by guards.
PROTECTION = *NONE
Access to the storage class is not to be controlled by guards.
PROTECTION = *BY-GUARDS(...)
Allocation of the storage class to a file and the listing of the storage class definitions are to be controlled by a guard. The guard named next defines conditions under which a user is allowed to access the storage class.
GUARD-NAME = <filename 1..18 without-cat-gen-vers>
Name of the guard.
VOLUME-SET-LIST = *NONE / <composed-name 1..8>
Specifies whether a volume set list is to be assigned to the storage class.
The default is *NONE, i.e. no volume set list is to be assigned to the storage class at this time.
VOLUME-SET-LIST = <composed-name 1..8>
The specified volume set list is assigned to the storage class. The volume set list must already exist for this SM pubset.
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 | DMS1488 | Storage class already defined | |
64 | DMS1497 | Invalid file attribute combination | |
64 | DMS148B | Volume set list not defined | |
64 | DMS1485 | Pubset not known | |
64 | DMS1486 | Pubset is not a system-managed pubset | |
64 | DMS1487 | Pubset not available | |
64 | DMS1490 | Storage class management not available for this pubset | |
64 | DMS1483 | Storage class catalog invalid | |
64 | DMS1481 | Error accessing storage class catalog | |
64 | DMS1484 | Volume set list catalog invalid | |
64 | DMS1482 | Error accessing volume set list catalog | |
129 | DMS148D | Not enough class 4/5 memory | |
129 | DMS148E | Error on MSCF connection to master | |
129 | DMS148F | GCF subsystem not ready |