Administrator's Reference


Using the Administrative 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. 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.

Console Mode

Use console mode to monitor TSM 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 TSM. 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 redirect all output to a file, specify the -OUTFILE option with a destination file name. On OS/2, for example, enter:

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

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


Table 5. Keyboard Break Sequences

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

Mount Mode

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 TSM redirect all output to a file, specify the -OUTFILE option with a destination file name. On OS/2, for example, enter:

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

To end an administrative client session in mount mode, see Table 5.

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 TSM 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.

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 TSM: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:

To start an administrative session in interactive 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.

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

Use the QUIT command to end an administrative client session in interactive mode.


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