Copyright © TIBCO Software Inc. All rights reserved.
Copyright © TIBCO Software Inc. All rights reserved.


Chapter 11 Users and Groups : Command Line Invocation

Command Line Invocation
To run this command you must be logged in either as the IPEADMIN user or, on a UNIX system, as the IPEBACKGROUND user or root user.
swutil USERINFO EXPORT [username] [nolocation]
swutil USERINFO { - | filename } [nousrchk]
where:
EXPORT [username] instructs swutil to write user information to standard output, either for all users, or optionally for a single username.
The information is written in control file format (see Control File Format), enabling it to be directed to a file that may be read back in (with the above commands). This enables user information to be transferred to another computer, restored to a former state or updated after editing the file.
By default, the value of a user’s SW_DOMAIN user attribute is output for an "add user" (U+) instruction, unless the nolocation parameter is used.
filename is the name of the control file to be used to update user information from. (On Windows, filename can be a full pathname or a simple filename in the current directory. On UNIX, filename can be a full pathname or a simple filename in the SWDIR\util directory.)
By default, the list of users in filename is checked against the list of operating system users. Any user that does not exist in the list is ignored. This validation is not performed if the optional nousrchk parameter is used. (nousrchk has no effect if user validation is being performed with UVAPI).
- (a hyphen character) instructs swutil to read control instructions from standard input and update user information. Control instructions must use control file format (see Control File Format).
During processing of a control file, error messages are written to standard output. On completion of processing, a message is written to standard output giving the total number of lines of instructions successfully processed.
The UNIX exit status is set to 0 for no errors, 2 if there are errors but some data is updated, or 3 if no data is updated.
Input and output redirection may be used as normal.

Copyright © TIBCO Software Inc. All rights reserved.
Copyright © TIBCO Software Inc. All rights reserved.