Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

9.22 COMPOSER_CALLF

Note
title注意

 9.1 組み込み関数の規則     利用オプション

この組み込み関数は、LANSA Composer V3.0 以降で利用可能です。

...

この組み込み関数は、他のLANSAシステムや区画にインストールされているLANSAアプリケーションに含まれる処理ロジックを起動するために、カスタム・アクティビティ・プロセッサもしくはLANSA Composerの他のユーザー定義のプラグイン・コンポーネントで使用されることを目的としています。 

この組み込み関数を実行する前に、9.24 COMPOSER_USE 組み込み関数を使用して、サーバー接続詳細とそれを表す別名を定義しなくてはいけません。

...

番号

タイプ

必須/任意

記述

最小長

最大長

最小小数桁数

最大小数桁数

1

A

必須

LANSA Composerのサーバー別名。Composerのサーバー別名

LANSA Composerサーバーシステムへの接続詳細を識別するのに使用される別名を指定します。名前は、COMPOSER_USE組み込み関数を使用して、現在のセッションにおいて、これより前に指定されていなくてはいけません。

1

10



2

A

必須

呼び出されるファンクションを含むLANSAプロセスの名前。呼び出されるファンクションを含むLANSAプロセスの名前

IBM i:*DIRECTが指定されている場合には、ファンクションはFUNCTION OPTIONS(*DIRECT)で定義されていなくてはいけません。 

Windowsサーバー:*DIRECTではなく、プロセス名が指定されていなくてはいけません。

1

10



3

A

必須

呼び出されるファンクションの名前

呼び出されるファンクションの名前。必須。必須

1

7



4

N

任意

使用される交換変数の数

使用される交換変数の数。指定されていない場合、省略値の0とみなされます。指定されていない場合、省略値の0とみなされます。

1

5

0

0

5

A

任意

交換変数EXCH01の値 (「交換変数」を参照)

1

256



6

A

任意

交換変数EXCH02の値 (「交換変数」を参照)

1

256



7

A

任意

交換変数EXCH03の値 (「交換変数」を参照)

1

256



8

A

任意

交換変数EXCH04の値 (「交換変数」を参照)

1

256



9

A

任意

交換変数EXCH05の値 (「交換変数」を参照)

1

256



10

A

任意

交換変数EXCH06の値 (「交換変数」を参照)

1

256



11

A

任意

交換変数EXCH07の値 (「交換変数」を参照)

1

256



12

A

任意

同期呼び出しか否か。同期呼び出しか否か

組み込み関数がファンクション呼び出しが完了するのを待つかどうかを指定します。 

省略値は'Y'で、待ちます。

それ以外の値が指定されている場合には、組み込み関数はファンクション呼び出しを投げた後、すぐに終了します。 

このパラメータが'Y'の場合、この組み込み関数は呼び出されたファンクションからの値(EXCH01~EXCH07の交換変数)のみ受け取ることができます。

1

1



13

N

任意

同期タイムアウト(秒)。同期タイムアウト(秒)

組み込み関数が、同期呼び出しが完了するのを待つ秒数。このタイムアウトを超えた場合、組み込み関数は結果コード'TM'で終了します。 デフォルトは30秒です。

1

5

0

0

14

N

任意

要求の有効期限(秒数)

IBM i のみ

Windowsサーバーには適用されません。要求の有効期限(秒数)。IBM i のみ。Windowsサーバーには適用されません。

IBM i サーバーにおいてのみ、リクエストサーバーに要求が投げられた後、要求が有効である秒数を指定します。リクエストサーバーが要求を処理し始めるまでに指定された間隔よりも長く経過した場合には、要求の有効期限が切れたと考え、その処理を行うのを取りやめます。

省略値はゼロ(0)であり、この場合、要求は期限切れを起こしません。 

有効期限は、IBM i サーバーのリクエストサーバーを通して実行された要求にのみ適用されることにご注意ください。Windowsサーバー上で実行される場合には、有効期限は適用されません。

1

5

0

0

...

番号

タイプ

必須/任意

記述

最小長

最大長

最小小数桁数

最大小数桁数

1

A

任意

結果コード。結果コード

組み込み関数が正常に完了した場合には、結果コードには'OK'と入ります。同期要求がタイムアウトした場合には、結果コードには'TM'と入ります。それ以外の結果コードは、エラーが起こったことを示します。

2

2



2

A

任意

交換変数EXCH01の値 (「交換変数」を参照)

1

256



3

A

任意

交換変数EXCH02の値 (「交換変数」を参照)

1

256



4

A

任意

交換変数EXCH03の値 (「交換変数」を参照)

1

256



5

A

任意

交換変数EXCH04の値 (「交換変数」を参照)

1

256



6

A

任意

交換変数EXCH05の値 (「交換変数」を参照)

1

256



7

A

任意

交換変数EXCH06の値 (「交換変数」を参照)

1

256



8

A

任意

交換変数EXCH07の値 (「交換変数」を参照)

1

256



この例では、COMPOSERという別名を使いあらかじめ定義されたLANSAシステムへ接続して(COMPOSER_USEを参照)、簡単なファンクション呼び出しを行います。プロセス名は変数#PROCESSに、ファンクション名は変数#FUNCTIONに指定されています。

     use builtin(COMPOSER_CALLF) with_args('COMPOSER' #PROCESS #FUNCTION)

この例ではファンクションを呼び出すために、上記と同じLANSAシステムに接続します。プロセス名は変数#PROCESSに、ファンクション名は変数#FUNCTIONに指定されています。次の2つのパラメータ値が受け渡されます。'VALUE 1' 及び 'VALUE 2'です。これらの値を交換リストを通じて受け取るには、呼び出されるファンクションにEXCH01及びEXCH02というフィールドが定義されていなくてはいけません。このケースでは、呼び出しが非同期であるため、ファンクションが完了するのを待たずに処理が続行されます。

...

組み込み関数は同期的に実行された場合、呼び出されたファンクションから戻ってきた値のみを受け取ることに注意してください。

交換リストを使用した情報の交換について詳しくは「EXCHANGE」コマンドの記述をご参照ください。

Anchor
COMPOSER_CALLF_NOTE1
COMPOSER_CALLF_NOTE1
呼び出されるファンクションについてのLANSAプログラミングの考慮事項

...