SET SYSTEM

説明

SET SYSTEM コマンドを使用して、 CICS システムの実行方法を制御するいくつかのオプションの値を変更します。

これらの値は、最初にシステム初期化パラメーターによって設定されます。 このコマンドでそれらの値に対応するシステム初期化パラメーターは、特に記載がない限り、同じまたは類似する名前が付けられています。 表 1 に、正確な対応をリストします。

オプション

AKP (データ値)

アクティビティー・キーポイント・トリガー値をフルワード・バイナリー値として指定します。これは、キーポイント間の CICS システム・ログ・ストリーム出力バッファーへの書き込み要求の数です。 数値は、ゼロ (キーポイント処理をオフにする)、または 50 から 65535 までの範囲にする必要があります。 CICS がキーポイント処理なしで (つまり、 AKPFREQ システム初期設定パラメーターをゼロに設定して) 初期設定された場合は、初期値をオーバーライドしてトリガー値を設定することができます。

DEBUGTOOL (cvda)

デバッグ・ツールの制御下で実行するプログラムを選択するためにデバッグ・プロファイルを使用するかどうかを示す、CVDA 値を指定します。 デバッグ・プロファイルを使用するデバッグ・ツールは、以下のとおりです。

• コンパイル言語アプリケーション・プログラム (COBOL、PL/I、C、C++、およびアセンブラーで作成されたプログラム) 用のデバッグ・ツール
• リモート・デバッグ・ツール (コンパイル済み言語アプリケーション・プログラムおよび Java™ プログラム用)

その他のデバッグ・メカニズム ( CICS 実行診断機能 (CEDF) など) は、デバッグ・プロファイルを使用しません。

CVDA 値は以下のとおりです。

DEBUG

CICS デバッグ・プロファイルを使用して、デバッグ・ツールの制御下で実行するプログラムを選択することを指定します。

NODEBUG

デバッガー・ツールの制御下で実行されるプログラムを選択するために、 CICS デバッグ・プロファイルを使用しないことを指定します。

デバッグ・プロファイルの使用について詳しくは、 デバッグ・プロファイルを参照してください。

DSALIMIT (データ値)

CICS が 16 MB 境界より下にある 4 つの個別の動的ストレージ域 (DSA) にストレージを割り振ることができる、ストレージの最大量 (バイト単位) をフルワード・バイナリー値で指定します。 DSALIMIT に現在の制限より小さい値が指定されている場合、 CICS は新しい制限をすぐには実装しない可能性がありますが、ストレージが解放されるにつれて実装しようとします。 DSALIMIT の範囲は 2 MB から 16 MB までです。 詳しくは、 DSALIM システム初期設定パラメーターを参照してください。

注: DSA の制限を動的に変更することは可能ですが、緊急事態に対処し、領域の循環を回避しようとしている場合を除き、変更しないことをお勧めします。 DSA の制限の変更は CICS の観点からは成功する可能性がありますが、制限を大きくすると、他の問題が発生する可能性があります。これは、DSA が大きくなると連続しなくなるためです。 MVS は、ストレージの割り振りを、高位の専用域から下方へ、低位の専用域から上方へと、両方とも行います。 DSA の制限を動的に増やすと、MVS 専用ストレージ域の中央に CICS によって割り振られる新しいストレージ部分が生じます。 この領域での MVS によるストレージの使用状況によっては、結果として S878 または S80A 異常終了のリスクが増大する可能性があります。

同様に、DSA 制限を動的に減らすと、実際には使用するためにストレージが MVS に戻される可能性がありますが、戻されるストレージがどこにあるかは確実ではなく、MVS が必要とする領域には存在しない可能性があります。

CICS 統計を定期的にモニターし、DSA 制限および MXT 制限を事前に調整します。

DSRTPROGRAM (データ値)

分散ルーティング・プログラムの 8 文字の名前を指定します。

DTRPROGRAM (データ値)

動的ルーティング・プログラムの 8 文字の名前を指定します。

DUMPING (cvda)

CICS システム・ダンプの取得を抑止するかどうかを示す CVDA 値を指定します。 CVDA 値は以下のとおりです。

NOSYSDUMP

システム・ダンプは抑制されます。

TABLEONLY

sdumps の取得を可能にする項目がダンプ・テーブル内にあるもの以外の、システム・ダンプを抑止します。

SYSDUMP

システム・ダンプは抑制されません。

EDSALIMIT (データ値)

CICS が、16 MB より上で 2 GB より下にある個々の動的ストレージ域にストレージを割り振ることができる、ストレージの最大量 (バイト単位) をフルワード・バイナリー値で指定します。 EDSALIMIT に現在の制限より小さい値が指定されている場合、 CICS は新しい制限をすぐには実装しない可能性がありますが、ストレージが解放されるにつれて実装しようとします。 詳しくは、 EDSALIM システム初期設定パラメーターを参照してください。

注: EDSA の制限を動的に変更することは可能ですが、緊急事態に対処し、領域の循環を回避しようとしている場合を除き、変更しないことをお勧めします。 EDSA の制限の変更は CICS の観点からは成功する可能性がありますが、制限を大きくすると、他の問題が発生する可能性があります。これは、EDSA が大きくなると連続しなくなるためです。 MVS は、ストレージの割り振りを、高位の専用域から下方へ、低位の専用域から上方へと、両方とも行います。 EDSA の制限を動的に増やすと、MVS 専用ストレージ域の中央に CICS によって割り振られる新しいストレージ部分が生じます。 この領域での MVS によるストレージの使用状況によっては、結果として S878 または S80A 異常終了のリスクが増大する可能性があります。

同様に、EDSA 制限を動的に減らすと、実際には使用するためにストレージが MVS に戻される可能性がありますが、戻されるストレージがどこにあるかは確実ではなく、MVS が必要とする領域には存在しない可能性があります。

CICS 統計を定期的にモニターし、EDSA 制限および MXT 制限を事前に調整します。

FORCEQR (cvda)

CICS が、CONCURRENCY (QUASIRENT) プログラムとして指定されたかのように、CONCURRENCY (THREADSAFE) として指定されたすべてのユーザー・アプリケーション・プログラムを CICS QR TCB の下で実行するように強制するかどうかを指定します。

このオプションを使用して、テスト環境で、非スレッド・セーフであることが実証された、完全にはテストされていないスレッド・セーフ・アプリケーション・プログラムを実行することができます。

FORCEQR オプションは、スレッド・セーフとして定義された、タスク関連ユーザー出口、グローバル・ユーザー出口、またはユーザー置き換え可能モジュールとして呼び出されない、すべてのプログラムに適用されます。

CVDA 値は以下のとおりです。

FORCE

CONCURRENCY(THREADSAFE) 属性を使用して定義されている場合でも、すべての CICSAPI ユーザー・アプリケーション・プログラムを QR TCB の下で強制的に実行します。 この強制は、特定のプログラム、例えば OPENAPI プログラムや XPLINK でコンパイルされた C/C++ プログラムなどには適用されません。 詳しくは、 FORCEQR システム初期設定パラメーターを参照してください。

NOFORCE

CICS は、プログラム・リソース定義で定義された CONCURRENCY (THREADSAFE) 属性を受け入れ、QR TCB またはオープン TCB のいずれかの下でそれらを呼び出します。

このオプションを使用して、FORCEQR システム初期設定パラメーターで指定されたオプションを動的に変更できます。

このオプションに対する変更は、現在呼び出されているプログラムには適用されず、FORCEQR 状況の変更後に最初に呼び出されたプログラムだけに適用されます。

GMMLENGTH (データ値)

good morning メッセージ・テキストの長さをハーフワード・バイナリー値で指定します。 この値の範囲は 1 から 246 までです。

GMMTEXT (データ値)

good morning メッセージ・テキストを指定します。このメッセージ・テキストの長さは最大 246 文字です。

LOGDEFER (データ域)

ログ延期間隔をハーフワード・バイナリー値で指定します。 ログ延期間隔は、MVS システム・ロガーを呼び出す前に強制ジャーナル書き込み要求を遅延させる期間を決定するために CICS ログ・マネージャーが使用する期間です。 値の範囲は 0 から 65535 です。 LOGDEFER パラメーターおよび関連する LGDFINT システム初期設定パラメーターについては、 LGDFINT システム初期設定パラメーターを参照してください。

MAXTASKS (データ値)

この CICS システムで一度にディスパッチに適格にできるタスクの最大数を、フルワード・バイナリー値で指定します。 アクティブなタスクと中断状態のタスクのどちらもこの制限に考慮されますが、初期ディスパッチ点に達していないタスクは考慮されません。 端末管理タスクやジャーナル管理タスクなどのシステム・タスクは考慮されません。 値の範囲は 10 から 2000 までです。

MROBATCH (データ値)

CICS が処理のために明示的に通知される前に、 CICS が待機している MRO および DASD 入出力イベントのリストから発生する必要があるイベントの数をフルワード・バイナリー値で指定します。 値の範囲は 1 から 255 までです。

NEWMAXTASKS (データ域)

MAXTASKS の新規の値をフルワード・バイナリー形式で返します。

SET SYSTEM コマンドを使用して MAXTASKS 値を設定するときに、要求した値に十分なストレージがない場合、 CICS は NOSTG 条件を発生させ、コマンドの処理を続行し、指定した値から値を削減します。 NEWMAXTASKS は、そのような調整後の値を示します。

PROGAUTOCTLG (cvda)

自動インストールされたプログラム定義をカタログするかどうか、およびいつカタログするかを指定します。 カタログされた定義は、ウォーム・リスタートまたは緊急時再始動時に復元されます。 カタログされていない定義はシャットダウン時に破棄されるため、後で CICSを実行するときに使用する場合は、再度インストールする必要があります。

カタログするかどうかの決定は、初期インストール時と自動インストールされた定義の変更時の両方で行われ、そのときの PROGAUTOCTLG の値に基づきます。 CVDA 値は以下のとおりです。

CTLGALL

定義は、インストールされ変更されたときにカタログされます。

CTLGMODIFY

定義は変更時にのみカタログされます。

CTLGNONE

定義はカタログされません。

PROGAUTOEXIT (データ値)

CICS プログラムの自動インストール・コードがモデル定義を提供するために呼び出す、ユーザー提供のプログラムの 8 文字の名前を指定します。

注: このプログラム (およびこのプログラムが呼び出すすべてのプログラム) は、明示的な PROGRAM 定義によって、または別の自動インストール・プログラムが有効な場合は自動インストールによって、プログラム自動インストール・プロセスで使用する前にインストールする必要があります。 そうでない場合、プログラムの自動インストール・プロセスは、次に使用されるときに失敗し、 CICS はそれを非アクティブにします。

PROGAUTOINST (cvda)

プログラムの自動インストールがアクティブであるか非アクティブであるかを指定します。 定義されていないプログラム、マップ・セット、または区画セットをタスクが要求すると、 CICS は、プログラムの自動インストールがアクティブである場合に、その定義を自動的に作成しようとします。 そうでない場合、 CICS は PGMIDERR 例外条件を出します。 CVDA 値は以下のとおりです。

AUTOACTIVE

プログラムの自動インストールはアクティブです。

AUTOINACTIVE

プログラムの自動インストールがアクティブです。

PRTYAGING (データ値)

CICS がディスパッチを待機するタスクの優先順位を上げる率をフルワード・バイナリー値で指定します。 ディスパッチなしの待ち時間の PRTYAGING 値によって設定されるミリ秒ごとに、 CICS はタスク優先順位を 1 ずつ増やします。 値は 0 から 65535 までの範囲の値である必要があります。

RUNAWAY (データ値)

デフォルトのランナウェイ・タスク時間を、ミリ秒単位のフルワード・バイナリー値として指定します。 この値は、ランナウェイ・タスク時間を指定しないプロファイルを使用してトランザクションを実行するすべてのタスクに使用されます ( INQUIRE TRANSACTION コマンドの RUNAWAY オプション ( INQUIRE TRANSACTION options-RUNAWAY) を参照してください)。

値はゼロ (デフォルト値を使用するタスクではランナウェイ・タスクの検出が不要) にするか、250 から 2700000 までの範囲にする必要があります。 指定する値は、250 の倍数に切り捨てられます。

SCANDELAY (データ値)

ICVTSD システム初期設定パラメーターによって初期設定される、 CICS 領域の端末スキャン遅延値をミリ秒単位でフルワード・バイナリー値で指定します。 デフォルトの設定値は ゼロです。 値は 0 から 5000 までの範囲の値である必要があります。 以前のリリースでは、端末スキャン遅延機能を使用して、要求を処理するためのオーバーヘッドを分散させるために、 CICS がアプリケーションによって行われたいくつかのタイプの端末出力要求を処理する速度を制限していました。 CICS システムが非 SNA ネットワークを使用する状況では、ゼロ以外の値を指定することが適切な場合もありました。 ただし SNA および IPIC ネットワークでは、応答時間を向上させ、仮想ストレージを最良の方法で使用するには、ICVTSD を 0 に設定するのが適切です。

TIME (データ値)

ディスパッチの準備ができているタスクがない場合に、 CICS がオペレーティング・システムに制御を渡す最大間隔をミリ秒単位のフルワード・バイナリー値で指定します。 この値は最初は ICV システム初期設定オプションによって設定され、領域終了時間間隔と呼ばれることがあります。 TIME 値は 100 から 3600000 までの範囲で、SCANDELAY の値以上でなければなりません。 現行の SCANDELAY 値を判定するには、INQUIRE SYSTEM SCANDELAY コマンドを使用します。

条件

INVREQ

RESP2 値:

1

MAXTASKS 値が範囲外です。

3

AKP 値が範囲外です。

5

TIME が 100–3600000 の範囲内ではありません。

6

RUNAWAY 値が範囲外です。

7

MROBATCH が 1–255 の範囲内ではありません。

9

DUMPING には無効な CVDA 値があります。

12

AKP が指定されましたが、 CICS はキーポイント処理なしで初期化されました。

13

TIME が SCANDELAY より小さくなっています。

14

PRTYAGING が 0–65535 の範囲内ではありません。

15

SCANDELAY が 0–5000 の範囲内ではありません。

20

DSALIMIT が 2 MB から 16 MB の範囲内ではありません。

21

EDSALIMIT が 48MB から 2047MB の範囲内ではありません。

22

DSALIMIT を割り振るための MVS ストレージが不足しています。

23

MVS ストレージが不足しているため、EDSALIMIT を割り振ることができません。

29

LOGDEFER 値が範囲外です。

30

MAXSOCKETS が 1-65535 の範囲内ではありません。

LENGERR

RESP2 値:

20

GMMLENGTH 値が範囲外です。

NOSTG

RESP2 値:

16

CICS は、ストレージの制約のために MAXTASKS に対して要求した値を削減しました。NEWMAXTASKS オプションを参照してください。

NOTAUTH

RESP2 値:

100

発行中のタスクに関連付けられているユーザーは、このコマンドの使用が許可されていません。

NOTSUPERUSER

RESP2 値:

15

CICS ジョブを実行しているユーザー ID にスーパーユーザー権限がないため、 CICS は MAXSOCKETS を要求された値に設定できませんでした。 CICS は、 SYS1.PARMLIB メンバー BPXPRMxx。