ファイル

-NumCsvオプションを指定してCSV編成ファイルの入出力をする場合，無視したい文字列を指定します。

規則

環境変数CBLCSVCHARに複数の文字列を指定する場合は，各文字列をセミコロン（;）で区切ります。

詳細は，「6.8.5　セルデータを数値として入出力する機能」の「(3)　数値として入力するとき，不要な文字列を無視する機能」を参照してください。

CSVファイルのREAD文実行時に，セルと対応しない未使用の基本項目を初期化する場合に指定します。

詳細は，「6.8.7　入力時の未使用項目の初期化機能」を参照してください。

入出力動作を指示する下記のオプションをファイル単位に指定します。

規則

複数のオプションを指定するときは各オプションをコロン（：）で区切ります。
環境変数CBLD_ファイル名は，OPEN文を実行するごとに環境変数の値が参照されます。
ここで指定するファイル名はSELECT句で指定したファイル名に対応します。ただし，ファイル名内のハイフン（-）は下線（_）に置き換えて指定します。
背反するオプションを同時に指定した場合，あとから指定したオプションが有効となります。

設定例

（例1）

（COBOLでの記述例）

SELECT A-FILE ASSIGN TO SYS000.

（環境変数の設定例）

CBLD_A_FILE=ISAMDL:NOISAMPREV

（例2）

背反するオプションを同時に指定した場合，あとから指定したオプションが有効となります。

 
CBLD_A_FILE=ISAMDL:NOISAMDL

上記の指定をした場合，最初の"ISAMDL"は無効となり，あとに設定した"NOISAMDL"が有効となります。

(a)　ISAMDL／NOISAMDL

ISAMDLは，索引編成ファイルでOPENモードがOUTPUTの場合，既存のファイルを削除して再生成します。NOISAMDLは，ファイルの削除はしません。省略時はNOISAMDLが仮定されます。

(b)　ISAMPREV／NOISAMPREV

ISAMPREVは，索引編成ファイルでSTART文の指定がLESS，LESS THAN OR EQUAL，およびLASTの場合，あとに続くNEXT指定のREAD文でキーの降順に呼び出します。NOISAMPREVは，START文の指定に関係なく，NEXT指定のREAD文はキーの昇順に呼び出します。省略時はISAMPREVが仮定されます。

(c)　SAMAADV／NOSAMAADV

SAMAADVは，ADVANCING指定を書かないWRITE文にAFTER ADVANCING 1 LINEを仮定します。NOSAMAADVはこれを仮定しません。省略時はNOSAMAADVが仮定されます。

SAMAADVとSAMBADVを同時に指定した場合は，あとに設定した方が有効となります。

(d)　SAMBADV／NOSAMBADV

SAMBADVは，ADVANCING指定を書かないWRITE文にBEFORE ADVANCING 1 LINEを仮定します。NOSAMBADVはこれを仮定しません。省略時はNOSAMBADVが仮定されます。

SAMAADVとSAMBADVを同時に指定した場合は，あとに設定した方が有効となります。

(e)　BTMODIFY／NOBTMODIFY（32bit版PC(x86) COBOL2002で有効）

BTMODIFYは，Btrieve（Pervasive.SQL）による索引編成ファイルの主レコードキーに対し，変更可能モードが設定されている物理ファイルをオープンできるようにします。このオプション設定時には次の注意が必要です。

BTMODIFYを指定した場合でも，実際に主レコードキーの変更はできない。
BTMODIFYを指定した場合でも，COBOLで作成されるファイルの主レコードキーは変更不可モードとなる。

なお，省略時はNOBTMODIFYが仮定されます。

(f)　CSVQUOTE／NOCSVQUOTE

CSVQUOTEは，CSV編成ファイルのWRITE文でセルの内容を出力するとき，データを引用符（ " ）で囲みます。NOCSVQUOTEは，引用符を付けません。省略時はCSVQUOTEが仮定されます。

NOCSVQUOTEを指定した場合の詳細は，「6.8　CSV編成ファイル（表計算プログラムファイル）」を参照してください。

(g)　CSVWRITESPACE／NOCSVWRITESPACE

CSVWRITESPACEは，CSV編成ファイルのWRITE文で，出力するレコードの基本項目のデータの最後の空白文字を出力します。NOCSVWRITESPACEは，データの最後の空白文字を出力しません。なお，省略時はNOCSVWRITESPACEが仮定されます。

CSVWRITESPACEを指定した場合の詳細は，「6.8.8　データの後の空白文字を出力する機能」を参照してください。

(h)　CSVTABSEPARATED／NOCSVTABSEPARATED

CSVTABSEPARATEDは，CSVファイル入出力機能でセルデータをタブ文字区切りで入出力します。NOCSVTABSEPARATEDはセルデータにコンマ（,）区切りで入出力します。なお，省略時はNOCSVTABSEPARATEDが仮定されます。

CSVTABSEPARATEDを指定した場合の詳細は，「6.8.9　セルデータをタブ文字区切りで入出力する機能」を参照してください。

(i)　SAMPADV／NOSAMPADV

SAMPADVは，OPEN文の実行後，最初に実行されるAFTER ADVANCING PAGE指定のWRITE文についての行制御を有効にします。NOSAMPADVは，行制御を無効にします。省略時はSAMPADVが仮定されます。このオプション設定時には次の注意が必要です。

SAMPADVおよびNOSAMPADVは，順編成ファイル，テキスト編成ファイルの印刷機能，書式印刷機能，および報告書作成機能^※に対して有効となります。
LINAGE句が指定されている場合，SAMPADVおよびNOSAMPADVの指定は無効となります。

注※: 報告書作成機能のGENERATE文は，内部的にWRITE文を使用するため，このオプションが有効になります。

(j)　FSYNC／NOFSYNC／WDISK

強制的にディスク書き込みをするかしないかを指定します。

FSYNCを指定した場合，プログラムの終了時，またはCLOSE文の実行終了時に，COBOLプログラムの環境部のファイル記述項で指定したファイル名のファイルに対して，強制的なディスク書き込みを適用します。

WDISKを指定した場合，WRITE文，REWRITE文，またはDELETE文の実行終了時に，COBOLプログラムの環境部のファイル記述項で指定したファイル名のファイルに対して，強制的なディスク書き込みを適用します。

NOFSYNCを指定した場合は，ディスクへの書き込み保証が適用されません。

FSYNC，NOFSYNC，WDISKのどれかを同時に指定した場合は，あとに指定した方が有効となります。また，FSYNC，NOFSYNC，WDISKのどれも指定しない場合は，環境変数CBLFSYNCの指定に従います。

ファイルのディスク書き込み保証機能の詳細については，「14.1　ファイルのディスク書き込み保証」を参照してください。

(k)　ISAMLARGE／NOISAMLARGE（32bit版PC(x86) COBOL2002で有効）

ISAMLARGEは，ISAMによる索引編成ファイルにラージファイル入出力機能を有効にします。NOISAMLARGEは，ISAMによる索引編成ファイルにラージファイル入出力機能を使用しないで通常の入出力とします。省略時はNOISAMLARGEが仮定されます。詳細は，「6.11　ラージファイル入出力機能」を参照してください。

(l)　TEXTWRITESPACE／NOTEXTWRITESPACE

テキスト編成ファイルに対するWRITE文またはREWRITE文で，レコード末尾からの連続する半角空白文字をファイルに書き出したい場合，TEXTWRITESPACEを指定します。テキスト編成ファイルに対するWRITE文またはREWRITE文で，レコード末尾からの連続する半角空白文字を削除したい場合は，NOTEXTWRITESPACEを指定します。詳細については，「6.7.5　レコード末尾の空白文字を出力する機能」を参照してください。

(m)　TEXTSUPPRESSBOM／NOTEXTSUPPRESSBOM

テキスト編成ファイルにUnicodeシグニチャを出力しない場合，TEXTSUPPRESSBOMを指定します。Unicodeシグニチャを出力する場合，NOTEXTSUPPRESSBOMを指定します。

詳細については，「30.5.2　入出力機能」の「(1)　テキスト編成ファイル」を参照してください。

(n)　RDBOPURGE／NORDBOPURGE

HiRDBによる索引編成ファイルで，出力モードでファイルを開く場合，すでにファイル内に存在するレコードを高速で削除するとき，RDBOPURGEを指定してください。レコードを高速で削除しない場合，NORDBOPURGEを指定してください。

プロセス内のすべてのファイルに対して，クローズ時のディスクへの書き込み保証を適用したいときにYESを指定します。YES以外の値を指定したときは，無効となります。

詳細は，「14.1.2　ファイルクローズ時のディスク書き込み保証の指定方法」および「13.7　COBOL入出力サービスルーチンでのディスク書き込み保証」を参照してください。

COBOLのGDI印刷機能およびESC/P印刷機能を使用した場合に，スプールに登録される印刷文書名称を指定します。

詳細は，「8.2.5　印刷文書名称」の「(2)　ユーザ指定の印刷文書名称」を参照してください。

GDIモード印刷機能を使用する場合に，CHARACTER TYPE IS INTERVAL句が出現しない間の項目の字間隔に対して，実行支援の印刷書式に設定した字間隔を適用したいときにYESを指定します。ただし，CHARACTER TYPE句の指定がまったくないレコードに対しては，環境変数CBLGDIINTERVALの指定に関係なく，実行支援の印刷書式に設定した字間隔が適用されます。なお，環境変数CBLGDIINTERVALにYESを指定した場合の詳細については，「8.4.2　出力形態とレコード形式」の「(2)　CHARACTER TYPE句指定での印刷」の「(e)　環境変数CBLGDIINTERVALを使用した出力例」を参照してください。

YES以外の値を指定したときは，無効となります。

GDIモード印刷機能を利用してプリンタ出力する場合に，警告メッセージの出力を抑止したいときにYESを指定します。指定しなかったときや，YES以外の値を指定したときは，警告メッセージを出力します。

ファイル入出力文でのエラー情報出力機能を使用したい場合に，この環境変数を指定します。指定可能な値を次に示します。