JR43281: DSADMIN COMMAND USING PRIMARY COMMAND OPTION -ENVSET CAN LEAD TO CORRUPTION OF DSPARAMS FILE.

APAR status

• Closed as program error.

Error description

• dsadmin command using -envadd primary command option can lead to
  corruption of DSParams file.
  
  Command such as
  dsadmin -domain xxxxx.xx.customer.com.au -user xxxx -password
  xxxx -server xxxxxx -envadd APT_DEBUG_DISTRIBUTE_COMPONENT -type
  STRING -value "1" NTT_DEV02
  
  This command should be rejected as invalid by dsadmin as it does
  not contain -prompt option and argument.
  
  Vaild command is
  
  Invalid arguments: dsadmin -envadd <environment variable name>
  -type STRING | ENCRYPTED -prompt "<prompt text>" [-value
  "<value>"] <project name>
  
  The corruption of the DSParams file can range from random
  characters to duplication of an environment variable.
  
  The latter can cause an error suc
  
  "Run-time error '457': This key is already associated with an
  element of this collection."
  
  This error will prevent DataStage clients logging into the
  project.
  

Local fix

• Ensure that -prompt "<prompt text>" is included in the dsadmin
  -envadd command.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Use of DSADMIN command -ENVSET with missing -prompt argument
  ****************************************************************
  PROBLEM DESCRIPTION:
  The command line utility DSADMIN may crash or cause corruption
  of DSPARAMS when used with the -ENVSET primary command option
  and the -prompt argument has not been specified.
  ****************************************************************
  RECOMMENDATION:
  Install patch JR43281
  ****************************************************************
  

Problem conclusion

• Install patch JR43281
  

Temporary fix

• N/A
  

Comments

APAR Information

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

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

Fix information

• Fixed component name

  WIS DATASTAGE

• Fixed component ID

  5724Q36DS

Applicable component levels

• R870 PSY

     UP