![]() |
![]() |
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.
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
End an administrative command line client session by entering this command on your workstation:
quit
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 |
Use mount mode to monitor removable media mount activities. While the session is running in mount mode, you cannot enter any administrative commands.
To start an administrative client session in mount mode, enter:
dsmadmc -mountmode
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 -mountmode -outfile=save.out
To end an administrative client session in mount mode, see Table 4.
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.
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