managepwfile

The managepwfile command creates a password file for an existing ESS or DS user account. This command processes the password requirements for 2105, 2107, and 1750 systems.


>>-managepwfile--+- -action---+--+---------------------+-------->
                 '-+-add----+-'  '- -pwfile--file_name-'   
                   +-remove-+                              
                   '-change-'                              

>--+-------------+--+-------------+--+------------------+------->
   '- -mc1--HMC1-'  '- -mc2--HMC2-'  '- -name--username-'   

>-- -pw--password----------------------------------------------><

Parameters

-action

(Required) Specifies that a process that is designated by the subparameter be enacted on the password file.

add: Specifies that the password file be created by adding the first line of the file, which contains the primary HMC designation and the HMC user name.
remove: Specifies that the password file be removed for the designated user.
change: Specifies that the password file be changed for the designated user.

-pwfile file_name

(Optional) Specifies the name that you want to use for the password file. You can specify the password file as an absolute path or a relative path. The relative path is obtained from the current working directory.

file_name: The user-specified ESS or DS password file name.

-mc1

(Optional) Specifies the DNS name or the IP address.

Note: You can use the default value that is specified for HMC1 in your profile file, or you can use the value that is specified for the current CLI session connection.

HMC1: Designates the primary HMC or 2105 DNS name or IP address. This information along with the -name parameter is used as a key in the password file.

-mc2

(Optional) Specifies the DNS name or the IP address of the secondary HMC.

Note: You can use the default value that is specified for HMC2 in your profile file, or you can use the value that is specified for the current CLI session connection.

HMC2: Designates the secondary HMC or 2105 DNS name or IP address.

-name

(Optional) Specifies the name that you use to access the DS CLI application.

username: Designates the user-specified SMC or 2105 user name. This information along with the –mc1 parameter information is used as a key in the password file.

-pw password

(Required) Specifies a user-assigned password.

password: Specifies the password that enables user name access to this ESS or DS CLI client installation. The password is case-sensitive.

Notes:

A password file is created with a user’s default protection mask. The user needs to update the protection mask to allow access only to the owner of the file. Also, you must write down the directory name where the password file is contained in case you need to use it later.
The password file has a default value of <user_home>/dscli/security.dat.
The home directory <user_home> is defined by the Java system property named "user.home" The location of your password file is determined by your operating system. The following examples are home directories in different operating systems:
Windows operating system

For a Windows operating system, the property value defaults to the environment variable %USERPROFILE%. As a result, your personal profile is C:\Documents and Settings\<username>\dscli\security.dat .

UNIX or Linux operating system

For an UNIX or Linux operating system, the property value defaults to the environment variable $HOME. As a result, your personal profile is ~/dscli/security.dat.

i5/OS

For the i5/OS, your personal profile is /home/<username>/dscli/security.dat.

OpenVMS system

For an OpenVMS operating system, the property value defaults to the logical name SYS$LOGIN. As a result, your personal profile is [.dscli.profile]security.dat
Note: The values of the Java system properties can be redefined by JRE options. If you are having problems, check to see if you have an environment setting like the following on your local system:
```
_JAVA_OPTIONS=-Duser.home=…
```

Example (1750)

Invoking the managepwfile command

dscli>managepwfile -action add -mc1 myess.ibm.com -name testuser –pw AB9cdefg

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS  CLI 
Version 5.0.0.0 DS: IBM.1750-68FA120 
Record myess.ibm.com/testuser successfully added to password file
c:\Documents and Settings\testuser\dscli\security.dat