共用方式為

方法屬性

  • 發行項

使用 [方法 屬性] 頁面，在 方法上設定陣列、COBOL、設計、主機定義和記錄集屬性。

陣列屬性

使用 作法
陣列維度 選取傳回值的陣列維度。 預設值為 (無) 。
Is Array 選取傳回值是否為陣列。 可能的值包括：

- 真
- False (預設)
發生視情況而定 選取以指出自動化中數據表前面 (記錄集或陣列的數值數據項，) 表示傳送或接收的實際數據列或項目數目。 相當於 COBOL 中的可變長度數據表。

使用下拉式清單來選取指定此值的數值數據項。 針對 CICS Link，記錄集或數位和相關聯的長度規範必須是 in/out。緩衝區中的數據會緊接在數據表的最後一個數據項後面，而不論為數據表指定的大小上限為何。 具有多個維度的陣列只能用於最外層循環 (COBOL) 或最右邊的維度， (Microsoft® Visual C++ ® 或 Visual Basic) 。 預設值為 (無) 。

COBOL 屬性

使用 作法
主機數據類型 選取主機數據類型。
錯誤處理 選取傳回值錯誤處理。 可能的值包括：

- 截斷。 選取此選項可設定 TI，以在發生錯誤時截斷值。 (預設值)
- 四捨五入。 選取此選項可設定 TI 在發生錯誤時四捨五入值。
- 錯誤。 選取此選項可設定 TI，以在發生錯誤時傳回錯誤。
Filler 輸入傳回值填入。 預設為 0。
從主機 在從伺服器接收的緩衝區中，輸入在這個數據項後面的 FILLER 位元元組數目。 FILLER 會導致緩衝區中未轉譯的間距。 AUTOMATION 端看不到 FILLER。 預設為 0。
主控 在傳送至伺服器的緩衝區中，輸入在這個數據項後面的 FILLER 位元組數目。 FILLER 會導致緩衝區中未轉譯的間距。 AUTOMATION 端看不到 FILLER。 預設為 0。
調整 輸入傳回值小數字數。
符號屬性 選取傳回值符號屬性。 可能的值包括：

- 尾端。 針對已簽署的 DISPLAY 數據類型，表示正負號為尾端 (預設) 。 此選項表示 TI 執行時間環境如何格式化帶正負號的 DISPLAY 資料類型，並影響主機的數據如何轉換成自動化資料類型，以及從自動化數據類型轉換數據的方式。
- 尾端分隔。 針對帶正負號的 DISPLAY 數據類型，表示符號是分開的。 此選項表示 TI 執行時間環境如何格式化帶正負號的 DISPLAY 資料類型，並影響主機的數據如何轉換成自動化資料類型，以及從自動化數據類型轉換數據的方式。
- 前置。 針對已簽署的 DISPLAY 數據類型，表示正負號為前置。 此選項表示 TI 執行時間環境如何格式化帶正負號的 DISPLAY 資料類型，並影響主機的數據如何轉換成自動化資料類型，以及從自動化數據類型轉換數據的方式。
- 前置分隔。 針對帶正負號的 DISPLAY 數據類型，表示符號是分開的。
大小 輸入傳回值大小。
SOSI 選取此選項可指定雙位元組字元集數據的開頭必須是移出 (SO) ，並以移入 (SI) 字元結尾。 可能的值包括：

- True。 從主應用程式接收 SO 和 SI 字元時，會從資料中移除，而 SO 和 SI 字元會在傳送至主應用程式時新增至數據。 在 PIC G 的長度中，不需要包含 SO 和 SI 字元的兩個字節，因為 TI 執行時間環境會套用它們。
- False (預設)
字串分隔 選取傳回值字串分隔。 可能的值包括：

- 空格填補。 告知 TI 執行時間環境，字串的主框架表示是以空格符填補字串定義來分隔。 例如，如果大型主機的COBOL定義是 PIC X (10) ，但字串中只有三個字元，大型主機需要七個尾端空格。 因此，選取此選項會告訴 TI 執行時間環境將傳送至大型主機的字串，將字串的 NULL 終止字元變更為適當的尾端空格數目，再將字元串傳送至大型主機。 例如，如果字串在大型主機上定義為 PIC X (10) ，TI 將會傳送 ABC 的字串，後面接著七個尾端空格。 選取此選項也會告訴 TI 執行時間環境，將字串從大型主機傳回的輸出字串轉換成 TI 自動化伺服器，方法是將字串的尾端空格轉換成單一 Null 終止字元。 如需詳細資訊，請參閱 使用空格填補大型主機字元字串。 (預設值)
- Null 終止。 告知 TI 執行時間環境，字串的主主機表示是以 null 字元分隔， (EBCDIC 0x00) 。 選取此選項會告訴 TI 執行時間環境，如果在將字串傳送至大型主機之前有位元組的空間，則會告訴 TI 執行時間環境在從大型主機接收字串時遇到的第一個 Null 字元停止。 因此，藉由選取此選項，您會告訴 TI 在來自大型主機的輸出字串中保留尾端空格，因為 TI 不會將尾端空格轉換成單一 NULL 終止符。 如需詳細資訊，請參閱 使用空格填補大型主機字元字串。

設計屬性

使用 作法
允許 32K In/Out 如果您想要 TI 獨立於輸出 DFHCOMMAREA 獨立處理輸入 DFHCOMMAREA，請選取此選項。 TI 通常會結合輸入 DFHCOMMAREA 和輸出 DFHCOMMAREA 區域。 合併的區域不能超過 32 KB 的數據。 選取此選項時，TI 會將輸入 DFHCOMMAREA 與輸出 DFHCOMMAREA 分開處理。 每個輸入和輸出區域最多會使用 32 KB 的數據。 變更此選項會影響目前選取的方法。 可能的值包括：

- 真
- False (預設) 注意： 您可以在 WINDOWS 起始的處理 (WIP) CICS 程式設計模型中，以及任何主機起始的處理 (HIP) 程式設計模型中，使用此屬性作為「使用連結程序設計模型」的配件。 注意： 只有當 Is Link 屬性設定為 True 時，才能使用這個屬性。
描述 輸入 方法的描述。 描述最多可以是 250 個 Unicode 字元。
說明內容識別碼 輸入與這個方法相關聯的說明內容標識符。 標識碼是用來連線至這個方法的說明，並在叫用此方法期間發生例外狀況時傳回。 預設為 0。
包含內容參數 選取客戶端物件方法是否自動包含內容。 可能的值包括：

- True。 Visual Basic .NET 會自動在 自變數中包含內容做為其他參數。 如果您未在方法呼叫中包含 COMTIContext 參數以及其他參數，Visual Basic .NET 會傳回錯誤訊息：在 microsoft.visualbasic.dll中發生類型 'System.MissingMemberException' 的未處理例外 狀況，並通知您無法呼叫方法，並指出無法以您撰寫的參數數目呼叫方法。 如果您收到此訊息，請確認 Include Context Parameter 已包含在 方法的參數列表中作為參數。
- False。 Visual Basic .NET 不會在 自變數中自動包含內容做為其他參數。 如果您將此屬性設定為 False ，並將 COMTIContext 參數連同其他參數一起包含在方法呼叫中，Visual Basic .NET 會傳回錯誤訊息 ：在 microsoft.visualbasic.dll中發生 'System.MissingMemberException' 類型的未處理例外 狀況，並通知您無法以您撰寫的參數數目呼叫方法。 如果您收到此訊息，請從方法參數清單中移除 COMTIContext 參數。

預設值為 True。
初始緩衝區值 輸入初始緩衝區值。 預設值是 null。
Is Link 選取主機物件方法是否使用連結程序設計模型。 Windows 起始的處理 (WIP) 可能的值為：

- True。 使用連結模型。 鏈接程式設計模型只能與 CICS 連結通訊協定搭配使用。
- False。 請勿使用連結模型。

預設值為 False。

主機起始的處理 (HIP) 可能的值為：

- 是。 使用連結模型。 鏈接程式設計模型可以搭配所有通訊協定使用。
- 否。 請勿使用連結模型。
- 使用 32K In/Out 連結。使用連結模型，並設定 [從主機] 和 [到主機] 屬性。

預設值為 No。
元數據 選取元數據的處理方式。 可能的值包括：

- () 無 。 根據預設，不會將特殊數據傳送至主應用程式或從主應用程式接收。 如果您只想要傳送和接收 方法的數據，請選取此選項按鈕。
- 包含方法資訊。 要連同參數數據一起傳送至主機的這個方法名稱。 方法名稱會當做緩衝區中的前 32 個字節傳送。 如果多個方法呼叫移至相同的交易，而且您想要區分數據與不同的呼叫，這個選項會很有用。
- 包含所有資訊。 所有可使用方法數據傳送和接收的元數據。 如需元數據格式的詳細資訊，請參閱的描述。
名稱 輸入方法的名稱。 名稱最多可以是 250 個 Unicode 字元。 名稱必須與相同專案中的任何其他方法名稱不同。 預設值為 null。
之後的位置傳回值 輸入 Automation 方法傳回值，這個值會在從主機接收時，接在選取的數據項後面。 此選項不會影響自動化端。 當您想要指定為自動化傳回值的數據項不是數據宣告中描述從主機接收之數據的第一個數據項欄位時，請使用此選項。
初步填入 檢視從主機接收或傳送的 FILLER 位元組數目。
從主機 在從伺服器接收的緩衝區中，輸入此數據項後面的 FILLER 位元元組數目。 FILLER 會導致緩衝區中未轉換的間距。 在自動化端看不到 FILLER。
主控 在傳送至伺服器的緩衝區中，輸入此數據項之後的 FILLER 位元組數目。 FILLER 會導致緩衝區中未轉換的間距。 在自動化端看不到 FILLER。
傳回類型 選取傳回值類型。 可能的值包括：

- 無效
- 布爾
- 位元組
- 日期
- 貨幣
- 十進位
- 整數
- 長
- 雙
- 單
- 字串
- 用戶定義型別
- 記錄
- (預設) (無 )
可變大小的最終欄位 - 當最後一個數據項是字串時，請選取此選項，指出字串的大小會有所不同。 此選項也可用來將資料資料表或記錄集定義為係結或包含參數上定義為 [發生次數上限 ] 設定的所有資料列。
從主機 - 真
- False (預設)
主控 - 真
- False (預設)

主機定義屬性

使用 作法
連結至程式名稱 (CICS LINK/DPL) 輸入連結對程式名稱。
鏡像交易標識碼 如果您想要覆寫遠端環境的鏡像 TRANID，請輸入此方法所使用的鏡像 TRANID， (RE) 與此元件相關聯。 將此方塊保留空白會導致使用遠端環境描述中的鏡像 TRANID。

TRANID 長度最多可達四個字元。 可接受的字元為 A-Z a-z 0-9 $ @ # 。 / _ & ？ ! : |= , ; <>。

開頭為 C 的交易名稱會保留給 CICS，不應使用。 如果交易安全性為作用中，%和 & 字元可能會導致 Resource 存取控制 Facility (RACF) 問題。
TP 名稱 當 CICS 應用程式必須存取 DB2 資料庫時，輸入來源交易程式 (TP) 名稱。 TP 名稱是在 CICS 資源控制數據表 (RCT) 項目中參考，該專案會將 CICS 交易與 DB2 方案產生關聯。

指定 (IMS 或 CICS) 主機交易程式的名稱，或 (CICS LINK/DPL) 的連結對程式名稱。

資料錄集屬性

使用 作法
包含實際大小 主機程式不會包含或預期任何資訊，這些資訊會指出) 記錄集) 或專案 (陣列) 傳送或接收的實際數據 (列數目。 可能的值包括：

- 真
- False (預設)

此屬性是只讀屬性，除非在建立類型庫時使用第一個 COM 交易整合器版本建立類型庫時設定為 False，否則一律會設定為 False。
最大出現次數 最大數據列出現次數。 指出要傳送至主機或接收的數據列數目上限。 相當於 COBOL 群組專案上的 OCCURS n TIMES 關鍵詞。 預設為 1。
發生視情況而定 相當於 COBOL 中的可變長度數據表。 表示自動化) 中數據表前面的數值數據項 (記錄集或陣列，表示傳送或接收的實際數據列或項目數目。 使用下拉式清單來選取哪些數值數據項指定此值。 針對 CICS Link，記錄集或數位和相關聯的長度規範必須是 in/out。緩衝區中的數據會緊接在數據表的最後一個數據項後面，而不論為數據表指定的大小上限為何。 對於具有多個維度的陣列，它只能用於最外層循環 (COBOL) 或最右邊的維度， (Visual C++ 或 Visual Basic) 。 傳回值記錄集會根據而發生。 預設值為 (無) 。
無限 表示記錄集未系結。 表示任何數目的數據列可以傳送至主機或從主機接收。 當傳送或接收的數據列來自資料庫，且不知道數據列數目上限時，您可以選取此選項。 可能的值包括：

- True。 當最後一個數據項是字串時，這表示字串的大小會有所不同。
- False。 當最後一個數據項是陣列時，這表示陣列中的元素數目會有所不同。 當最後一個數據項是記錄集時，這表示記錄集中的數據列數目會有所不同。 (預設值)

警告

元件的屬性不打算以程序設計方式設定或變更。 以程式設計方式設定或變更屬性可能會導致元件無法正常運作。

另請參閱

使用 COMTIContext 提供自訂 TRM 和 ELM
方法名稱節點 (.NET)
屬性 (TI 專案)