MQZ_REFRESH_CACHE-刷新所有授权

此函数由 MQZAS_VERSION_3 授权服务组件提供,并且由队列管理器调用以刷新组件内部持有的权限列表。

此函数 (针对 MQZEP) 的函数标识为 MQZID_REFRESH_CACHE (8L)。

语法

MQZ_REFRESH_CACHE( QMgrName , ComponentData , Continuation , CompCode , Reason )

参数

QMgrName
类型:MQCHAR48 - 输入

队列管理器名称。 调用组件的队列管理器的名称。 此名称将以空格填充到参数的完整长度; 该名称不会以空字符终止。

队列管理器名称将传递给组件以获取信息; 授权服务接口不要求组件以任何定义的方式使用该名称。

ComponentData
类型:MQBYTE×ComponentDataLength- 输入/输出

组件数据。 此数据由队列管理器代表此特定组件保存; 将保留此组件提供的任何函数对其进行的任何更改,并在下次调用此组件的某个函数时显示。

此数据区的长度由队列管理器在 MQZ_INIT_AUTHORITY 调用的 ComponentDataLength 参数中传递。

延续
类型:MQLONG - 输出
按组件设置的连续指示符。 可以指定以下值:
MQZCI_默认
依赖于队列管理器的延续。

对于 MQZ_CHECK_AUTHORITY ,其效果与 MQZCI_STOP 相同。

MQZCI_CONTINUE
继续下一个组件。
MQZCI_STOP
请勿继续使用下一个组件。
CompCode
类型:MQLONG - 输出
完成代码。 它必须是下列其中一个值:
MQCC_OK
成功完成。
MQCC_FAILED
调用失败。
原因
类型:MQLONG - 输出

原因码限定 CompCode

如果 CompCode 为 MQCC_OK:
MQRC_NONE
(0, X'000') 没有要报告的原因。
如果 CompCode 为 MQCC_WARNING:
MQRC_SERVICE_ERROR
(2289,X'8F1')访问服务时发生意外错误。

C 调用

MQZ_REFRESH_CACHE (QMgrName, ComponentData,
                   &Continuation, &CompCode, &Reason);
按如下所示声明参数:
MQCHAR48  QMgrName;          /* Queue manager name */
MQBYTE    ComponentData[n];  /* Component data */
MQLONG    Continuation;      /* Continuation indicator set by
                                component */
MQLONG    CompCode;          /* Completion code */
MQLONG    Reason;            /* Reason code qualifying CompCode */