読み込み規則
読み込み対象とする画面コピー句のデータ記述項の形式を以下に示します。
<レベル番号> <項目名 | FILLER> ［ REDEFINES <参照名> ］
［ PICTURE | PIC ［ IS ］<編集文字列> ］
［［ USAGE［ IS ］］COMPUTATIONAL | COMP |
COMPUTATIONAL-1 | COMP-1 |
COMPUTATIONAL-2 | COMP-2 |
COMPUTATIONAL-3 | COMP-3 |
DISPLAY | PACKED-DECIMAL ］
［［ SIGN［ IS ］］LEADING | TRAILING |
LEADING SEPARATE | TRAILING SEPARATE | <演算符号> ］
［ OCCURS <繰り返し数> ［ TIMES ］
ASCENDING | DECENDING［ KEY IS ］<データ名>
INDEXED BY <指標> ］
［ OCCURS <最小繰り返し数>［ TO ］<最大繰り返し数> ［ TIMES ］
DEPENDING ON <データ名>
ASCENDING | DECENDING［ KEY IS ］<データ名>
INDEXED BY <指標> ］
［［ SYNCHRONIZED | SYNC ］LEFT | RIGHT ］
［［ JUSTIFIED | JUST ］RIGHT ］
［ BLANK WHEN ZERO ］
［ VALUE［ IS ］<データ> ］.
上記以外のデータ記述項は、読み込めません。000010 05 ZAIKO. 000020 06 PARAM1 PIC N(10). 000030 06 PARAM2 PIC 9(5) 000040 06 PARAM3 OCCURS 5. 000050 07 FLD1 USAGE COMP-1. 000060 07 FLD2 USAGE COMP-2. 000070 06 PARAM4 PIC S9(4) USAGE COMP-3.上記コピー句の例の場合、000010,000040は集団項目として、000020,000030,000050,000060,000070は基本項目として読み込まれます。読み込むコピー句のレベル番号の値は05,06,07である必要はありません。
行番号に関して
第1カラムから第6カラムまでが数字である場合に行番号として処理します。
000010* COMMENT LINE. 000020 07 PARAM1 PIC 999V99 000030 USAGE COMP-3.
コメントに関して
第1カラムが '*' または'/'であるか、第1カラムから第6カラムまでが数字あるいは空白で第7カラムが '*' または'/'である場合にコメント行として処理します。
000010* COMMENT LINE. 000020/ COMMENT LINE. * COMMENT LINE.
継続行に関して
第1カラムが '-' または空白であるか、第1カラムから第6カラムまでが数字で第7カラムが '-' または空白である場合に継続行として処理します。
'-' ： 前の行の空白でない最後の文字の後に現在の行の空白でない最初の文字が続くものとみなして処理します。 空白 ： 前の行の後ろの最後の文字の後に空白があるものとみなして処理します。
000010 07 PARAM1 PIC 999V99
000020 USAGE COMP-3.
07 PARAM2 PIC 999V99
USAGE COMP-3.
07 PARAM3 PIC 999
- V99 USAGE COMP-3.
配列に関して
05 ZAIKO.
06 PARAM1 PIC N(10).
06 ARRAY1 USAGE COMP-1 OCCURS 5.
06 ARRAY2 USAGE COMP-2 OCCURS 5.
これを読み込んだ場合、ARRAY1はSHORT型の配列となり、ARRAY2はLONG型の配列となります。
REDEFINES句に関して
05 ZAIKO.
06 PARAM1 PIC 999V99.
06 PARAM2 REDEFINES PARAM1.
07 PARAM2-1 PIC 999V.
07 PARAM2-2 PIC V99.
06 PARAM3 PIC S9(10)V9(5) USAGE COMP-3.
これを読み込んだ場合、REDEFINES句で定義したフィールドにアクセスできます。MappedRecordの場合は読み込めますが、IndexedRecordの場合は読み込めません。
MappedRecord、IndexedRecordの詳細に関しては、APIリファレンスのjp.co.nec.WebOTX.connector.olftp.cciパッケージ中にある、OLFIndexedRecord、OLFMappedRecordの項を参照してください。
FILLER句に関して
000010 05 ZAIKO. 000020 06 FILLER PIC N(03). 000030 06 FILLER PIC 9(03).
これを読み込んだ場合、行番号000020のデータはFILLER0、行番号000030のデータはFILLER1と、項目名がそれぞれ変換されます。
OCCURS TO句に関して
000010 01 SAMPLE001. 000020 03 USERCOUNT PIC X(3). 000030 03 USER OCCURS 1 TO 5 DEPENDING ON I. 000040 05 PIC1 PIC X(1). 000050 05 COMP1 USAGE COMP-1.
OCCURS TO句は電文の最後に記述してください。これ以降に電文を記述することはできません。
読み込み時のエラーに関して
読み込めなかったデータ記述項に関する情報は、標準出力画面に表示します。
読み込んだコピー句がサポート範囲外の句を含んでいる場合には、そのコピー句に対する読み込みおよび解析処理を中断し、標準出力画面にエラーメッセージを表示します。