The following table lists optional parameters you can include when running the bcmadmin shell.
| Command Option | Description |
|---|---|
| -w <password key> | Uses password stored with TD wallet key <password key> for authentication. |
| -u <username> | Specifies the Business Continuity Manager username. |
| -P <password> | Specifies the Business Continuity Manager user password. |
| -h <host> | Sets the name or IP address of the Business Continuity Manager server to which to connect. The default is localhost. |
| -p <port> | Sets the listening port of the Sequencer server. The default value is 5344. |
| -e "<command>" | Enables you to run a single bcmadmin command from the command line. The tool exits once the command returns. The user and password must be specified as part of the command-line arguments. The command must be enclosed in quotes. For example,-e "SESSION LIST". To use bcmadmin in interactive mode, do not specify -e. |
| -l <filename> | Sends the session output to the specified log file. There is no default log file. |
| -nosync or -n | * Sets the bcmadmin shell default to asynchronous mode. By default, the bcmadmin shell runs all operations in the synchronous mode. You must specify this command option to switch to asynchronous mode. When the command succeeds, the output prints All operations will be run in asynchronous mode. You can use the abbreviation -n or -nosync for this command option. For example, bcmadmin -nosync or bcmadmin -n. |
| -sync or -s | * Sets the bcmadmin shell to synchronous mode which blocks each command that runs in the shell until it completes. When a synchronous command succeeds, the output prints Operations' output will be synchronous. You can use the abbreviation -s or -sync for this command option; for example: bcmadmin -s or bcmadmin -Sync. This option is enabled by default. |
| --prompt=<string> | Specifies the command prompt string. The default value is bcmadmin. |
| -? | Displays help information. |
* If both the -n and -s options are entered in the same command, bcmadmin uses the last option in the command as the selected operation. For example, in the command bcmadmin -s -n, bcmadmin selects to run all operations in the non-synchronous mode.
Examples
These examples show a Business Continuity Manager user working in the /opt/teradata/bcm directory.
The following example shows a user connecting to the Sequencer on the host ftcp1 and using the default port and username admin. The user is prompted for a password.
./bin/bcmadmin -h ftcp1 -u admin
The following example shows a user connecting to the Sequencer on the host ftcp1 and with the username admin and password adminPass. The user includes -e to run the SYSTEM ACTIVATE ALL command. This format is a useful for running scripting tasks at bcmadmin. The bcmadmin shell runs by default in synchronous mode, and therefore the -s option used previously to force bcmadmin to wait for command completion before continuing is no longer needed.
./bin/bcmadmin -h ftcp1 -u admin -P adminPass -e "SYSTEM ACTIVATE ALL";
The following example shows the Welcome message that displays when you log on. The last line of the message tells you the mode selected for running all operations.
bcmadmin -u admin -P admin Login successful, authenticated connection established. Welcome to the interactive administration shell (version 99.99.99.99) Commands end with ; Type 'help' for additional shell commands. All operations will be run in synchronous mode.