The administrative command-line client is a program that allows administrators to control and monitor the server from a remote workstation rather than from the server console.
The administrative client program can be installed on a workstation, personal computer, or terminal running in one of the following environments:
You can start an administrative client session by using any of the following modes:
Use the console mode to monitor ADSM 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 ADSM. You cannot enter any administrative commands in console mode.
For example, to start an administrative client session in console mode on an OS/2 client:
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 ADSM write all terminal output to a file, specify the OUTFILE option with a destination file name. To write output to the SAVE.OUT file, enter:
dsmadmc -id=sullivan -password=secret -consolemode -outfile=save.out
For more information about the ID, PASSWORD, CONSOLEMODE, and OUTFILE options, see "Using Administrative Client Options".
To end an administrative client session in console mode, use one of the following keyboard break sequences:
Use the mount mode from an administrative client to monitor ADSM removable-media mount activities. While the system is running in mount mode, you cannot enter any administrative commands from the client session.
For example, to start an administrative client session in mount mode on an OS/2 client:
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 ADSM write all terminal 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
For more information on the ID, PASSWORD, MOUNTMODE, and OUTFILE options, see "Using Administrative Client Options".
To end an administrative client session in mount mode, use one of the following keyboard break sequences:
Use batch mode for your administrative client session to enter a single administrator command or a MACRO command. To start an administrative client session in batch mode, a server session must be available. Your administrative client session automatically ends when the command or macro has executed.
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 file. If you specify a parameter with a string of text using batch mode, enclose the text in single quotation marks (' ') in the macro file. Double quotes are not allowed in batch mode. For more information about using macro files, see "Using Macros to Issue Commands".
Use the interactive mode from an administrative client to enter a series of administrative commands. 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 automatically restart your administrative client session by entering another command.
When command processing is complete, the adsm> prompt will appear and the administrator can then perform additional work. Command processing can be stopped by either canceling the existing client session or stopping and then restarting the client program.
You can use continuation characters in the interactive mode of the administrative client. For more information, see "Using Continuation Characters".
Use the QUIT command to end an administrative client session in interactive mode.