MQPMO-Put-message 选项

输入队列的对象句柄。

如果指定了 PMPASI 或 PMPASA ，那么此字段必须包含从中获取要与所放入的消息相关联的上下文信息的输入队列句柄。

如果未指定 PMPASI 和 PMPASA ，那么将忽略此字段。

这是一个输入字段。 此字段的初始值为 0。

无法发送的消息数。

这是无法发送到分发列表中的队列的消息数。 计数包括未能打开的队列以及已成功打开但放置操作失败的队列。 将消息放入不在分发列表中的单个队列时，也会设置此字段。

这是输出字段。 此字段的初始值为 0。 如果 PMVER 小于 PMVER2，那么不会设置此字段。

成功发送到本地队列的消息数。

这是当前 MQPUT 或 MQPUT1 调用成功发送到作为本地队列的分发列表中的队列的消息数。 该计数不包括发送到解析为远程队列的队列的消息 (即使最初使用本地传输队列来存储消息)。 将消息放入不在分发列表中的单个队列时，也会设置此字段。

这是输出字段。 此字段的初始值为 0。 如果 PMVER 小于 PMVER2，那么不会设置此字段。

用于控制 MQPUT 和 MQPUT1的操作的选项。

可以指定以下任何内容或不指定任何内容。 如果需要多个值，那么可以添加这些值 (请勿多次添加相同的常量)。 将记录无效的组合; 任何其他组合都有效。

只能指定其中一个 PM* 上下文选项。 如果未指定任何这些选项，那么将采用 PMDEFC。

PMARES

PMARES 选项请求完成 MQPUT 或 MQPUT1 操作，而无需应用程序等待队列管理器完成调用。 使用此选项可以提高消息传递性能，尤其是对于使用客户机绑定的应用程序。 应用程序可以使用 MQSTAT 动词定期检查在任何先前异步调用期间是否发生了错误。

使用此选项时，仅保证在 MQMD 中完成以下字段;

• MDAID
• MDPAT
• MDPAN
• MDAOD

此外，如果将 PMNMID 和/或 PMNCID 指定为选项，那么还会完成返回的 MDMID 和 MDCID。 (可以通过指定空白 MDMID 字段来隐式指定 PMNMID)。

仅完成先前指定的字段。 未定义通常在 MQMD 或 MQPMO 结构中返回的其他信息。

当为 MQPUT 或 MQPUT1请求异步放置响应时， CMPCOD 和 REASON CCOK 和 RCNONE 不一定表示消息已成功放入队列。 当开发使用异步 put 响应且需要确认消息已放入队列的 MQI 应用程序时，您应该从 put 操作中同时检查 CMPCOD 和 REASON 代码，并且还应该使用 MQSTAT 来查询异步错误信息。

虽然可能不会立即返回每个单独的 MQPUT/MQPUT1 调用的成功或失败，但可以在稍后通过调用 MQSTAT 来确定异步调用下发生的第一个错误。

如果无法使用异步 put 响应传递同步点下的持久消息，并且您尝试落实事务，那么落实将失败，并且事务将以完成代码 CCFAIL 和原因回退RC2003. 应用程序可以调用 MQSTAT 以确定先前 MQPUT 或 MQPUT1 故障的原因

PMSRES

在 MQPMO 结构中为 put 选项指定此值可确保始终同步发出 MQPUT 或 MQPUT1 操作。 如果操作成功，那么将完成 MQMD 和 MQPMO 中的所有字段。 提供它是为了确保同步响应，而不考虑在队列或主题对象上定义的缺省 put 响应值。

PMRASQ

如果为 MQPUT 调用指定了此值，那么将从应用程序打开队列时在队列上指定的 DEFpresP 值中获取所使用的 put 响应类型。 如果客户机应用程序以低于 V 7.0的级别连接到队列管理器，那么它的行为就像指定了 PMSRES 一样。

如果为 MQPUT1 调用指定了此选项，那么不会使用队列定义中的 DEFpresP 值。 如果 MQPUT1 调用使用 PMSYP ，那么它的行为与 PMARES 相同，如果使用 PMNSYP ，那么它的行为与 PMSRES 相同。

PMRAST

这是与主题对象配合使用的 PMRASQ 的同义词。

这是一个输入字段。 PMOPT 字段的初始值为 PMNONE。

指示存在哪些 MQPMR 字段的标志。

此字段包含必须设置以指示应用程序提供的放入消息记录中存在哪些 MQPMR 字段的标志。 仅当将消息放入分发列表时，才会使用 PMPRF 。 如果 PMREC 为零，或者 PMPRO 和 PMPRP 均为零，那么将忽略该字段。

对于存在的字段，队列管理器将相应放置消息记录中的字段中的值用于每个目标。 对于不存在的字段，队列管理器使用 MQMD 结构中的值。

如果 PMPRF 包含无效的标志，或者提供了放置消息记录，但 PMPRF 的值为 PFNONE ，那么调用将失败并返回原因码RC2158.

这是一个输入字段。 此字段的初始值为 PFNONE。 如果 PMVER 小于 PMVER2，那么将忽略此字段。

从 MQPMO 开始的第一条放入消息记录的偏移量。

这是从 MQPMO 结构开始的第一个 MQPMR 放置消息记录的偏移量 (以字节为单位)。 偏移可以是正数或负数。 仅当将消息放入分发列表时，才会使用 PMPRO 。 如果 PMREC 为零，那么将忽略该字段。

不需要指定所有这些属性，但无论选择什么子集，都必须以正确的顺序指定字段。 请参阅 MQPMR 结构的描述以获取更多详细信息。

通常，打开分发列表时，应该有与 MQOD 指定的对象记录一样多的放置消息记录; 每个放置消息记录都提供相应对象记录所标识的队列的消息属性。 分发列表中未能打开的队列仍必须将为其分配的消息记录放在数组中的相应位置，尽管在这种情况下将忽略消息属性。

放入消息记录数可能与对象记录数不同。 如果放入消息记录少于对象记录，那么将从消息描述符 MQMD 中的相应字段中获取没有放入消息记录的目标的消息属性。 如果存在比对象记录更多的放置消息记录，那么不会使用多余的消息记录 (尽管仍必须可以访问这些消息记录)。 放置消息记录是可选的，但如果提供了这些记录，那么其中必须有 PMREC 个记录。

可以通过在 PMPRO中指定偏移量或在 PMPRP 中指定地址，以类似于 MQOD 中的对象记录的方式提供放置消息记录; 有关如何执行此操作的详细信息，请参阅 MQOD-对象描述符中描述的 ODORO 字段。

不能使用多个 PMPRO 和 PMPRP ; 调用失败，原因码为RC2159如果两者都是非零的。

这是一个输入字段。 此字段的初始值为 0。 如果 PMVER 小于 PMVER2，那么将忽略此字段。

第一条放入消息记录的地址。

这是第一个 MQPMR 放置消息记录的地址。 仅当将消息放入分发列表时，才会使用 PMPRP 。 如果 PMREC 为零，那么将忽略该字段。

可以使用 PMPRP 或 PMPRO 来指定放入消息记录，但不能同时指定两者; 请参阅 PMRRO 字段的描述以获取详细信息。 如果未使用 PMPRP ，那么必须将其设置为空指针或空字节。

这是一个输入字段。 此字段的初始值为空指针。 如果 PMVER 小于 PMVER2，那么将忽略此字段。

存在的放置消息记录或响应记录数。

这是应用程序提供的 MQPMR 放入消息记录或 MQRR 响应记录数。 仅当将消息放入分发列表时，此数字才能大于零。 放置消息记录和响应记录是可选的-应用程序无需提供任何记录，也可以选择仅提供一种类型的记录。 但是，如果应用程序提供了这两种类型的记录，那么它必须提供每种类型的 PMREC 记录。

PMREC 的值不必与分发列表中的目标数相同。 如果提供的记录过多，那么不会使用多余的记录; 如果提供的记录过少，那么会将缺省值用于没有放置消息记录的目标的消息属性 (请参阅本主题后面的 PMPRO )。

如果 PMREC 小于零或大于零，但消息未放入分发列表，那么调用将失败并返回原因码RC2154.

这是一个输入字段。 此字段的初始值为 0。 如果 PMVER 小于 PMVER2，那么将忽略此字段。

目标队列管理器的已解析名称。

这是本地队列管理器执行名称解析后的目标队列管理器的名称。 返回的名称是拥有由 PMRQN标识的队列的队列管理器的名称，并且可以是本地队列管理器的名称。

如果 PMRQN 是本地队列管理器所属的队列共享组所拥有的共享队列，那么 PMRMN 是队列共享组的名称。 如果队列由其他某个队列共享组拥有，那么 PMRQN 可以是队列共享组的名称，也可以是作为队列共享组成员的队列管理器的名称 (返回的值的性质由本地队列管理器中存在的队列定义确定)。

仅当对象是单个队列时，才会返回非空白值; 如果对象是分发列表或主题，那么返回的值未定义。

这是输出字段。 此字段的长度由 LNQMN 给出。 此字段的初始值为 48 个空白字符。

目标队列的已解析名称。

这是本地队列管理器执行名称解析后目标队列的名称。 返回的名称是由 PMRMN标识的队列管理器上存在的队列的名称。

仅当对象是单个队列时，才会返回非空白值; 如果对象是分发列表或主题，那么返回的值未定义。

这是输出字段。 此字段的长度由 LNQN 给出。 此字段的初始值为 48 个空白字符。

从 MQPMO 开始的第一个响应记录的偏移量。

这是从 MQPMO 结构开始的第一个 MQRR 响应记录的偏移量 (以字节为单位)。 偏移可以是正数或负数。 仅当将消息放入分发列表时，才会使用 PMRRO 。 如果 PMREC 为零，那么将忽略该字段。

将消息放入分发列表时，可以提供一个或多个 MQRR 响应记录的数组，以标识消息未成功发送到的队列 (MQRR 中的RRCC 字段) 以及每个失败的原因 (MQRR 中的RRREA 字段)。 可能由于队列未能打开或由于 put 操作失败而未发送消息。 仅当调用结果混合时，队列管理器才会设置响应记录 (即，某些消息已成功发送，而其他消息失败，或者所有消息都失败，但原因不同); 来自调用的原因码 RC2136 指示此情况。 如果相同原因码适用于所有队列，那么将在 MQPUT 或 MQPUT1 调用的 REASON 参数中返回该原因，并且不会设置响应记录。

通常，当打开分发列表时，应该有与 MQOD 指定的对象记录一样多的响应记录; 必要时，每个响应记录都设置为放入相应对象记录所标识的队列的完成代码和原因码。 分发列表中未能打开的队列仍必须在数组中的相应位置为它们分配响应记录，尽管它们设置为由打开操作而不是 put 操作生成的完成代码和原因码。

响应记录数可能与对象记录数不同。 如果响应记录少于对象记录，那么应用程序可能无法标识放置操作失败的所有目标或失败原因。 如果有比对象记录更多的响应记录，那么不会使用多余的响应记录 (尽管仍必须能够访问这些响应记录)。 响应记录是可选的，但如果提供了这些记录，那么其中必须有 PMREC 个记录。

可以通过类似于 MQOD 中的对象记录的方式提供响应记录，方法是在 PMRRO中指定偏移量，或者在 PMRRP 中指定地址; 有关如何执行此操作的详细信息，请参阅 MQOD-对象描述符中描述的 ODORO 字段。 但是，不能使用多个 PMRRO 和 PMRRP ; 调用失败，原因码为RC2156如果两者都是非零的。

对于 MQPUT1 调用，此字段必须为零。 这是因为响应信息 (如果请求) 是在对象描述符 MQOD 指定的响应记录中返回的。

这是一个输入字段。 此字段的初始值为 0。 如果 PMVER 小于 PMVER2，那么将忽略此字段。

第一个响应记录的地址。

这是第一个 MQRR 响应记录的地址。 仅当将消息放入分发列表时，才会使用 PMRRP 。 如果 PMREC 为零，那么将忽略该字段。

可以使用 PMRRP 或 PMRRO 来指定响应记录，但不能同时指定这两者; 请参阅 PMRRO 字段的描述以获取详细信息。 如果未使用 PMRRP ，那么必须将其设置为空指针或空字节。

对于 MQPUT1 调用，此字段必须是空指针或空字节。 这是因为响应信息 (如果请求) 是在对象描述符 MQOD 指定的响应记录中返回的。

这是一个输入字段。 此字段的初始值为空指针。 如果 PMVER 小于 PMVER2，那么将忽略此字段。

结构标识。

这始终是一个输入字段。 此字段的初始值为 PMSIDV。

此出版物以预订为目标的级别。

只有最高 PMSL 小于或等于此值的预订才会收到此发布内容。 此值必须在 0 到 9 的范围内; 零是最低级别。

此字段的初始值为 9。

已保留。

这是保留字段; 其值不重要。 此字段的初始值为 -1。

成功发送到远程队列的消息数。

这是当前 MQPUT 或 MQPUT1 调用已成功发送到分发列表中解析为远程队列的队列的消息数。 队列管理器在分发列表表单中临时保留的消息计数为这些分发列表包含的各个目标的数目。 将消息放入不在分发列表中的单个队列时，也会设置此字段。

这是输出字段。 此字段的初始值为 0。 如果 PMVER 小于 PMVER2，那么不会设置此字段。

结构版本号。

这始终是一个输入字段。 此字段的初始值为 PMVER1。