Show available services for SM pubset
Component: | BS2000 |
Functional area: | File processing |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | STD-PROCESSING |
Function
The SHOW-PUBSET-FILE-SERVICES command shows which services are provided by a locally available SM pubset. This allows the user to establish what requirements can be met on a given SM pubset in terms of storage-related file attributes. The user can formulate file service requirements when creating files with the CREATE-FILE command when modifying file attributes with the MODIFY-FILE-ATTRIBUTES command, and to some extent at the time of file generation (using OPEN).
The range of services that an SM pubset can offer is determined by the attribute profiles of the volume sets which form the pubset. The system uses these profiles when automatically selecting a volume set as the storage location for a file. The range of services can be described in terms of the various combinations of values for the file attributes which govern the storage location (WORK-FILE, AVAILABILITY, FILE-FORMAT, PERFORMANCE, USAGE, DISK-WRITE) and are supported on the SM pubset. The SHOW-PUBSET-FILE-SERVICES command shows how well each selected attribute value combination is supported (SUPPORT-QUALITY).
The file attribute combinations which are to be shown are selected by the SUPPORT-QUALITY and FILE-ATTRIBUTES operands:
SUPPORT-QUALITY: shows the combinations of file attributes which can be supported at the specified level of quality. Default: support at optimum quality (SUPPORT-QUALITY=*OPTIMAL) If no quality restrictions are required, SUPPORT-QUALITY should be set to *ANY. In this case, though, it is advisable to use the FILE-ATTRIBUTES operand to restrict the volume of output information.
FILE-ATTRIBUTES: shows the file attribute combinations which match the specified attribute values. Default: no restriction on the selection on the basis of attribute values (FILE-ATTRIBUTES=*ANY).
The command offers nonprivileged users support primarily in making use of the services provided by an SM pubset by explicitly specifying file attributes.
The SHOW-STORAGE-CLASS command can be used to find out about SM pubset services for which storage classes have been defined and to make use of them by selecting a suitable storage class (in the CREATE-FILE command).
The command supports structured output in S variables (see "Output in S variables").
Privileged functions
The command offers systems support personnel (TSOS privilege) the following additional features such as support for the creation and maintenance of storage classes and volume set lists (see the CREATE-STORAGE-CLASS, MODIFY-STORAGE-CLASS, CREATE-VOLUME-SET-LIST, and MODIFY-VOLUME-SET-LIST commands):
The name of a volume set list can be specified in the VOLUME-SET-LIST operand. The list must have been defined in the specified SM pubset. If a volume set list is named, the output information regarding support quality for file attribute combinations relates to the volume sets which are on the list. If no volume set list is named (equivalent to VOLUME-SET-LIST=*NONE), support quality is evaluated with regard to the volume sets which are not on any volume set list (as for nonprivileged users).
The file attribute combinations which are to be displayed can be specified in the form of a storage class (see FILE-ATTRIBUTES=*BY-STORAGE-CLASS(...)). In this case, the file attributes are taken from the storage class definition.
Format
SHOW-PUBSET-FILE-SERVICES | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
PUBSET = <cat-id 1..4>
SM pubset identifier. The pubset must have been imported to the local system (in exclusive or shared mode).
VOLUME-SET-LIST = *NONE / <composed-name 1..8>
Specifies the volume set list to which the quality of service subsequently described applies.
VOLUME-SET-LIST = *NONE
The quality of service described next applies to volume sets which are not assigned to any volume set list.
When a volume set is selected as the storage location for a file, these volume sets will be given precedence if no storage class at all or the storage not assigned to any volume set list is specified in the CREATE-FILE command.
VOLUME-SET-LIST = <composed-name 1..8>
Only allowed for users with TSOS privilege.
Name of a volume set list. A volume set list with this name must have been defined in the specified SM pubset (see the CREATE-VOLUME-SET-LIST command). The quality of service applies to volume sets which are assigned to this volume set list.
SELECT = *BY-ATTRIBUTES(...)
Defines the criteria for selecting which combinations of file attribute values are to be displayed (FILE-ATTRIBUTES operand), taking into account the quality of support offered for the specified file attributes (SUPPORT-QUALITY operand).
The values specified for the various selection criteria are logically ANDed. The default (*ANY) means that the associated attribute is not a selection criterion.
SUPPORT-QUALITY = *OPTIMAL / *ANY / list-poss(5): *OPTIMAL / *NEARLY-OPTIMAL /
*BETTER-THAN-REQUESTED / *WORSE-THAN-REQUESTED /
*CONFLICT-WITH-VOLUME-SET-LIST
Governs the selection of displayed value combinations for file attributes affecting storage location, based on the quality of service support that can be offered. The quality is expressed in terms of the match between the file attributes and the corresponding volume set attributes of the volume set which, on the basis of the selection strategy, appears to be the most suitable storage location for a file with these attributes (irrespective of the current allocation situation).
A list of several quality criteria can be specified.
SUPPORT-QUALITY = *OPTIMAL
Only attribute value combinations for which optimum support is provided are displayed. Optimum support for a request means that there is a volume set available for selection in the SM pubset which has attributes that exactly match the requested attributes and which is not on any volume set list or is on the specified volume set list, as appropriate.
SUPPORT-QUALITY = *ANY
Output selection is not based on the supported quality.
SUPPORT-QUALITY = *NEARLY-OPTIMAL
Only attribute value combinations for which “nearly optimum” support is provided are displayed.
Support for a request is considered to be nearly optimum if the attributes of the volume which most closely matches the requirements differ only marginally from the specified requirements (e.g. a file in NK4 format on a volume set in NK2 format).
SUPPORT-QUALITY = *BETTER-THAN-REQUESTED
Only “better-than-requested” file attribute combinations are displayed.
This means that the attributes of the volume set which most closely matches the request are of higher quality than the requested attributes (e.g. a file with standard availability on a high-availability volume set).
SUPPORT-QUALITY = *WORSE-THAN-REQUESTED
Only “worse-than-requested” file attribute combinations are displayed.
This means that the specified requirements cannot be met in full, but that the mismatch is not great enough to cause the associated command to abort (e.g. a file with enhanced performance requirements on a volume set offering only standard performance).
SUPPORT-QUALITY = *CONFLICT-WITH-VOLUME-SET-LIST
The only file attribute combinations displayed are those which can only be matched on volume sets which do not belong to the specified volume set list (see the VOLUME-SET-LIST operand; the default is those which do not belong to any volume set list).
Ordinary users are advised not to specify such file attribute combinations explicitly, as these volume sets should be reserved for requests which use the storage class mechanism.
Systems support can use this operand value in conjunction with an explicit volume set list specification as a means of finding out which file attribute combinations a storage class should definitely not have if it is to be assigned this volume set list (in a CREATE-STORAGE-CLASS or MODIFY-STORAGE-CLASS command).
FILE-ATTRIBUTES = *ANY / *PARAMETERS(...) / *BY-STORAGE-CLASS(...)
Governs the selection of the displayed attribute combinations on the basis of the values of the requested file attributes.
FILE-ATTRIBUTES = *ANY
Displays any file attribute combinations for which the support quality defined in the SUPPORT-QUALITY operand is offered.
FILE-ATTRIBUTES = *PARAMETERS(...)
The only file attribute combinations that are to be displayed are those which match the file attributes specified next and for which the support quality defined in the SUPPORT-QUALITY operand is offered.
The selection is restricted by values specified for individual file attributes.
The default (*ANY) in each case means that there is no restriction based on the associated attribute. A list of values for a single file attribute selects combinations for which the associated attribute has one of the specified values (logical ORing).
WORK-FILE = *ANY / list-poss(2): *NO / *YES
Selects file attribute combinations in which the work file attribute has the specified value. Values in a list are logically ORed.
WORK-FILE = *ANY
The work file attribute is not to be used as a selection criterion.
WORK-FILE = *NO
Selects file attribute combinations in which the value of the work file attribute is *NO (ordinary files).
WORK-FILE = *YES
Selects file attribute combinations in which the value of the work file attribute is *YES (work files).
AVAILABILITY = *ANY / list-poss(2): *STD / *HIGH
Selects file attribute combinations in which the availability attribute matches the specified value. Values in a list are logically ORed.
AVAILABILITY = *ANY
The availability attribute is not to be used as a selection criterion.
AVAILABILITY = *STD
Only selects combinations in which no special availability requirements are defined.
AVAILABILITY = *HIGH
Only selects combinations in which high availability is required.
FILE-FORMAT = *ANY / *BY-PUBSET-DEFAULT / list-poss(3): *K / *NK2 / *NK4
Selects file attribute combinations in which the file format attribute has the specified value. This can be either the preferred file format (see the FILE-PREFORMAT operand in the CREATE-FILE command) or the “true” file format as defined when the file is generated (at OPEN time). Values in a list are logically ORed.
FILE-FORMAT = *ANY
The file format is not to be used as a selection criterion.
FILE-FORMAT = *BY-PUBSET-DEFAULT
Selects only those combinations in which the file format matches the value defined by systems support as the pubset-global default for the SM pubset.
FILE-FORMAT = *K
Only selects combinations in which the value of the file format is *K (K files).
FILE-FORMAT = *NK2
Only selects combinations in which the value of the file format is *NK2 (NK2 files).
FILE-FORMAT = *NK4
Only selects combinations in which the value of the file format is *NK4 (NK4 files).
IO-ATTRIBUTES = *ANY / *PARAMETERS(...)
Specifies whether the performance attributes are to be used as a selection criterion.
IO-ATTRIBUTES = *PARAMETERS(...)
Selects only those file attribute combinations in which the performance attributes have the PERFORMANCE and USAGE values specified next.
PERFORMANCE = *ANY / list-poss(3): *STD / *HIGH / *VERY-HIGH
Selects all combinations which have one of the specified performance attributes. Values in a list are logically ORed.
PERFORMANCE = *ANY
The performance attribute is not a selection criterion.
PERFORMANCE = *STD
Only selects combinations in which the value of the performance attribute is *STD (no special performance requirements).
PERFORMANCE = *HIGH
Only selects combinations in which the value of the performance attribute is *HIGH (enhanced performance requirements).
PERFORMANCE = *VERY-HIGH
Only selects combinations in which the value of the performance attribute is *VERY-HIGH (very high performance requirements).
USAGE = *ANY / list-poss(3): *READ-WRITE / *WRITE / *READ
Selects all combinations which match the performance attribute for one of the specified I/O operations. Values in a list are logically ORed.
USAGE = *ANY
The I/O operation mode is not a selection criterion.
USAGE = *READ-WRITE
Only selects combinations with a performance attribute which applies to read/write operations.
USAGE = *WRITE
Only selects combinations with a performance attribute which applies to write operations.
USAGE = *READ
Only selects combinations with a performance attribute which applies to read operations.
DISK-WRITE = *ANY / list-poss(2): *IMMEDIATE / *BY-CLOSE
Selects file attribute combinations in which the attribute governing the time of data consistency after write operations matches the specified value. Values in a list are logically ORed.
DISK-WRITE = *ANY
The point at which data consistency is required is not a selection criterion.
DISK-WRITE = *IMMEDIATE
Only selects combinations in which data consistency is required immediately on completion of the write operation (relevant only for enhanced performance for write access).
DISK-WRITE = *BY-CLOSE
Only selects combinations in which data consistency is not required until after CLOSE processing.
FILE-ATTRIBUTES = *BY-STORAGE-CLASS(...)
Only users with the TSOS privilege are allowed to select this value.
The individual file attributes are to be taken from the specified storage class.
STORAGE-CLASS-NAME = <composed-name 1..8>
Name of the storage class.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No errors | |
1 | CMD0202 | Syntax error | |
32 | CMD0221 | Internal system error | |
32 | CMD2009 | Error on structured output in S variables | |
64 | CMD0216 | User does not have necessary authorization | |
64 | DMS140B | Pubset not available | |
64 | DMS141B | Pubset is not an SM pubset | |
64 | DMS1406 | No combination selected | |
64 | DMS1407 | Storage class management problem | |
64 | DMS1408 | Volume set list not defined | |
64 | DMS1409 | Storage class not defined | |
130 | DMS140F | Not enough class 4/5 memory |
Output format
The information is shown in the form of a table. The output is divided into seven columns. The first six columns each refer to a file attribute, the seventh shows the quality of support offered for the given combination of file attributes.
The table begins with a header line labeling the output columns. This is followed by rows of values for the selected combinations:
WORK-F AVAIL F-FORM IO(PERF) IO(USAGE) DISK-WRITE SUPPORT-QUALITY ------+------+------+---------+---------+-----------+--------------<work> <av> <format> <perf> <usage> <diskw> <supqu>
Output column | Possible values | Meaning |
|---|---|---|
WORK-F | Work file flag: | |
NO | ordinary file | |
YES | work file | |
AVAIL | Availability: | |
STD | no special availability requirements | |
HIGH | high availability | |
F-FORM | File format (FILE-FORMAT): | |
K | K file | |
NK2 | NK2 file | |
NK4 | NK4 file | |
IO(PERF) | Performance attribute: | |
STD | no special performance requirements | |
HIGH | enhanced performance priority | |
VERY-HIGH | highest performance priority | |
IO(USAGE) | I/O operation mode in conjunction with performance requirement (USAGE); no value for IO(PERF)=STD: | |
READ-WRITE | read and write operations | |
WRITE | write operations only | |
READ | read operations only | |
DISK-WRITE | Time when data consistency is required; no value for IO(PERF)=STD or IO(USAGE)=WRITE | |
IMMEDIATE | immediately after write operations | |
BY-CLOSE | not until after CLOSE processing | |
SUPPORT-QUALITY | Quality of support for shown file attribute combination | |
OPTIMAL | Optimum support | |
NEARLY-OPTIMAL | Nearly optimum support | |
BETTER-THAN-REQUEST | “Better-than-requested” support | |
WORSE-THAN-REQUEST | “Worse-than-requested” support | |
CONFL-W-VOL-SET-LST | Support possible only on volume sets which conflict with the volume set list specification |
Output in S variables
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Requirements concerning failsafe capability | var(*LIST).AVAIL | S | *STD | |
File consistency time | var(*LIST).DISK-WRITE | S | '' | |
File format | var(*LIST).F-FORM | S | *K | |
Performance requirements | var(*LIST).IO-ATTR.PERF | S | *STD | |
Type of file access covered by the performance requirement *HIGH or *VERY-HIGH | var(*LIST).IO-ATTR.USAGE | S | '' | |
Quality of service support for the combination of file attributes resulting from the values of the other S variables of the relevant list member | var(*LIST).SUP-QUALITY | S | *BETTER-THAN-REQUEST | |
Work file | var(*LIST).WORK-F | S | *NO |