SHOW-POSIX-USER-DEFAULTS

Show POSIX default attributes

Component:	SRPMNUC
Functional area:	User management POSIX administration and application
Domain:	USER-ADMINISTRATION
Privileges:	STD-PROCESSING POSIX-ADMINISTRATION USER-ADMINISTRATION

Function

This command shows the POSIX default attributes as recorded in the user catalog of the specified pubset. It is available to the following users:

• holders of the POSIX-ADMINISTRATION or USER-ADMINISTRATION privilege, for all pubsets.

• group administrators of the *UNIVERSAL group on the pubset they manage.

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

Format

SHOW-POSIX-USER-DEFAULTS                                                                                                               

PUBSET = *HOME / *ALL / list-poss(20): <cat-id 1..4>
,OUTPUT = list-poss(2): *SYSOUT / *SYSLST(...)
	*SYSLST(...)
		|		SYSLST-NUMBER = *STD / <integer 1..99>
		|		,LINES-PER-PAGE = 64 / <integer 20..255>

Operands

PUBSET =
Pubset for which the POSIX default attributes in the user catalog are to be shown.

PUBSET = *HOME
Shows the POSIX default attributes in the user catalog of the home pubset.

PUBSET = *ALL
Shows the POSIX default attributes in the user catalogs of all the pubsets available at command runtime.

PUBSET = list-poss(20): <cat-id 1..4>
Shows the POSIX default attributes in the user catalog of the specified pubset.

OUTPUT = list-poss(2): *SYSOUT / *SYSLST(...)
Specifies the system file to which the output is to be sent.

OUTPUT = *SYSOUT
The information is sent to the SYSOUT system file.

OUTPUT = *SYSLST(...)
The information is sent to the SYSLST system file.

SYSLST-NUMBER =
Selects a SYSLST number.

SYSLST-NUMBER = *STD
Selects the default SYSLST output.

SYSLST-NUMBER = <integer 1..99>Selects the specified SYSLST number.

LINES-PER-PAGE =
Specifies the number of lines per page.

LINES-PER-PAGE = 64
By default, 64 lines are printed per page.

LINES-PER-PAGE = <integer 20..255>
The specified number of lines are printed per page.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without error
2	0	SRM6001	Command executed with warning
	32	CMD2009	Error during generation of output variables
	32	SRM6020	Command rejected owing to system error
	64	OPS0002	K2 interrupt on output to S variables
	64	SRM6040	Command rejected with error message
	130	OPS0001	Insufficient resources for output to S variables
	130	SRM6030	Command rejected owing to insufficient resources

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Comment	var(*LIST).COMMENT	S	*NONE <c-string 1..255>
Login directory	var(*LIST).DIR	S	<posix-pathname 1..1023>
POSIX group ID	var(*LIST).GROUP-NUM	I	<integer 0..60002>
Name of the program	var(*LIST).PROG	S	*SHELL <posix-pathname 1..1023>
Pubset catalog ID	var(*LIST).PUBSET	S	<cat-id 1..4>
POSIX user ID	var(*LIST).USER-NUM	I	<integer 0..60002>

Example

/show-posix-user-defaults

%POSIX-USER-DEFAULTS   --- PUBSET 2OSH                     2014-03-14 17:18:06
------------------------------------------------------------------------------
USER-NUMBER           100
GROUP-NUMBER           25
COMMENT      *NONE
DIRECTORY    /
PROGRAM      *SHELL
------------------------------------------------------------------------------
POSIX-USER-DEFAULTS                                             END OF DISPLAY