IT25727: NEED TO CLARIFY DSMCUTIL.EXE OPTION USAGE

IBM Spectrum Protectâ„¢ Client 8.1.8 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• The dsmcutil command description on "IBM Tivoli Storage Manager
  for Windows Backup-Archive Clients Installation and User's
  Guide"
  needs to be updated.
  The lines indicated by "|" at the left should be added.
  
  
  >>>>>
  1
  dsmcutil command
     Dsmcutil commands: Required options and examples
     ...
     UPDATEPW
     ..
     The password is validated with the Tivoli Storage Manager
  server if /validate:Yes is specified. The password is updated on
  the server if you specify /updateonserver:Yes. If you specify
  this option, you must specify the current password with the
  /oldpassword: option.
  
  |   From the IBM Spectrum Protect client 7.1.8, 8.1.2, when
  specifying the "updatepw" option with /validate:no,
  |   the commserver must be the server name from "set
  servername". You can find it by "query system" command.
  
     Task
     Update the encrypted password for the specified node.
  Validate and update the password on the specified Tivoli Storage
  Manager server which resides on the specified TCP/IP hostname
  and port:
        Command:
        dsmcutil updatepw /node:alpha1 /commMethod:tcpip
        ...
  
  2
  Dsmcutil valid options
     /commserver:servername
     Specifies the protocol specific Tivoli Storage Manager server
  name.
     Depending on the protocol used, this can be a TCP/IP hostname
  or a
     Named Pipes name. If not specified, the value is obtained
  from the client
     options file or set to the default client value.
     This option can also be used with the UPDATEPW command to
  specify a
     protocol specific server name to connect to for updating
  passwords.
  
  |   From the IBM Spectrum Protect client 7.1.8, 8.1.2, when
  specifying the "updatepw" option with /validate:no,
  |   the commserver must be the server name from "set
  servername". You can find it by "query system" command.
  <<<<<
  
  IBM Tivoli Storage Manager/IBM Spectrum Protect Versions
  affected:
  IBM Spectrum Protect client 7.1.8/8.1.2 and higher releases on
  Windows
  
  
  Customer/L2 Diagnostics (If Applicable)
  None.
  
  Additional Keywords:
  dsmcutil.exe, updatepw
  
  
  Initial Impact:
  middle
  

Local fix

• Specify Tivoli Storage Manager server name at /commserver
  option.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect backup-archive client versions 7.1.8,   *
  * 8.1.2, 8.1.4, 8.1.6, 8.1.7 on Windows platforms.             *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in level 8.1.8. Note that this is      *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• Now the command "dsmcutil updatepw /validate:no" requires option
  "/commserver" then if option "/commserver" is not specified then
  the error message is displayed.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Modules/Macros

• dsmcutil
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R71W PSY

     UP

• R81W PSY

     UP