z/OS での DEFINE STGCLASS (ストレージ・クラスからページ・セットへのマッピングの定義)

ストレージ・クラスをページ・セット・マッピングに定義するには、MQSC コマンド DEFINE STGCLASS を使用します。

z/OS での MQSC コマンドの使用

z/OS®で MQSC コマンドを使用する方法については、 IBM® MQ for z/OSで MQSC コマンドおよび PCF コマンドを発行できるソースを参照してください。

このコマンドは、ソースの 2CR から実行できます。ソースのシンボルの説明については、 IBM MQ for z/OSで MQSC および PCF コマンドを発行できるソースを参照してください。

構文図
DEFINE STGCLASS の使用上の注意
DEFINE STGCLASS のパラメーターの説明

同義語: DEF STC

構文図の主線の上に示されている値は、 IBM MQで提供されているデフォルトですが、ご使用のシステムで変更されている可能性があります。これらの図の使用法については、「構文図の読み方」を参照してください。

DEFINE STGCLASS

注:

¹ キュー・マネージャーがキュー共有グループのメンバーである場合に、 z/OS でのみ有効です。

DEFINE STGCLASS の使用上の注意

XCFGNAME および XCFMNAME の結果として生じる値は、両方ともブランクであるか、両方ともブランクでないかのいずれかです。
ストレージ・クラスは、どのキューでも使用されていない場合にのみ変更できます。ストレージ・クラスを使用しているキューがあるかどうかを判別するには、次のコマンドを使用します。
```
DISPLAY QUEUE(*) STGCLASS(ABC) PSID(n)
```
「ABC」はストレージ・クラスの名前であり、n はストレージ・クラスが関連付けられているページ・セットの ID です。

このコマンドを実行すると、ストレージ・クラスを参照しかつページ・セット n へのアクティブな関連付けを持つすべてのキューのリストが返されるので、ストレージ・クラスへの変更を実際に妨げているキューが特定されます。 PSID を指定しない場合、変更を停止している可能性のあるキューのリストだけが表示されます。

ページ・セットへのキューのアクティブな関連付けについて詳しくは、 DISPLAY QUEUE PSID コマンドを参照してください。

DEFINE STGCLASS のパラメーターの説明

(ストレージ・クラス)

ストレージ・クラスの名前。

この名前は 1 から 8 文字です。先頭文字は A から Z までの範囲です。その後は、A から Z まで、または 0 から 9 までの文字です。

注: 例外的に、数値のストレージ・クラス名はすべて許可されますが、 IBM サービス担当員が使用するために予約されています。

このキュー・マネージャーに現在定義されている他のストレージ・クラスと同じストレージ・クラスを指定してはなりません。

CMDSCOPE

このパラメーターは、キュー・マネージャーがキュー共有グループのメンバーである場合に、どのようにコマンドを実行するのかを指定します。

CMDSCOPE はブランクにする必要があります。ただし、QSGDISP が GROUP に設定されている場合には、ローカル・キュー・マネージャーにする必要があります。

' ': コマンドは、コマンドが入力されたキュー・マネージャーで実行されます。
qmgr-name: コマンドは、指定したキュー・マネージャーで実行されます。ただし、そのキュー・マネージャーは、キュー共有グループ内でアクティブである必要があります。
共有キュー環境を使用しており、コマンド・サーバーが使用可能である場合のみ、コマンドが入力されたキュー・マネージャーとは別のキュー・マネージャー名を指定できます。
*: コマンドはローカル・キュー・マネージャーで実行され、キュー共有グループ内のすべてのアクティブ・キュー・マネージャーにも渡されます。 * は、キュー共有グループ内のすべてのキュー・マネージャーでコマンドを入力するのと同じ結果をもたらします。

DESCR ( 説明 )

平文コメント。オペレーターが DISPLAY STGCLASS コマンドを実行したときに表示される、このオブジェクトについての記述情報です。

表示可能文字だけを含めることができます。最大長は 64 文字です。 DBCS のインストール済み環境では、この値に DBCS 文字 (最大長 64 バイト) を使用できます。

注: このキュー・マネージャーのコード化文字セット ID (CCSID) に含まれていない文字が使用されている場合、情報が別のキュー・マネージャーに送信されると、正しく変換されない可能性があります。

LIKE(stgclass-name)

同じタイプのオブジェクトの名前。この定義をモデル化するために使用するパラメーターと共に指定します。

このフィールドが入力されておらず、コマンドに関連するパラメーター・フィールドを入力していない場合には、値はこのオブジェクトのデフォルト定義から取得されます。

このパラメーターを入力しない場合、次のように指定したことに相当します。

LIKE(SYSTEMST)

このデフォルトのストレージ・クラス定義は、インストール環境ごとに必要なデフォルト値に変更できます。

キュー・マネージャーは指定した名前と、QMGR または COPY の属性指定を持つオブジェクトを検索します。 LIKE オブジェクトの属性指定は、定義しているオブジェクトにはコピーされません。

注:

QSGDISP (GROUP) オブジェクトは検索されません。
QSGDISP(COPY) が指定された場合、LIKE は無視されます。

PASSTKTA(application name)

MQIIH ヘッダーで指定された PassTicket の認証時に RACF® に渡されるアプリケーション名。

PSID ( 整数 )

このストレージ・クラスが関連付けられるページ・セット ID。

注: ページ・セットが定義されているかどうかの検査は行われません。このストレージ・クラスを指定するキューにメッセージを書き込もうとすると (MQRC_PAGESET_ERROR)、エラーが発生します。

ストリングは、00 から 99 の範囲の 2 つの数字で構成されます。 z/OSを参照してください。

QSGDISP

グループ内のオブジェクトの属性指定を指定します。

表 1. QSGDISP オプションのオブジェクト属性指定
QSGDISP	DEFINE
COPY	オブジェクトは、コマンドを実行するキュー・マネージャーのページ・セットで定義されます。 LIKE オブジェクトと同じ名前の QSGDISP(GROUP) オブジェクトを使用します。例えば、下記のコマンドを実行した場合、 `DEFINE STGCLASS(storage_class_name) REPLACE QSGDISP(COPY)` キュー・マネージャーは、共有構成リポジトリーで `storage_class_name`という名前の `STGCLASS` 定義を検索します。一致する`STGCLASS`定義が見つかった場合、キュー・マネージャーは、この定義のローカル・コピーをキュー・マネージャーのページ・セットに作成します。ローカル・キューの場合、メッセージは各キュー・マネージャーのページ・セットに保管され、そのキュー・マネージャーを介してのみ使用できます。
GROUP	オブジェクト定義は、共有構成リポジトリーにあります。 QSGDISP(GROUP) は、キュー・マネージャーがキュー共有グループ内にある場合のみ許可されます。 QSGDISP(GROUP)オブジェクトのDEFINE が正常に実行されると、 `DEFINE STGCLASS(storage_class_name) REPLACE QSGDISP(COPY)` コマンドが生成され、キュー共有グループ内のすべてのアクティブなキュー・マネージャーに送信されて、ページ・セット 0 上のローカル・コピーが作成またはリフレッシュされます。グループ・オブジェクトに対する DEFINE は、QSGDISP(COPY) で生成されたコマンドが失敗したかどうかに関係なく有効になります。
PRIVATE	許可されません。
QMGR	オブジェクトは、コマンドを実行するキュー・マネージャーのページ・セットで定義されます。

REPLACE および NOREPLACE

属性指定が同じである既存の定義をこの定義で置き換えるかどうかを判別します。属性指定が異なるオブジェクトは変更されません。

REPLACE: 同名の定義が既に存在すれば、この定義で置き換えます。定義が存在しない場合は作成されます。
REPLACE オプションを使用する場合、コマンドを発行する間は、このストレージ・クラスを使用するすべてのキューが別のストレージ・クラスを使用するように一時的に変更する必要があります。
NOREPLACE: 同名の定義が既に存在していても、この定義で置き換えません。

XCFGNAME(group name)

IMS ブリッジを使用している場合、この名前は、 IMS システムが属している XCF グループの名前です。 (この名前は、IMS パラメーター・リストに指定されたグループ名です。)

この名前は 1 から 8 文字です。先頭文字は A から Z までの範囲です。その後は、A から Z まで、または 0 から 9 までの文字です。

XCFMNAME(member name)

IMS ブリッジを使用している場合、この名前は XCFGNAME で指定された XCF グループ内の IMS システムの XCF メンバー名です。 (この名前は、IMS パラメーター・リストに指定されたメンバー名です。)

この名前は 1 から 16 文字です。先頭文字は A から Z までの範囲です。その後は、A から Z まで、または 0 から 9 までの文字です。