Tivoli Storage Manager for Windows: Administrator's Reference

UPDATE NODE (Update Node Attributes)

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

You must use the RENAME NODE command to change the name of a registered 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-+-'  '-ARCHDELete--=--+-Yes-+-'
                     +-Yes----+                     '-No--'
                     '-No-----'
 
>--+------------------------+----------------------------------->
   '-BACKDELete--=--+-No--+-'
                    '-Yes-'
 
>--+-----------------------------+------------------------------>
   '-WHEREDOmain--=--domain_name-'
 
>--+----------------------------------------+------------------->
   '-WHEREPLatform--=--client_platform_name-'
 
>--+--------------------+--+---------------------+-------------->
   '-KEEPMP--=--+-No--+-'  '-MAXNUMMP--=--number-'
                '-Yes-'
 
>--+---------------------+--+-----------------------------+----><
   '-URL--=--url_address-'  '-AUTOFSRename--=--+-Yes----+-'
                                               +-No-----+
                                               '-Client-'
 
 

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.
Note:
|This parameter cannot be specified for a NAS node. |

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.

URL
Specifies the client's Uniform Resource Locator (URL) address that the administrator can use to administer the TSM client. If you want to remove the value for this field, specify empty single quotes or empty double quotes with no spaces, '' or "".

AUTOFSRename
Specifies whether the client is prompted for renaming file spaces when the client system upgrades to a client that supports Unicode. The prompting and renaming, if allowed, occur only when the client runs one of the following operations: archive, selective backup, full incremental backup, or partial incremental backup. The renaming changes the names of existing backed-up file spaces that are not in Unicode in server storage. Then the file spaces are backed up in Unicode. You can use this parameter for Unicode-enabled TSM clients using Windows NT and Windows 2000 operating systems.
Note:
After the client with support for Unicode is installed, any new file spaces that the client backs up are stored in server storage using the UTF-8 code page. UTF-8 is a byte-oriented encoding form specified by the Unicode Standard.
Possible values are:

Yes
The server automatically renames existing file spaces when the client system upgrades to a client that supports Unicode, and the client runs one of the following operations: archive, selective backup, full incremental backup, or partial incremental backup. The renaming occurs whether the client uses the graphical user interface, the command line, or the client scheduler.

For example, the server renames a drive as follows:

Original name: D_DRIVE
New name: D_DRIVE_OLD

The new name indicates that the file space is stored on the server in format that is not Unicode.

No
The server does not rename file spaces automatically when the client system upgrades to a client that supports Unicode, and the client runs one of the following operations: archive, selective backup, full incremental backup, or partial incremental backup.

Client
The option AUTOFSRENAME in the client's option file determines whether file spaces are renamed.

By default, the client option is set to PROMPT. When the client system upgrades to a client that supports Unicode and the client runs a TSM operation with the graphical user interface or the command line, the program displays a one-time prompt to the user about whether to rename file spaces.

When the client scheduler runs an operation, the program does not prompt for a choice about renaming, and does not rename file spaces. Backups of existing file spaces are sent as before (not in Unicode).

Refer to the appropriate Using the Backup-Archive Client book for more information on the client option.

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 325. 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 a 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 ]