SHOW-SHARED-PUBSET Request information on shared pubsets

Description status: Functional area: Domain: Privileges:	MSCF V21.0A Pubset and MRSCAT management MULTI-CATALOG-AND-PUBSET-MGMT STD-PROCESSING TSOS OPERATING
Routing code:	E

Function

The SHOW-SHARED-PUBSET command provides information on the main characteristics of the “sharers” for shared pubsets.
“Sharers” are processors that have imported a particular pubset simultaneously.

If no shared pubset is available, the message MCA0201 PUBSET(S) NOT SHARED is output.

The command supports structured output in S variables.

Format

SHOW-SHARED-PUBSET

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

Operands

PUBSET =
ID of the pubset on whose sharers information is requested.

PUBSET = *ALL
Default value: information given on all imported shared pubsets.

PUBSET = <cat-id 1..4>
ID of the pubset on which information is to be provided.

PUBSET = *XCS
Information is to be provided about all shared pubsets which have been imported as XCS pubsets.

PUBSET = *CCS
Information is to be provided about all shared pubsets which have been imported purely as CCS pubsets (i.e. not as XCS pubsets).

Output format

The following data is output for each shared pubset (from an internal table):

SHARER CONFIGURATION OF SHARED PUBSET :<catid>:
  PARTNER   HOME   HOME   SHARER  SHARER   BS2000
   NAME     CATID  SYSID  TYPE    STATE    VERSION
  @@@@@@@@  @@@@   @@@    @@@@@@  @@@@@@@  @@@@@

Example

SHARER CONFIGURATION OF SHARED PUBSET :M1D1:
%   PARTNER   HOME   HOME   SHARER  SHARER   BS2000
%    NAME     CATID  SYSID  TYPE    STATE    VERSION
%   D016ZE07  1OSH   152    SLAVE   IMCAT    V21.0
%   SQHAV101  C3H1   176    SLAVE   SHUTD    V21.0
%   D016ZE10  2OV1   157    SLAVE   IMCAT    V20.0
%   D016ZE04  2OSH   163    SLAVE   IMCAT    V21.0
%   D016ZE00  2OV0   155    MASTER  IMCAT    V19.0

Key to output

Output field	Meaning / Information
BS2000 VERSION	BS2000 version of the shared-pubset sharer (e.g. V19.0, V20.0, V21.0)
HOME CATID	Home catid of the shared-pubset sharer
HOME SYSID	System ID of the shared-pubset sharer
PARTNER NAME	Host name of the shared-pubset sharer
SHARER STATE	Partner status from the viewpoint of the local host. The values refer to the system specified under PARTNER-NAME. Meaning: CHECK: The disk protocol has crashed. Monitoring possible only via the MSCF connections CRASH: The partner system has failed. EXCAT: Partner system has correctly exported the pubset
SHARER STATE (continued)	IMCAT: Pubset is imported by the system MCHANGE: A master change is currently running for the pubset READERR: Permanent read error on the disk SHUTDOWN Partner system correctly exported the pubset in the course of MSCF or BS2000 shutdown processing WRTERR: Permanent write error on the disk
SHARER TYPE	Sharer type of the shared-pubset sharer: BACKUP: A master change is currently running; the sharer is the backup master of the shared pubset MASTER: The sharer is the master of the shared pubset SLAVE: The sharer is the slave of the shared pubset

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
	1	CMD2201	Parameter error
	2	CMD2202	MSCF subsystem not defined
	32	MCS0025	Internal error (bourse call, memory request)
	32	MCA0204	Error on output to SYSOUT
	64	MCA0201	Pubset is not shareable
	64	MCA0202	Pubset cannot be accessed
	66	CMD2242	No connection to the MSCF subsystem
	128	CMD2280	MSCF subsystem temporarily unavailable
	129	CMD2281	MSCF subsystem unavailable for an extended period
	130	CMD2282	MSCF subsystem unavailable for an undefined period

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Catalog ID of the home pubset	var(*LIST).LIST(*LIST).HOME-PUBSET	S	<cat-id 1..4>
Name of the partner system	var(*LIST).LIST(*LIST).PARTNER-NAME	S	<alphan.-name 1..8>
Catalog ID of the shared pubset	var(*LIST).SHARED-PUBSET	S	<cat-id 1..4>
Status of the partner system *CHECK=The disk log has failed. Monitoring is only being performed via the MSCF connection. *CRASH=The partner computer has failed. *EXP-PUBSET=The partner computer has exported the pubset correctly. *IMP-PUBSET=The pubset has been imported by the computer. *MASTER-CHA=A master change for the pubset is currently being run. *READ-ERROR=A permanent read error has occurred on the disk. *SHUTDOWN=The partner computer exported the pubset correctly when MSCF was shut down. *WRITE-ERROR=A permanent write error has occurred on the disk.	var(*LIST).LIST(*LIST).SHARER-STA	S	*CHECK *CRASH *EXP-PUBSET *IMP-PUBSET *MASTER-CHA *READ-ERROR *SHUTDOWN *WRITE-ERROR
Partner system type *BACKUP=A master change is being performed; the sharer is the backup master of the shared pubset. *MASTER=The sharer is the master of the shared pubset. *SLAVE=The sharer is slave of the shared pubset.	var(*LIST).LIST(*LIST).SHARER-TYPE	S	*BACKUP *MASTER *SLAVE
System ID	var(*LIST).LIST(*LIST).SYS-ID	S	<alphan.-name 1..3>
System version	var(*LIST).LIST(*LIST).SYS-VERSION	S	<version>

Example

/declare-var var-name=var(type=*structure),multiple-elem=*list
/exec-cmd cmd=(show-shared-pubset swkl),text-output=*none,struct-output=var
/show-var var,inf=*par(list-index=*yes)
OUT#1.SHARED-PUBSET = SWKL
OUT#1.LIST#1.PARTNER-NAME = D016ZE07
OUT#1.LIST#1.HOME-PUBSET = 1OSH
OUT#1.LIST#1.SYS-ID = 152
OUT#1.LIST#1.SHARER-TYPE = *SLAVE
OUT#1.LIST#1.SHARER-STA = *IMP-PUBSET
OUT#1.LIST#1.SYS-VERSION = V21.0
OUT#1.LIST#2.PARTNER-NAME = SQHAV101
OUT#1.LIST#2.HOME-PUBSET = C3H1
OUT#1.LIST#2.SYS-ID = 176
OUT#1.LIST#2.SHARER-TYPE = *SLAVE
OUT#1.LIST#2.SHARER-STA = *SHUTDOWN
OUT#1.LIST#2.SYS-VERSION = V210
OUT#1.LIST#3.PARTNER-NAME = D016ZE10
OUT#1.LIST#3.HOME-PUBSET = 2OV1
OUT#1.LIST#3.SYS-ID = 157
OUT#1.LIST#3.SHARER-TYPE = *SLAVE
OUT#1.LIST#3.SHARER-STA = *IMP-PUBSET
OUT#1.LIST#3.SYS-VERSION = V20.0
OUT#1.LIST#4.PARTNER-NAME = D016ZE04
OUT#1.LIST#4.HOME-PUBSET = 2OSH
OUT#1.LIST#4.SYS-ID = 163
OUT#1.LIST#4.SHARER-TYPE = *SLAVE
OUT#1.LIST#4.SHARER-STA = *IMP-PUBSET
OUT#1.LIST#4.SYS-VERSION = V21.0
OUT#1.LIST#5.PARTNER-NAME = D016ZE00
OUT#1.LIST#5.HOME-PUBSET = 2OV0
OUT#1.LIST#5.SYS-ID = 155
OUT#1.LIST#5.SHARER-TYPE = *MASTER
OUT#1.LIST#5.SHARER-STA = *IMP-PUBSET
OUT#1.LIST#5.SYS-VERSION = V19.0

Note

The command’s source of information is the sign-of-life messages which the sharers exchange (disk log). As the current status of the shared pubset configuration is logged on the master system, a certain delay is to be expected on the slave systems, depending on the value of the FAIL-DETECTION-LIMIT configuration parameter.