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
>>-mqsichangeflowuserexits-- BrokerName ------------------------> >-- -e --EgName --+---------------------+----------------------> '- -f -- MessageFlow -' >--+-----------------------------+--+----------------------+----> +- -a --ActiveUserExitNames -+ '- -k -applicationName-' '- -i --InactiveUserExitNames-' >--+------------------+---------------------------------------->< '- -y -libraryName-'
z/OS console command
Synonym: cx
>>-+-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
mqsichangeflowuserexits MB8BROKER -e default -f myFlow -a exit2
mqsichangeflowuserexits MB8BROKER -e default -f myFlow -i exit1
mqsichangeflowuserexits MB8BROKER -e default -a exit3,exit1
mqsichangeflowuserexits MB8BROKER -e default -1 exit2
mqsichangeflowuserexits MB8BROKER -e default -f myFlow -i exit1 -a exit2