2.4.1.14.4 オプション

2つのオプション「-i」および「-d」のいずれかを指定する必要があります。その他すべてのオプションはオプションです。

-C <concatenation>

このファイルを、このddnameに対する以前のdsnameと連結します。

-D <delimiter>

sysinのデリミタ。

-d <DispOption>

このオプションは、ファイルのDISPositionステータスを次の書式で示します。

DISP=([status][,normal-termination-disp][,abnormal-termination-disp])

有効な組合せは次のとおりです。

DISP= ( [NEW]     [,DELETE ]   [,DELETE ] )
        [OLD]     [,KEEP]      [,KEEP ]
        [SHR]     [,PASS]      [,CATLG ]
        [MOD]     [,CATLG ]    [,UNCATLG ]
        [ANY]     [,UNCATLG ]

Dispオプションは、ジョブ・ステップ開始時点におけるデータ・セットのステータスと、ステップの正常終了と異常終了におけるデータ・セットの処理を示します。

<status>

ステータスは、既存のデータ・セットを使用するか、あるいは新規データ・セットを作成するかを示します。既存データ・セットの場合、ステータスはデータ・セットが他のジョブと共有できるか、あるいはデータ・セットの最後にレコードを追加するために使用できるかを示します。可能な値は次のとおりです:

NEW — 新しい、共有されていないデータ・セットを作成することを示します。

OLD — 既存の共有されていないデータ・セットを使用することを示します。

SHR — 既存の共有データ・セットを使用することを示します。

MOD — 既存の共有されていないデータ・セットがファイルの末尾にレコードを追加することを示します。

追加ステータスが従来のz/OSステータスに追加されました。

ANY -ファイルを特別モードで使用することを示します。その他のサブパラメータ(<normal-termination-disp>および<abnormal-termination-disp>)はこの場合無視されます。

ノート:

OLDとSHRでは、ファイルがすでに存在することをチェックします。

NEWでは、ファイルが存在しない場合は作成し、すでに存在する場合は中断します。

MODでは、ファイルが存在しない場合は作成し、すでに存在する場合は続行します。

<normal-termination-disp>

このオプションはステップが正常終了した場合に、データ・セットをどうするべきかを示します。可能な値は次のとおりです:

DELETE — データ・セットはもう不要です。

KEEP — データ・セットは保持されます。

PASS — データ・セットは、以降のステップによって使用されるために渡されます。

CATLG — データ・セットはカタログ化されます。

UNCATLG — データ・セットはカタログから削除されます。

<abnormal-termination-disp>

DELETE — データ・セットはもう不要です。

KEEP — データ・セットは保持されます。

CATLG — データ・セットはカタログ化されます。

UNCATLG — データ・セットはカタログから削除されます。

終了時の処理には、ステータスごとにデフォルト値があります。デフォルト値は次のとおりです。

NEW: DELETE, DELETE

OLD/SHR/MOD: KEEP, KEEP

ノート:

1つのステップの中では、PASSの機能はKEEPと同等です。しかし、1つのジョブの中では、NEWまたはMODによってデータ・セットが新規作成され、以降のステップでこのデータ・セットに対してKEEPやCATLGが指定されていない場合、このデータ・セットは削除されます。

GDSに対して指定されると、KEEPはジョブの実行後にGDGのメンバーになります。

GDGの場合、CATLGおよびUNCATLGは暗黙的にKEEPに変換され、KEEPは常にGDGのメンバーとなるGDSを新規作成します。

-g <generationFile>

データ・セットが世代ファイルであることを示します。可能な値は次のとおりです:

+n: n番目の世代ファイルを新しく作成します。

-n: n番目に古い以前の世代ファイルにアクセスします。

0: 最新の世代ファイルにアクセスします。

cur: 最新の世代ファイルにアクセスします。

all: すべての世代ファイルを連結します。

ノート:

allを指定すると、新しく追加されたGDSを含めて、対応するGDGのすべての世代ファイルが1つの一時ファイルに連結され、この一時ファイルがm_FileAssignで指定されるDDに割り当てられます。たとえば、allが指定され、<normal-termination-disp>または<abnormal-termination-disp>がDELETEに指定されている場合、現在のステップの最後に、対応するGDGからすべての世代ファイルが削除されます。

-i

データ・セットがsysinであることを示します。

-k <key position>+<key length>

索引編成ファイル(ファイル編成がIDXのときに使用される)の主要特性を示します。

-r [<record length-min>-]<record length-max>

レコードの長さ特性を示します。

固定ファイルの場合は、最大レコード長が指定されます。

変数ファイルの場合は、最小および最大レコード長が指定されます。

-S <model file>

(大文字のS)

ファイルのdsnameを指定します。

配置モードがNEWのとき、このファイルは新規作成するファイルの「モデル」になります。

新規ファイルの特性は、モデル・ファイルの特性と、m_FileAssign関数によって指定されるその他のパラメータに依存します。IDX、LSEQ、SEQ、RELおよびGDGが、モデル・ファイルとしてサポートされています。

-t <file organization>

ファイル編成の種類を示します。

SEQ: シーケンシャル

LSEQ: ライン・シーケンシャル

REL: 相対

IDX: 索引編成

PDS: ディレクトリ

-v volume

外部ファイルのボリュームを指定します。このオプションは、バッチ・ランタイムでファイル・カタログが有効な場合のみ機能します。

-e Ydate|Ddays (Yは大文字) (Dは大文字)

データ・セットの保存期間を示します。

-U

ファイルがUNIXファイルであることを示します。このタイプのファイルに対してdcbファイルは生成されません。

このオプションを指定する場合、ファイル名は、ファイル名のみではなく、UNIXファイル・パスである必要があります。

-O

(メインフレームJCLの) DD文からPATHOPTSの値を取得し、m_FileAssignで使用します。

-M

(メインフレームJCLの) DD文からPATHMODEの値を取得し、m_FileAssignで使用します。

date

データ・セットの有効期限を指定します。日付は[yy]yydddの形式で指定します。

yyddd

yyは2桁の年番号(99まで)、dddは3桁の日付番号(000から365、うるう年を除く)です。たとえば、1995年2月2日は95033と表されます

yyyyddd

yyyyは4桁で表した年(2155年まで)、dddは3桁で表した日付です。

ノート:

有効期限[19]99365と[19]99366は、存在しない日付と見なされています。

days

データ・セットの保存期間を指定します。これは、ddddの形式で指定します。この場合のdddd範囲は0-9999の範囲で設定する必要があります。有効期限を生成するために、システムによりddddが現在の日付に追加されます。

-w referenced-file

参照ファイルのボリュームを使用することを指定します。このオプションは、バッチ・ランタイムでファイル・カタログが有効な場合のみ機能します。

参照モードには、次のいずれかの値を使用できます。

• FileName
• *.DD
• *.STEP.DD

ddname <InternalFileName>

COBOLプログラムのSELECT文で定義された、ファイルの論理名。

dsname <ExternalFileName>

実際のファイル名、ディスク上でのファイルのフル・パス。