8.2.2　TP1/COBOLアクセス用BeanユーザインタフェースAPI

(1)　遠隔サービスの要求

[ callメソッド ]
 
public void call(int cltid,
                java.lang.String group,
                java.lang.String service,
                int flags)
         throws J2CBException

[ callToメソッド ]
 
public void callTo(int cltid,
                java.lang.String hostnm,
                int scdport,
                java.lang.String group,
                java.lang.String service,
                int flags)
         throws J2CBException

ページの先頭へ

(2)　出力引数データの取得

[getXxxOメソッド]
 
public Object getXxxO( [ int dim1 { , int dim2 } … ] ) throws J2CBException

メソッド名getXxxOのXxxは，設定するデータ項目のデータ名を表します。また，[ int dim1 { , int dim2 } … ]は，OCCURS句による繰り返しがあることを表します。（[setXxxIメソッド]の例をご覧ください）

パラメタ：

dim1,dim2… ：（添字が必要な場合の）各次元の添字

戻り値：

取得できたデータオブジェクト

例外：J2CBException - 例外情報の取得

詳細は「8.8　J2CBExceptionユーザインタフェースAPI」をご覧ください。

ページの先頭へ

(3)　メッセージの送受信

[ receiveメソッド ]
 
public void receive(int cltid,
                int timeout,
                int flags)
         throws J2CBException

[ receive2メソッド ]
 
public void receive2(int cltid,
                int timeout,
                int flags)
         throws J2CBException

[ sendメソッド ]
 
public void send(int cltid,
                java.lang.String hostname,
                int portnum,
                int flags)
         throws J2CBException

ページの先頭へ

(4)　setter発行時の入力引数長設定

[setInLenFollowSetDataメソッド]
 
public void setInLenFollowSetData()

TP1/Clientに渡す入力引数の長さをこのメソッドを呼び出した直後のsetXxx(obj)の末尾までの長さとします。また．設定するデータが英数字項目（Stringまたはbyte[]）の場合は，objを英数字項目に転記後の末尾までの長さとします。

このメソッドを呼び出す例

01  ARG.
 02 ARGCOMP PIC S9(9) USAGE COMP.   --> setter名はsetArgcompIとなる
 02 ARGALNUM PIC X(60).       --> setter名はsetArgalnumIとなる

上記の入力引数の設定前にこのメソッドを呼び出すと，入力引数の長さを変更できます。

（その1）ARGCOMPまでの入力引数とする場合
  setInLenFollowSetData();
  setArgcompI(new Integer(10));
  call(....);                 --> 入力引数の長さは4となる。
（その2）ARGALNUMの先頭８文字までを入力引数とする場合
  setArgcompI(new Integer(4));
  setInLenFollowSetData();
  setArgalnumI("abcdefgh");
  call(....);                 --> 入力引数の長さは12となる。

このメソッドを呼び出さない場合

入力引数の長さは，入力引数領域長です。

パラメタ：なし

戻り値：なし

例外：なし

ページの先頭へ

(5)　入力引数データの設定

[setXxxIメソッド]
 
public void setXxxI(Object xxxI [ , int dim1 { , int dim2 } … ] ) throws J2CBException

メソッド名setXxxIのXxxおよび引数xxxIのxxxは，設定するデータ項目のデータ名を表します。

（例）

02 WK-DATANAME PIC X(10). と定義されたデータが入力引数にある場合，次に示すsetterになります。

public void setWk_datanameI(Object wk_datanameI) throws J2CBException

• setterを呼び出してデータ項目に値を設定する場合，データ項目に対応するデータ属性のパラメタxxxIを指定してください。データ項目の対応は，「表 8-6　各データ項目に対応する表示文字列」をご覧ください。

• [ , int dim1 { , int dim2 } … ]は，OCCURS句による繰り返しがあることを表します。

  dimは次元の個数分作成されます。

（例）

２次元の文字データが引数にある場合，次に示すsetterになります。

public void setWk_dataname(Object wk_datanameI, int dim1, int dim2) throws J2CBException

パラメタ：

xxxI - 設定するデータ

dim1,dim2… ：（添字が必要な場合の）各次元の添字

戻り値：

なし

例外：J2CBException - 例外情報の取得

詳細は「8.8　J2CBExceptionユーザインタフェースAPI」をご覧ください。

ページの先頭へ