Tivoli Storage Manager for HP-UX Administrator's Reference

UPDATE ADMIN (Update an Administrator)

Use this command to change the password or contact information for an administrator. However, you cannot update the SERVER_CONSOLE administrator name.

Passwords for administrators must be changed after a length of time determined by the SET PASSEXP command.

You must use the RENAME ADMIN command to change the name of a registered administrator.

Privilege Class

To issue this command to change another administrator's password or contact information, you must have system privilege. Any administrator can issue this command to update his or her own password or contact information.

Syntax

                (1)
>>-UPDate Admin--------admin_name--+----------+----------------->
                                   '-password-'
 
>-----+-------------------+---+-------------------+------------->
      '-PASSExp--=--days--'   '-CONtact--=--text--'
 
>-----+---------------------------+----------------------------><
      '-FORCEPwreset--=--+-No--+--'
                         '-Yes-'
 

Notes:

  1. You must specify at least one optional parameter on this command.

Parameters

admin_name (Required)
Specifies the name of the administrator to be updated.

password
Specifies the administrator's password. This parameter is optional. Passwords remain current for a period determined by the password expiration period.

PASSExp
Specifies the number of days the password remains valid. You can set the password expiration period from 0 to 9999 days. A value of 0 means that the password never expires. This parameter is optional. If you do not specify this parameter the password expiration period is unchanged.

CONtact
Specifies a text string that identifies the administrator. This parameter is optional. Enclose the text string in quotation marks if it contains any blanks. To remove previously defined contact information, specify a null string ("").

FORCEPwreset
Specifies whether the administrator is required to change or reset the password. This parameter is optional. Possible values are:

No
Specifies that the administrator does not need to change or reset the password while attempting to sign on to the server. The password expiration period is set by the SET PASSEXP command.

Yes
Specifies that the administrator's password will expire at the next sign on. The administrator must change or reset the password at that time. If a password is not specified, you will receive a syntax error.

Examples

Task

Update the administrator LARRY to have the password SECRETWORD and a password expiration period of 120 days.

Command:
update admin larry secretword passexp=120

Related Commands

Table 274. Commands Related to UPDATE ADMIN

Command Description
QUERY ADMIN Displays information about one or more TSM administrators.
QUERY STATUS Displays the settings of server parameters, such as those selected by the SET commands.
REGISTER ADMIN Defines a new administrator without granting administrative authority.
REGISTER NODE Defines a client to the server and sets options for that user.
RENAME ADMIN Changes a TSM administrator's name.
SET PASSEXP Specifies the number of days after which a password is expired and must be changed.
UPDATE NODE Changes the attributes associated with a client node.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]