メソッドのプロパティ

[アーティクル]
07/21/2023

メソッドのプロパティページを使用して、配列、COBOL、デザイン、ホスト定義、およびレコードセットのプロパティをメソッドに設定します。

配列プロパティ

プロパティ	目的
配列の次元	戻り値の配列次元を選択します。既定値は (なし) です。
配列です	戻り値が配列かどうかを選択します。次の値を指定できます。 - True - False (既定値)
に応じて発生します	テーブルの前の数値データ項目 (オートメーションのレコードセットまたは配列) が、送受信される行または要素の実際の数を示す場合に選択します。 COBOL の可変長テーブルと同じです。ドロップダウンリストを使用して、この値を指定する数値データ項目を選択します。 CICS Link の場合は、レコードセットまたは配列、および関連する長さ指定子を入出力する必要があります。テーブルに指定された最大サイズに関係なく、可変長テーブルの直後にあるバッファー内のデータ。複数の次元を持つ配列は、最も外側のループ (COBOL) または右端のディメンション (Microsoft® Visual C++ ® または Visual Basic) にのみ使用できます。既定値は (なし) です。

COBOL プロパティ

プロパティ	目的
ホストデータ型	ホストデータ型を選択します。
エラー処理	戻り値のエラー処理を選択します。次の値を指定できます。 - 切り捨てます。エラーが発生したときに値を切り捨てる TI を設定するには、このオプションを選択します。 (既定値)。 - ラウンド。エラーが発生したときに値を丸める TI を設定するには、このオプションを選択します。 - エラー。エラーが発生したときにエラーを返すように TI を設定するには、このオプションを選択します。
Filler	戻り値の入力口を入力します。既定値は 0 です。
ホストから	サーバーから受信したバッファーに、このデータ項目の後に続く FILLER のバイト数を入力します。 FILLER は、バッファー内に未変換のギャップを引き起こします。 FILLER はオートメーション側では表示されません。既定値は 0 です。
ホストする	サーバーに送信されるバッファーに、このデータ項目の後に続く FILLER のバイト数を入力します。 FILLER は、バッファー内に未変換のギャップを引き起こします。 FILLER はオートメーション側では表示されません。既定値は 0 です。
スケール	戻り値のスケールを入力します。
Sign 属性	戻り値の符号属性を選択します。次の値を指定できます。 - 末尾。符号付き DISPLAY データ型の場合、符号が末尾であることを示します (既定値)。このオプションは、署名付き DISPLAY データ型の書式設定方法を TI ランタイム環境に示し、ホストからのデータが Automation データ型との間で変換される方法に影響します。 - 末尾に区切りを付ける。符号付き DISPLAY データ型の場合は、記号が個別であることを示します。このオプションは、署名付き DISPLAY データ型の書式設定方法を TI ランタイム環境に示し、ホストからのデータが Automation データ型との間で変換される方法に影響します。 - 先頭。符号付き DISPLAY データ型の場合、符号が先頭にあることを示します。このオプションは、署名付き DISPLAY データ型の書式設定方法を TI ランタイム環境に示し、ホストからのデータが Automation データ型との間で変換される方法に影響します。 - 先頭に区切りを付ける。符号付き DISPLAY データ型の場合は、記号が個別であることを示します。
サイズ	戻り値のサイズを入力します。
SOSI	2 バイト文字セット・データがシフトアウト (SO) で始まり、シフトイン (SI) 文字で終わる必要があるかどうかを指定するには、このオプションを選択します。次の値を指定できます。 - True。 SO 文字と SI 文字は、ホストアプリケーションから受信するとデータから削除され、SO 文字と SI 文字はホストアプリケーションに送信されるときにデータに追加されます。 PIC G の長さでは、TI ランタイム環境で適用されるため、SO 文字と SI 文字の 2 バイトを含める必要はありません。 - False (既定値)
文字列区切り	戻り値の文字列区切りを選択します。次の値を指定できます。 - スペース埋め込み。文字列のメインフレーム表現が、文字列定義にスペース文字を埋め込むことで区切られたことを TI ランタイム環境に伝えます。たとえば、メインフレームの COBOL 定義が PIC X(10) で、文字列内に 3 文字しかない場合、メインフレームは 7 つの末尾のスペースを想定します。したがって、このオプションを選択すると、TI ランタイム環境は、メインフレームに送信される文字列を変換して、メインフレームに送信する前に文字列の NULL 終了文字を適切な数の末尾のスペースに変更するように指示します。たとえば、文字列が PIC X(10) としてメインフレームで定義されている場合、TI は ABC の文字列と 7 つの末尾のスペースを送信します。このオプションを選択すると、文字列の末尾のスペースを 1 つの null 終端文字に変換することで、メインフレームから返される出力文字列を TI Automation サーバーに変換するように TI ランタイム環境にも指示されます。詳細については、「スペースを使用したメインフレーム文字列の埋め込み」を参照してください。 (既定値)。 - Null で終わる。 TI ランタイム環境に、文字列のメインフレーム表現が null 文字 (EBCDIC 0x00) で区切られたことを通知します。このオプションを選択すると、メインフレームに文字列を送信する前にバイトの空きがある場合は、TI ランタイム環境に文字列の末尾に 1 つの null 文字を追加するように指示し、メインフレームから文字列を受信したときに発生した最初の null 文字で停止するように TI ランタイム環境に指示します。したがって、このオプションを選択すると、TI は後続のスペースを 1 つの NULL ターミネータに変換しないため、メインフレームから送信される出力文字列の末尾のスペースを保持するように TI に指示します。詳細については、「スペースを使用したメインフレーム文字列の埋め込み」を参照してください。

デザインプロパティ

プロパティ	目的
32K の入力/出力を許可する	TI で入力 DFHCOMMAREA を出力 DFHCOMMAREA とは別に処理する場合は、このオプションを選択します。 TI は通常、入力 DFHCOMMAREA と出力 DFHCOMMAREA エリアを結合します。結合された領域は、32 KB のデータを超えることはできません。このオプションを選択すると、TI は入力 DFHCOMMAREA を出力 DFHCOMMAREA とは独立して処理します。入力領域と出力領域ごとに、最大 32 KB のデータが使用されます。このオプションを変更すると、現在選択されているメソッドに影響します。次のいずれかの値になります。 - True - False (既定値) 注: このプロパティは、Windows によって開始される処理 (WIP) CICS プログラミングモデルおよびホストによって開始される処理 (HIP) プログラミングモデルの "リンクプログラミングモデルの使用" のアクセサリとして使用できます。メモ：このプロパティは、 Is Link プロパティが True に設定されている場合にのみ使用できます。
説明	メソッドの説明を入力します。説明には、最大 250 文字の Unicode 文字を指定できます。
ヘルプコンテキスト ID	このメソッドに関連付けられているヘルプコンテキスト ID を入力します。 ID は、このメソッドのヘルプに接続するために使用され、このメソッドの呼び出し中に例外が発生したときに返されます。既定値は 0 です。
コンテキストパラメーターを含める	クライアントオブジェクトメソッドにコンテキストを自動的に含めるかどうかを選択します。次の値を指定できます。 - True。 Visual Basic .NET では、引数に追加のパラメーターとしてコンテキストが自動的に含まれます。他のパラメーターと共に COMTIContext パラメーターをメソッド呼び出しに含めない場合、Visual Basic .NET はエラーメッセージ "System.MissingMemberException" 型の未処理の例外が microsoft.visualbasic.dllで発生し、記述したパラメーターの数でメソッドを呼び出すことができないことを通知します。このメッセージが表示された場合は、 Include Context Parameter がメソッドのパラメーターの一覧内のパラメーターとして含まれていることを確認します。 - False。 Visual Basic .NET では、引数に追加パラメーターとしてコンテキストが自動的に含まれることはありません。このプロパティを False に設定し、他のパラメーターと共に COMTIContext パラメーターをメソッド呼び出しに含める場合、Visual Basic .NET はエラーメッセージを返します。型 'System.MissingMemberException' のハンドルされない例外が microsoft.visualbasic.dllで発生し、作成したパラメーターの数でメソッドを呼び出すことができないことを通知します。このメッセージが表示された場合は、メソッドパラメーターリストから COMTIContext パラメーターを削除します。既定値は Trueです。
初期バッファー値	初期バッファー値を入力します。既定値は null です。
Is Link	ホストオブジェクトメソッドで Link プログラミングモデルを使用するかどうかを選択します。 Windows によって開始される処理 (WIP) に使用できる値は次のとおりです。 - True。リンクモデルを使用します。リンク・プログラミング・モデルは、CICS リンク・プロトコルでのみ使用できます。 - False。リンクモデルは使用しないでください。既定値は Falseです。ホストによって開始される処理 (HIP) に使用できる値は次のとおりです。 - はい。リンクモデルを使用します。リンクプログラミングモデルは、すべてのプロトコルで使用できます。 - いいえ。リンクモデルは使用しないでください。 - 32K の入力/出力を使用してリンクします。リンクモデルを使用し、From Host プロパティと To Host プロパティを設定します。既定値はいええです。
メタデータ	メタデータの処理方法を選択します。次の値を指定できます。 - (なし)。既定では、ホストアプリケーションに対する特別なデータの送受信は行われません。メソッドのデータのみを送受信する場合は、このオプションボタンを選択します。 - メソッド情報を含めます。パラメーターデータと共にホストに送信されるこのメソッドの名前。メソッド名は、バッファー内の最初の 32 バイトとして送信されます。このオプションは、複数のメソッド呼び出しが同じトランザクションに移動し、データを異なる呼び出しと区別する場合に便利です。 - すべての情報を含めます。メソッドデータと共に送受信できるすべてのメタデータ。メタデータの形式の詳細については、「省略可能なメタデータ」の説明を参照してください。
名前	メソッドの名前を入力します。名前には、最大 250 文字の Unicode 文字を指定できます。名前は、同じプロジェクト内の他のメソッド名とは異なっている必要があります。既定値は null です。
戻り値の後の位置	選択したデータ項目がホストから受信されたときに続く Automation メソッドの戻り値を入力します。このオプションは Automation 側には影響しません。 Automation の戻り値として指定するデータ項目が、ホストから受信したデータを記述するデータ宣言の最初のデータ項目フィールドでない場合は、このオプションを使用します。
予備的なフィラー	ホストから受信またはホストに送信された FILLER のバイト数を表示します。
ホストから	サーバーから受信したバッファーに、このデータ項目の後に続く FILLER のバイト数を入力します。 FILLER は、バッファー内に未変換のギャップを引き起こします。 FILLER はオートメーション側では表示されません。
ホストする	サーバーに送信されるバッファーに、このデータ項目の後に続く FILLER のバイト数を入力します。 FILLER は、バッファー内に未変換のギャップを引き起こします。 FILLER はオートメーション側では表示されません。
戻り値の型	戻り値の型を選択します。次の値を指定できます。 - 無効 - ブール - バイト - 日付 - 通貨 - 10 進 - 整数 - 長い - ダブル - 単一 - 文字列 - ユーザー定義型 - レコード - (なし) (既定値)
可変サイズの最終フィールド	- 最後のデータ項目が文字列の場合は、このオプションを選択して、文字列のサイズが異なっていることを示します。このオプションは、データテーブルまたはレコードセットを境界付きとして定義したり、パラメーターに設定された最大出現回数として定義されているすべての行を含めたりするためにも使用されます。
ホストから	- True - False (既定値)
ホストする	- True - False (既定値)

ホスト定義のプロパティ

プロパティ	目的
プログラムへのリンク名	プログラムへのリンク名 (CICS LINK/DPL) を入力します。
ミラートランザクション ID	このコンポーネントが関連付けられているリモート環境 (RE) のミラー TRANID をオーバーライドする場合は、このメソッドが使用するミラー TRANID を入力します。このボックスを空白のままにすると、リモート環境の説明にミラー TRANID が使用されます。 TRANID の長さは最大 4 文字です。使用できる文字は、A-Z a-z 0-9 $ @ # です。 / _ % & ? ! : \|= , ; <>。 C で始まるトランザクション名は CICS 用に予約されており、使用しないでください。 % 文字と & 文字は、トランザクション・セキュリティーがアクティブな場合に、リソースAccess Control機能 (RACF) に問題を引き起こす可能性があります。
TP 名	CICS アプリケーション・プログラムが DB2 データベースにアクセスする必要がある場合は、ソース・トランザクション・プログラム (TP) 名を入力します。 TP 名は、CICS トランザクションを DB2 プランに関連付ける CICS リソース制御テーブル (RCT) 項目で参照されます。ホスト・トランザクション・プログラム (IMS または CICS) の名前、またはリンク先プログラム名 (CICS LINK/DPL) を指定します。

レコードセットのプロパティ

プロパティ	目的
実際のサイズを含める	ホストプログラムには、送受信される実際の行数 (レコードセット) または要素 (配列) を示す情報は含まれません。次の値を指定できます。 - True - False (既定値) このプロパティは読み取り専用であり、タイプライブラリが COM トランザクションインテグレーターの最初のバージョンで作成された時点で True に設定されていない限り、常に False に設定されます。
最大出現回数	行の最大出現回数。ホストに送信またはホストから受信する行の最大数を示します。 COBOL グループ項目の OCCURS n TIMES キーワード (keyword)と同じです。既定値は 1です。
に応じて発生します	COBOL の可変長テーブルと同じです。テーブルの前の数値データ項目 (オートメーションのレコードセットまたは配列) が、送受信される行または要素の実際の数を示していることを示します。ドロップダウンリストを使用して、この値を指定する数値データ項目を選択します。 CICS Link の場合は、レコードセットまたは配列、および関連する長さ指定子を入出力する必要があります。テーブルに指定された最大サイズに関係なく、可変長テーブルの直後にあるバッファー内のデータ。複数の次元を持つ配列の場合、最も外側のループ (COBOL) または右端のディメンション (Visual C++ または Visual Basic) にのみ使用できます。戻り値レコードセットは、に応じて発生します。既定値は (なし) です。
無制限	レコードセットが無制限であることを示します。ホストとの間で任意の数の行を送受信できることを示します。このオプションは、送受信される行がデータベースからのものであり、行の最大数が不明な場合に選択します。次の値を指定できます。 - True。最後のデータ項目が文字列の場合、これは文字列のサイズが異なっていることを意味します。 - False。最後のデータ項目が配列の場合は、配列内の要素の数が異なっていることを意味します。最後のデータ項目がレコードセットの場合、これはレコードセット内の行数が異なっていることを意味します。 (既定値)。

注意事項

コンポーネントのプロパティは、プログラムによって設定または変更されるものではありません。プログラムでプロパティを設定または変更すると、コンポーネントが正しく機能しなくなる可能性があります。

参照

COMTIContext によるカスタム TRM と ELM
メソッド名ノード (.NET)
プロパティ (TI プロジェクト)