Tivoli Storage Manager for Windows Administrator's Reference

UPDATE NODE (Update a Client Node)

Use this command to modify the attributes of a registered client node.

You must use the RENAME NODE command to change the name of a registered client node.

Privilege Class

To issue this command, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the policy domain to which the client node belongs.

Syntax

               (1)
>>-UPDate Node--------node_name--------------------------------->
 
>-----+-----------------------------------------+--------------->
      +-password--+---------------------------+-+
      |           '-FORCEPwreset--=--+-No--+--' |
      |                              '-Yes-'    |
      '-FORCEPwreset--=--Yes--------------------'
 
>-----+-------------------+---+-------------------------------+->
      '-PASSExp--=--days--'   '-CLOptset--=--option_set_name--'
 
>-----+-------------------+---+-------------------------+------->
      '-CONtact--=--text--'   '-DOmain--=--domain_name--'
 
>-----+-----------------------------+--------------------------->
      '-COMPression--=--+-Client-+--'
                        +-Yes----+
                        '-No-----'
 
>-----+-------------------------+---+-------------------------+->
      '-ARCHDELete--=--+-Yes-+--'   '-BACKDELete--=--+-No--+--'
                       '-No--'                       '-Yes-'
 
>-----+------------------------------+-------------------------->
      '-WHEREDOmain--=--domain_name--'
 
>-----+-----------------------------------------+--------------->
      '-WHEREPLatform--=--client_platform_name--'
 
>-----+---------------------+---+----------------------+-------><
      '-KEEPMP--=--+-No--+--'   '-MAXNUMMP--=--number--'
                   '-Yes-'
 

Notes:

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

Parameters

node_name (Required)
Specifies the name of the client node to be updated. You can use wildcard characters to specify this name.

password
Specifies the new password for the client node. This parameter is optional. The maximum length of the password is 64 characters. Passwords remain current for a period determined by the password expiration period.

FORCEPwreset
Specifies whether to force a client to change or reset the password. This parameter is optional. Possible values are:

No
Specifies that the password expiration period is set by the SET PASSEXP command. The administrator does not force a client to change or reset the password while attempting to logon to the server.
Note:This value is valid only when you specify a password.

Yes
Specifies that the client node or administrator's password will expire at the next logon. The client must change or reset the password at that time.

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.

CLOptset
Specifies the name of the option set to be used by the client. This parameter is optional.

CONtact
Specifies a text string of information identifying the client node. This parameter is optional. The maximum length of the text string is 255 characters. Enclose the contact information in quotation marks if it contains any blanks. To remove previously defined contact information, specify a null string ("").

DOmain
Specifies the name of the policy domain to which the client node is registered. This parameter is optional.

COMPression
Specifies whether the client node compresses its files before sending them to the server for backup and archive. This parameter is optional. Possible values are:

Client
Specifies that the client determines whether files will be compressed.

Yes
Specifies that the client node compresses its files before sending them to the server for backup and archive.

No
Specifies that the client node does not compress its files before sending them to the server for backup and archive.

ARCHDELete
Specifies whether the client node can delete its own archived files from the server. This parameter is optional. Possible values are:

Yes
Specifies that the client node can delete its own archive files from the server.

No
Specifies that the client node cannot delete its own archive files from the server.

BACKDELete
Specifies whether the client node can delete its own backup files from the server. This parameter is optional. Possible values are:

No
Specifies that the client node cannot delete its own backup files from the server.

Yes
Specifies that the client node can delete its own backup files from the server.

WHEREDOmain
Specifies the name of the policy domain to be used as a filter in combination with the node name to select nodes to update. This parameter is optional.

WHEREPLatform
Specifies the name of the client platform to be used as a filter in combination with the node name to select nodes to update. This parameter is optional.

KEEPMP
Specifies whether the client node keeps the mount point for the entire session. The parameter is optional. Possible values are:

No
Specifies that the client node release the mount point during the session. If policy definitions cause data to be stored to a disk storage pool after storing data to a sequential access storage pool, any mount points held by the session will be released.

Yes
Specifies that the client node must retain the mount point during the entire session. If policy definitions cause data to be stored to a disk storage pool after storing data to a sequential access storage pool, any mount points held by the session will not be released.

MAXNUMMP
Specifies the maximum number of mount points a node is allowed to use on the server. You can specify an integer from 0-999. A value of 0 specifies that a node cannot acquire any mount point for a backup or archive operation. However, the server will still allow the node a mount point for a restore or retrieve operation.

Examples

Task

Update node LARRY so that the data on node LARRY will be compressed when it is backed up or archived by TSM and so that the client cannot delete archived files.

Command:
update node larry compression=yes archdelete=no

Related Commands

Table 305. Commands Related to UPDATE NODE

Command Description
QUERY NODE Displays partial or complete information about one or more clients.
REGISTER ADMIN Defines a new administrator without granting administrative authority.
REGISTER NODE Defines a client to the server and sets options for that user.
REMOVE NODE Removes a client from the list of registered nodes for a specific policy domain.
RENAME NODE Changes the name for an existing user that belongs to a specific policy domain.
SET PASSEXP Specifies the number of days after which a password is expired and must be changed.
UPDATE ADMIN Changes the password or contact information associated with any administrator.


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