针对 MQCBD 的 CallbackName (MQCHAR128)
回调描述符结构- CallbackName 字段
回调函数作为动态链接的程序调用。
必须指定 CallbackFunction 或 CallbackName。 如果同时指定这两者，那么将返回原因码 MQRC_CALLBACK_ROUTINE_ERROR。
如果既未设置 CallbackName 也未设置 CallbackFunction ，那么调用将失败，原因码为 MQRC_CALLBACK_ROUTINE_ERROR。
当注册要使用的第一个回调例程时装入该模块，当最后一个要使用该模块的回调例程注销时卸载该模块。
除非在以下文本中注明，否则名称在字段中是左对齐的，没有嵌入的空格; 名称本身用空格填充字段的长度。 在下面的描述中，方括号 ([]) 表示可选信息:
- IBM® i
- 回调名称可以是下列其中一种格式:
- 库 "/" 程序
- 库"/"ServiceProgram"（"FunctionName"）"
MyLibrary/MyProgram(MyFunction)。库名可以是 *LIBL。 库名和程序名都限制为最多 10 个字符。
- AIX® and Linux®
- 回调名称是动态可装入模块或库的名称，以驻留在该库中的函数的名称作为后缀。 函数名必须括在括号内。 可以选择以目录路径作为库名的前缀:
[path]library(function)如果未指定路径，那么将使用系统搜索路径。
名称限制为最多 128 个字符。
- Windows
- 回调名称是动态链接库的名称，后缀为驻留在该库中的函数的名称。 函数名必须括在括号中。库名可以选择以目录路径和驱动器作为前缀:
[d:][path]library(function)如果未指定驱动器和路径，那么将使用系统搜索路径。
名称限制为最多 128 个字符。
- z/OS®
- 回调名称是对 LINK 或 LOAD 宏的 EP 参数规范有效的装入模块的名称。
名称限制为最多 8 个字符。
- z/OS CICS®
- 回调名称是对 EXEC CICS LINK 命令宏的 PROGRAM 参数规范有效的装入模块的名称。
名称限制为最多 8 个字符。
可以使用已安装的 PROGRAM 定义的 REMOTESYTEM 选项或通过动态路由程序将程序定义为远程程序。
如果程序要使用 IBM MQ API 调用，那么必须将远程 CICS 区域连接到 IBM MQ 。 但是请注意， MQCBC 结构中的 Hobj 字段在远程系统中无效。
如果尝试装入
CallbackName时发生故障，那么会将下列其中一个错误代码返回到应用程序:- MQRC_模块未找到
- MQRC_模块无效
- MQRC_模块入口未找到
这是一个输入字段。 此字段的初始值为空字符串或空白。