WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

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 execution group 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 diagram
>>-mqsichangeflowuserexits-- BrokerName ------------------------>

>-- -e --EgName  --+---------------------+---------------------->
                   '- -f -- MessageFlow -'   

>--+-----------------------------+--+----------------------+---->
   +- -a --ActiveUserExitNames  -+  '- -k -applicationName-'   
   '- -i --InactiveUserExitNames-'                             

>--+------------------+----------------------------------------><
   '- -y -libraryName-'   

z/OS console command

Synonym: cx

Read syntax diagramSkip visual syntax diagram
>>-+-changeflowuserexits-+--e= EgName--+---------------+-------->
   '-cx------------------'             '-f=MessageFlow-'   

>--+-------------------------+--+-------------------+----------->
   +-a=ActiveUserExitNames---+  '-k=ApplicationName-'   
   '-i=InactiveUserExitNames-'                          

>--+---------------+-------------------------------------------><
   '-y=LibraryName-'   

Parameters

BrokerName
(Required). The name of the broker.
-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 execution group, then the command fails with a BIP8858 error.
-e EgName
(Required). The name of the execution group.
-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 execution group 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 execution group, 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 MB8BROKER -e default -f myFlow -a exit2
Setting inactive exits at flow level
mqsichangeflowuserexits MB8BROKER -e default -f myFlow -i exit1
Setting active exits at execution group level
mqsichangeflowuserexits MB8BROKER -e default -a exit3,exit1
Setting inactive exits at execution group level
mqsichangeflowuserexits MB8BROKER -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 MB8BROKER -e default -f myFlow -i exit1 -a exit2
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:47:22


Reference topicReference topic | Version 8.0.0.7 | an28490_