dscli

The dscli command starts DS CLI. Use this command to run DS CLI commands in the interactive, single-shot, or script mode.


>>-dscli--+-----------------------+--+----------------+--------->
          '-+-+- -h----+--------+-'  '- -cfg--profile-'   
            | +- -help-+        |                         
            | '- -?----'        |                         
            +- -ver-------------+                         
            +- -overview--------+                         
            +- -scriptfile_name-+                         
            '-command-----------'                         

>--+--------------+--+--------------+--+-------------------+---->
   '- -hmc1--HMC1-'  '- -hmc2--HMC2-'  '- -user--user_name-'   

>--+--------------------+--+------------------------+----------><
   '- -passwd--password-'  '- -pwfile--passwordfile-'

Parameters

Note: You must not start more than 100 DS CLI sessions simultaneously. Starting more than 100 DS CLI sessions simultaneously can result in connection problems.

-help | -h | -?

(Optional) Displays a help screen about how to use the DS CLI program.

-ver

(Optional) Displays the DS CLI version.

-overview

(Optional) Provides overview information about the DS CLI.

-script file_name

(Optional) Initiates the script mode so that multiple dscli program commands can be issued consecutively using a saved file.

file_name: Specifies the file with the stored program commands to be executed.

Format options that are specified using the framework setoutput command apply to all commands in the file. Output from successful commands routes to stdout, and output from failed commands routes to stderr. If an error occurs during the processing of one of the commands in the file, the script exits at the point of failure and returns to the system prompt.

command

Specifies the single command that you want to run.

-cfg profile

Specifies a profile file. This parameter is not required if you are using default profiles. The default profile file name is dscli.profile, and it is provided as part of the DS CLI package under the profile directory.

-hmc1 HMC1

(Optional) Specifies the primary management console IP address or the host name.

HMC1: The IP address for the primary management console.

This parameter is not required if you have established this information as a profile variable.

-hmc2 HMC2

(Optional) Specifies the secondary management console IP address or the host name.

HMC2: The IP address for the secondary management console.

This parameter is not required if you have established this information as a profile variable.

Note: The HMC1 and HMC2 values must apply to two different management consoles.

-user user_name

(Optional) Specifies your user name for issuing DS CLI commands on the command-line.

user_name: Your user name.

This parameter is not required if you have established this information as a profile variable.

-passwd password

(Optional and not recommended) Specifies the password that you use for issuing DS CLI commands on the command line.

password: Your password.

This parameter is not required or recommended. If you use this method to designate your password, the password is displayed on the screen. Another option is to specify a password file (see the next parameter) that is used when you start the DS CLI application.

Also, if you specify this parameter and do not specify the -user parameter, nothing happens. In other words, you are still prompted for a user ID and password before you can log in to the DS CLI application.

-pwfile passwordfile

Specifies the password file that contains your password.

passwordfile: Specifies a password file as an alternative to the –passwd parameter.

Example

This command invokes the CLI in interactive mode:

>dscli

The resulting output

dscli>