Chapter 2: mr ルーチン

一般的に、mrルーチンによって、テーブルのオープン、レコードの追加、削除、検索、更新が行なえます。すべての操作は 一つのレコードに対して実行可能です。以下に示す、6つのデータポインタがあります。

1. オープンされたテーブルを指す、テーブル記述子（teble_descriptors)。

2. フィールドを指す、フィールド記述子（attribute_descriptors)。

3. レコードを指す、レコード記述子（record_descriptors）。

4. フィールドまたはレコードと、条件を関連付ける、条件記述子（qualification_descriptors）。

5. テーブルと条件を関連付ける、検索記述子（retrieval_descriptors）。

6. フィールド値の、外部フォーマットに一致する文字列（strings）。いくつかのフィールド値の、フォーマットを以下の 章で解説します。

最初の5つのデータポインタは、"addr"として宣言され、6番目の文字列は、"char *"として宣言しなくてはなりません。 テーブル、レコード、フィールド、条件の各記述子は、Emppress内部構造体へのポインタです。"addr"データタイプは、 "char *"として定義されていますが、これらのポインタは、文字列ではないので、そのように使用してはなりません。 addrデータタイプは、この連想子として使用されています。

ヘッダーファイルmscc.hは、mrルーチンを使用するプログラムの先頭で、インクルードしなくてはなりません。ここには すべてのmr関数の定義と、多数のデータタイプ(addr、booleanなど）と定数の定義が含まれています。 mscc.hは、標準I/Oライブラリをインクルードしているので、プログラム中で、このライブラリをインクルードする必要は ありません。mscc.hファイルの内容を、以下に示します。

mscc.hファイルは、バージョンによって内容が違います。正確なファイルの内容は、$EMPRESSPATH/includeディレクトリにあるファイルを参照してください。

   /***********************************************************************
    *      (c) Copyright   Empress Software Inc. 1983, 2002
    ***********************************************************************/

   #ifndef __MSCC_H

   #define __MSCC_H

   #ifdef __cplusplus
   extern "C" {
   #endif

   #include        <stdio.h>
   #include        "c.h"

   #include        <misc/public.h>
   #include        <usrmp/msdsqldt.h>
   #include        <usrfns/dtparvar.hx>
   #include        <api/mrapi.hx>
   #include        <api/msapi.hx>
   #include        <api/mxapi.hx>
   #include        <misc/init.hx>
   #include        <misc/mscc_com.h>
   #include        <misc/mxe.h>
   #include        <misc/mxtrig.h>


   #ifdef __cplusplus
   }
   #endif

   #endif  /* __MSCC_H */

Empress mrルーチンを使用した、プログラムの作成には、2つの方法があります。

1. 通常のmainプロシージャを、msmainとします。これは必要な初期化を行い、mainプロシージャをインクルード します。また、通常通り、パラメータargcとargvを使用できます。 同様に、通常のexitプロシージャをmsexitにします。

2. mainプロシージャを書くことも可能です。そのためには、msinitを呼び出して初期化し、msexitを呼び出して クリーンアップします。

msclean関数は、プログラム終了前に、呼び出され実行されるプロシージャを、スタックに配置します。

mrルーチンを使用したプログラムは、ccではなくempccまたはempc++で、コンパイルされる必要があります。この結果、 コンパイルで、Empress関数のライブラリが、確実にリンクされます。この他はccと同様に機能します。

mscall文も、empccまたはempc++によって、コンパイルされるプログラムで使用できます。例えば、アプリケーション プログラム内で、新しいテーブルを作成する、最も簡単な方法は、mscall文を使用することです。

ここでは、フィールド値の内部、外部、ファイルフォーマットについて解説します。外部フォーマットは、クエリーのSELECT コマンドによって、表示されるフォーマットです。外部フォーマットの値は、文字列です。

内部フォーマットは、Empressで処理されるフォーマットです。これは外部フォーマットと、必ずしも一致しません。例えば date(1)タイプの値は、"20 April 2003"として処理されているわけではありません。またDOLLARタイプでは、ドル記号、カンマ、ピリオドを 持った値が、処理されているわけではありません。

ファイルフォーマットは、Empressによりディスク上に、値が保存される場合のフォーマットです。アプリケーションプログラムで 、ファイルフォーマットを、直接検索することはありません。

フィールド値は、通常は外部フォーマットで検索されますが、integer値または内部フォーマット値を、直接検索することも 可能です。フィールドへの、値の割り当ては、通常は外部フォーマットまたはinteger値で行いますが、内部フォーマットで 、直接割り当てることも可能です。

外部フォーマットで、検索された値の算術を行なう場合には、sscanf()やatof()を使用して、文字列から数値に変換する必要 があります。またドル記号、アスタリスクなどは、変換前に、DOLLAR値から削除しなければなりません。これを実行する方法 はdollcvtであり、3章で解説します。

BULKデータ値は、他のタイプとは異なった処理となります。外部フォーマットで、Bulk値を出力するには、バイトを通常 必要としない、16進文字に変換します。Bulkデータは、mrgetiを用いて内部フォーマットで取得できます。この関数は Bulkデータの検索用に、特に意図して作成されたものですが、他の内部フォーマットを取得するためにも、使用することが 可能です。次に章のサンプルプログラム、voice.cで内部フォーマットのBulk値を取得する、mrgetiの使用方法を解説して います。

Empressデータタイプ（MSデータタイプ）とC言語データタイプは、通常（マシンのアーキテクチャに従って）、以下のように 対応します。 データベースからの検索値を、C変数に格納する場合には、対応した適切なタイプでなければなりません。

Table 2-1 MSデータタイプに対応するC言語データタイプ

Table 2-2 汎用データタイプに対応するC言語データタイプ

テーブルに、レコードレベルのロックが設定されていて、mrルーチンから、アクセスするレコードがロックされている場合、 あるいは、テーブルに格納しようとしているデータが、範囲チェックや重複制限インデックスのために、認められない場合、 あるいは、不適切なデータが受け渡された場合など、mrルーチンが、正しく実行を完了できない場合があります。

mrルーチンが失敗した場合に、呼出しプログラムを終了するか、しないかは関数によって異なります。関数の、成功あるいは 失敗を示す、フラグを返す関数は、他の方法で指定しない限り、失敗した場合には終了しません。フラグを返さない関数は、 失敗した場合に終了します。操作は、失敗時に終了する関数と、しない関数の2つを使用している場合が、あることに注意 してください。

失敗した場合でも、終了しない関数では、mroperr変数に、mrerrno.hファイルで定義されている、エラー変数MERE....の いづれかがセットされます。mroperr変数を参照する事により、失敗した原因や理由を取得することができ、アプリケーションを 制御することが可能となります。

mrerrno.hファイルの内容を、以下に示します。尚、この内容はバージョンにより違います。正確な内容は、 $EMPRESSPATH/include/usrmrディレクトリ配下にある、ファイルを参照してください。

   /***********************************************************************
    *  (c) Copyright Empress Software Inc. 1983, 2002
    ***********************************************************************/
   
   #define MRNOERR             0 /* no error indication*/
   #define MRERNAME            1 /* invalid table name */
   #define MREREXIST           2 /* table already exists */
   #define MRERNEXIST          3 /* table does not exist */
   #define MRERRPERM           4 /* no read permission on table */
   #define MRERWPERM           5 /* no read/write permission on tab */
   #define MRERBUSY            6 /* database/table lock busy */
   #define MRERVWOP            7 /* operation invalid on view */
   #define MRERVWDEF           8 /* invalid definition for view */
   #define MRERVWRECUR         9 /* recursive definition for view */
   #define MRERDBEXIST        10 /* not a database */
   #define MRERANAME          11 /* invalid attribute name */
   #define MRERAEXIST         12 /* attribute already exists */
   #define MRERANEXIST        13 /* attribute does not exist */
   #define MRERDTPAR          14 /* invalid data type/parameters */
   #define MRERINAME          15 /* invalid index name */
   #define MRERNULL           16 /* null value for attribute */
   #define MRERUDUP           17 /* duplicate value for attribute */
   #define MRERDUP            18 /* too many duplicate values */
   #define MRERCVT            19 /* bad value conversion for attr */
   #define MRERPRIV           20 /* no privilege for table */
   #define MRERAPRIV          21 /* no update privilege on attribute */
   #define MRERCRPRIV         22 /* no create table privilege */
   #define MRERQOP            23 /* invalid operator/function */
   #define MRERQATTR          24 /* incompatible attributes */
   #define MRERQPAT           25 /* invalid pattern */
   #define MRERQRNG           26 /* invalid range */
   #define MRERXCONS          27 /* invalid constant */
   #define MRERXCVT           28 /* invalid conversion */
   #define MRERXFUNC          29 /* invalid operator/function */
   #define MRERIEXIST         30 /* index already exists */
   #define MRERINEXIST        31 /* index does not exist */
   #define MRERICOMP          32 /* index name/definition mismatch */
   #define MRERCREATOR        33 /* invalid creator name */
   #define MRERCRPERMS        34 /* invalid create permissions */
   #define MRERDDEXIST        35 /* data dictionary already exists */
   #define MRERDBA            36 /* not the dba */
   #define MRERINPRIV         37 /* insufficient privileges */
   #define MRERDBACR          38 /* not the dba or creator */
   #define MRERRCNAME         39 /* invalid constraint name */
   #define MRERRCEXIST        40 /* constraint already exists */
   #define MRERRCNEXIST       41 /* constraint does not exist */
   #define MRERRCINSERT       42 /* insert constraint violation */
   #define MRERRCDELETE       43 /* delete constraint violation */
   #define MRERRCLKBUSY       44 /* cannot check constraint */
   #define MRERRCINCDTS       45 /* incompatible types in constraint */
   #define MRERRCOTABLE       46 /* cannot open table for constraint */
   #define MRERRCNATTR        47 /* invalid attribute in constraint */
   #define MRERNLOC           48 /* invalid location */
   #define MRERVWTWICE        49 /* table selected twice in view */
   #define MRERVWNONEQ        50 /* join condition without '=' */
   #define MRERVWOROP         51 /* OR conjunction in view */
   #define MRERVWNOTOP        52 /* NOT operator in view */
   #define MRERVWJOIN         53 /* insufficient join conditions */
   #define MRERVWKEY          54 /* insufficient keys in view */
   #define MRERVWREATTR       55 /* view attributes repeated/equated */
   #define MRERVWNONULL       56 /* cannot obtain 'not null' value */
   #define MRERVWUNIND        57 /* unique value unobtainable in view */
   #define MREREXPR           58 /* expression failure */
   #define MRERTRPROGRESS     59 /* transaction already in progress */
   #define MRERTRSTARTNOT     60 /* unable to start transaction */
   #define MRERTROFF          61 /* no transaction in progress */
   #define MRERTRINVSVP       62 /* invalid save point name */
   #define MRERTRSVPEXISTS    63 /* save point name already exists */
   #define MRERTRNOSVP        64 /* save point does not exist */
   #define MRERNUPDMODE       65 /* table opened in non-updatable mode */
   #define MRERSERVER         66 /* server not available */
   #define MRERANOTDTF        67 /* not a variable length attribute */
   #define MRERINOVRFL        68 /* index has no overflow file */
   #define MRERCRFL           69 /* cannot create data files */
   #define MRERCRFLACCESS     70 /* no access to create data files */
   #define MRERVWATTREX       71 /* too many attribute names specified */
   #define MRERGENDT          72 /* unknown generic type */
   #define MRERRECNO          73 /* invalid record number */
   #define MRERDT             74 /* invalid data type */
   #define MREREXDTPAR        75 /* too many parameters for the data type */
   #define MRERBADDTPAR       76 /* bad data type parameter */
   #define MRERATTRSPEC       77 /* attribute specification not allowed */
   #define MRERHAVBADA        78 /* disallowed attribute in having clause */
   #define MRERVWGRPGRP       79 /* no group by allowed on grouped view */
   #define MRERVWGRPHAV       80 /* no having allowed on grouped view */
   #define MRERVWGRPJOIN      81 /* no join allowed on a grouped view */
   #define MRERVWGRPQUAL      82 /* no qual allowed on grouped view */
   #define MRERVWORDERINT     83 /* invalid order by specification (integer) */
   #define MRERVWINSELHAV     84 /* invalid select list with having clause */
   #define MRERQNESTATTR      85 /* too many attributes in nested select */
   #define MRERVWAGGATTRX     86 /* no derived aggr attribute in expression */
   #define MRERVWAGGRHAV      87 /* no having allowed on aggregate view */
   #define MRERVWAGGRJOIN     88 /* no join allowed on a aggregate view */
   #define MRERVWAGGRQUAL     89 /* no qual allowed on aggregate view */
   #define MRERVWGRPAGGR      90 /* no aggr function allowed on grouped view */
   #define MRERVWINSELDIST    91 /* invalid select list with select distinct */
   #define MRERVWAGGATTRG     92 /* no derived aggr attribute in group by */
   #define MRERNOHASHREC      93 /* record not found in table */
   #define MREROPMODE         94 /* invalid table open mode */
   #define MRERVWORDERSEL     95 /* invalid order by specification (select) */
   #define MRERINVTXT         96 /* invalid char in the value for attribute */
   #define MRERDRIOATTR       97 /* direct I/O not supported for attribute */
   #define MRERDRIOSET        98 /* file redirection error */
   #define MRERCRSIZE         99 /* record size too large */
   #define MRERNLCOMP        100 /* null compile entry for the table */
   #define MRERNOCOMP        101 /* no compile entry for the table */
   #define MRERNVEW          102 /* expecting a view, got a table */
   #define MR_DB_ALREADY_LOCKED 103 /* the database has been already locked */
   #define MR_IN_ADM         104 /* the dba put the database down*/
   #define MRERDTER          105 /* Refer to error at DT level */
   #define MRERINVUREC       106 /* invalid record for update */
   #define MRERURECDEL       107 /* record for update has been deleted */
   #define MRERAGGRNORECS    108 /* no records to do aggregate */
   #define MRERNOCRSHM       109 /* cannot create shared memory */
   #define MRERNORMSHM       110 /* cannot remove shared memory */
   #define MREROUTERILL      111 /* Illegal outer join */
   #define MRERNOSHM         112 /* No shared memory available */
   #define MRERDRECDEL       113 /* deleted record for delete */
   #define MRERNONEXIST      114 /* no data file for '%s' */
   #define MRERNET           115 /* network error in file operation */
   #define MREROPEN          116 /* bad data file for '%s' */
   #define MRERFLOPMODE      117 /* invalid open mode '%c' */
   #define MRERSVPORT_BADID  118 /* invalid server port id */
   #define MRERSVPORT_INCOMPAT 119 /* incompatible server port id */
   #define MRERSVPORT_UNDEF  120 /* server port not defined */
   #define MREROPDICTMODE    121 /* invalid data dictionary open mode */
   #define MRERFULLBUSY      122 /* lock resource is full */
   #define MRERNOLKRESOURCE  123 /* cannot access lock resource */
   #define MRERBADRECORD     124     /* bad record retrieved */
   #define MRERBADDATARETR   125     /* from DT: bad var.len.val.retrieved*/
   #define MRERSORTLOCK      126 /* sort by error(locked) **WARNING */
   
   #define MRERMNAME         127 /* invalid module name */
   #define MRERMEXIST        128 /* module already exist */
   #define MRERMNEXIST       129 /* module does not exist */
   #define MRERLANGOPTION    130 /* invalid language option */
   #define MRERFNAME         131 /* invalid SQL-invoked routine name */
   #define MRERFMCLASS       132 /* there are multiple function
                                    classes for same routine */
   #define MRERFEXIST        133 /* SQL-invoked routine already exist */
   #define MRERFNEXIST       134 /* SQL-invoked routine not exist */ 
   #define MRERPARAMNAME     135 /* invalid parameter name */
   #define MRERPARAMEXIST    136 /* parameter already exist */
   #define MRERPARAMNEXIST   137 /* parameter does not exist */
   #define MRERPARAMNO       138 /* invalid parameter number */ 
   #define MRERQPARAM        139 /* incompatible parameter */
   #define MRERPARAMNUM      140 /* too many parameters */
   #define MRERPARAMNUM1     141 /* expecting one parameter */
   #define MRERPARAMNUM2     142 /* expecting two parameters */
   #define MRERPARAMB        143 /* parameter data type should 
                                    be generic boolean */  
   #define MRERPARAMNB       144 /* parameter data type should 
                                    be parametric data type */
   #define MRERRETB          145 /* return data type should be 
                                    generic boolean */
   #define MRERRETNB         146 /* return data type should be 
                                    parametric data type */
   #define MRERARETNB        147 /* aggregate function's return data type 
                                    should be parametric data type */
   #define MREREXTNAME       148 /* invalid external function name */
   #define MREREXTEXIST      149 /* external name already exist */
   #define MRERFILENEXIST    150   /* file doesn't exist */
   
   #define MRERTRNAME        151  /* invalid trigger name */
   #define MRERTREXIST       152 /* trigger already exist */
   #define MRERTRNEXIST      153 /* trigger does not exist */
   #define MRERMODWRAPCOMPFAIL 154 /* failed to compile wrapper for module */
   #define MRERDDCACHEFAIL   155 /* failed to modify DD_CACHE for module */
   #define MRERXSVFUNC       156 /* SQL-invoked routine '%s' is not 
                                    available on the client */
   #define MRERTRIGABORT     157 /* operation aborted by trigger */
   #define MRERXTRIGPROC     158 /* trigger procedure should have
                                    no parameter */
   #define MRERNOTRIGPROC    159 /* trigger procedure '%s' unavailable */
   #define MRERTRIG_OLD_NEW  160 /* attribute '%s' must be qualified 
                                    by OLD or NEW */
   #define MRERTRIGNESTED    161 /* nested queries are not allowed
                                    for triggers */
   #define MRERPARAMSTYLE    162 /* parameter style of SQL-invoked
                                    routine '%s' inconsistent */ 
   #define MRERMODWRAPGENFAIL 163 /* failed to generate wrapper for system */
   #define MRERNOATTR        164 /* no attributes left in table '%s */
   #define MRERRNGCONVT      165 /* cannot convert range check for 
                                    attribute '%s' */
   #define MRERCANTADDATTR   166 /* cannot add non-null attribute 
                                    to non-empty table */
   #define MRERDUPATTR       167 /* duplicate attribute '%s' */
   #define MRERFEWCONS       168 /* too few constants */
   #define MRERMANYCONS      169 /* too many constants */
   #define MRERWRONGCONS     170 /* wrong number of constants */
   #define MRERAINVEXPR      171 /* invalid expression for attribute '%s' */
   #define MRERSAMETAB       172 /* same table involved in select 
                                    and insert */
   #define MRERFEWSETATTR    173 /* too few SET attributes */
   #define MRERMANYSETATTR   174 /* too many SET attributes */
   #define MRERFEWATTRS      175 /* too few attributes in '%s' */
   #define MRERNOTNULLATTR   176 /* not-null attribute '%s' is not 
                                    included in attribute list */
   #define MRERINVATTR       177 /* invalid attribute '%s' for table '%s' */
   #define MRERINVIDXPARM    178 /* invalid index parameters (%s, %s)" */
   #define MRERNOPRIVCRVW    179 /* insufficient privileges to create view */
   #define MRERUNEQCONSTR    180 /* unequal number of attributes 
                                    in the constraint */
   #define MRERNOCONSTR      181 /* constraint '%s' does not exist */
   #define MRERNOIDX         182 /* index '%s' does not exist */
   #define MRERSYSTABLE      183 /* cannot perform %s operation on %s */
   #define MRERINVOPR        184 /* invalid operator '%s' */
   #define MREREXPRPROB      185 /* expression cannot be evaluated 
                                    or out of range */
   #define MRERUPDMOD        186 /* failed to update module '%s' 
                                    (unable to resolve symbol) */ 
   #define MRERCOPYRL        187 /* failed to copy file from server 
                                    to client */
   #define MRERCOPYLR        188 /* failed to copy file from client 
                                    to server */
   #define MRERINVCALLEXPR   189 /* invalid call expression, output 
                                    is not bound with a variable */
   /* next number is 190 */

プログラム内で、ファイルをオープンする必要がある場合、Empressがすべての使用可能なファイルをオープンしていて 実行できないのであれば、Empressによって、オープンされるファイルの数を制限する必要があります。 これは、オペレーティングシステムに、Empressのシステム変数MSFILESOPENを、設定することで実行できます。 例えば、Empressがオープンできるファイル数を、10に設定する場合を以下に示します。

• UNIX/LINUX Cシェルの場合。
  

     setenv MSFILESOPEN 10

• UNIX/LINUX Bシェルの場合。
  

     MSFILESOPEN = 10
     export MSFILESOPEN

• Windowsの場合。
  

     set MSFILESOPEN = 10

これによって、Empressが10ファイルを越えたアクセスが、できないというわけではありません。 制限の10に到達した場合、Empressは、新しいファイルをオープンする前に、アクセスされていない、古いファイルをクローズ します。Empressによってクローズされたファイルは、必要に応じてアクセス時にオープンされます。Empressはファイルの 内容を内部に保存します。よって、クローズされたり、再オープンされたかはユーザには、わかりません

詳細は、Empress SQL: User's GuideのSetting Variables を参照してください。

mrルーチンの、それぞれの関数名は規則的な方法で、命名されています。個々の関数名は、"mr"で始まります。 次に、機能を表す1文字が付けられます。例えば、条件を処理する関数であれば、"q"が付けられます。 そして、また次には、処理を表す文字、例えば検索であれば"get"が付けられます。 "mr"の次に、"t"が入る関数は、関数の失敗、成功を通知すつ値を返します。"t"が入らない関数は、失敗したら 呼出しプログラムは、終了します。

すべてのmrルーチンの分類と、概要を以下に示します。個々の関数の詳細な仕様は、このマニュアルの最後に記載 されています。プログラム作成時に参照してください。

以下に、テーブルのオープンとクローズで使用される関数を示します。

Table 2-3: オープン関数

以下に、ロックで使用される関数を示します。

Table 2-4: ロック関数

以下に、メモリの確保と解放で使用される関数を示します。

Table 2-5: スペース確保関数

以下に、フィールド記述子の操作で使用する関数を示します。

Table 2-6: フィールド記述子関数

以下に、レコードに値を割り当てに使用する関数を示します。

Table 2-7: レコード割当て関数

以下に、テーブル内にレコードを挿入するために使用する関数を示します。

Table 2-8: 挿入関数

以下に、レコードを削除する場合に使用する関数を示します。

Table 2-9: 削除関数

以下に、レコードを更新する場合に使用する関数を示します。

Table 2-10: 更新関数

以下に、検索に初期化を行なう場合に使用する関数を示します。

Table 2-11: 初期化関数

以下に、検索のために使用される関数を示します。

Table 2-12: 検索関数

以下に、フィールド値の比較を実行する場合に使用する関数を示します。

Table 2-13: 比較関数

以下に、異なるデータタイプ間で、値の変換に使用する関数を示します。

Table 2-14: 入力変換関数

以下に、フィールドを比較する場合に使用する関数を示します。

Table 2-15: 条件関数

以下に、トランザクションを制御するのに使用する関数を示します。

Table 2-16: トランザクション関数

以下に、表現を構築する場合に使用する関数を示します。

Table 2-17: 表現関数

以下に、BULKとTEXTデータタイプ用の、データストリーミング関数を示します。

Table 2-18: データストリーミング関数

以下に、エラーハンドリングに使用する関数を示します。

Table 2-19: エラーハンドリング関数

アプリケーションプログラムの作成時に、ユーザ関数名が、Empressの内部関数名と 同一の場合、リンク時にエラーが発生します。関数名で障害が発生した場合、接頭辞をチェックして、必要に応じて変更してください。

この障害を防ぐために、Empress内部関数名に使用される、接頭辞の一覧を以下に示します。（この一覧は完璧なものでは ありません。またバージョンにより違います。）

   addr         ap*
   byte
   cpbytes*     cv* 
   date*        day*       dt* 
   er*          ewrite*    exit*     extsrt* 
   fl*          fm*        fork* 
   gdat*        gdec*      gflt*     gint* 
   int
   ll* 
   main         match*     mem*      month*   mp*    mr*     ms*
   msbool       mw*        mx* 
   of* 
   prog* 
   ql* 
   ran* 
   sc*          sep*       sfmt       sig*     sm*    sp*     str* 
   taddr        time*      tty*     
   ufx* 
   varg* 
   wkday*       word        ww* 
   xf* 
   year*

mrルーチンの、一般的な使用法を以下に解説します。以下に記述する関数の多くは、失敗時に呼出しプログラムを終了 しないで、エラーコードを返すものと、呼出しプログラムを終了させるものの、相対する2種類の関数を提供します。 また、検索や条件定義のためにも、多くの関数を提供します。次の章では、関数の使用方法に関する解説と、サンプル プログラムを提供します。

データベースディレクトリ、テーブル名、オープンするモードを指定し、mropen関数を実行すると、テーブルをオープンし 、データディクショナリーに設定されたレベルにより、ロックを行いテーブル記述子のポインタを返します。 一旦テーブルがオープンされると、mrmkrec関数により、テーブル記述子からレコード記述子のポインタを取得します。 その後、数々の操作を行なった後に、mrclose関数によってテーブルをクローズします。

フィールドの操作を行なう場合には、フィールド識別子を取得するために、mrigeta関数、またはmrngeta関数を使用します。 既に記述子がある場合には、mrganame関数を使用して、フィールド名を取得できます。

レコードを検索する場合には、mrgetbegin関数により初期化します。この関数は、検索条件をテーブルのレコードと関連付け します。検索条件がない場合でも、mrgetbegin関数は呼出しが必要となり、ソートされた検索を行なう場合には、代わりに mrsrtbegin関数を使用します。

検索条件は、mrqcon関数、mrqrng関数、mrqatr関数、mrqmch関数、mrqnul関数を使用して設定します。これらの関数は、 フィールド値を定数、範囲、他のフィールド値と比較し定数とのマッチングや、NULLとの比較を行なうために使用されます。 この時使用される値が、外部フォーマットの場合には、mrcvt関数により、ファイルフォーマットへ変換しなくてはなりません。 複雑な検索条件には、ANDやORまたはNOTを指定しなくてはなりません。その場合には、mqrand関数、mrqor関数、 mrqnot関数を使用します。

検索は、mrget関数とmrprev関数を繰り返し使用することによって実行されます。mrget関数（またはmrprev関数）を使用する ごとに、定義されたレコード構造に、内部フォーマットでレコード値が保存されます。他のプロセスによりロックされ、一時的に アクセスできない場合には、再検索するためにmrreget関数（またはmrreprev関数）を使用します。mrspv関数は、フィールド値 の、保存用スペースを割当てるために使用します。mrcopyv関数は、そのスペースに値を保存します。（TEXTデータタイプの 場合には、mrcopyv関数の代わりに、mrgetvs関数を使用しなくてはなりません。）こうして、アプリケーションプログラムによって 、検索と操作が可能な文字列による、外部フォーマットが作成されます。

mrfree関数は、mrspv関数によって、割当てられたスペースを開放します。

フィールドの集計関数（COUNT、MIN、MAX、AVG、SUM）は、mrgfunc関数によって実行されます。

   database:table

   attribute
   table.attribute
   database:table.attribute

   *** エラータイプ *** エラーの詳細