Skip navigation.

Command Reference

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents View as PDF   Get Adobe Reader




tpgrpadd—Adds a new group on the system.


tpgrpadd [-g GID] grpname


The tpgrpadd command creates a new group definition on the system by adding the appropriate entry to the BEA Tuxedo security data files. This information is used for BEA Tuxedo system authentication with the AUTHSVR(5) server and for access control. A BEA Tuxedo configuration with SECURITY set to USER_AUTH, ACL, or MANDATORY_ACL must be created before you can run 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.


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 you must: (a) configure the application, using either the graphical user interface or tmloadcf(1); and (b) set the TUXCONFIG environment variable to point to your TUXCONFIG file. tpgrpadd must be run on the configuration MASTER if the application is not active. If the application is active, this command can run on any active node.


This command is available on any platform on which the BEA Tuxedo server environment is supported.


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

See Also

tpgrpdel(1), tpgrpmod(1), tpusradd(1), tpusrdel(1), tpusrmod(1), AUTHSVR(5)

Administering a BEA Tuxedo Application at Run Time


Skip navigation bar  Back to Top Previous Next