Tivoli Storage Manager for Windows Administrator's Reference

REGISTER ADMIN (Register an Administrator)

Use this command to add an administrator to the server. After registration, the administrator can issue a limited set of commands, including all query commands. To provide additional privileges, use the GRANT AUTHORITY command.

Privilege Class

To issue this command, you must have system privilege.

Syntax

>>-REGister Admin--admin_name--password------------------------->
 
>-----+-------------------+---+-------------------+------------->
      '-PASSExp--=--days--'   '-CONtact--=--text--'
 
      .-FORCEPwreset--=--No------.
>-----+--------------------------+-----------------------------><
      '-FORCEPwreset--=--+-No--+-'
                         '-Yes-'
 

Parameters

admin_name (Required)
Specifies the name of the administrator to be registered. The maximum length of the name is 64 characters. The password is not case-sensitive. See Naming Conventions in Tivoli Storage Manager for a table that lists the characters available for specifying a password.

You cannot specify an adminstrator name of NONE.

password (Required)
Specifies the password of the administrator to be registered. The maximum length of the password is 64 characters.

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 is set with the global expiration period of 90 days.

CONtact
Specifies information identifying the administrator being registered. This parameter is optional. The maximum length of this string is 255 characters. The contact information must be enclosed in quotation marks if it contains any blanks.

FORCEPwreset
Specifies whether the administrator is required to change or reset the password. This parameter is optional. The default value is NO. 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.

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

Examples

Task

Define an administrator, LARRY, with the password PASSONE. You can identify LARRY as second-shift personnel by specifying this information with the CONTACT parameter.

Command:
register admin larry passone contact='second shift'

Related Commands

Table 213. Commands Related to REGISTER ADMIN

Command Description
GRANT AUTHORITY Assigns privilege classes to an administrator.
LOCK ADMIN Prevents an administrator from accessing TSM.
QUERY ADMIN Displays information about one or more TSM administrators.
REGISTER NODE Defines a client to the server and sets options for that user.
REMOVE ADMIN Removes an administrator from the list of registered administrators.
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.
UNLOCK ADMIN Enables a locked administrator to access TSM.
UPDATE ADMIN Changes the password or contact information associated with any administrator.
UPDATE NODE Changes the attributes associated with a client node.


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