NAME

gbch-user - list batch user details.


SYNOPSIS

gbch-user [ -options ]


DESCRIPTION

gbch-user provides 4 functions:

With no arguments it lists the permissions for the invoking user and exits.

With the -m option it enables the invoking user to edit his own default job and variable permissions. The user must have change default modes permission to do this.

With the -v option it enables the invoking user to interactively review the list of permissions for all users. The user must have read admin file permission to do this.

With the -i option it enables the invoking user to interactively review and update the list of permissions for all users. The user must have write admin file permission to do this.


OPTIONS

Note that the order of treatment, letters and keywords described below may be modified by editing the file btrest.help - see btsyntax(5).

The environment variable on which options are supplied is GBCH_USER and the environment variable to specify the help file is BTUSERCONF.

Certain commands available on-screen enable many of these options to be changed and saved in configuration files.

-? or +explain

Causes a summary of the other options to be displayed without taking further action.

-B or +no-help-box

Put help messages in inverse video rather than in a box when operating in interactive mode. This is the default case.

-b or +help-box

Put help messages in a box rather than displaying inverse video when operating in interactive mode.

-d or +display-only

Is the default. A list of permissions is output to the standard output.

-E or +no-error-box

Put error messages in inverse video rather than in a box when operating in interactive mode. This is the default case.

-e or +error-box

Put error messages in a box rather than displaying inverse video when operating in interactive mode.

-g or +group-name-sort

Sort users by group name, then user name within primary group. This is only relevant to -v or -i options.

-H or +keep-char-help

When displaying a help screen in interactive mode, interpret the next key press as a command as well as clearing the help screen.

-h or +lose-char-help

Discard whatever key press is made to clear a help screen when in interactive mode.

-i or +update-users

View and update the list of users. This option requires write admin file privilege.

-m or +set-default-modes

Interactively set the default modes for the invoking user. This option requires change default modes privilege.

-n or +numeric-user-sort

Sort users by numeric userid (default).

-u or +user-name-sort

Sort users by user name.

-v or +view-users

View in read-only mode the list of users and permissions. This requires read admin file privilege.


FILES

~/.gnubatch configuration file (home directory)

.gnubatch configuration file (current directory)

btuser.help message file

btufile user control file.


ENVIRONMENT

GBCH_USER

space-separated options to override defaults.

BTUSERCONF

location of alternative help file.


SEE ALSO

gbch-uchange(1), gbch-ulist(1), btsyntax(5) gbch-uconv(8).


DIAGNOSTICS

Various diagnostics are read and printed as required from the message file btuser.help.


COPYRIGHT

Copyright (c) 2009 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.


AUTHOR

John M Collins, Xi Software Ltd.