IMS 固有の環境変数

本トピックでは、IMS 環境の構成に関連する環境変数の一覧を示します。

ES_ACBLIB

IMS ACB ファイルの場所を指定します。

構文

SET ES_ACBLIB={pathname

値

pathname IMS ACB ファイルのパス ロケーション。

デフォルト

この変数が設定されていない場合、ACB ファイルはプロジェクト ディレクトリ内にあると想定されます。

ES_DFS3650

IMS への正常なサインオン後に実行するデフォルト トランザクションまたは表示される MOD ファイル。これらを指定するには、リージョンの起動前に環境変数を設定します。ES_DFS3650 - MOD ファイルを送信する場合は MOD に設定し、トランザクションを実行する場合は TRX に設定します。MOD に設定する場合は、ES_MOD3650 を表示する MOD の名前に設定する必要があります。TRX に設定する場合は、ES_TRX3650 をトランザクションの名前に設定する必要があります。

構文

ES_DFS3650=value

値

• MOD - ES_MOD3650 を表示する MOD の名前に設定する必要があります。
• TRX - ES_TRX3650 をトランザクションの名前に設定する必要があります。

デフォルト

デフォルトのトランザクションまたは MOD はありません。

ES_IMS_BASIC_CHKP_OPT

1 に設定すると、SYNC 呼び出しが発行されたかのように基本チェックポイント呼び出しを処理できます。デフォルトは 0 (ゼロ) です。

ES_IMS_BYPASS_OTMA_DEST_RES

デフォルトでは、OTMA または IMS Connect によってサブミットされたトランザクションから発行された CHNG 呼び出しでは、宛先が OTMA クライアントであると想定します。場合によっては、非 OTMA クライアントを前提とする以前の動作が望ましいこともあります。以前の動作を使用するには、この環境変数を Y に設定します。

値：

• Y
• N (デフォルト)

例

ES_IMS_BYPASS_OTMA_DEST_RES=Y

ES_IMS_CLIENTID_LTERM

デフォルトでは、IMS Connect 要求は、コミット モードがゼロの場合は LTERM (明示的にオーバーライドされない場合) をクライアント ID に設定し、コミット モードが 1 の場合はポート ID に設定します。この変数を「Y」に設定すると、LTERM がポート ID ではなくクライアント ID に設定されるようにこの動作がオーバーライドされます。

値：

• Y
• N (デフォルト)

ES_IMS_CONFIG

IMS TM パラメーター。

ES_IMS_DB_COMMIT_FLUSH

0 (ゼロ) に設定すると、データベース バッファーからディスクへのフラッシュが CLOSE 時にのみ強制されます (デフォルト)。1 に設定すると、データベース バッファーからディスクへのフラッシュが COMMIT 時にのみ強制されます。

ES_IMS_DB_TLOG_WRITETHRU

0 (ゼロ) に設定すると、TLOG バッファーからディスクへのフラッシュが COMMIT 時にのみ強制されます (デフォルト)。1 に設定すると、TLOG バッファーからディスクへのフラッシュがすべてのデータベース入出力時に強制されます。

ES_IMS_DEADLOCK_WAIT

デッドロックが発生していないかをチェックするまでの待機時間 (ミリ秒単位)。デフォルトは 1000 (1 秒) です。

ES_IMS_DIAGNOSE

IMS TM を IMSMSGQ 専用の診断モードとしてマークします。

Y に設定すると、トランザクション マネージャー (TM) が診断モード専用になり、アクティビティの重要なポイントがメッセージ キューに書き込まれなくなります。

注意:

ES_IMS_DIAGNOSE を設定するのは、Micro Focus から勧められた場合だけにしてください。

ES_IMS_DOSVS_PCB

EXEC DLI プログラムの DOS/VSE PCB アドレス整列をエミュレートします。

ES_IMS_DUMP_ON_DEADLOCK

デッドロックが検出された際にシステム ダンプを作成します。

ES_IMS_DUMP_ON_TIMEOUT

ロックのタイムアウトが発生した際にシステム ダンプを作成します。

ES_IMS_EXITPATH

セグメント出口、フィールド出口、印刷出口を含むコンパイル済みコードの場所。

ES_IMS_FORCE_SIGNON

現在の端末での IMS へのサインオンおよび他の端末からのサインオフを強制できるようにします。

ES_IMS_GOTO_CICS_ON_SIGNOFF

ログオフまたはタイムアウト時に、IMS サインオン画面に戻る (デフォルトの動作) 代わりに CICS に戻ります。

ES_IMS_IBMPLATFORM

IMS ランタイムのエミュレーションを設定します。有効な値は、M (MVS) または D (DOSVS) です。デフォルト値は M です。

注: 大多数の DOSVS ユーザーの場合も、この変数のデフォルトからの変更が必要となることはほとんどありません。

ES_IMS_IMSID

AIBTDLI INQY ENVIRON 呼び出しに返される IMS システム ID を指定できるようにします。

ES_IMS_INQY_OTMA

INQY 呼び出しに TPIPE、MBR、SYNC、および MSYNC を返します。

ES_IMS_INQY_UNKNOWN

INQY 呼び出しに返される値。

ES_IMS_IRLM

Internal Resource Lock Manager (IRLM) ロッキングを有効にします。IRLM ロッキングは、メインフレーム IMS データベース DB ロッキングの動作と非常に似ており、データ制約およびデッドロックの可能性を削減します。

ES_IMS_JES_DIRTY_ABEND

デフォルト設定は Y です。IMS アプリケーションが異常終了または異常終了した場合、IMS は JES コンテナーをダーティとしてマークします。この動作を無効にするには、この環境変数を N に設定します。

ES_IMS_JES_DIRTY_ABEND=N

ES_IMS_LOCALDLI

非推奨。「IMS データベース ロッキング」を参照してください。1 に設定すると、JES イニシエーターですべての IMS DB 呼び出しを処理するバッチ プログラムの実行が指示され、パフォーマンスが大幅に向上します。実行前に、バッチ プログラムからアクセスされるすべての IMS DB 制御プロセスを停止する必要があります。プログラムが終了するまで、これらのプロセスは JES によって排他的に所有されるようになるためです。

ES_IMS_LOCK_RETRY_DELAY

IMS DB ロック再試行遅延 (ミリ秒単位)。

ES_IMS_LOCK_TIMEOUT

IMS DB 制御がロックされたレコードの再試行をタイム アウトまで続ける秒数。有効な値は 0 ～ 65535 です。デフォルトは 30 秒、値 0 は無限の待ち時間を示します。

ES_IMS_LTERM_PREFIX

ES_IMS_SINGLE 環境変数が N に設定されている場合にデフォルト (OTMA) の代わりに使用する 1 から 4 文字の LTERM プレフィックスを指定します。OTMA に代わるプレフィックスを使用することで名前の競合を制御できます。

構文

ES_IMS_LTERM_PREFIX=1to4charprefix

値

最大 4 文字まで使用できます。Enterprise Server では、LTERM プールを 9999 から 999999 まで拡張できるように、指定した値が 8 文字まで数字の桁で埋められます。プール サイズは、指定したプレフィックスで使用されている文字数で決まります。たとえば、4 文字のプレフィックスでは、LTERM プール サイズは 9999 になり、3 文字のプレフィックスでは、99999 になります。

デフォルト

OTMA

注: この環境変数のデフォルト設定は、LTERMS が OTMA クライアントにのみ適用されることを示します。ただし、これは実際と異なります。LTERMS は、2 番目以降の 3270 ユーザー接続にも適用できます。

ES_IMS_LU_LTERM

MFS システムによって返される LTERM リテラルの値を指定します。有効な値は、Y (LU 名を返す場合) または N (ユーザー ID を返す場合) です。

ES_IMS_MESGQ

IMS TM メッセージ キューの構成を設定します。ES_IMS_MESGQ 環境変数は、Enterprise Server で自動で生成されて設定される予約された変数です。

制約事項: この変数を手動で設定するのは、Micro FocusSupportLine から勧められたときだけにしてください。

ES_IMS_MESGQ=[ds-file-name];max-blocks;buffer-count;start-control;[cushion-size]

ds-file-name

デフォルトの IMSMESGQ.dat の代わりに使用するデータ ストア ファイル。

max-blocks

データ ストア サイズの制限。64K のブロックの数で指定します。デフォルトは 4 です。

buffer-count

割り当てる 64K のバッファーの数。デフォルトは 2 です。

start-control

起動時の動作を設定するフラグ。

Y	リソース定義のコールド スタート。これがデフォルト値です。
S	統計およびリソース状態情報のコールド スタート。
Q	データ ストアのコールド スタート (システムのコールド スタート)。

cushion-size

領域が不足した際に適切に対処できるように予約しておくクッションのサイズ。0 から 255 の数値を指定します。指定した数値の 32 倍の領域が max-blocks から緊急時用に確保されます。デフォルトは 4 (実際の値は 128) です。

ES_IMS_OPEN_TIMEOUT

別のタスクで使用されているデータベース ファイルを開けるようになるまで待機する時間を秒単位で定義します。デフォルトは 30 秒です。

ES_IMS_OTMA_DEST

出力先として、出力先の名前、キーワード NONOTMA、および LU タイプ (LU1 または LU3) をカンマで区切ってそれぞれ指定します。各出力先の定義はセミコロンで区切ります。

IMS_OTMA_DEST=printerName,NONOTMA,LUtype[;...]

ES_IMS_PATH

コンパイル済み COBOL アプリケーションの場所。

ES_IMS_PLI_INDIRECT_PCBADDR

PL/I プログラムで PCB アドレス リストを直接アドレス指定から間接アドレス指定に変換するかどうかを指定します。この変数は次のいずれかの値に設定します。

D

メイン プログラムが PL/I プログラムである場合に、PCB アドレスが直接アドレス指定から間接アドレス指定に変換されます。

Y

PSB 言語が PL/I に設定されている限り、アドレスは常に直接アドレス指定から間接アドレス指定に変換されます。

N

アドレスは直接アドレス指定から間接アドレス指定に変換されません。

デフォルトは D (動的) です。

ES_IMS_RCLASS

変数の値 (7 文字以下) を各リソース クラスのデフォルトの文字に追加して、新しく指定した一連の IMS セキュリティ リソース クラスを作成します。

2 つの Enterprise Server システムで同じ ESM Active Directory を使用しており、それぞれに異なるセキュリティを設定する必要がある場合に、このようなカスタム指定のクラスを作成します。

この変数を設定しない場合に作成されるリソース クラスの名前については、「IMS セキュリティのリソース クラス」を参照してください。

ES_IMS_RELEASE

AIBTDLI INQY ENVIRON 呼び出しに返される IMS リリースを指定できるようにします。

ES_IMS_REGION

AIBTDLI INQY ENVIRON 呼び出しに返される IMS リージョンを指定できるようにします。

ES_IMS_ROLLBACK

自動バックワード回復を有効にします。デフォルトで有効になっています。

ES_IMS_ROLLFORWARD

フォワード回復ログ処理を有効または無効にします。有効な値は、Y (有効化) または N (無効化) です。デフォルトは N です。

ES_IMS_SINGLE

単一のユーザーが複数の LU に同時にサインオンできるようにするかどうかを指定します。

値

Y

マルチ サインオン機能を無効にします。

N

マルチ サインオン機能を有効にします。

ES_IMS_SINGLE が N に設定されている場合に、ユーザーが別の LU で現在アクティブになっているサインオンを使用して LU にサインオンしようとすると、IMS Transaction Manager (TM) によって、ES_IMS_LTERM_PREFIX 設定の後に数値を続けて (合計 8 文字) 作成された名前を使用して (詳細については、本トピックの「IMS_LTERM_PREFIX」を参照)、一時 LTERM がユーザーおよび LU に割り当てられます。一時 LTERM は、ユーザーによって制御される他の LU でのアクティビティに関係なく、ユーザーおよび LU の宛先となります。一時 LTERM によって提供される LU からユーザーが切断すると、LTERM は再利用できるように一時プールに戻されます。

また、ES_IMS_SINGLE が N に設定されている場合、/dis USER all を実行すると、すべてのアクティブな接続を示すユーザーごとのサブリストが返されます。これらの接続は、セッションを通じて維持され、ウォーム スタート時に動的に再作成されます。

デフォルト

Y

注: ES_IMS_SINGLE の使用に関連する KEYPOINT アクティビティはありません。

ES_IMS_SPARSE_EXIT_LANG

IMS DB 2 次索引のスパース ルーチンの言語を示します。

• C (COBOL)
• A (アセンブラー)

デフォルトでは、この変数は設定されていません (スパース出口は無効になっています)。

ES_IMS_SUPPORT

IMS サポートを有効にします。

ES_IMS_TLOG_COMPRESS

0 (ゼロ) に設定すると、バックワード回復 TLOG ファイルの圧縮が無効になります。圧縮されない場合、このファイルにはデータベースの回復に必要な情報のみが含まれます。デフォルトは有効です。

注: 有効な場合、Enterprise Server は情報が古くなった際にファイル内のスペースを解放します。

ES_IMS_TLOG_FLUSH

1 に設定すると、TLOG およびデータベース バッファーからディスクへの頻繁なフラッシュが強制されます。

警告: データベース更新の回数、コミットの頻度、その他のコンピューター活動によっては、ES_IMS_TLOG_FLUSH を使用するとパフォーマンスが大幅に低下する可能性があります。

注: この環境変数は非推奨です。TLOG バッファーをフラッシュするには ES_IMS_DB_TLOG_WRITETHRU を、データベース バッファーをフラッシュするには ES_IMS_DB_COMMIT_FLUSH を使用してください。

ES_IMS_TLOG_MAXSIZE

IMS DB トランザクション ロギング ファイルの最大サイズ (バイト単位)。デフォルトは 4 GB または h"FFF00000" です。

ES_IMS_TLOG_PATH

IMS DB トランザクション ロギング ファイルの場所。デフォルトは Enterprise Server システム ディレクトリです。

注: ログ ファイルは、作成した後、移動はできますが名前の変更はできません。データベースを回復する前に、すべてのログ ファイルを ES_IMS_TLOG_PATH で指定したディレクトリに入れる必要があります。

ES_IMS_TLOG_THRESHOLD

IMS DB トランザクション ロギング ファイルのしきい値サイズ。このサイズに達すると、現在の TLOG ファイルが閉じて、新しい TLOG ファイルが後続のトランザクション用に作成されます。デフォルトは 2 GB または h"7FFFFFFF" です。

ES_IMSCFG

IMS 構成ファイル IMSCONFG.DAT の場所。

ES_IMSDAT

IMS DB データ ファイルの場所。

ES_IMSLIB

DBDGEN2.DAT、DBDGEN2F.DAT、および PSBGEN3.DAT ファイルの場所。

ES_MFSLIB

MFS 生成プログラムによって生成される制御ブロックの場所。

構文

ES_MFSLIB=pathname

値

• pathname MFS ディレクトリのパス。

デフォルト

product_install_dir/etc/ims

ES_MOD3650

IMS への正常なサインオン後に表示されるデフォルトの MOD ファイル。ES_DFS3650 を参照してください。

構文

ES_MOD3650=filename

値

• filename - MOD ファイルの名前。

ES_SSTM_IMS

SSTM IMS 環境の初期化に使用される JCL の場所。

ES_TMC_AGGREGATE

IMS TM データ ストアのパフォーマンス環境を制御します。詳細については、「環境変数：アルファベット順」の ES_TMC_AGGREGATE を参照してください。

構文

SET ES_TMC_AGGREGATE={[,N|,D]|nnn,Y}

値

,N

Sets the default behavior, which is to unilaterally flush operating system buffers to your physical disk at each key transactional point. While this does not change the method used by default at startup, it does enable dynamic modification via ESMAC. Once set, you can then test the effect of various non-default settings by altering them dynamically.

,D

Disables the transactional flushing of operating system buffers to disk. This option can significantly enhance message queue performance; however it is at the expense of the transactional integrity of the message queue in the event of a system failure.

注: To avoid unpredictable results when using this setting, we highly recommend that you also set the static options as follows on the Administration Server > Properties > MSS > IMS > TM > General tab:

• Set Cold start to Everything (queue)
• Check Persist

See Server Instance Properties: MSS IMS TM General for details.

nnn,Y

Enables the aggregated transactional flushing of operating system buffers to disk where nnn represents an interval of time, in milliseconds, during which additional buffers are allowed to accumulate before flushing. Valid values are 0 through 255.

Once a thread reaches a key transactional point and requests a flush, TM waits the specified interval to accumulate subsequent threads that also request a flush. At the end of the interval, one flush is performed for all accumulated requests thus potentially improving performance by reducing the number of flush commands issued to the operating system.

注:

• Threads requesting a flush wait until the flush is confirmed.
• Generally, when the message queue resides on a higher performance I/O subsystem such as one using SSDs, a smaller value, e.g. 1 or 2, produces the best results. A value of 10 or higher seldom improves performance.

デフォルト

,N

ES_TRX3650

IMS への正常なサインオン後に実行するデフォルトのトランザクション。ES_DFS3650 を参照してください。

構文

SET ES_TRX3650=transaction

値

• transaction 実行するデフォルトのトランザクション。

ES_USR_DFLT_IMS

IMS 認証用にログオンしているユーザーがいない場合にデフォルト ユーザーのオーバーライドを許可します。

構文

SET ES_USR_DFLT_IMS=user

値

• user - デフォルトをオーバーライドするユーザー名。

デフォルト

IMSUSER

ICONN1

IMS Connect エミュレーターのクライアント TCP 接続ステータスを制御します。

IMSCPY

DBDGEN、PSBGEN、および MFSGEN ユーティリティのコピーブック ファイルの場所。

MFIMS_ACBDUMP_TIMESTAMP

ACB レポートにおける日時スタンプ表示を抑制します。

MFIMS_BMPCHKP

チェックポイント呼び出しに IO 領域が含まれる場合は、その呼び出しに QC を返します。

MFIMS_BTS

Mainframe Express 形式の BTS トレーシングを構成します。

MFIMS_DIBSTAT_CODES

EXEC DLI プログラムに返される追加の DIBSTAT 戻りコードを指定します。

MFIMS_DLI_OPT

DL/I 呼び出し最適化フラグを指定します。

MFIMS_DIAG

IMS BTS フォーマット診断トレーシングを有効にします。

MFIMS_FLUSHTRACE

各書き込み後に BTS トレース ファイルをディスクにフラッシュします。

MFIMS_FP_DA

IMS Fastpath DB 削除時にキーチェックを無視します。

MFIMS_LOADMVS

IMS アプリケーション プログラムに対する MVS サポートのロードを無効にします。

MFIMS_PCBCALL

スタンドアロン EXEC DLI プログラムが PCB 呼び出しを発行できるようにします。