Adapting the shared memory

The logging file of the proxy container contains the message U189 when it is necessary to adapt the shared memory (see U-messages).

The necessary modification depends on the insert in the U189 message:

• U189 &OBJ1 ( &PTRM, &PRNM ): IPC shortage of LETT EXTP FULL or
  U189 &OBJ1 ( &PTRM, &PRNM ): IPC shortage of LETT MAX ILETT or
  U189 &OBJ1 ( &PTRM, &PRNM ): IPC shortage of LETT MAX OLETT

  These inserts mean that the size of a message exceeds the maximum size of the data area for a connection. The default maximum size after installation is 32 (specified in 4KB units).

  To correct it, you must change the value of the UTM_IPC_EXTP_LETTER environment variable to a bigger value.

• U189 &OBJ1 ( &PTRM, &PRNM ): IPC shortage of LETT IPC FULL

  These inserts mean that the size of all messages exceeds the maximum size of the data area for all connections. The default maximum size after installation is 1600 (specified in 4KB units).

  To correct it, you must change the value of the UTM_IPC_LETTER environment variable to a bigger value.

In most cases, however, the following "rule of thumb" can be used:

• UTM_IPC_EXTP_LETTER = maximum size of an outbound/inbound message in 4KB units

• UTM_IPC_LETTER = <nConn> * UTM_IPC_EXTP_LETTER, but not less than 1600 (6.4 MB).

  <nConn> is the maximum number of connections between the proxy container and its partner applications (EIS partner, resource adapter, Management Console).