CBLEEMCP('ACTCN ') - コネクションの確立
- 〈このページの構成〉
機能
コネクションを確立します。
コネクションの確立後，MCP後処理トランザクションを起動します。
コネクションの確立は非同期で実行されるため，この関数で返されるリターン値が00000の場合でも，コネクションの確立が失敗しているときがあります。コネクションの確立結果は，MCP後処理トランザクションによって通知されます。
この関数で指定したコネクションID中に，相手システム（eemcpcnオペランド -o）を省略したeemcpcnオペランドのコネクションIDが含まれていた場合は，指定した全コネクションIDのコネクション確立処理は実行されません。
形式
- PROCEDURE DIVISIONの指定
CALL 'CBLEEMCP' USING 一意名1 一意名2
- DATA DIVISIONの指定
01 一意名1. 02 データ名A PIC X(8) VALUE 'ACTCN '. 02 データ名B PIC X(5). 02 FILLER PIC X(3). 02 データ名Z PIC S9(9) COMP VALUE ZERO. 01 一意名2. 02 FILLER PIC X(4). 02 データ名C PIC 9(9) COMP. 02 データ名D PIC X(9). 02 データ名E PIC X(9). 02 データ名F PIC X(9). 02 データ名G PIC X(9). 02 データ名H PIC X(9). 02 データ名I PIC X(9). 02 データ名J PIC X(9). 02 データ名K PIC X(9).
UAPで値を設定する引数
●データ名A
コネクションの確立を示す要求コードを「VALUE 'ACTCN△△△'」と設定します。
●データ名Z
0を設定します。
●データ名C
コネクションを確立するコネクションID数を設定します。1〜8の範囲で指定してください。
●データ名D，E，F，G，H，I，J，K
コネクションを確立するコネクションIDを設定します。コネクションIDはeemcpcn定義コマンドの-yオプションのmodeオペランドにclientを指定したコネクションだけ設定できます。
コネクションIDの長さは最大8バイトです。コネクションIDの後ろは空白で埋めてください。
コネクションIDは，*を使って一括指定できます。一括指定は一つだけ指定できます。一括指定する場合は，データ名Cに1を設定して，データ名Dに「*」または「先行文字列*」の形式で設定してください。
「*」の場合はすべてのコネクションを確立します。「先行文字列*」の場合は先行文字列で始まるすべてのコネクションを確立します。
TP1/EEから値が返されるデータ領域
●データ名B
ステータスコードが，5けたの数字で返されます。
ステータスコード
|
ステータスコード |
意味 |
|---|---|
|
00000 |
正常に終了しました。 |
|
00001 |
TP1/EEの環境下にありません。 |
|
00004 |
UOCから発行しているため，この機能は使用できません。 |
|
10003 |
データ名Aに設定した値が間違っています。 |
|
10005 |
データ名Zに設定した値が間違っています。 |
|
10008 |
データ名Cに設定した値が間違っています。 |
|
10009 |
発行条件が不正です。 |
|
10010 |
指定したコネクションIDの中に不正なコネクションIDがあります。 |
|
10027 |
システムエラーが発生しました。 |
|
10028 |
一部のコネクションの確立に失敗しました。 |
|
10030 |
メモリ不足が発生しました。 |
|
10048 |
指定したコネクションはすでに使用中です。 |
注意事項
コネクションの確立は非同期で行われます。したがって，この関数で返されるステータスコードが「00000」であった場合でも，コネクションの確立に失敗している場合があります。コネクションの確立結果はMCP後処理トランザクションで通知されます。