IBM Support

MustGather: How to Trace Integrated Web Services (IWS) Administrative Scripts on IBM i

How To


Summary

When encountering issues during the execution of any Integrated Web Services (IWS) administration script in Qshell on the IBM i, follow these steps to gather verbose information to investigate your issue further.

Environment

IBM i OS 7.3 and later
Integrated Web Services (IWS) administration scripts in /QIBM/ProdData/OS/WebServices/bin

Steps

  1. Open a new 5250 session.
  2. ADDENVVAR ENVVAR(QIBM_IWS_SERVICE_TRACE) VALUE(true) LEVEL(*SYS)
  3. STRQSH
  4. cd /QIBM/ProdData/OS/WebServices/bin
  5. Execute your IWS script.
    i.e. listWebServicesServers.sh or installWebService.sh
  6. Press F6 to print the scroll to a spooled file.
  7. Review the /tmp/qiws_trace.log file and the Qshell QPRINT spooled file.

Still have problems or questions?

Visit the IBM Support Site page to obtain support or view the IBM Support Guide for detailed information on obtaining IBM Support.
Then, gather and upload the files to a support case for IBM to review, if needed.

Detailed information on how to upload data to IBM Support can be found here: https://www.ibm.com/support/pages/node/644037

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000COsAAM","label":"Web Services-\u003EIntegrated Web Services"}],"ARM Case Number":"TS019277767","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3.0;7.4.0;7.5.0;7.6.0"}]

Document Information

Modified date:
30 May 2025

UID

ibm17234265