Receive exit name (RCVEXIT)

This attribute specifies the name of the user exit program to be run by the channel receive user exit.

This attribute can be a list of names of programs that are to be run in succession. Leave blank, if no channel receive user exit is in effect.

The format and maximum length of this attribute depend on the platform:

• On z/OS it is a load module name, maximum length 8 characters, except for client-connection channels where the maximum length is 128 characters.
• On IBM i, it is of the form:

  libname/progname
  

  when specified in CL commands. When specified in IBM MQ Commands (MQSC) it has the form:

  progname libname
  

  where progname occupies the first 10 characters, and libname the second 10 characters (both blank-padded to the right if necessary). The maximum length of the string is 20 characters.
• On Windows, it is of the form:

  dllname(functionname)
  

  where dllname is specified without the suffix .DLL. The maximum length of the string is 40 characters.
• On UNIX, it is of the form:

  libraryname(functionname)
  

  The maximum length of the string is 40 characters.

During cluster sender channel auto-definition on z/OS, channel exit names are converted to z/OS format. To control how exit names are converted, we can write a channel auto-definition exit. For more information, see Channel auto-definition exit program.

We can specify a list of receive, send, or message exit program names. The names must be separated by a comma, a space, or both. For example:

RCVEXIT(exit1 exit2)
MSGEXIT(exit1,exit2)
SENDEXIT(exit1, exit2)

The total length of the string of exit names and strings of user data for a particular type of exit is limited to 500 characters. In IBM MQ for IBM i, we can list up to 10 exit names. In IBM MQ for z/OS, we can list up to eight exit names.

This attribute is valid for all channel types.

Parent topic: Channel attributes in alphabetical order