[z/OS]

z/OS での SET SYSTEM (システム設定の変更)

キュー・マネージャーの始動時にシステム・パラメーター・モジュールから最初に設定された、特定の一般システム・パラメーター値を動的に変更するには、MQSC コマンド SET SYSTEM を使用します。 これらを永続的に変更するには、CSQ6SYSP パラメーターを変更してパラメーター・モジュールを再生成するか、または CSQINP2 連結のデータ・セットに SET SYSTEM コマンドを組み込みます。

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

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

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

同義語: なし

SET SYSTEM

構文図を読むビジュアル構文図をスキップ SET SYSTEM DEFAULTパラメーター・ブロック CMDSCOPE(' ')CMDSCOPE(qmgr-name)1CMDSCOPE(*)1
Parameter Block
構文図を読むビジュアル構文図をスキップACCTIME(文字)ACELIM(integer)EXCLMSG(文字)LOGLOAD(integer)SERVICE(文字)STATIME(文字)TRACTBL(integer)
注:
  • 1 キュー・マネージャーがキュー共有グループのメンバーである場合にのみ有効。

CTHREAD、IDFORE、および IDBACK パラメーターは、 IBM WebSphere® MQ 7.1 以降では無視されますが、以前のバージョンとの互換性のために引き続き許可されています。 そのいずれかのパラメーターの値を変更しようとすると、デフォルト値の 32767 に設定されます。

SET SYSTEM の使用上の注意

新しい値は即時に有効になります。ただし、STATIME、 [MQ 9.3.0 Jul 2021]ACCTIME、 および TRACTBL は例外です。

STATIME [MQ 9.3.0 Jul 2021]および ACCTIME に対する変更は、現在の間隔が満了したときに有効になります。ただし、新しい間隔が現在の間隔の満了していない部分より小さい場合は例外です。この場合、SMF データは即時に収集され、新しい間隔が有効になります。

TRACTBL の場合は、現時点で有効なトレースがあると、既存のトレース・テーブルが引き続き使用され、サイズも変更されません。 新しいグローバル・トレース・テーブルが取得されるのは、新しい START TRACE コマンドの場合に限られます。 新しいトレース・テーブルの作成に使用するストレージが十分ではない場合、以前のトレース・テーブルが引き続き使用され、メッセージ CSQW153E が表示されます。

SET SYSTEM のパラメーターの説明

CMDSCOPE
このパラメーターは z/OS にのみ適用され、キュー・マネージャーがキュー共有グループのメンバーである場合のコマンドの実行方法を指定します。
' '
コマンドは、コマンドが入力されたキュー・マネージャーで実行されます。 これがデフォルト値です。
qmgr-name
コマンドは、指定したキュー・マネージャーで実行されます。ただし、そのキュー・マネージャーは、キュー共有グループ内でアクティブである必要があります。

キュー共有グループ環境を使用しており、コマンド・サーバーが使用可能である場合のみ、コマンドを入力したキュー・マネージャーとは別のキュー・マネージャー名を指定できます。 最初の初期設定入力データ・セット CSQINP1 から実行するコマンドで CMDSCOPE(qmgr-name) を使用することはできません。

*
コマンドはローカル・キュー・マネージャーで実行され、キュー共有グループ内のすべてのアクティブ・キュー・マネージャーにも渡されます。 これは、キュー共有グループ内のすべてのキュー・マネージャーでコマンドを入力するのと同じ結果をもたらします。

CSQINP1 から実行するコマンドで CMDSCOPE(*) を使用することはできません。

デフォルト
すべての一般システム・パラメーターを、キュー・マネージャーの始動時に設定された値にリセットします。

パラメーター・ブロック

[z/OS]これらのパラメーターの詳細については、 CSQ6SYSPの使用を参照してください。

パラメーター・ブロックでは、以下のパラメーターのうち、変更するパラメーターを 1 つ以上指定します。
[MQ 9.3.0 Jul 2021]ACCTIME
アカウンティング・データの連続収集の間隔 (分と秒) を指定します。
0 から 1440 分の範囲の数値を 'mmmm'の形式で指定するか、 0 から 1439 分および 0 から 59 秒の範囲の数値を 'mmmm.ss'の形式で指定します。 デフォルトは 30 分です。
-1または 0 から 1440 分の範囲の数値を 'mmmm'の形式で指定するか、 0 から 1439 分 0 から 59 秒の範囲の数値を 'mmmm.ss'の形式で指定します。
注:
  • 秒のみの間隔を指定する場合は、間隔値に接頭部として 0 の値を付加する必要があります。 指定可能な最小の間隔は 1 秒 ('0.01') です。
  • 0 の値を指定した場合、アカウンティング・データが SMF データ収集ブロードキャストで収集されます。 詳しくは、 システム管理機能の使用 を参照してください。
  • 値 -1 (デフォルト) を指定すると、アカウンティング・データは STATIME 値を使用して収集されます。
以下に例を示します。
  • '0.30' は、30 秒の間隔を設定します。
  • '5.30' は、5 分 30 秒の間隔を設定します。
  • '30' は、30 分の間隔を設定します。
ACELIM
ACE ストレージ・プールの最大サイズを指定します (1 KB ブロック単位)。 この数値は 0 から 999999 の範囲でなければなりません。 デフォルト値である 0 は、システムで使用できるサイズ以外の制約は課されないことを意味します。

ACELIM の値は、適正な範囲を超えた量の ECSA ストレージを使用していると見なされているキュー・マネージャーに対してのみ設定する必要があります。 ACE ストレージ・プールを制限すると、システム内の接続数が制限されるという影響があるため、キュー・マネージャーで使用される ECSA ストレージの量も制限されます。

キュー・マネージャーが制限に達すると、アプリケーションは新しい接続を取得できなくなります。 新しい接続がないと MQCONN の処理で障害が発生し、RRS によって調整されるアプリケーションでは、どの IBM MQ API でも障害が発生する可能性があります。

ACE は、接続のスレッド関連制御ブロックに必要な全体の ECSA の約 12.5% を表します。 したがって、例えば、 ACELIM=5120 を指定すると、キュー・マネージャーによって割り振られる ECSA の総量 (スレッド関連制御ブロックの場合) の上限は、約 40960K; (5120 x 8) になります。

スレッド関連制御ブロック用にキュー・マネージャーによって割り振られる ECSA の総量の上限を 5120Kに設定するには、ACELIM 値を 640 に設定する必要があります。

統計 CLASS(3) のトレースで生成される SMF 115 サブタイプ 5 のレコードを使用して、「ACE/PEB」ストレージ・プールのサイズをモニターできます。これにより、ACELIM に適切な値を設定できます。

キュー・マネージャーが制御ブロックに使用する ECSA ストレージの合計量を、統計 CLASS(2) トレースによって書き込まれる SMF 115 サブタイプ 7 のレコードから取得できます。 使用される ECSA ストレージの合計の量は、QSRSPHBGF および QSRSPHBGV フィールドの合計です。

SMF 115 統計レコードについて詳しくは、 IBM MQ パフォーマンス統計の解釈を参照してください。

ACELIM の設定は、キュー・マネージャーへのアプリケーション接続を制御する手段としてではなく、キュー・マネージャーの誤動作から z/OS イメージを保護する手段として検討する必要があります。

EXCLMSG
ログへの書き込み時に除外するメッセージ ID のリストを指定します。 このリストのメッセージは、 z/OS コンソールおよびハードコピー・ログには送られません。 結果として、EXCLMSG パラメーターを使用してメッセージを除外する方が、メッセージ処理機能リストなどの z/OS メカニズムを使用するよりも CPU の観点から見ると効率的で、可能な場合は代わりに使用する必要があります。 このリストは動的であり、SET SYSTEM コマンドを使用して更新されます。

デフォルト値は空のリスト ( ) です。

メッセージ ID は、CSQ 接頭部なし、およびアクション・コード接尾部 (I-D-E-A) なしで指定します。 例えば、メッセージ CSQX500I を除外するには、このリストに X500 を追加します。 このリストには、最大 16 のメッセージ ID を含めることができます。

リストに含める対象にできるメッセージは、MSTR または CHIN アドレス・スペースの正常始動後に発行され、かつ、先頭文字が E、H、I、J、L、M、N、P、R、T、V、W、X、Y、2、3、5、9 のいずれかの文字であるものです。

コマンド処理結果として発行されるメッセージ ID をリストに追加できますが、除外されません。

以下に例を示します。
SET SYSTEM EXCLMSG(X511,X512)
チャネルが開始したことを示すメッセージと、チャネルがアクティブでなくなったことを示すメッセージを抑制します。
LOGLOAD
1 つのチェックポイントの開始から次のチェックポイントの開始までの間に IBM MQ が書き込むログ・レコードの数を指定します。 IBM MQ は、指定された数のレコードが書き込まれた後で、新しいチェックポイントを開始します。

200 から 16 000 000 の範囲の値を指定してください。

SERVICE
このパラメーターは IBM による使用のために予約済みです。
STATIME
[MQ 9.3.0 Jul 2021] 「開始」 IBM MQ for z/OS 9.2.4は、統計データを連続して収集する間隔を分と秒で指定します。 ACCTIME が設定されていないか、-1 に設定された場合は、アカウンティング・データの連続収集の時間間隔も指定します。

0 の値を指定した場合、データが SMF データ収集ブロードキャストで収集されます。

0 から 1440 分の範囲の数値を 'mmmm'の形式で指定するか、 0 から 1439 分および 0 から 59 秒の範囲の数値を 'mmmm.ss'の形式で指定します。 デフォルトは 30 分です。

-1または 0 から 1440 分の範囲の数値を 'mmmm'の形式で指定するか、 0 から 1439 分 0 から 59 秒の範囲の数値を 'mmmm.ss'の形式で指定します。
注: 秒の間隔のみを指定する場合は、間隔の前に 0の値を付ける必要があります。 指定可能な最小の間隔は 1 秒 ('0.01') です。
以下に例を示します。
  • '0.30' は、30 秒の間隔を設定します。
  • '5.30' は、5 分 30 秒の間隔を設定します。
  • '30' は、30 分の間隔を設定します。
TRACTBL
グローバル・トレース機能が IBM MQ トレース・レコードを保管するトレース表のデフォルト・サイズを 4 KB ブロック単位で指定します。

1 ～ 999 の範囲の値を指定してください。

注: トレース・テーブルのストレージは ECSA に割り振られます。 したがって、この値の選択は慎重に行ってください。