gbch-user - list batch user details.

# 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.