SHOW-SM-PUBSET-PARAMETERS Show parameters of SM pubset

This statement is for the HSMS administrator only. It outputs the parameters of an SM pubset under HSMS management.

In addition to output to SYSOUT or SYSLST, the statement also supports structured output to an S variable.

Format (only for HSMS administrators)

SHOW-SM-PUBSET-PARAMETERS

Alias: SSP

SM-PUBSET-ID = <cat-id>
,OUTPUT = *NONE / list-poss(2): *SYSOUT / *SYSLST
,STRUCTURE-OUTPUT = *SYSINF / *NONE / <composed-name 1..255>(...)
	<composed-name 1..255>(...)
		|	WRITE-MODE = *REPLACE / *EXTEND

SM-PUBSET-ID = <cat-id>
ID of the SM pubset whose parameters are to be displayed. This pubset must be imported locally.

OUTPUT =
Determines the output medium for the required information. Batch requests are always output to SYSLST.

OUTPUT = *NONE
Output is not performed in text format.

OUTPUT = *SYSOUT
Output is to the logical system file SYSOUT, i.e. as a rule in the dialog on the screen.

OUTPUT = *SYSLST
Output is to the logical system file SYSLST. Each mask comprises 43 lines.

STRUCTURE-OUTPUT =
Controls structured output in S variables (for the variable layout see "Output in S variables").

STRUCTURE-OUTPUT = *SYSINF
Structured output is directed to the SYSINF S variable stream.

STRUCTURE-OUTPUT = *NONE
No structured output is required.

STRUCTURE-OUTPUT = <composed-name 1..255>(...)
Name of the S variable that is to be used for the structured output.

WRITE-MODE =
Determines whether the output should replace or complement the current content of the S variables.

WRITE-MODE = *REPLACE
The current content of the S variable is to be replaced by the new output.

WRITE-MODE = *EXTEND
The new output extends the current content of the S variable.

Layout of the screen mask

//SHOW-SM-PUBSET-PARAMETERS SM-PUBSET-ID=<cat-id>

 SHOW-SM-PUBSET-PARAMETERS                     PUBSET-ID: @@@@
 ------------------------------------------------------------------------------
 GLOBAL-PARAMETERS                             HSMS VERSION : @@@
    DESTROY-BY-DELETE : @@@@

 S1-DEFINITION
    S1-VOLUME-SET : @@@@@@@@@@@@@@@@@@@

 S2-DEVICE-TYPE : @@@@@@@@@@@
 SYSBACKUP      : @@@@@@@@@@@@@@@@@@@@@@
 SYSVERSION     : @@@@@@@@@@@@@@@@@@@@@@
 SYSARCHIVE     : @@@@@@@@@@@@@@@@@@@@@@        ARCHIVAL-ENVIRONMENT : @@
 SYSMIGRATE     : @@@@@@@@@@@@@@@@@@@@@@
 SYSNODEBACKUP  : @@@@@@@@@@@@@@@@@@@@@@
 SYSNODEARCHIVE : @@@@@@@@@@@@@@@@@@@@@@


 MIGRATION-CONTROL
    MIGRATION        : @@@@@@@@@@
    BACKUP-MANDATORY : @@@@
    EXCEPT-FILE      : @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
    FILE-INHIBIT     : @@@@@@@@@@
 ------------------------------------------------------------------------------
 NEXT-PAGE : __  (E)
 @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

Key:

Column	Values	Meaning
HSMS VERSION		Minimum HSMS version necessary so that all possible functions can be used for this SM pubset. If an earlier HSMS version is used, all HSMS statements that use a local long-term archive will be rejected.
GLOBAL-PARAMETERS		Global parameters of this SM environment:
	DESTROY-BY-DELETE	Default value for the DESTROY-BY-DELETE parameter in the archive definition:
	= *YES	When the save file is deleted, the released storage space is overwritten with binary zeros for data security reasons
	= *NO	When the save file is deleted, the released storage space is not overwritten with binary zeros.
S1-DEFINITION		S1 level:
	S1-VOLUME-SET	S1 volume set
S2-DEVICE-TYPE		Default device type with which the objects are to be saved to the S2 level.
SYSBACKUP		Name of the default backup archive
SYSARCHIVE		Name of the default long-term archive
ARCHIVAL-ENVIRONMENT		SF or SM pubset environment
SYSMIGRATE		Name of the default migration archive
SYSNODEBACKUP		Name of the default backup archive for node files
SYSNODEARCHIVE		Name of the default long-term archive for node files
SYSVERSION		Name of the default version backup archive
MIGRATION-CONTROL		Parameters for migration control:
	MIGRATION	Specification as to whether and to what degree nonprivileged users may migrate files:
	= *ALLOWED	Nonprivileged users may migrate files without restriction.
	= *S2-ONLY	Nonprivileged users may only migrate files to S2.
	= *INHIBITED	Only the HSMS administrator may migrate files.
	BACKUP-MANDATORY	Migration of files without backup:
	= *YES	Migration of unsaved files is permitted
	= *NO	Migration of unsaved files is not permitted
	EXCEPT-FILE	Name of the exception file with names of the files excluded from migration.
	FILE-INHIBIT	Indicates whether the migration inhibits set as file attributes by the user are respected:
	= *STD	The value is taken from the global HSMS parameters of the host
	= *RESPECTED	Migration inhibits set as file attributes are respected
	= *IGNORED	Migration inhibits set as file attributes are not respected

Output in S variables

All variables are of the data type string.

Name of the S variable	Content	Footnote
var(*LIST).PUBSET	<string_1..4>
var(*LIST).GLOBAL-PAR.DESTROY-BY-DEL	*YES *NO
var(*LIST).S1-DEFI.S1-VOL-SET	*UNDEF <string_1..4> *ALL-HSMS-CONTROLLED
var(*LIST).S2-DEV-TYPE	*STD *UNDEF <string_1..8>
var(*LIST).SYSBACKUP	*UNDEF <string_1..22>
var(*LIST).SYSARCHIVE	*STD *UNDEF <string_1..22>
var(*LIST).SYSARCHIVE-ENVIR	*SINGLE-FEATURE *SYS-MANAGE	1) 1)
var(*LIST).SYSMIGRATE	*UNDEF <string_1..22>
var(*LIST).SYSNODEBACKUP	*UNDEF <string_1..22>
var(*LIST).SYSNODEARCHIVE	*UNDEF <string_1..22>
var(*LIST).SYSVERSION	*UNDEF <string_1..22>
var(*LIST).MIGR-CONTR.MIGR	*ALLOW *S2-ONLY *INHIBIT
var(*LIST).MIGR-CONTR.BACKUP-MANDATORY	*YES *NO
var(*LIST).MIGR-CONTR.EXCEPT-F	*NONE <string_1..54>
var(*LIST).MIGR-CONTR.F-INHIBIT	*STD *RESPECT *IGNORE
var(*LIST).MIN-HSMS-VERSION	<string_3..3>

1)	Useable output only if SYSARCHIVE=<string_1..22>; otherwise output with blank character string