SubName (MQCHARV) (MQSD の場合)

これはサブスクリプション名を指定します。 このフィールドは、Options でオプション MQSO_DURABLE が指定されているものの、提供内容が MQSO_NON_DURABLE に関するキュー・マネージャーでも使用される場合のみ必須です。

指定する場合は、SubName はサブスクリプションの識別に使用する方式なので、キュー・マネージャー中で固有でなければなりません。

SubName の最大長は 10240 です。

このフィールドは 2 つの目的を果たします。 MQSO_DURABLE サブスクリプションの場合、このフィールドを使用してサブスクリプションを識別し、サブスクリプションに対するハンドルをクローズした場合 (MQCO_KEEP_SUB オプションを使用) か、キュー・マネージャーから切断された場合に、サブスクリプションの作成後に再開できるようにします。 この処理は MQSO_RESUME オプションを指定した MQSUB 呼び出しを使用して行われます。 また、DISPLAY SBSTATUS の SUBID フィールドのサブスクリプションの管理ビューにも表示されます。

MQCHARV 構造体の使用法の説明に従って SubName が正しく指定されていない場合は、必要に応じて省略されます (つまり、 SubName)。 VSLength がゼロである場合) 、またはこれが最大長を超える場合、呼び出しは失敗し、理由コード MQRC_SUB_NAME_ERROR が戻ります。

これは入力フィールドです。 この構造体のフィールドの初期値は、MQCHARV 構造体のものと同じです。

MQSO_ALTER オプションを使用して既存のサブスクリプションを変更する場合、サブスクリプション名は、参照されているサブスクリプションの検索に使用する識別フィールドなので、変更できません。 MQSO_RESUME オプションを指定した MQSUB 呼び出しからの出力上で変更されません。