SHMKEY_ID

WIS and WQS Process Configuration

Warning: TIBCO recommends that you do not change the value of this attribute unless you are instructed to do so by TIBCO Support, or you are fully familiar with the use of UNIX shared memory and the operation of the ftok system call.

Summary

This attribute defines the UNIX shared memory key that is allocated (using the ftok system call) when the WQS process is started.

Applies To

This attribute must be set for ALL processes.

Default Value

This attribute is not defined on a newly installed iProcess Engine node. In this case, the default value is:

Machine ID

Process

Instance

Value

0

ALL

0

“x”

The attribute only appears in the output of the SHOW_ALL_ATTRIBUTES command if you have explicitly assigned a value to it using the SET_ATTRIBUTE command. The default setting is not displayed

Notes

The default value should work correctly in most situations. However, it is possible for a shared memory conflict to occur - for example, if iProcess Engine is restarted, another application may allocate to itself the shared memory key that iProcess expects to use when it restarts. If this happens, the WQS process will fail to start, and the following error message is written to the sw_error file:

WQS initialise failed, connected to shared memory for nodename

where nodename is either a valid nodename or blank.

If such a shared memory conflict does occur you can change the SHMKEY_ID value to resolve it.