Exports the functions bipInitializeUserExits and bipTerminateUserExits
You can set the state
of the user exit dynamically to active, or inactive, on a per-message
flow basis without restarting the broker.
To deploy the user
exit:
Install the user exit code on a broker.
The
library containing the user exit code must be installed on a file
system that can be accessed by the broker. For example, the file must
have read and execute authority for the user ID under which the broker
runs. The broker looks in the following places for libraries that
contain user exits:
The broker property UserExitPath defines
a list of directories separated by colons (semicolons on Windows). Use the –x flag
on the mqsicreatebroker or mqsichangebroker command to
set this property for integration servers for each broker.
Alternatively, you can append the directory containing the directory
that holds the extension files to the environment variable MQSI_USER_EXIT_PATH
associated with the environment in which the broker is running.
If both are set, the environment variable takes precedence. All
the directories in the environment variable are searched in the order
in which they appear in the variable, then all the directories in
the broker property are searched in the order in which they appear
in the property.
Load the user exit library into the broker's processes.
When the user exit library has been installed on the broker,
you must load it in one of the following ways:
Stop and restart the broker.
Run the mqsireload command
to restart the integration server processes.
Activate the user exit.
User
exits can be active or inactive, and are inactive by default. You
can change the state of a user exit dynamically by using the mqsichangeflowuserexits command
on a per-flow basis, without having to restart the broker. You can
also change the default state for a set of user exits to active on
a per-broker basis by using the mqsichangebroker command; in
this case, you do have to restart the broker.
To set the default
user exit state for a broker:
Stop the broker.
Set the activeUserExits property of
the broker by using the mqsichangebroker command.
Start the broker and check the system log to ensure
that all integration servers start without error. If any invalid
user exit names are specified (that is, the user exit is not provided
by any library loaded by the integration server), a BIP2314 message
is written to the system log and all flows in the integration servers
fail to start unless you take one of the following actions:
Provide a library in the user exit path that implements the exit;
then run the mqsireload command,
or restart the broker, to load an exit from the library.
Run the mqsichangeflowuserexits command
to remove the exit from both the active and inactive lists.
You can also override the default user exit state for a broker.
You can use the mqsichangeflowuserexits command
to activate, or deactivate, user exits on a per-integration server or
per-message flow basis, with the order of precedence being message
flow then integration server. When multiple exits are active for a flow,
the broker starts them in the order that is defined by the mqsichangeflowuserexits command.