IBM Support

IBM InfoSphere DataStage job fails with ds_ipcput() - timeout waiting for mutex error

Troubleshooting


Problem

IBM DataStage job fails with error: ds_ipcput() - timeout waiting for mutex

Symptom

IBM DataStage job fails with error:
ds_ipcput() - timeout waiting for mutex

Resolving The Problem

Add DS_IPCPUT_OLD_TIMEOUT_BEHAVIOR=1 as an environment variable at the job or project level.

The IPC link is used to pass data between the parallel engine and basic transformer stage or server-shared container. It currently has a default open timeout of 5 seconds.

  1. A writer will wait 5 seconds for a reader to connect
  2. A reader will wait 5 seconds for the writer to create the shared memory pipe.
Setting DS_IPCPUT_OLD_TIMEOUT_BEHAVIOR will restore the old timeout behavior; where the timeout will only occur if the process connected to the other end of the IPC link is no longer running or the job state is no longer running.

To set the variable at the job level:
  1. Open the job properties for the job in the DataStage Designer client.
  2. Select the Parameters tab
  3. Click "Add Environmental Variable"
  4. Select (New...) and specify the variable name and prompt as DS_IPCPUT_OLD_TIMEOUT_BEHAVIOR
  5. Click OK and set the default value to 1.

To set the variable at the project level:
  1. Open DataStage Administrator client
  2. Select the project and click on Properties
  3. Click on Environment.
  4. Add DS_IPCPUT_OLD_TIMEOUT_BEHAVIOR as a user defined environment variable and set it to 1.

To set the variable at the environment level add it to the dsenv file, as follows:
DS_IPCPUT_OLD_TIMEOUT_BEHAVIOR=1; export DS_IPCPUT_OLD_TIMEOUT_BEHAVIOR
Restart the DataStage Engine in order for the change to take affect.

[{"Product":{"code":"SSVSEF","label":"IBM InfoSphere DataStage"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Not Applicable","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.7;8.5;8.1;8.0.1;7.5","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
16 June 2018

UID

swg21450066