ファイル処理およびデータセットの環境変数

本トピックでは、ファイルおよびデータセット処理の構成に関連する環境変数の一覧を示します。

COBDATA

Specifies one or more locations, separated by ; (Windows) or : (UNIX), in which to search for data files at run time. As long as the file assignment does not contain a sub-path (that is, a string containing \ or /) then the file assignment is appended to each location specified by COBDATA in order to locate the file.

注: Users modernizing RM/COBOL or ACUCOBOL-GT legacy code can use a sub-path in the file assignment, but only by compiling with the relevant DIALECT or IDXFORMAT values for the respective File Handling systems; setting these values in the File Handling configuration file is not sufficient to achieve this.

ランタイム システムがデータ ファイルを検索するディレクトリを指定します。データ ファイルをグローバルにマップする機能を提供するため、ユーザーは実行時までに名前が認識されていないディレクトリに作業データ ファイルを置くことができます。

構文

COBDATA=pathname[:pathname]...
export COBDATA

COBDATA=pathname[:pathname]...

パラメーター

• 検索ディレクトリのリスト (各項目はセミコロン (Windows) またはコロン (UNIX) で区切られます)。ランタイム システムでアプリケーションのデータ ファイルが検索される場合にこれらのディレクトリが検索されます。pathname を複数指定する場合に、空の pathname は現在の作業ディレクトリを示します。

説明

COBDATA は、コンパイラ、およびその他のユーティリティに影響します。たとえば、コンパイル時では、プログラム ソースがコンパイラのデータ ファイルになります。COBOL 開発システム ユーティリティを使用する場合は、COBDATA の値を、コロン (:) を先頭にして指定することをお奨めします。

ご使用の環境空間に、COBDATA という名前の環境変数があり、なんらかの値が設定されている場合は、COBDATA が設定されていると見なされます。

ファイルのすべてのマッピング順序は次のようになります。

1. すべての dd_ 環境マッピング
2. すべての ASSIGN TO EXTERNAL マッピング
3. すべての COBDATA 環境変数マッピング

COBDATA 環境変数、または dd_ 環境変数のどちらかで複数のディレクトリを指定した場合は、システムが、ユーザー名のプレフィックスとして指定されるスラッシュ (/) の前の最初のディレクトリを検索します。

ファイル名が見つからない場合、または読み取れない場合は、上記の順番に、最後のディレクトリまで検索されます。最後のディレクトリでも見つからず、ファイルを作成する必要がある場合は、ファイルは最初のディレクトリに作成されます。

ハイフン (-)、またはスラッシュ (/) で始まっているファイル名に関しては、dd_、および COBDATA のマッピングはすべて無視されます。また、環境変数名にハイフンが含まれている場合も無効になります。

この機能を使用する場合は、COB... で始まるファイル名を使用しないでください(これらは COBOL システムで予約済みです)。

COBDATA 環境変数は、どんなモード (出力も含む) で開かれているファイルにも、また、固定長ファイルや可変長ファイルにも使用することができます。索引ファイルを使用している場合は、データ ファイル、および索引ファイルの両方を同じディレクトリに置く必要があります。

COBDATA 環境変数は、ファイルを開く場合だけでなく、ここに示す規則に従ってファイルを削除する場合にも影響があります。

COBOL 開発システム プログラムを使用しようとする場合はまず、COBDATA の設定を解除することをお奨めします。これらのプログラムの多くでは、データ ファイルが開かれるため、COBDATA の値に影響されます。COBDATA を使う必要がある場合は、COBDATA のパスの最初に :$COBDIR/dynload/helptbox.lbr および :$COBDIR/dynload/check.lbr を追加してください。Animator のヘルプ ページが必要な場合は、COBDIR/dynload/advanim.lbr も追加します。

注: Users modernizing RM/COBOL or ACUCOBOL-GT legacy code can use a sub-path in the file assignment, but only by compiling with the relevant DIALECT or IDXFORMAT values for the respective File Handling systems; setting these values in the File Handling configuration file is not sufficient to achieve this.

例

COBDATA=:demo:/home/data:progs
export COBDATA

SET COBDATA=:demo:/home/data:progs

このように COBDATA を設定すると、ランタイム システムは、最初に現在のディレクトリでデータ ファイルを検索するよう指定されます。次に、ディレクトリ ./demo を、次にディレクトリ /home/data を検索し、最後に ./progs を検索するように指定されます。

DB2DBDFT

SQL 文を処理する DB2 SQL プリコンパイラのデフォルト データベース。

値

• デフォルト データベースの場所と名前。

ES_RLS_FILE_SUPPORT

プログラムが更新のための読み取りを行っているためにレコードがロックされており、他のプログラムがそのレコードにアクセスできないようにする必要がある場合は、この環境変数を設定して、ロックを保持しているプログラムが完了するまで無効なレコードが返されるのを防止できます。ファイル共有のタイムアウトも、ファイル共有構成ファイルで /t 0 を使用して 0 に設定する必要があります。

構文

ES_RLS_FILE_SUPPORT=value
export ES_RLS_FILE_SUPPORT

SET ES_RLS_FILE_SUPPORT=value

値

• Y|y - レコードが別のプロセスによってロックされている場合は、無効なレコードが返されるのを停止します。

デフォルト

RLS ファイル サポートはオフです。

EXTFH

呼び出し可能ファイル ハンドラーの構成ファイルを指定します。

構文

EXTFH=filename.cfg
export EXTFH

パラメーター

filename.cgf 構成ファイルの名前を指定します。

例

EXTFH=/home/mydir/myconfig.cfg
export EXTFH

FHREDIR

Fileshare クライアントに使用させる構成ファイルを指定します。

構文

FHREDIR=filename.cfg
export FHREDIR

パラメーター

filename.cfg 構成ファイルの名前を指定します。

例

FHREDIR=/home/mydir/myconfig.cfg
export FHREDIR

FS

Fileshare Server に使用させる構成ファイルを指定します。

構文

FS=filename.cfg
export FS

パラメーター

filename.cfg 構成ファイルの名前を指定します。

例

FS=myconfig.cfg
export FS

FSCOMMS

Fileshare システムがシングル ユーザー モードで実行されることを指定します。

構文

FSCOMMS="\$local"
export FSCOMMS

パラメーター

"\$local" Fileshare システムをシングル ユーザー モードで実行します。

GDG.RECALL

MFA データ アクセス サービスを使用してメインフレーム GDG にアクセスするときに、HSM アーカイブ済みデータセットの再呼び出しを制御します。

HCOBND (非推奨)

DB2 外部コンパイラモジュール (ECM) で生成されるバインド ファイルが使用するディレクトリを指定します。

注: HCOBND は非推奨です。下位互換性のみを目的として提供されています。代わりに BIND または BINDDIR コンパイラ指令オプションのいずれかを使用することをお勧めします。

構文

SET HCOBND=pathname

HCOBND=pathname
export HCOBND

パラメーター

pathname DB2 ECM がバインド ファイルの格納に使用するディレクトリを指定します。

例

Windows：

SET HCOBND=d:\mydir\binds

UNIX：

SET HCOBND=/mydir/binds
export HCOBND

説明

DB2 ECM は、この環境変数が設定解除されるか、または別のディレクトリが再設定されるまでは指定されたディレクトリを使用します。DB2 コンパイラの指令オプション BIND はこの環境変数を上書きします。

LIB

DB2 LIB ディレクトリの場所。

MFALLOC_LOC

デフォルトの割り当て済みデータセットの場所。

MFALLOC_PROP

割り当て時に生成される PC データセット名の規則 (つまり、デフォルトのカタログ PC DSN フォーマット)。

MF_CBLQDA

オプション ファイル (FILE-CONTROL 段落で SELECT OPTIONAL 構文を使用して開かれたファイル) または OUTPUT 用に開かれたファイル (オプションかどうかは問わない) の OPEN I-O 文または OPEN EXTEND 文を処理する際に QSAM ファイルを動的に割り当てるかどうかを決定します。指定できる値は OFF および ON です。デフォルトは OFF で、動的割り当てを許可しないように指定します。

これは、CBLQDA 言語環境 (LE) ランタイム オプションのエミュレーションです。

ON に設定した場合に、JCL に含まれている開くファイルの DD 文にスペルミスがあるか、JCL にその文が含まれていないと、OPEN 文の結果として一時ファイルが作成され、プログラムの実行後に削除されます。I-O または EXTEND 用に開かれたオプション ファイルの場合は、戻りコード 05 が返されます。OUTPUT 用に開かれたファイルの場合は、戻りコード 00 が返されます。

この変数は、VSAM アプリケーションまたは JCL ユーティリティ プログラムには影響しません。

注: ESDS ファイルを使用し、この変数を ON に設定しているプログラムでは、FILETYPE が 15 または 16 に設定されていることを確認してください。それ以外の場合、このファイルは変数の影響を受け、QSAM ファイルとして扱われます。

MF_NEWSPACE

新規データセットにスペースが必要かどうかを示します。

MF_SYSLOGDSN

Syslog データセット名。

MFLOCKING

ロッキング サポートを有効にします。

PROCLIB

PROCLIB データセットを指定します。これは、PDS 名の連結にすることができます。

STRICTVSAM

構文：

strictvsam=ON|OFF

パラメーター：

ON

次の場合に、既存の VSAM ファイルが OUTPUT 用に開かれると、ファイル状態 37 が返されます。

• ファイルにデータがあるか、以前にデータが書き込まれた。
• ファイルの形式がディスク上のファイルと異なる。

OFF

既存の VSAM ファイルが OUTPUT 用に開かれると、ファイル状態 0 が返され、新しいファイルが作成されます。

プロパティ：

TXFILEP

Micro Focus VSAM ファイルの場所。