PURPOSE

tpgrpadd - add a new group on the system

SYNOPSIS

TUXCONFIG=tuxconfig tpgrpadd  [-g gid] grpname

DESCRIPTION

The tpgrpadd command creates a new group definition on the system by adding the appropriate entry to the TUXEDO security data files. This information is used for TUXEDO System/T authentication with the AUTHSVR(5) server and for access control. A TUXEDO configuration with SECURITY set to USER_AUTH, ACL, or MANDATORY_ACL must be created before running this command successfully.

The following options are available:

-g gid

The group identifier for the new group. This group identifier must be a non-negative decimal integer below 16K. gid defaults to the next available (unique) identifier greater than 0. Group identifier 0 is reserved for the "other" group.

grpname

A string of printable characters that specifies the name of the new group. It may not include a pound sign (#), comma (,), colon (:) or a newline (\n).

Before running this command, the application must be configured using either the graphical user interface or tmloadcf(1). tpgrpadd must be be run on the configuration MASTER if the application is not active; if active, this command can run on any active node.

PORTABILITY

This command is available only on non-/WS sites running TUXEDO System/T Release 6.0 or later.

DIAGNOSTICS

The tpgrpadd command exits with a return code of 0 upon successful completion.

SEE ALSO

tpgrpdel(1),
BEA TUXEDO Administrator's Guide