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-ATTRIBUTES

&pagelevel(3)&pagelevel

Request overview of pubset attributes

Component:

BS2000

Functional area:

Pubset and MRSCAT management

Domain:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

TSOS
OPERATING

Routing code:

E

Function

With this command systems support can display the values and characteristics which have been defined for a pubset using the SET-PUBSET-ATTRIBUTES command.

Only the PUBRES of the relevant SF pubset or the control volume set of the SM pubset needs to be available for executing the command.
If PUBSET=*BY-VOLUME-SET is specified, the VOLRES of the specified volume set must also be available.

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

Format

SHOW-PUBSET-ATTRIBUTES                                                                                                                    

PUBSET = <cat-id 1..4>(...) / *BY-VOLUME-SET(...)


<cat-id 1..4>(...)



|


PUBSET-TYPE = *ANY / *SINGLE-FEATURE / *SYSTEM-MANAGED(...)



|



*SYSTEM-MANAGED(...)



|




|


CONTROL-VOLUME-SET = *ANY / <cat-id 1..4>


*BY-VOLUME-SET(...)



|


VOLUME-SET = <cat-id 1..4>

,DEVICE-TYPE = *STD / <device>

Operands

PUBSET = <cat-id 1..4>(...)
Catalog ID of the pubset (alphanumeric) for which information is required.

PUBSET-TYPE = *ANY / *SINGLE-FEATURE / *SYSTEM-MANAGED(...)
Specifies the type of pubset involved.
The default applies if an MRSCAT entry exists or if the pubset identifier refers to a single-feature pubset.

PUBSET-TYPE = *ANY
Default: A valid MRSCAT entry exists (the pubset type is irrelevant), or the pubset is a single-feature pubset.

PUBSET-TYPE = *SINGLE-FEATURE
The pubset in question is a single-feature pubset.

PUBSET-TYPE = *SYSTEM-MANAGED(...)
The pubset in question is a system-managed pubset.

CONTROL-VOLUME-SET = *ANY
The pubset in question is an SM pubset with a valid MRSCAT entry which contains the name of the control volume set.

CONTROL-VOLUME-SET = <cat-id 1..4>
Control volume set of the specified SM pubset.

PUBSET = *BY-VOLUME-SET(...)
If the catalog ID of an SM pubset is not known, the pubset attributes can also be requested by specifying one of the volume sets which belong to the SM pubset. The volume set requires an existing valid MRSCAT.

VOLUME-SET = <cat-id 1..4>
Volume set ID.

DEVICE-TYPE = *STD / <device>
Device type of the PUBRES for the SF pubset or for the control volume set of the SM pubset. If a device type is specified explicitly, only disk device types known on the system will be accepted. Entering DEVICE-TYPE=? in interactive mode calls up a list of available device types.

DEVICE-TYPE = *STD
General disk type STDDISK with which the system itself finds the disk type.

DEVICE-TYPE =<device>
Specifies the device type. 

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

Command executed without error


1

CMD0202

Syntax error


32

DMS03BE

Error in command processing:




  • during MRSCAT read access




  • during time stamp read access




  • during SVL access




  • during the SYSID conversion call




  • during output to SYSOUT




  • in the pubset occupancy


64

DMS03BE

No authorization for command


64

DMS03BE

Device type missing in the MRSCAT


130

DMS03BE

Disk request rejected


130

DMS03BE

Pubset in process of being exported

Note on output

Column                 

Meaning

Value                     

PVSID

Pubset identifier of pubset

1-4 characters

SYSID

Identifier for the system which uses this pubset as home pubset

1-3 characters / ?

SHARABILITY

Shared pubset is mode possible

YES/NO

CURRENT MASTER

System ID of the current master processor

1-3 characters / NONE / ?

DESIGNATED MASTER

System ID of the master processor designated via the SET-PUBSET-ATTRIBUTES command

1-3 characters / NONE / ?

If the backup master is defined as alternate master, the value OR is output in the column between DESIGNATED MASTER and BACKUP MASTER. This indicates that of these two, the one on which the pubset import was first conducted becomes master.

OR

BACKUP MASTER

System ID of the processor to take over from master processor if master processor crashes

1-3 characters / NONE / ?

ALTERNATE BACKUP

Response when automatic master is not possible

*NONE / *BY-SHARER / *BY-OPERATOR

DEFAULT-STORAGE-TYPE

Default storage type for creating files

*PUBLIC-SPACE

LARGE
VOLUMES

Large volumes (>= 32 GB) permitted

*FORBIDDEN / *ALLOWED

LARGE FILES

Files >= 32 GB permitted

*FORBIDDEN / *ALLOWED

SNAPSET-LIMIT

maximum permitted number of snapsets

Number from 0 to 52

Table 139: Output columns of the SHOW-PUBSET-ATTRIBUTES command

The “?” character means that there is no correct entry for this value.

Output in S variable

Output information

Name of the S variable

T

Contents                 

Condition

Alternate backup master

var(*LIST).ALT-BACKUP

S

*BY-OPER
*BY-SHARER
*NONE


Alternate master

var(*LIST).ALT-MASTER

S

*BACKUP-MASTER
*NONE


System ID of the backup master processor (takes over as master if the pubset owner fails)

var(*LIST).BACKUP-MASTER

S

*NONE
<sys-id>


ID of the control volume set (SM pubsets only)

var(*LIST).CONTROL-VOLSET

S

<cat-id>


System ID of the current master processor (owner of the pubset)

var(*LIST).CURR-MASTER

S

*NONE
<sys-id>


Default storage type for creating files

var(*LIST).DEFAULT-STORAGE-TYPE

S

*PUBLIC-SPACE


System ID of the designated master processor

var(*LIST).DESIGNATED-MASTER

S

*NONE
<sys-id>


Large volumes (> 32 GB) allowed in pubset

var(*LIST).LARGE-VOL

S

*NOT-ALLOW
*ALLOW


Creating large files (> 32 GB) allowed

var(*LIST).LARGE-FILE

S

*NOT-ALLOW
*ALLOW


Pubset catalog ID

var(*LIST).PUBSET

S

<cat-id>


Type of pubset
*STANDARD=single-feature pubset
*SM-PUBSET=system-managed pubset

var(*LIST).PUBSET-TYPE

S

*STANDARD
*SM-PUBSET


Shareability of the pubset

var(*LIST).SHARE

S

*NO
*YES


System ID of the processor which uses the pubset as its home pubset

var(*LIST).SYS-ID

S

*NONE
<sys-id>


Snapset limit for the pubset

var(*LIST).SNAPSET-LIMIT

S

<integer 0..52>


Example

/set-pubset-attr pubset=3g2,snapset-limit=2
/show-pubset-attributes pubset=3g2

============================================================================
 PVSID   SYSID   SHARABILITY   CURRENT   DESIGNATED   BACKUP     ALTERNATE
                               MASTER      MASTER     MASTER       BACKUP
----------------------------------------------------------------------------
  3G2     250       *YES       *NONE       *NONE      *NONE        *NONE
============================================================================
 DEFAULT-STORAGE-TYPE   LARGE VOLUMES   LARGE FILES   SNAPSET LIMIT
----------------------------------------------------------------------------
 *PUBLIC-SPACE          *FORBIDDEN      *FORBIDDEN          2
============================================================================
Powered by Atlassian Confluence and Scroll Viewport.