This statement is for the HSMS administrator only and is used to display the usage and assignment of one or more pubsets in an environment.
Format (only for HSMS administrators)
SHOW-PUBSET-USAGE | Alias: SPU | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ENVIRONMENT = *SINGLE-FEATURE(...)
The statement only processes SF pubsets or S1-SM-pubsets.
PUBSET-ID = *ALL
The usage of all pubsets imported in master mode is displayed.
PUBSET-ID = <cat-id>
ID of the pubset whose usage is to be displayed. The pubset must be imported in master mode. It may also be an S1-SM-pubset.
INFORMATION = *SUMMARY
A summary containing the following information for each pubset is displayed:
catalog ID
storage level (S0, S1, UNDEFINED)
total capacity in PAM pages
percentage of used, free and migrated pages.
The following additional information is displayed for S0 pubsets:
total number of pages migrated to S1
number of used and free pages on the allocated S1 pubset.
Details on the content of the screen mask are provided in the section "Output with INFORMATION=*SUMMARY".
INFORMATION = *UNUSED-DAYS(...)
A summary of the inactive files on a pubset is displayed. The period, amounting to 9999 days before the date in question, is divided into individual intervals. One line is displayed on the summary table for each interval:
beginning and end of interval (e.g. 100-199 days)
number of files which have not been accessed since this time
storage space occupied by these files.
This summary does not include the following:
migrated files
temporary user and system files
files which have been cataloged but not processed.
Output depends on the specifications for MINIMUM and MAXIMUM-UNUSED-DAYS. These entries define a main interval which is divided into smaller equal subintervals.The total number of files and the occupied storage space are displayed on the first line of the summary table for the files which were not accessed before MINIMUM-UNUSED-DAYS.
The same information is displayed on the last line for files which were not accessed after MAXIMUM-UNUSED-DAYS.
Details on the content of the screen mask are provided in the section "Output with INFORMATION=*UNUSED-DAYS".
MINIMUM-SIZE = *NONE / <integer 1..2147483647 2Kbyte>
The files included in the summary can be selected according to their minimum size in PAM pages.
Unless otherwise specified, the files are selected irrespective of their minimum size.
MINIMUM-UNUSED-DAYS = <integer 0..9999 days>
Beginning of main interval (see above).
MAXIMUM-UNUSED-DAYS = <integer 0..9999 days>
End of main interval (see above).
INFORMATION = *REUSABLE-S1-SPACE(...)
Provides information about the specified SF pubset’s S1 pubset. Displays a summary containing the space to be obtained through reorganization for selectable save files in the specified migration archive.
The save files are divided according to amount of unused space into intervals of 10%, i.e. 0% – 10%, 10% – 20% etc.
The following is displayed in a table for each of these intervals:
number of save files
number of PAM pages occupied by the save files
number of unused PAM pages in these save files.
The total number of save files is also displayed.
Details on the content of the screen mask are provided in the section "Output with INFORMATION=*REUSABLE-S1-SPACE".
For compressed save files, the percentage is not calculated as the ratio between unused and used pages but rather as the ratio between the number of invalid and valid files.
MINIMUM-DAYS-ON-S1 = 0 / <integer 0..9999 days>
The save files included in the summary can be selected according to the minimum number of days they have been residing on S1.
Unless otherwise specified, the save files are selected irrespective of the number of days they have been residing on S1.
MAXIMUM-DAYS-ON-S1 = 9999 / <integer 0..9999 days>
The save files included in the summary can be selected according to the maximum number of days they have been residing on S1.
Unless otherwise specified, the save files are selected irrespective of the number of days they have been on S1.
MINIMUM-SIZE = *NONE / <integer 1..2147483647 2KByte>
The save files included in the summary can be selected according to their minimum PAM page size.
Unless otherwise specified, the save files are selected irrespective of their size.
ARCHIVE-NAME = *SYSMIGRATE / <filename 1..22 without-cat-gen-vers>
Name of the migration archive.
If the archive directory is protected by a password, this password must first be entered by means of the ADD-PASSWORD command.
ARCHIVE-NAME = *SYSMIGRATE
Default system archive for migration (SYSMIGRATE) on the specified pubset.
INFORMATION = *MIGRATION-EVALUATION
For S0 pubsets only:
displays a summary of inconsistent migrated files. A distinction is made between the following:
A file is not contained (with the same CFID as in the catalog) in the migration archive (NOT-IN-ARC). The file can therefore not be recalled.
According to the catalog entry (PUB/S1), a file was migrated to storage level S1 but is not contained in a save file there.
For the specified pubset (or all of them), the inconsistent files are displayed for each user ID in a table, indicating the type of inconsistency.
Details on the content of the screen mask are provided in the section "Output with INFORMATION=*MIGRATION-EVALUATION".
ENVIRONMENT = *SYSTEM-MANAGED(...)
The statement only processes SM pubsets.
INFORMATION-LEVEL = *GLOBAL(...)
The information for the specified SM pubset is output globally.
CATALOG-ID = <cat-id>
ID of the SM pubsets whose usage is to be output. The pubset must be available (imported).
INFORMATION = *REUSABLE-S1-SPACE(...)
Information is output about the S1 volume set of the specified SM pubset.
An overview is displayed showing the space for selectable save files of the specified migration archive that is to be obtained for reorganization.
The save files are assigned in accordance with the size of the unused space at intervals of 10% increments, i.e. 0% – 10%, 10% – 20%.
A table is output for each of these intervals with the:
number of save files
number of PAM pages occupied by the save files
number of PAM pages not used in these save files
Furthermore, the grand total of save files is also output.
Details on the content of the screen mask are provided in the section "Output with INFORMATION=*REUSABLE-S1-SPACE".
Where save files are compressed, the percentage is calculated not as a ratio of the unused to used pages but as a ratio of the number of invalid to valid files.
Notes
Depending on how the S1-VOLUME-SET is defined the behaviour is as follows:
S1 volume set is defined by a single volume set (S1-VOLUME-SET=<cat-id>):
The values for the specific volume set are output.S1 volume set is defined by all HSMS-CONTROLLED volume sets (S1-VOLUME-SET=*ALL-HSMS-CONTROLLED):
Sums of the respective values of all volume sets that are defined as HSMS-CONTROLLED are output.MINIMUM-DAYS-ON-S1 = 0 / <integer 0..9999 days>
The save files included in the overview can be selected using the minimum number of days they have been on S1 as the selection criterion.
Unless otherwise specified, the save files are selected irrespective of this information.MAXIMUM-DAYS-ON-S1 = 9999 / <integer 0..9999 days>
The save files included in the overview can be selected using the maximum number of days they have been on S1 as the selection criterion.
Unless otherwise specified, the save files are selected (more or less) irrespective of this information.MINIMUM-SIZE = *NONE / <integer 1..2147483647 2Kbyte>
The save files included in the overview can be selected using their minimum size in PAM pages as the selection criterion.
Unless otherwise specified, the save files are selected irrespective of this information.ARCHIVE-NAME = *SYSMIGRATE / <filename 1..22 without-cat-gen-vers>
Name of the migration archive.If the archive directory is protected by a password, this password must be entered by means of the ADD-PASSWORD command prior to statement entry.ARCHIVE-NAME = *SYSMIGRATE
Default system archive for migration (SYSMIGRATE) of the specified SM pubset.
INFORMATION = *MIGRATION-EVALUATION
An overview of the inconsistent, migrated files of the specified SM pubset is output. A distinction is made between two different possibilities:
A file is not listed at all in the migration archive (with the same CFID as in the catalog) (NOT-IN-ARC). However, the file still can be recalled if the save file with the data exists and is not corrupt.
A file was migrated to the S1 storage level – according to the current S1 volume set of the SM pubset – but is not located there in a save file.
The inconsistent files are output in a table for each user ID in the specified SM pubset with specification of the type of inconsistency.
Details on the content of the screen mask are provided in the section "Output with INFORMATION=*MIGRATION-EVALUATION".
OUTPUT =
Determines the output medium for the desired information. Output generally takes place to SYSLST for batch requests.
OUTPUT = *SYSOUT
The information is output to the logical system file SYSOUT, i.e. it is normally displayed on the screen in interactive mode.
OUTPUT = *SYSLST
The information is output to the logical system file SYSLST. Each mask comprises 43 lines.
Layout of the screen masks
Output with INFORMATION=*SUMMARY
SHOW-PUBSET-USAGE INFORMATION = SUMMARY PUBSET-ID = @@@@ -------------------------------------------------------------------------------- PUB ST CAPACITY %USED %AVAIL %MIG S1-MIG S1-USED S1-AVAIL @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ xxxxxxxx @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@ @@ @@@@@@@@@@@@ @@@@@ @@@@@ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@ -------------------------------------------------------------------------------- NEXT-PAGE : __ (+, -, ++, --, E) @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Key:
Column | Values | Meaning |
PUBSET | Pubset ID of the displayed pubset | |
ST | Storage level to which the pubset is assigned with MODIFY-PUBSET-PARAMETERS | |
S0 |
| |
S1 |
| |
empty |
| |
CAPACITY | Pubset capacity in PAM pages. | |
%USED | Percentage of used pages | |
%AVAIL | Percentage of free pages | |
%MIG | Percentage of migrated pages; set to “SLAVE” if the pubset was imported in slave mode. | |
S1-MIG | Number of pages migrated to S1; set to “SHRD PVS” if the pubset was imported in slave mode. | |
S1-USED | Number of used pages on the allocated S1 pubset or S1 volume sets (for S0 pubsets only) | |
S1-AVAIL | Number of free pages on the allocated S1 pubset or S1 volume sets (for S0 pubsets only) |
Output with INFORMATION=*UNUSED-DAYS
SHOW-PUBSET-USAGE INFORMATION = UNUSED-DAYS
PUBSET-ID = @@@@ MINIMUM-SIZE = @@@@@@@@@@
--------------------------------------------------------------------------------
DAYS-NOT-USED #PAGES #FILES
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
@@@@@ @ @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
--------------------------------------------------------------------------------
(+, -, ++, --, E) TOTAL: @@@@@@@@@@@@@ @@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Key:
Column | Meaning |
DAYS-NOT-USED | Interval; files are assigned to this interval according to the time they were last accessed. The interval is divided up according to the specifications for MINIMUM- and MAXIMUM-USED-DAYS. |
#PAGES | Number of pages occupied by the files in this interval |
#FILES | Number of files in this interval |
Output with INFORMATION=*REUSABLE-S1-SPACE
In an SF environment:
SHOW-PUBSET-USAGE PUBSET-ID = @@@@ INFORMATION = REUSABLE-S1-SPACE
MINIMUM-SIZE = @@@@@@@@@@ MINIMUM-DAYS-ON-S1 = @@@@@ MAXIMUM-DAYS-ON-S1 = @@@@@
ARCHIVE-NAME = @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
--------------------------------------------------------------------------------
PUBSET: @@@@ CAPACITY: @@@@@@@@@@@@ %USED: @@@@@ %AVAIL: @@@@@
--------------------------------------------------------------------------------
% UNUSED-SPACE #SAVE-FILES #PAGES #UNUSED-PAGES
= 100 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
90 - 100 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
80 - 90 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
70 - 80 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
60 - 70 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
50 - 60 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
40 - 50 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
30 - 40 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
20 - 30 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
10 - 20 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
00 - 10 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
= 00 @@@@@ @@@@@@@@@@@@ @@@@@@@@@@@@
--------------------------------------------------------------------------------
TOTAL @@@@@@@ @@@@@@@@@@@@@ @@@@@@@@@@@@@
--------------------------------------------------------------------------------
NEXT-PAGE: (+, -, ++, --, E)
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
In an SM environment:
SHOW-PUBSET-USAGE PUBSET-ID = @@@@ INFORMATION = REUSABLE-S1-SPACE MINIMUM-SIZE = @@@@@@@@@@ MINIMUM-DAYS-ON-S1 = @@@@@ MAXIMUM-DAYS-ON-S1 = @@@@@ ARCHIVE-NAME = @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ -------------------------------------------------------------------------------- VOLSET: @@@@ CAPACITY: @@@@@@@@@@@@ %USED: @@@@@ %AVAIL: @@@@@ --------------------------------------------------------------------------------
The rest of the output is identical to that in an SF environment.
Key:
Column | Meaning |
PUBSET | In an SF environment only: Pubset ID of the displayed pubset |
VOLSET | In an SM environment only: Volume set of the SM pubset or *ALL if the S1 volume set is defined by all HSMS-CONTROLLED volume sets. |
CAPACITY | Pubset capacity in PAM pages |
%USED | Percentage of used pages |
%AVAIL | Percentage of free pages |
% UNUSED-SPACE | Percentage of invalid save files |
#SAVE-FILES | Number of save files in this interval |
#PAGES | Number of pages occupied by save files in this interval |
#UNUSED-PAGES | Number of pages unused by save files in this interval |
Output with INFORMATION=*MIGRATION-EVALUATION
In an SF environment:
SHOW-PUBSET-USAGE INFORMATION = MIGRATION-EVALUATION S0-PUBSET: @@@@ S1-PUBSET: @@@@ USER-ID: @@@@@@@@ -------------------------------------------------------------------------------- INCONSISTENT FILE ERROR @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@ -------------------------------------------------------------------------------- NEXT-PAGE : __ (+, -, ++, --, E) @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
In an SM environment:
SHOW-PUBSET-USAGE INFORMATION = MIGRATION-EVALUATION S0-PUBSET: @@@@ S1-VOLSET: @@@@ USER-ID: @@@@@@@@ --------------------------------------------------------------------------------
The rest of the output is identical to that in an SF environment.
Key:
Column | Values | Meaning |
INCONSISTENT FILE | Name of the inconsistent file | |
ERROR | Type of inconsistency | |
NOT-IN-ARC |
| |
NO-S1-DATA |
| |
S1-NOT-DEF |
| |
S1 NOT-AVL |
| |
ER-SEQ-NUM |
|