概要

これは，固定長の文字列データおよびバイナリデータの読み書きに関す るサブルーチンパッケージである． ftpなどのファイル転送ソフトを念頭において， 使用する機種によらずファイル操作の一元化を計ろうとするものである． したがってファイルそのものの互換性はないが，適切な転送手段によっ てファイルの内容は保存され，文字は文字レベルで，バイナリはバイナ リレベルでハンドリングできることになる．

このパッケージは次のような仕様にもとづいて設計されている．

1. 固定長ファイルの入出力を取り扱う．
2. 入力と出力は同時におこなわない．
3. 出力は順次的におこなう．
4. 入力はレコード番号を指定するランダムアクセスを許す．
5. 行末の改行制御をするかどうかが指定できる．
6. 書き込のためオープンすると既存のファイルは消去される．

このような仕様は，以下の要請からきている．

• unix系のマシンでは直接参照入出力を念頭においているので1を要請 する．
• メインフレーム系のマシンでは順番参照入出力を念頭においている （ファイルシステムの違いから一般に直接参照入出力より順番参照入出 力のアクセススピードの方が速い）ので2, 3を要請する．
• unix系のマシンでおこなう直接参照入出力の利点を生かしてランダム アクセスができることを要請する．ただしメインフレーム系の順番参照 入出力では出力時にレコード番号を指定するようなやりかたは非現実的 であり，実際われわれの使用形態のほとんどの場合が順番参照的である ことから，4によって入力時のみ疑似的なランダムアクセスを要請する．
• unix系の文字入出力を念頭において5の要請がある．
• 既存のファイルサイズが上書きするファイルサイズより大きいような 直接参照出力をおこなうとき，以前のファイル内容の一部が残ってしま うので6を要請する．

以下のサブルーチン群を使用するにあたっては次の点に注意すること．

• 入出力装置番号の妥当性はチェックしない．
• レコード長の妥当性はチェックしない．
• レコード番号の妥当性はチェックしない．
• 指定できる入出力装置番号は1から99である．

なお以下の説明で共通してあらわれるコンディションコードは， 正常終了していれば0が，そうでなければ0以外の整数値が返される．

サブルーチンのリスト

                                                                      
  FCOPEN(IOU,CDSN,NRL,CACT,ICON)   ファイルをオープンする．           
                                                                      
  FCCLOS(IOU,ICON)                 ファイルをクローズする．           
                                                                      
  FCSLFC(CLX)                      行末の改行文字を設定する．         
                                                                      
  FCLEOL(IOU,LEOL)                 行末の改行制御を指定する．         
                                                                      
  FCNREC(IOU,NREC)                 レコード番号を指定する．           
                                                                      
  FCGETR(IOU,CBUF,ICON)            1レコードを（文字列で）読み込む．  
                                                                      
  FCPUTR(IOU,CBUF,ICON)            1レコードを（文字列で）書き出す．  
                                                                      
  FCGETS(IOU,IBUF,ICON)            1レコードを（配列で）読み込む．    
                                                                      
  FCPUTS(IOU,IBUF,ICON)            1レコードを（配列で）書き出す．    
                                                                      
  FCRWND(IOU,ICON)                 リワインドする．                   
                                                                      

サブルーチンの説明

FCOPEN

1. 機能

   ファイルをオープンする．

2. 呼び出し方法

   CALL FCOPEN(IOU,CDSN,NRL,CACT,ICON)

3. パラメーターの説明

                                                                           
     IOU    (I)       入出力装置番号．                                     
                                                                           
     CDSN   (C*(*))   ファイル名．                                         
                                                                           
     NRL    (I)       レコード長．                                         
                                                                           
     CACT   (C*1)     入出力モードの指定． 読み込みのとき'R',              
                      書き込みのとき'W'を 指定する．                       
                                                                           
     ICON   (I)       コンディションコード．                               
                                                                           
   

4. 備考
   1. 書き込のためオープンすると既存のファイルは消去される．

FCCLOS

1. 機能

   ファイルをクローズする．

2. 呼び出し方法

   CALL FCCLOS(IOU,ICON)

3. パラメーターの説明

                                          
     IOU    (I)   入出力装置番号．        
                                          
     ICON   (I)   コンディションコード．  
                                          
   

4. 備考
   1. なし．

FCSLFC

1. 機能

   行末の改行文字を設定する．

2. 呼び出し方法

   CALL FCSLFC(CLX)

3. パラメーターの説明

                                        
     CLX   (C*(*))   指定する改行文字.  
                                        
   

4. 備考
   1. 改行文字はふつうシステムごとに定められているが， 特定のシステムを念頭においてファイルを作成するときに このサブルーチンを使用すればよい．
   2. FCLEOLの前に呼ばなければならない．
   3. 改行文字は2文字以下でなければならない．

FCLEOL

1. 機能

   行末の改行制御をするかどうかを指定する．

2. 呼び出し方法

   CALL FCLEOL(IOU,LEOL)

3. パラメーターの説明

                                                                           
     IOU    (I)   入出力装置番号．                                         
                                                                           
     LEOL   (L)   改行制御の指定をする． .TRUE.なら改行制御をする;         
                  .FALSE.ならしない．                                      
                                                                           
   

4. 備考
   1. FCOPENの前に呼ばなければならない．
   2. このルーチンを呼んでいないときの省略値は.FALSE.である． 文字入出力を取り扱うときには，.TRUE.を明示的に指定すべき である．

FCNREC

1. 機能

   レコード番号を指定する．

2. 呼び出し方法

   CALL FCNREC(IOU,NREC)

3. パラメーターの説明

                                                 
     IOU    (I)   入出力装置番号．               
                                                 
     NREC   (I)   レコード番号．1以上の整数値．  
                                                 
   

4. 備考
   1. ここで指定したレコード番号は，次のFCGETRまたは FCGETSで有効になる．
   2. このサブルーチンは読み込みモードでのみ使用できる．

FCGETR

1. 機能

   1レコードを（文字列で）読み込む．

2. 呼び出し方法

   CALL FCGETR(IOU,CBUF,ICON)

3. パラメーターの説明

                                                
     IOU    (I)       入出力装置番号．          
                                                
     CBUF   (C*(*))   読み込むデータレコード．  
                                                
     ICON   (I)       コンディションコード．    
                                                
   

4. 備考
   1. CBUFの長さはNRL ( FCOPEN参照） でなければならない．
   2. FCNRECによってレコード番号が指定されていなければ， 先頭のレコードから順に読み込む; レコード番号が指定されていれば， 先頭のレコードを1として指定されたレコード番号のレコードから 読み込む．

FCPUTR

1. 機能

   1レコードを（文字列で）書き込む．

2. 呼び出し方法

   CALL FCPUTR(IOU,CBUF,ICON)

3. パラメーターの説明

                                                                           
     IOU    (I)       入出力装置番号．                                     
                                                                           
     CBUF   (C*(*))   書き込むデータレコード． 長さNRL                     
                      ( FCOPEN参照）の文字列で指定する．                   
                                                                           
     ICON   (I)       コンディションコード．                               
                                                                           
   

4. 備考
   1. CBUFの長さはNRL ( FCOPEN参照） でなければならない．
   2. 書き込みは先頭のレコードから順におこなわれる．

FCGETS

1. 機能

   1レコードを（配列で）読み込む．

2. 呼び出し方法

   CALL FCGETS(IOU,IBUF,ICON)

3. パラメーターの説明

                                            
     IOU    (I)   入出力装置番号．          
                                            
     IBUF   (I)   読み込むデータレコード．  
                                            
     ICON   (I)   コンディションコード．    
                                            
   

4. 備考
   1. IBUFの長さに4をかけたものが NRL ( FCOPEN参照）となっていなければならない．
   2. FCNRECによってレコード番号が指定されていなければ， 先頭のレコードから順に読み込む; レコード番号が指定されていれば， 先頭のレコードを1として指定されたレコード番号のレコードから 読み込む．

FCPUTS

1. 機能

   1レコードを（配列で）書き込む．

2. 呼び出し方法

   CALL FCPUTS(IOU,IBUF,ICON)

3. パラメーターの説明

                                            
     IOU    (I)   入出力装置番号．          
                                            
     IBUF   (I)   書き込むデータレコード．  
                                            
     ICON   (I)   コンディションコード．    
                                            
   

4. 備考
   1. IBUFの長さに4をかけたものが NRL ( FCOPEN参照）となっていなければならない．
   2. 書き込みは先頭のレコードから順におこなわれる．

FCRWND

1. 機能

   リワインドする．

2. 呼び出し方法

   CALL FCRWND(IOU,ICON)

3. パラメーターの説明

                                          
     IOU    (I)   入出力装置番号．        
                                          
     ICON   (I)   コンディションコード．  
                                          
   

4. 備考
   1. なし．

Back to Main