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