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-MASTER-CATALOG-ENTRY

&pagelevel(3)&pagelevel

Request information on MRSCAT entries

Component:

BS2000

Functional area:

Pubset and MRSCAT management

Domain:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

STD-PROCESSING
TSOS
OPERATING
SW-MONITOR-ADMINISTRATION

Routing code:

E

Function

The SHOW-MASTER-CATALOG-ENTRY command lists the MRSCAT entries for SF and SM pubsets and volume sets. Thus, it provides the user with information about the status of a pubset and hence about the accessibility of its catalog.

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

Privileged functions

Privileged users can also request information on volume sets.

Format

SHOW-MASTER-CATALOG-ENTRY                                                                           

Alias: SHMCE

ENTRY-NAME = *ALL / *HOME / <alphanum-name 1..4 with-wild(255)>

,INFORMATION = *STD / *USER

,SELECT = *ALL / *ACCESSIBLE / *DEFINED-XCS-CONFIGURATED / *EXCLUSIVE /

*HSMS-SUPPORTED / *INACCESSIBLE / *LOCAL / *LOCAL-ACCESSIBLE /

*MASTER-CHANGE-ERROR / *PAGING / *QUIET / *REMOTE / *REMOTE-ACCESSIBLE /

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

*UNUSED-VOLUME-SETS / *VOLUME-SETS(...) / *XCS-CONFIGURATED


*VOLUME-SETS(...)



|

PUBSET = *ALL / <alphanum-name 1..4>

Operands

ENTRY-NAME =
Catalog ID on which information is required. If there is an entry in the MRS catalog for this catalog ID, it is output. If not, the command is rejected. If an unknown catalog ID is specified, the following message is issued: CMS0312 MRSCAT ENTRY NOT FOUND.

If you specify more than one catalog ID (using wildcards or *ALL), you can use the SELECT operand to restrict the set of entries to be shown.

ENTRY-NAME = *ALL
All entries in the local MRS catalog are output.

ENTRY-NAME = *HOME
Information is output for the home pubset.

ENTRY-NAME = <alphanum-name 1..4 with-wild(255)>
Information is output for the specified pubset. The catalog can be specified using wildcards (maximum of four characters). In this case, information is output for all pubsets whose catalog ID matches the pattern (see also to the information on data types and suffixes in "SDFsyntax representation").

INFORMATION =
Determines the scope of the information output for the specified pubset.

INFORMATION = *STD
Only default information about SF and SM pubsets and about volume sets is output.

INFORMATION = *USER
All information accessible to nonprivileged users is output for locally accessible SF and SM pubsets. Only default information is output for all other pubsets.

SELECT = *ALL / *ACCESSIBLE / *DEFINED-XCS-CONFIGURATED / *EXCLUSIVE / *HSMS-SUPPORTED / *INACCESSIBLE / *LOCAL / *LOCAL-ACCESSIBLE / *MASTER-CHANGE-ERROR / *PAGING / *QUIET / *REMOTE / *REMOTE-ACCESSIBLE / *SHARED / *SINGLE-FEATURE / *SPEEDCAT/ *SYSTEM-MANAGED / *UNUSED-VOLUME-SETS / *VOLUME-SETS(...) / *XCS-CONFIGURATED
Specifies a selection criterion for the MRS catalog entries to be output. It makes sense to specify a selection criterion if the value *ALL (default value) or a pattern was specified in the CATALOG-ID operand. 

A selection criterion can be used to restrict the scope of the output information:

Value

Meaning

*ALL

Default: The output takes place without restriction for SF pubsets, SM pubsets and volume sets.

*ACCESSIBLE

Display only for pubsets whose catalog can be accessed

*DEFINED-XCS-CONFIGURATED

Display only for pubsets which are defined as XCS pubsets in the MRS catalog

*EXCLUSIVE

Display only for pubsets which are not used or may not be used as shared pubsets

*HSMS-SUPPORTED

Display only for SM pubsets which can be operated from HSMS

*INACCESSIBLE

Display only for unavailable pubsets

*LOCAL

Display only for locally imported pubsets

*LOCAL-ACCESSIBLE

Display only for pubsets which are imported and accessible locally

*MASTER-CHANGE-ERROR

Display only for pubsets in which an error occurred when a master change took place

PAGING

Display only for pubsets with paging areas which are used locally

*QUIET

Display only for pubsets which have been imported in slave mode if the MSCF connection between the master and slave is interrupted

*REMOTE

Display only for pubsets for which the criterion LOCAL does not apply

*REMOTE-ACCESSIBLE

Display only for pubsets which have not been imported locally but whose file catalog can be accessed over an existing MSCF connection

*SHARED

Display only for pubsets which are used as shared pubsets

*SINGLE-FEATURE

Display only for SF pubsets:

*SPEEDCAT

Display only for SF pubsets whose file catalog accesses are handled by the local system using SPEEDCAT

*SYSTEM-MANAGED

Display only for SM pubsets:

*UNUSED-VOLUME-SETS

Display only for defined volume sets which have not been used

*VOLUME-SETS(...) PUBSET=

Display only for volume sets which belong to the specified SM pubset 

*XCS-CONFIGURATED

Display only for pubsets of an XCS configuration

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

Command executed without error


1

CMS0011

Syntax error


1

CMS0314

Syntax error for <cat-id>


32

CMD0221

Internal system error


32

CMS0310

Error during privilege checking


32

CMS0311

Operand invalid


32

CMS0313

Error during release of memory space


32

CMS0316

Internal memory space error


32

CMS0318

Synchronization error


32

CMS031F

MRS parameter error


64

CMS0013

Specified pubset not in the selected state


64

CMS0312

MRSCAT entry not found


64

CMS0317

Lock conflict in MRSCAT


64

CMS031C

Invalid host name


130

CMS0313

Error in memory space request


130

CMS031A

MRSCAT not initialized


130

CMS031B

Transfer error

Output format with INFORMATION = *STD:

Output line for pubsets
PUBSET catid : type, state [(PAGING)], [NOWAIT]
                         [ NK4-FORMAT / NK2-FORMAT / K-FORMAT] [...]
catid ::= catalog ID
type  ::= { SINGLE-FEATURE / SYSTEM-MANAGED }
state ::= { [PUBRES-UNIT=mn, ]LOCAL-HOME /
            [PUBRES-UNIT=mn, ]LOCAL-IMPORTED [,QUIET] /
            REMOTE-HOME [,QUIET] [,HOST= bcamname] /
            REMOTE-IMPORTED [,QUIET] [,HOST= bcamname] /
            INACC [,QUIET][,HOST=bcamname]
                  [,DEVICE={ (UNUSED) /  dtype }] [ PUBRES-UNIT=mn] }

The individual parts of the text have the following meaning:

Value                

Meaning

SINGLE-FEATURE

The pubset is an SF pubset.

SYSTEM-MANAGED

The pubset is an SM pubset.

(PAGING)

Displayed if a paging area has been created on the pubset which is used by the local processor

LOCAL

Pubset is locally accessible.

REMOTE

No MSCF connection exists to the owner processor of the pubset (i.e. access to the file catalog is possible, but access to files is not).

INACC

A pubset is not accessible, but can, for instance, be accessible via RFA.

HOME DAB

The catalog belongs to a local or nonlocal processor.

IMPORTED

The pubset has been imported on a local or nonlocal processor.

QUIET

The connection to the pubset's master is temporarily interrupted.

NOWAIT

No particular meaning (displayed only for reasons of compatibility)

HOST= bcamname

BCAM name of the processor

  • on which the catalog is manged or

  • on which the catalog was last managed or

  • which was specified in the PARTNER-NAME operand.

NK4-FORMAT,
NK2-FORMAT,
K-FORMAT

Only for SF pubsets:
Specifies whether a K or NK pubset is involved and how large the minimum transfer unit (TU) is.

[...]

Further values such as EXTRA-LARGE-CATALOG can be displayed.

DEVICE

Display type of the Pubres or “(UNUSED)”

PUBRES-UNIT

MN of the Pubres


Note

The status “INACC, QUIET” indicates that a master change could not be initiated or that it terminated abnormally. The pubset can be exported, or IMPORT-PUBSET ... SHARER-TYPE=*MASTER(MASTER-CHANGE=*YES) can be used to attempt a master change again. 

Output line for volume sets: 
VOLSET catid1 : state , CORRESPONDING PUBSET=catid2 [CONTROL VOLUME SET]

catid1 ::= volume set ID
catid2 ::= catalog ID of SM pubset
state  ::= { CONNECTED / IN_HOLD / DEFECTIVE / DEFINED_ONLY }

The individual parts of the text have the following meaning:

Value

Meaning

CORRESPONDING PUBSET

Catalog ID of the associated SM pubset

CONTROL_VOLUME_SET

Output for a control volume set only

CONNECTED

The volume set is in operation and accessible

IN_HOLD

The volume set is temporarily not in operation

DEFECTIVE

The volume set is defective

DEFINED_ONLY

The volume set is only defined

In some cases the second line of information is output:

  • For SF pubsets only:

    If the user is authorized to request individual volumes of an SF pubset, the second line is output:

    PHYSICAL ALLOCATION BY USER ALLOWED

    For inaccessible high-availability pubsets, the following additional line is output:

    DRV PUBSET

  • For SM pubsets only:

    If the SM pubset is in the process of being generated, the following additional line is output:

    GENERATION-IN-PROCESS

  • For SF and SM pubsets only:

    For inaccessible pubsets for which an import job is in progress, the second line is output:

    IMPORT-IN-PROCESS

    For inaccessible pubsets for which an export job is in progress, the second line is output:

    EXPORT-IN-PROCESS

    For local shared pubsets for which a master change is in progress, an additional line is output:

    SHARED, MASTER-CHANGE-IN-PROCESS

    For local and accessible shared pubsets, an additional line is output:

    SHARED, MASTER-HOST= OWN-HOST / bcamname 

    In the case of an exclusive pubset, the nonprivileged user receives the following additional line:

    ACCESS CONTROLLED, RESERVED TO OWN USERID

    or

    ACCESS CONTROLLED, RESERVED TO OTHER USERID

    The privileged user receives the following additional line:

    ACCESS CONTROLLED, RESERVED TO <userid>

    If wildcards are used or *ALL is specified, the output ends with the number of entries found:

    1 ENTRY FOUND

    or

    <integer> ENTRIES FOUND

Additional output for INFORMATION=*USER

Extra information is output relating to current pubset operating parameters and, in the case of SF pubsets, to the cache configuration. It is shown only for locally accessible pubsets.

Information on current pubset operating parameters

The information block begins with the following header line:

-- CURRENT PUBSET PARAMETERS---------------------------------------

Then the following lines of values are displayed:

  • Information on the maximum I/O transfer length (2 KB):

    MAXIMAL I/O LENGTH            | <n> HP

  • For SF pubsets this is followed by information on the allocation values of the pubset:

    ALLOCATION UNIT SIZE          | <n> HP

  • For SF pubsets this is followed by information as to whether absolute space allocation is allowed for nonprivileged users or only for systems support staff:

    PHYSICAL ALLOCATION           | BY ADMINISTRATOR
                              | USER ALLOWED

  • Information on the Speedcat mode (for SF pubsets only):

    SPEEDCAT MODE                 | NO SCA RUNNING
                              | SCA RUNNING

Information on the current PFA cache configuration (for SF pubsets only)

The information block begins with the following header line:

--- CURRENT CACHE-CONFIGURATION-----------------------------------

Then the following lines of values are displayed:

  • Information on the cache medium:

    CACHE MEDIUM                  | NO CACHE IN USE
                              | NONVOLATILE
                              | VOLATILE

    The name sections have the following meanings:

    NO CACHE IN USEThere is currently no cache area active for the pubset.

    NONVOLATILE

    There is a cache area active for the pubset in a nonvolatile cache medium. Full data consistency is guaranteed in the event of both power failure and system error.

    VOLATILE

    There is a cache area active for the pubset in a volatile cache medium. This may be main memory (MM). Data storage is volatile. If used as a write cache, data inconsistency may result in the event of a power failure or a system error.

If the cache is currently active, additional information is output relating to cache size and buffering mode:

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

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

  • Displayed only for reasons of compatibility. :

    DOUBLE BUFFERING               | YES

Output in S variable

The generation of S variables is dependent on the type of object (value of the S variable ENTRY-TYPE), the specification in the INFORMATION operand and, in some cases, on the accessibility of the pubset (value of the S variable STA):

Additional condition for generating the S variable

Abbreviated form used in table

MRSCAT entry for SM or SF pubset

1

MRSCAT entry for SM or SF pubset and INFORMATION=*USER

2

MRSCAT entry for SM pubset

3

MRSCAT entry for SF pubset

4

MRSCAT entry for SF pubset and INFORMATION=*USER

5

MRSCAT entry for volume set

6

Pubset is accessible

7

Output information

Name of the S variable

T

Contents           

Condition

Access to pubset is checked

var(*LIST).ACCESS-CONTR

B

FALSE
TRUE

1

Min. size of a memory space assignment for SF pubset (integers are specified right-justified in an eleven-character string)

var(*LIST).ALLOC-UNIT-SIZE

S

<integer>
*UNDEF

5

Cache medium in use
*NONE=No cache activated
*NOT-VOLATILE=Nonvolatile cache activated
*VOLATILE=Volatile cache activated

var(*LIST).CACHE-MED

S

*NONE
*NOT-VOLATILE
*VOLATILE

5

Cache size (integers are specified right-justified in an eleven-character string)

var(*LIST).CACHE-SIZE

S

*GLOBAL-CACHE
1..32767
*UNDEF

5

Unit of measurement for the cache size

var(*LIST).CACHE-SIZE-DIM

S

*KB
*MB
*UNDEF

5

Configuration status
*DEFECTIVE=Volume set defective, not accessible
*DEFI-ONLY=Volume set only defined, not accessible
*IN-HOLD=Volume set partially not accessible
*NORMAL-USE=Normal volume set status

var(*LIST).CONF-STA

S

*DEFECTIVE
*DEFI-ONLY
*IN-HOLD
*NORMAL-USE

6

Volume set is control volume set

var(*LIST).CONTROL-VOLSET

B

FALSE
TRUE

6

Pubset of the volume sets

var(*LIST).CORRESP-PUBSET

S

<cat-id>

6

Device type of the Pubres (pubset residence)

var(*LIST).DEV

S

*UNUSED
STDDISK
<dev-type>

1

Dual data recording in the cache

var(*LIST).DOUBLE-BUF

B

FALSE
TRUE

5

High availability through DRV

var(*LIST).DRV-PUBSET

B

FALSE
TRUE

4

Name of the MRSCAT entry

var(*LIST).ENTRY-NAME

S

<cat-id>


Type of pubset/volume set entered in MRSCAT

var(*LIST).ENTRY-TYPE

S

*SINGLE-FEATURE
*SYSTEM-MANAGED
*VOLUME-SET


Pubset in process of being exported

var(*LIST).EXP-IN-PROCESS

B

FALSE
TRUE

1

Catalog format “extra large”

var(*LIST).EXTRA-LARGE-CATALOG

B

FALSE
TRUE

7

Pubset format

var(*LIST).FORM

S

*K
*NK2
*NK4
*UNDEF

4

Host name

var(*LIST).HOST

S

*UNDEF
<host-name>

1

Pubset in process of being imported

var(*LIST).IMP-IN-PROCESS

B

FALSE
TRUE

1

Pubset in process of being generated (SM pubset only)

var(*LIST).IN-GENERATION

B

FALSE
TRUE

3

Large files (>= 32 GB) may be created

var(*LIST).LARGE-FILES-ALLOWED

B

FALSE
TRUE

7

Large volumes (> 32 GB) are allowed

var(*LIST).LARGE-OBJECTS

B

FALSE
TRUE

7

Change of the master system in the case of local shared pubset

var(*LIST).MASTER-CHA-PROCESS

B

FALSE
TRUE

1

Max. size of a transfer unit (integers are specified right-justified in an eleven-character string)

var(*LIST).MAX-IO-LEN

S

<integer>
*UNDEF

2

No meaning (displayed only for reasons of compatibility)

var(*LIST).NOWAIT

B

FALSE
TRUE

1

Paging area exists on pubset

var(*LIST).PAGING

B

FALSE
TRUE

1

Memory space assignment on disk of pubset by nonprivileged user

var(*LIST).PHYS-ALLOC

B

FALSE
TRUE

5

Mnemonic device name of the Pubres (pubset residence)

var(*LIST).PUBRES-MN

S

*UNUSED
<x-text 4..4>
<alphanum 2..2>

1

Master system of the pubset

var(*LIST).PUBSET-MASTER

S

*OWN-HOST
*UNDEF
<host-name>

1

Temporary interruption of the MSCF connection

var(*LIST).QUIET

B

FALSE
TRUE

1

No meaning (displayed only for reasons of compatibility)

var(*LIST).RAID-PUBSET

B

FALSE
TRUE

4

Shared pubset

var(*LIST).SHARE-PUBSET

B

FALSE
TRUE

1

Optimizing catalog accesses by means of SPEEDCAT

var(*LIST).SPEEDCAT-MODE

B

FALSE
TRUE

5

Status of the entered pubset/volume set
*CONN=Volume set is connected to a system-managed pubset
*LOC-HOME=Pubset local-home
*LOC-IMP=Pubset imported locally
*NOT-ACCESS=Pubset cannot be accessed
*NOT-CONN=Volume set not connected to SM pubset
*REM-HOME=Pubset remote home
*REM-IMP=Pubset imported remotely

var(*LIST).STA

S

*CONN
*LOC-HOME
*LOC-IMP
*NOT-ACCESS
*NOT-CONN
*REM-HOME
*REM-IMP


User ID which may access the pubset

var(*LIST).USER-ID

S

*OTHER
*OWN
*UNDEF
<user-id>

1

Examples

Output in S variables

/declare-var var-name=var(type=*structure),multiple-elem=*list
/exec-cmd cmd=(show-master-catalog-entry 2os*,inf=*user),text-output=*none,
               structure-output=var
/show-var var,inf=*par(val=*c-literal)

VAR#1.ENTRY-NAME = '2OSC'
VAR#1.ENTRY-TYPE = '*SYSTEM-MANAGED'
VAR#1.STA = '*LOC-IMP'
VAR#1.PAGING = FALSE
VAR#1.QUIET = FALSE
VAR#1.HOST = 'D016ZE07'
VAR#1.DEV = 'STDDISK'
VAR#1.PUBRES-MN = 'B0F4'
VAR#1.NOWAIT = FALSE
VAR#1.LARGE-OBJECTS = FALSE
VAR#1.LARGE-FILES-ALLOWED = FALSE
VAR#1.SHARE-PUBSET = TRUE
VAR#1.MASTER-CHA-PROCESS = FALSE
VAR#1.PUBSET-MASTER = 'D016ZE07'
VAR#1.IMP-IN-PROCESS = FALSE
VAR#1.EXP-IN-PROCESS = FALSE
VAR#1.ACCESS-CONTR = FALSE
VAR#1.USER-ID = '*UNDEF'
VAR#1.IN-GENERATION = FALSE
VAR#1.MAX-IO-LEN = '         36'
*END-OF-VAR
VAR#2.ENTRY-NAME = '2OSD'
.....
.....
.....
VAR#10.ENTRY-NAME = '2OS7'
VAR#10.ENTRY-TYPE = '*SINGLE-FEATURE'
VAR#10.STA = '*LOC-IMP'
VAR#10.PAGING = FALSE
VAR#10.QUIET = FALSE
VAR#10.HOST = 'D016ZE07'
VAR#10.DEV = 'STDDISK'
VAR#10.PUBRES-MN = 'B070'
VAR#10.NOWAIT = FALSE
VAR#10.FORM = '*K'
VAR#10.LARGE-OBJECTS = FALSE
VAR#10.LARGE-FILES-ALLOWED = FALSE
VAR#10.SHARE-PUBSET = TRUE
VAR#10.MASTER-CHA-PROCESS = FALSE
VAR#10.PUBSET-MASTER = 'D016ZE07'
VAR#10.IMP-IN-PROCESS = FALSE
VAR#10.EXP-IN-PROCESS = FALSE
VAR#10.ACCESS-CONTR = FALSE
VAR#10.USER-ID = '*UNDEF'
VAR#10.DRV-PUBSET = FALSE
VAR#10.RAID-PUBSET = FALSE
VAR#10.MAX-IO-LEN = '         36'
VAR#10.ALLOC-UNIT-SIZE = '          3'
VAR#10.PHYS-ALLOC = FALSE
VAR#10.SPEEDCAT-MODE = FALSE
VAR#10.CACHE-MED = '*NONE'
VAR#10.DOUBLE-BUF = FALSE
VAR#10.CACHE-SIZE = '*UNDEF'
VAR#10.CACHE-SIZE-DIM = '*UNDEF'
*END-OF-VAR
Output to SYSOUT

  1. Information on the Home pubset:

    /show-master-cat *home 

    PUBSET CAM1: SINGLE-FEATURE, PUBRES-UNIT=D000, LOCAL-HOME, NK2-FORMAT

  2. Information on all SM pubsets:

    /show-master-cat *all,sel=*sys-managed

    PUBSET LISA: SYSTEM-MANAGED, INACC, DEVICE=STDDISK
PUBSET SMPG: SYSTEM-MANAGED, INACC, DEVICE=STDDISK
PUBSET S055: SYSTEM-MANAGED, INACC, DEVICE=STDDISK
3 ENTRIES FOUND

  3. Information on all paging pubsets:

    /show-master-cat *all,sel=*paging

    PUBSET 1OPP: SINGLE-FEATURE, PUBRES-UNIT=D147, LOCAL-IMPORTED (PAGING)
             K-FORMAT
PUBSET 1OP1: SINGLE-FEATURE, PUBRES-UNIT=D149, LOCAL-IMPORTED (PAGING)
             K-FORMAT
2 ENTRIES FOUND

  4. Information on all volume sets:

    /show-master-cat *all,sel=*vol-set

    VOLSET CN55: NOT CONNECTED, CORRESPONDING PUBSET=S055
            CONTROL VOLUME SET
VOLSET CN56: NOT CONNECTED, CORRESPONDING PUBSET=S055
VOLSET ELSA: NOT CONNECTED, CORRESPONDING PUBSET=LISA
            CONTROL VOLUME SET
VOLSET ELSB: NOT CONNECTED, CORRESPONDING PUBSET=LISA
VOLSET ELSC: NOT CONNECTED, CORRESPONDING PUBSET=LISA
VOLSET ELSD: NOT CONNECTED, CORRESPONDING PUBSET=LISA
VOLSET ELSE: NOT CONNECTED, CORRESPONDING PUBSET=LISA
VOLSET ELSF: NOT CONNECTED, CORRESPONDING PUBSET=LISA
VOLSET 0   : NOT CONNECTED, CORRESPONDING PUBSET=SMPG
            CONTROL VOLUME SET
9 ENTRIES FOUND
Powered by Atlassian Confluence and Scroll Viewport.