Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-PUBSET-CACHE-ATTRIBUTES

&pagelevel(3)&pagelevel

Display PFA cache configuration of a pubset

Component:

BS2000

Functional area:

Pubset and MRSCAT management

Domain:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

TSOS
OPERATING
SW-MONITOR-ADMINISTRATION

Routing code:

@

Function

The SHOW-PUBSET-CACHE-ATTRIBUTES command provides system support with information on the PFA cache configuration of a pubset. In the case of an SF pubset, these attributes are cross-pubset attributes, and in the case of an SM pubset, the attributes are defined specifically for each volume set.

The default causes information on all pubsets to be output. The SELECT-PUBSET can be used to restrict the output volume to pubsets with particular attributes. The PUBSET or VOLUME-SET operands can also be used to request information output explicitly for a specific pubset or volume set.

The PFA cache configuration of a pubset or volume set can be modified using the MODIFY-PUBSET-CACHE-ATTRIBUTES command.

The command supports structured output in S variables (see "Output in S variable").

The information on cache configuration is also contained in the output of the SHOW-PUBSET-PARAMETERS command.
Restrictions

In the case of SF pubsets in a shared pubset network, only the information displayed on the pubset master is valid. The information displayed on a pubset slave becomes valid if that slave is made the pubset master. 

Format

SHOW-PUBSET-CACHE-ATTRIBUTES

PUBSET = *ALL / <cat-id 1..4>

,SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *LOCAL / *REMOTE / *ACCESSIBLE /

*LOCAL-ACCESSIBLE / *REMOTE-ACCESSIBLE / *HSMS-SUPPORTED /

*SPEEDCAT / *PAGING / *SINGLE-FEATURE / *SYSTEM-MANAGED /

*INACCESSIBLE / *QUIET / *DEFINED-XCS-CONFIGURATED /

*XCS-CONFIGURATED

,VOLUME-SET = *ALL / <cat-id 1..4>

Operands

PUBSET = *ALL / <cat-id 1..4>
Specifies the pubsets for which the cache attributes are to be displayed.

PUBSET = *ALL
The cache attributes of all volume sets are to be displayed. The SELECT-PUBSET operand can be used to restrict the selection to pubsets with specific attributes.

PUBSET = <cat-id 1..4>
ID of the pubset whose cache attributes are to be displayed. For an SM pubset the display of the cache attributes can be restricted to a specific volume set using the VOLUME-SET operand.

SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *LOCAL / *REMOTE / *ACCESSIBLE /
*LOCAL-ACCESSIBLE / *REMOTE-ACCESSIBLE / *HSMS-SUPPORTED / *SPEEDCAT / *PAGING /
*SINGLE-FEATURE / *SYSTEM-MANAGED / *INACCESSIBLE / *QUIET / *DEFINED-XCS-CONFIGURATED /
*XCS-CONFIGURATED
Specifies whether information is required only for specific pubsets. This restriction is useful if *ALL is used in the PUBSET operand to select all pubsets.

SELECT-PUBSET = *ALL
The cache attributes of all the pubsets specified in the PUBSET operand are displayed.

SELECT-PUBSET = *EXCLUSIVE
The cache attributes of all pubsets imported exclusively are displayed.

SELECT-PUBSET = *SHARED
The cache attributes of all pubsets imported as shared are displayed.

SELECT-PUBSET = *LOCAL
The cache attributes of all locally imported pubsets are displayed. The cache attributes of the pubsets which cannot be accessed are also displayed.

SELECT-PUBSET = *REMOTE
The cache attributes of all pubsets for which the *LOCAL attribute does not apply are displayed.

SELECT-PUBSET = *ACCESSIBLE
The cache attributes of all pubsets which can be accessed are displayed.

SELECT-PUBSET = *LOCAL-ACCESSIBLE
The cache attributes of all locally accessible, i.e. imported, pubsets are displayed.

SELECT-PUBSET = *REMOTE-ACCESSIBLE
The cache attributes of all pubsets which have not been imported locally but whose file catalog can be accessed over an MSCF connection are displayed.

SELECT-PUBSET = *HSMS-SUPPORTED
The cache attributes of all pubsets which are supported by the HSMS subsystem are displayed.

SELECT-PUBSET = *SPEEDCAT
The cache attributes of all SF pubsets whose file catalog can be accessed in the local system via SPEEDCAT are displayed.

SELECT-PUBSET = *PAGING
The cache attributes of all pubsets with paging areas which are used locally are displayed.

SELECT-PUBSET = *SINGLE-FEATURE
The cache attributes of all SF pubsets are displayed.

SELECT-PUBSET = *SYSTEM-MANAGED
The cache attributes of the volume set selected in the VOLUME-SET operand are displayed.

SELECT-PUBSET = *INACCESSIBLE
The cache attributes of all pubsets which are not available are displayed.

SELECT-PUBSET = *QUIET
The cache attributes of all pubsets whose MSCF connections no longer exist are displayed.

SELECT-PUBSET = *DEFINED-XCS-CONFIGURATED
The cache attributes of all pubsets which are defined as XCS pubsets in the MRS catalog are displayed.

SELECT-PUBSET = *XCS-CONFIGURATED
The cache attributes of all XCS pubsets are displayed.

VOLUME-SET = *ALL / <cat-id 1..4>
Identifies the volume sets whose cache attributes are to be displayed.

VOLUME-SET = *ALL
The cache attributes of all volume sets are displayed.

VOLUME-SET = <cat-id 1..4>
Catalog ID of the volume set whose cache attributes are displayed. 

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

No error


32

CMD0221

Internal system error


32

CMD2009

Error on output in S variables (e.g. subsystem not available)


64

CMD0216

Privilege error


64

DMS1381

Volume set conflict


64

DMS138B

Pubset does not exist or not with specified attribute


64

DMS138E

Volume set does not exist


128

DMS1386

Class 4/5 memory shortage

Output format

The output starts with a header line consisting of the command name. The output information per pubset breaks down into three groups of output blocks:

  1. output block for pubset-global summary information

  2. output blocks for pubset-global detailed information

  3. output blocks for volume set-specific detailed information


Pubset-global summary information

The output block for pubset-global summary information consists of a row of values which at the same time acts as a header line introducing the information output for a pubset. The summary information has the following layout:

PUBSET <catid>: <type>, CTL-SET = (<ctlid>, <type>), <status>, <hsms> 

Meaning of the output values:

<catid>

Pubset ID

<type>

Pubset type; possible values: SINGLE-FEATURE or SYSTEM-MANAGED

<ctlid>

Control volume set ID (for SM pubsets)

<type>

Device type of control volume set’s system disk (for SM pubsets)

<status>

Pubset accessibility; possible values:

  • ACC: Pubset is locally accessible.

  • INACC: Pubset is not locally accessible.

<hsms>

HSMS subsystem support (for SM pubsets); possible values:

  • HSMS-SUP: Pubset is supported by HSMS.

  • NO-HSMS-SUP: Pubset is not supported by HSMS.

Pubset-global detailed information

Only for SF pubsets is the cache configuration displayed on a pubset-global basis (for SM pubsets see "Volume set-specific information").

The header line divides the subsequent rows of values into a three-column table. Each row of values contains the parameter name in the first column, the defined pubset-global values (DEFINED) in the second and the currently set values (CURRENT) in the third.

The output block is introduced by the following header line:

--- CACHE CONFIGURATION   ---- + --- DEFINED --- + --- CURRENT ---

Then the following rows of values are displayed:

  • Information on the cache medium:

    CACHE MEDIUM                  | NONE            | NONE
                              | MAIN MEMORY     | MAIN MEMORY
                              | GLOBAL STORAGE  | GLOBAL STORAGE

    The following extra row is displayed if the cache is currently not active:

                                  |                 | NOT ACTIVE

    The following extra row is displayed if the cache has been disabled for reconfiguration:

                                  |                 | IN HOLD

  • Information on cache size (in MB or KB):

    CACHE SIZE                    | NONE            |
                              | <n> MB          | <n> MB
                              | <n> KB          | <n> KB

  • Information on whether caching must be granted by the user, applies to all files or whether the files are selected automatically by the system (AutoDAB for the cache medium main memory):

    CACHED FILES                  | BY USER         |
                              | ALL             |
                              | BY SYSTEM       |

The status of the following additional information depends on the type of cache medium. The defined value is always shown, but it applies only if the associated medium is defined (value in parentheses). The currently set value is shown only if the currently associated medium is currently being used.

  • Information on whether the consistency of the cached write data is ensured in the event of a power failure in the global storage system:

    VOLATILITY (GLOBAL STORAGE)   | YES            | YES
                              | NO             | NO

  • For global storage, extra information on the GS unit is displayed:

    GS-UNIT (GLOBAL STORAGE)      | BY DEFAULT      | DUAL
                              | DUAL            |
                              | MONO (1)        | MONO (1)
                              | MONO (2)        | MONO (2)

  • Information on the segment size:

    SEGMENT SIZE (NOT CONTROLLER) |  4           KB|  4           KB
                              |  8           KB|  8           KB
                              | 16           KB| 16           KB
                              | 32           KB| 32           KB

  • Information on the time at which the cache contents are asynchronously written out to disk by the DAB cache handler (threshold-controlled save):

    FORCE OUT (NOT CONTROLLER)    | NO FORCE OUT    | NO FORCE OUT
                              | AT LOW FILLING  | AT LOW FILLING
                              | AT HIGH FILLING | AT HIGH FILLING

Volume set-specific information

In the case of an SM pubset configuration information is displayed for each volume set (for all volume sets or for an explicitly specified volume set). The information on a volume set is preceded by the following header line:

--- VOLUME SET INFORMATION  --------------------------------------

This is followed by the output information for all volume sets of the SM pubset or for the volume set specified explicitly. The output information for each volume set begins with the volume set summary:

VOLUME-SET <catid>:  <type> <status>

Meaning of the output values:

<catid>

Volume set ID

<type>

VOLRES device type

<status>

Volume operating status:

  • NORMAL-USE: The volume set is in operation and therefore accessible.

  • IN-HOLD: The volume set is temporarily not in operation.

  • DEFECT: The volume set is defective.

  • DEFINED-ONLY: The volume set is defined but not accessible.

Subsequently, the cache configuration of the volume set is displayed.

The header line divides the subsequent rows of values into a three-column table. Each row of values contains the parameter name in the first column, the defined pubset-global values (DEFINED) in the second and the currently set values (CURRENT) in the third.

The output block is introduced by the following header line:

--- CACHE CONFIGURATION   ---- + --- DEFINED --- + --- CURRENT ---

Then the following rows of values are displayed:

  • Information on the cache medium:

    CACHE MEDIUM                  | NONE            | NONE
                              | MAIN MEMORY     | MAIN MEMORY
                              | GLOBAL STORAGE  | GLOBAL STORAGE

    The following extra row is displayed if the cache is currently not active:

                                  |                 | NOT ACTIVE

    The following extra row is displayed if the cache has been disabled for reconfiguration:

                                  |                 | IN HOLD

  • Information on cache size (in MB or KB):

    CACHE SIZE                    | NONE            |
                              | <n> MB          | <n> MB
                              | <n> KB          | <n> KB

  • Information on whether caching must be granted by the user or applies to all files:

    CACHED FILES                  | BY USER        |
                              | ALL            |

The status of the following additional information depends on the type of cache medium. The defined value is always shown, but it applies only if the associated medium is defined (value in parentheses). The currently set value is shown only if the currently associated medium is currently being used.

  • Information on whether the consistency of the cached write data is ensured in the event of a power failure in the global storage system:

    VOLATILITY (GLOBAL STORAGE)   | YES            | YES
                              | NO             | NO

  • For global storage, extra information on the GS unit is displayed:

    GS-UNIT (GLOBAL STORAGE)      | BY DEFAULT      | DUAL
                              | DUAL            |
                              | MONO (1)        | MONO (1)
                              | MONO (2)        | MONO (2)

  • Information on the segment size:

    SEGMENT SIZE (NOT CONTROLLER) |  4           KB|  4           KB
                              |  8           KB|  8           KB
                              | 16           KB| 16           KB
                              | 32           KB| 32           KB

  • Information on the time at which the cache contents are asynchronously written out to disk by the DAB cache handler (threshold-controlled save):

    FORCE OUT (NOT CONTROLLER)    | NO FORCE OUT    | NO FORCE OUT
                              | AT LOW FILLING  | AT LOW FILLING
                              | AT HIGH FILLING | AT HIGH FILLING

Example

/show-pubset-cache-attributes pubset=nets

%----------------------------------------------------------------------------
%COMMAND: SHOW-PUBSET-CACHE-ATTRIBUTES
%- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%PUBSET NETS: SINGLE-FEATURE, ACC
%---- CACHE CONFIGURATION    --------- + ---- DEFINED ---- + ---- CURRENT ---
% CACHE MEDIUM                         | NONE              | NONE
% CACHE SIZE                           | NONE              |
% CACHED FILES                         | BY USER           |
% SEGMENT SIZE     (NOT CONTROLLER)    | 32            KB  |
% FORCE OUT        (NOT CONTROLLER)    | AT LOW FILLING    |
%----------------------------------------------------------------------------

Output in S variable

Some S variables are generated only for the volume-set-specific information. These are labeled with “1” in the Condition column of the table below.

Output information             

Name of the S variable           

T

Contents                   

Condition

Current FORCE-OUT value
*NO=no forced removal
*AT-HIGH-FILL=removal with high filling level
*AT-LOW-FILL=removal with low filling level
*UNDEF=no definition (for SM pubset)

var(*LIST).CACHE-CURR.FORCE-OUT

S

*AT-HIGH-FILL
*AT-LOW-FILL
*NO
*UNDEF


No meaning (displayed only for reasons of compatibility)

var(*LIST).CACHE-CURR.GS-UNIT

S

*DUAL
*MONO
*UNDEF


No meaning (displayed only for reasons of compatibility)

var(*LIST).CACHE-CURR.GS-UNIT-NUM

I

0
<integer 1..2>


Current cache medium
*MAIN-MEM=main memory
*NONE=no cache defined
(*UNDEF for SM pubset only)

var(*LIST).CACHE-CURR.MED

S

*MAIN-MEM
*NONE
*UNDEF


Current status of the cache medium
*ACTIVE=cache active
*NOT-ACTIVE=cache not active
*IN-HOLD=cache temporarily deactivated
(*UNDEF for SM pubset only)

var(*LIST).CACHE-CURR.MED-STAT

S

*ACTIVE
*IN-HOLD
*NOT-ACTIVE
*UNDEF


No meaning (displayed only for reasons of compatibility)

var(*LIST).CACHE-CURR.PREFETCH

S

*HIGH
*LOW
*NO
*UNDEF


Current segment size of the cache medium (0 for SM pubset)

var(*LIST).CACHE-CURR.SEG-SIZE

I

0
4
8
16
32


Current cache size (0 for SM pubset)

var(*LIST).CACHE-CURR.SIZE

I

0
<integer 1..32767> 


Current unit of measurement for the cache size
*KB=size in kilobytes
*MB=size in megabytes
*UNDEF=no definition (for SM pubset)

var(*LIST).CACHE-CURR.SIZE-DIM

S

*KB
*MB
*UNDEF


Current value for data consistency
*NO=full data consistency after crash
*YES=no data consistency after crash
*UNDEF=no definition (for SM pubset)

var(*LIST).CACHE-CURR.VOLATILITY

S

*NO
*YES
*UNDEF


Defined caching setting
*ALL=caching for all files
*BY-USER=activation by the user
*BY-SYSTEM=activation by the system (AutoDAB)
(*UNDEF for SM pubset only)

var(*LIST).CACHE-DEFI.CACH-FILE

S

*ALL
*BY-USER
*BY-SYSTEM
*UNDEF


Defined FORCE-OUT value
*AT-HIGH-FILL=removal with high filling level
*AT-LOW-FILL=removal with low filling level
*NO=no forced removal
(*UNDEF for SM pubset only)

var(*LIST).CACHE-DEFI.FORCE-OUT

S

*AT-HIGH-FILL
*AT-LOW-FILL
*NO
*UNDEF


No meaning (displayed only for reasons of compatibility)

var(*LIST).CACHE-DEFI.GS-UNIT

S

*BY-DEFAULT
*DUAL
*MONO
*UNDEF


No meaning (displayed only for reasons of compatibility)

var(*LIST).CACHE-DEFI.GS-UNIT-NUM

I

0
<integer 1..2>


Defined cache medium
*MAIN-MEM=main memory
*NONE=no cache defined
(*UNDEF for SM pubset only)

var(*LIST).CACHE-DEFI.MED

S

*MAIN-MEM
*NONE
*UNDEF


No meaning (displayed only for reasons of compatibility)

var(*LIST).CACHE-DEFI.PREFETCH

S

*HIGH
*LOW
*NO
*UNDEF


Defined segment size of the cache medium (0 for SM pubset)

var(*LIST).CACHE-DEFI.SEG-SIZE

I

0
4
8
16
32 


Defined cache size (0 for SM pubset)

var(*LIST).CACHE-DEFI.SIZE

I

<integer 1..32767>
0


Defined unit of measurement for the cache size
*KB=size in kilobytes
*MB=size in megabytes
(*UNDEF for SM pubset only)

var(*LIST).CACHE-DEFI.SIZE-DIM

S

*KB
*MB
*UNDEF


Defined guarantee of data consistency
*NO=full data consistency after crash
*YES=no data consistency after crash
(*UNDEF for SM pubset only)

var(*LIST).CACHE-DEFI.VOLATILITY

S

*NO
*YES
*UNDEF


Device type of the system disk of the control volume set;
*NO for SF pubsets

var(*LIST).CONTR-DEV-TYPE

S

*NO
<c-string 1..8>


ID of the control volume set;
*NO for SF pubsets

var(*LIST).CONTR-VOLSET

S

*NO
<cat-id>


HSMS support for the pubset
*NO=pubset is not supported
*STD=for SF pubsets
*YES=pubset is supported

var(*LIST).HSMS-SUP

S

*NO
*STD
*YES


Pubset ID

var(*LIST).PUBSET-ID

S

<cat-id>


Pubset type

var(*LIST).PUBSET-TYPE

S

*SINGLE-FEATURE
*SYS-MANAGE


Availability of the pubset
*ACCESSIBLE=locally accessible
*INACCESSIBLE=not locally accessible

var(*LIST).STA

S

*ACCESSIBLE
*INACCESSIBLE


Current FORCE-OUT value
*AT-HIGH-FILL=removal with high filling level
*AT-LOW-FILL=removal with low filling level
*NO=no forced removal
*UNDEFINED=not defined

var(*LIST).VOLSET(*LIST).CACHE-CURR.FORCE-OUT

S

*AT-HIGH-FILL
*AT-LOW-FILL
*NO
*UNDEF

1

No meaning (displayed only for reasons of compatibility)

var(*LIST).VOLSET(*LIST).CACHE-CURR.GS-UNIT

S

*DUAL
*MONO
*UNDEF

1

No meaning (displayed only for reasons of compatibility)

var(*LIST).VOLSET(*LIST).CACHE-CURR.GS-UNIT-NUM

I

0
<integer 1..2> 

1

Current cache medium
*MAIN-MEM=main memory
*NONE=no cache defined

var(*LIST).VOLSET(*LIST).CACHE-CURR.MED

S

*MAIN-MEM
*NONE

1

Current status of the cache medium
*ACTIVE=cache active
*IN-HOLD=cache temporarily deactivated
*NOT-ACTIVE=cache not active

var(*LIST).VOLSET(*LIST).CACHE-CURR.MED-STAT

S

*ACTIVE
*IN-HOLD
*NOT-ACTIVE

1

Current prefetching value
*HIGH=prefetching for a maximum number of blocks
*LOW=prefetching for a minimum number of blocks
*NO=no prefetching
*UNDEFINED=not defined

var(*LIST).VOLSET(*LIST).CACHE-CURR.PREFETCH

S

*HIGH
*LOW
*NO
*UNDEF

1

Current segment size of the cache medium

var(*LIST).VOLSET(*LIST).CACHE-CURR.SEG-SIZE

I

0
4
8
16
32

1

Current cache size

var(*LIST).VOLSET(*LIST).CACHE-CURR.SIZE

I

0
<integer 1..32767>

1

Current unit of measurement for the cache size
*KB=size in kilobytes
*MB=size in megabytes
*UNDEFINED=not defined

var(*LIST).VOLSET(*LIST).CACHE-CURR.SIZE-DIM

S

*KB
*MB
*UNDEFINED

1

Current value for data consistency
*NO=full data consistency after crash
*YES=no data consistency after crash
*UNDEF=not defined

var(*LIST).VOLSET(*LIST).CACHE-CURR.VOLATILITY

S

*NO
*YES
*UNDEF

1

Defined cache value
*ALL=caching for all files
*BY-USER=activation by the user

var(*LIST).VOLSET(*LIST).CACHE-DEFI.CACH-FILE

S

*ALL
*BY-USER

1

Defined FORCE-OUT value
*AT-HIGH-FILL=removal with high filling level
*AT-LOW-FILL=removal with low filling level
*NO=no forced removal

var(*LIST).VOLSET(*LIST).CACHE-DEFI.FORCE-OUT

S

*AT-HIGH-FILL
*AT-LOW-FILL
*NO

1

No meaning (displayed only for reasons of compatibility)

var(*LIST).VOLSET(*LIST).CACHE-DEFI.GS-UNIT

S

*BY-DEFAULT
*DUAL
*MONO

1

No meaning (displayed only for reasons of compatibility)

var(*LIST).VOLSET(*LIST).CACHE-DEFI.GS-UNIT-NUM

I

0
<integer 1..2>

1

Defined cache medium
*MAIN-MEM=main memory
*NONE=no cache defined

var(*LIST).VOLSET(*LIST).CACHE-DEFI.MED

S

*MAIN-MEM
*NONE

1

Defined prefetching value
*HIGH=prefetching for a maximum number of blocks
*LOW=prefetching for a minimum number of blocks
*NO=no prefetching

var(*LIST).VOLSET(*LIST).CACHE-DEFI.PREFETCH

S

*HIGH
*LOW
*NO

1

Defined segment size of the cache medium

var(*LIST).VOLSET(*LIST).CACHE-DEFI.SEG-SIZE

I

0
4
8
16
32

1

Defined cache size

var(*LIST).VOLSET(*LIST).CACHE-DEFI.SIZE

I

<integer 1..32767>

1

Defined unit of measurement for the cache size
*KB=size in kilobytes
*MB=size in megabytes

var(*LIST).VOLSET(*LIST).CACHE-DEFI.SIZE-DIM

S

*KB
*MB

1

Defined guarantee of data consistency
*NO=full data consistency after crash
*YES=no data consistency after crash

var(*LIST).VOLSET(*LIST).CACHE-DEFI.VOLATILITY

S

*NO
*YES

1

Device type of the system disk of
the volume set

var(*LIST).VOLSET(*LIST).DEV-TYPE

S

*UNKNOWN
<device>

1

Status of the volume set
*DEFECT=permanently inaccessible (defective)
*DEFINED=not available, all that exists is an entry in the configuration file
*IN-HOLD=temporarily not accessible (frozen)
*NORMAL=available

var(*LIST).VOLSET(*LIST).STA

S

*DEFECT
*DEFINED
*IN-HOLD
*NORMAL

1

Volume set ID

var(*LIST).VOLSET(*LIST).VOLSET

S

<vsid>

1

Powered by Atlassian Confluence and Scroll Viewport.