mqsichangeflowuserexits command - z/OS

Use the mqsichangeflowuserexits command on z/OS® to set the list of active or inactive user exits. A list of active and a list of inactive user exits is maintained for each integration server and message flow. The effective state of user exits for a given flow is decided when the flow starts.

Syntax

z/OS command - BIPCHUE

Read syntax diagramSkip visual syntax diagrammqsichangeflowuserexits integrationNodeName  -e  integrationNodeName  -f  MessageFlow   -a ActiveUserExitNames   -i InactiveUserExitNames -k applicationName -y libraryName

z/OS console command

Synonym: cx

Read syntax diagramSkip visual syntax diagramchangeflowuserexitscx e= integrationServerName f=MessageFlow a=ActiveUserExitNamesi=InactiveUserExitNamesk=ApplicationNamey=LibraryName

Parameters

integrationNodeName
(Required). The name of the integration node.
-a ActiveUserExitNames
(Optional). A list of the names, separated by colons, of the active user exits. These are the names registered by the user exits when they were loaded. If any of the user exits listed are not registered for the target integration server, then the command fails with a BIP8858 error.
-e integrationServerName
(Required). The name of the integration server.
-f MessageFlow
(Optional). The name of the message flow.
If you supply this value, the user exit is changed for that message flow; if you do not, the user exit is set at the integration server level.
-i InactiveUserExitNames
(Optional). A list of the names, separated by colons, of the inactive user exits. These are the names registered by the user exits when they were loaded. If any of the user exits listed are not registered for the target integration server, then the command fails with a BIP8858 error.
-k applicationName
(Optional) This parameter specifies the name of the application that contains the message flow for which the user exit is changed.

When you set this parameter, you must also set the -f (message flow) parameter. To change the user exit for a named message flow in a specific application, set the -k and -f parameters.

You can use this parameter with the -y (library name) parameter to specify that the message flow is contained in a library referenced by the application.

-y libraryName
(Optional) This parameter specifies the name of the library that contains the message flow for which the user exit is changed.

When you set this parameter, you must also set the -f (message flow) parameter. To display statistics collection options for a named message flow in a specific library, set the -y and -f parameters.

Examples

Setting active exits at flow level
mqsichangeflowuserexits IBNODE -e default -f myFlow -a exit2
Setting inactive exits at flow level
mqsichangeflowuserexits IBNODE -e default -f myFlow -i exit1
Setting active exits at integration server level
mqsichangeflowuserexits IBNODE -e default -a exit3,exit1
Setting inactive exits at integration server level
mqsichangeflowuserexits IBNODE -e default -1 exit2
Changing exit1 to inactive and leaving exit2 active at flow level (A command had previously been issued with "-a exit1:exit2" to set them both active)
mqsichangeflowuserexits IBNODE -e default -f myFlow -i exit1 -a exit2