Tivoli Header

Administrator's Reference


Using the Administrative Command Line Client

The administrative command-line client is a program that runs on a file server, workstation, or mainframe that allows administrators to control and monitor the server through administrative commands.

You can start an administrative client session in console, mount, batch, or interactive mode by using the DSMADMC command. In each of these modes, you can specify certain options with commands. For details, see Using Administrative Client Options. You can redirect output to a file using redirection characters. For details, see Redirecting Command Output.

Starting the Administrative Command Line Client

The TSM server must be running before any client can connect. See Quick Start for specific instructions.

To start an administrative client session in command line mode, enter this command on your workstation:

dsmadmc/ -id=admin -password=admin

The slash (/) after dsmadmc is required.

Note:
Enter the DSMADMC command with your user ID and password by using the -ID and -PASSWORD options as shown if you do not want to be prompted for that information.

Stopping the Administrative Command Line Client

End an administrative command line client session by entering this command on your workstation:

quit

Console Mode

Use console mode to monitor Tivoli Storage Manager activities as they occur or to capture processing messages to an output file. For example, you can monitor migration processes and clients logging on to Tivoli Storage Manager. You cannot enter any administrative commands in console mode.

To start an administrative client session in console mode, enter:

dsmadmc -consolemode

You are prompted for a password if authentication is turned on for the server. If you do not want to be prompted for your user ID and password, enter the DSMADMC command with the -ID and -PASSWORD options.

To have Tivoli Storage Manager redirect all output to a file, specify the -OUTFILE option with a destination file name. For example, enter:

dsmadmc -id=sullivan -password=secret -consolemode -outfile=save.out

To end an administrative client session in console mode, see Table 4.

Table 4. Keyboard Break Sequences

Environment Break Sequence
UNIX-based clients Ctrl+C
CMS HX
DOS and OS/2, Windows and Windows NT(R) Ctrl+C, Ctrl+Break
TSO ATTN

Batch Mode

Use batch mode to enter a single administrative command. Your administrative client session automatically ends when the command has processed.

To start an administrative client session in batch mode, enter:

dsmadmc 

You can enter the DSMADMC command with your user ID and password by using the -ID and -PASSWORD options, respectively if you do not want to be prompted for that information.

To have Tivoli Storage Manager redirect all output to a file, specify the -OUTFILE option with a destination file name. For example, to issue the QUERY NODE command in batch mode with the output redirected to the SAVE.OUT file, enter:

dsmadmc -id=sullivan -password=secret -outfile=save.out query node 

In batch mode, you must enter the complete command on one line. If a command does not fit on one line, enter the command by using a macro or a script. If you specify a parameter with a string of text using batch mode, enclose the text in single quotation marks (' ') in the macro. Double quotes are not allowed in batch mode.

On MVS and VM operating systems, you must enter:

Interactive Mode

Use the interactive mode to enter a series of administrative commands. You can automatically restart your administrative client session by entering another command each time the Tivoli Storage Manager:servername > prompt appears.

To start an administrative client session in interactive mode, a server session must be available. To ensure the availability of server sessions for both administrative and client node sessions, the interactive mode of the administrative client is disconnected if one or more of the following conditions is true:

You can use continuation characters when using interactive mode. For more information, see Using Continuation Characters.

To start an administrative session in interactive mode, enter:

dsmadmc 


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