PI69267: xscmd does not exit with proper return code

APAR status

• Closed as program error.

Error description

• xscmd returns a non-zero return code when the command is run
  successfully, and it returns 255 (out of index) when the
  command fails with an error.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:  WebSphere eXtreme Scale users who use the   *
  *                  xscmd command line tool                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: xscmd returns 0 even when the command   *
  *                      fails; and on Unix, it returns 255      *
  *                      when an unexpected error occurs         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The xscmd command line tool returns 0 even when the command
  fails. On Unix, it returns 255 when an unexpected error occurs.
  

Problem conclusion

• Problem is fixed in the 8.6.1.1 release.  The return codes of
  xscmd are "Success: 0", "Unexpected error: 1", "Error: 3"
  

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:

Fix information

• Fixed component name

  WS EXTREME SCAL

• Fixed component ID

  5724X6702

Applicable component levels

• R861 PSY

     UP