Tivoli Header

Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide

Set Access

The set access command gives users at other nodes access to your backup versions, archived copies, or backup images. You can give another user access to a specific file or image, multiple files or images, or all files or images in a directory. When you give access to another user, that user can restore or retrieve your objects. Specify in the command whether you are giving access to archives or backups.

Note:
You cannot give access to both archives and backups using a single command.

Supported Clients

This command is valid for all Windows clients.

Syntax

>>-SET Access--+- Archive-+--+- filespec----------------+------->
               '- Backup--'  '- {filespacename}filespec-'
 
>-- node--+-------+--+--------------+--------------------------><
          '- user-'  | .----------. |
                     | V          | |
                     '--- options-+-'
 
 

Parameters

Archive
Permits access to archived files or images.

Backup
Permits access to backup versions of files or images.

filespec
Specifies the path, file, image, or directory to which your are giving access to another node or user. Use wildcard characters to specify a group of files or images, or all files and images in a directory; all objects in a directory branch; or all objects in a drive. However, you cannot use a wildcard to specify all drives. Use a single asterisk "*" for the file spec to give access to all files or images owned by you and backed up on the server. When the command set access backup "*" node is entered, no check is made with the server; it is assumed you have at least one object backed up.

If you give access to a branch of the current working directory, you only need to specify the branch. If you give access to objects that are not in a branch of the current working directory, you must specify the complete path. The file spec to which you gave access must have at least one backup version or archive copy object (file or directory) on the server.

To give access to all objects below a certain level, use an asterisk, directory delimiter, and an asterisk at the end of your file spec. For example, to give access to all objects below d:\test\, use file spec d:\test\*\*.

To specify all files or images in a named directory, enter c:\proj\* on the command line. To specify all files or images in all directories off of the root directory, enter d:\*\* on the command line. Enter d:\* on one set access command and d:\*\* on another if you want another user to have complete access to all of your files. The first d:\* gives access to all subdirectories and all files or images off of the root directory.

Use the file space name if the drive label name has changed.

Note: If you include filespacename, do not include a drive letter in the file specification.

{filespacename}
Specifies the file space name (enclosed in braces) on the server that contains the files to which you are giving access. This name is the drive label name on the workstation drive from which the file was backed up or archived. Use the file space name if the drive label name has changed.

image-fs
The name of the image file system to be shared. This may be specified as an asterisk (*) to allow access to all images owned by the user granting access.

node
Specifies the client node of the user to whom you are giving access. Use wildcards to give access to more than one node with similar node names. Use an asterisk (*) to give access to all nodes.

user
This is an optional parameter that restricts access to the named user at the specified node.

options
See Chapter 9, Setting Processing Options for information about common options that you can use with this command.

Examples

Task
Give the user at node_2 authority to restore all files with an extension of .c from the c:\devel\proja directory.

Command: set access backup c:\devel\proja\*.c node_2

Task
Give the user at node_3 authority to retrieve all files in the c:\devel directory, but do not permit access to files in subdirectories of c:\devel, such as c:\devel\proj.

Command: set access archive c:\devel\* node_3

Task
Give all nodes whose names end with bldgb the authority to restore all backup versions from all directories on the d: drive. The d: drive has the file space name of project.

Command: set ac b {project}\*\* *bldgb


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