IMS TM Resource Adapter user message exit routine (HWSJAVA0)

Use the IMS™ TM Resource Adapter user message exit routine (HWSJAVA0) to edit messages and perform custom security checking in support of the IMS Connect client, IMS TM Resource Adapter.

The HWSJAVA0 exit routine and its related macros are provided as both load modules and source code. Use the load module if you do not want to alter the way HWSJAVA0 operates. Edit the source code if you want to use a modified version of the exit in your installation. After modifying the source code, you must assemble and link edit it to replace the pre-assembled load module in your system.

The HWSJAVA0 exit routine is bound into the IMS.SDFSRESL data set. This exit does not perform a translation or build to the OTMA headers. Both the translation and insertion or deletion of the OTMA header is done by IMS TM Resource Adapter.

By default, the HWSJAVA0 exit routine sets the COMMIT mode to 1, and the SYNC level to NONE. However, IMS TM Resource Adapter can override these settings.

The HWSJAVA0 exit routine can return user-defined messages and return and reason codes when user-defined criteria are met. The HWSJAVA0 exit routine can also request that IMS Connect keep the socket connection open after returning a user-defined message depending on the return code set in the EXPREA_RETCODE parameter pointed to by register 1 at the READ subroutine exit.

Important: IMS Connect does not support user-defined messages for Local Option connections. Additionally, the message length must be from a minimum of 1 to the maximum of 128 characters. If the specified message length is greater than 128, the message will be truncated to 128.

This user exit also calls the user-provided security exit (IMSLSECX) if one is defined to this exit and passes a parameter list in register 1.