使用 方法 屬性頁面來設定陣列、COBOL、設計、主機定義及記錄集屬性。
陣列特性
| 使用此 | 若要這樣做 |
|---|---|
| 陣列維度 | 選擇回傳值的陣列維度。 預設是（無）。 |
| 是陣列 | 選擇回傳值是否為陣列。 可能的值為： - 沒錯 - 錯誤 （預設） |
| 事件的發生取決於 | 選擇以表示表格前的數字資料項目（自動化中的記錄集或陣列）表示實際傳送或接收的列數或元素數。 相當於 COBOL 中的可變長度表格。 使用下拉選單選擇指定此值的數值資料項目。 對於 CICS Link，記錄集或陣列及其相關的長度指定符必須是輸入/輸出。緩衝區中緊接可變長度資料表的資料，會緊接著資料表中最後一個資料項目，無論該資料表的最大大小為何。 多維陣列只能用於最外層迴圈（COBOL）或最右側維度（Microsoft® Visual C++®或Visual Basic）。 預設是（無）。 |
COBOL 特性
| 使用此 | 若要這樣做 |
|---|---|
| 主機資料型別 | 選擇主機資料型態。 |
| 錯誤處理 | 選擇返回值錯誤處理。 可能的值為： - 刪除。 選擇此選項，設定 TI 在發生錯誤時截斷該值。 (預設) - 圓。 選擇此選項以設定 TI 在發生錯誤時進行數值四捨五入。 - 錯誤。 選擇此選項，設定 TI 在錯誤發生時回傳錯誤。 |
| 填充內容 | 輸入回傳值的佔位符。 預設值是 0。 |
| 來自主持人 | 請輸入伺服器接收的緩衝區中緊接此資料項目後的 FILLER 位元組數。 FILLER 會導致緩衝區產生未平移的空隙。 FILLER 在自動化系統中不可見。 預設值是 0。 |
| 成為主辦人 | 在傳送至伺服器的緩衝區中，輸入該資料項目後面的 FILLER 位元組數。 FILLER 會導致緩衝區產生未平移的空隙。 FILLER 在自動化端看不到。 預設值是 0。 |
| Scale | 輸入返回值比例。 |
| 符號屬性 | 選擇返回值符號屬性。 可能的值為： - 後緣。 對於已簽署的 DISPLAY 資料型別，表示該符號為尾隨（預設）。 此選項會向 TI 執行時環境指示簽署 DISPLAY 資料型態的格式化，並影響主機資料如何轉換成自動化資料型別。 - 尾行分隔。 對於有符號的顯示資料型別， 表示符號是獨立的。 此選項會向 TI 執行時環境指示簽署 DISPLAY 資料型態的格式化，並影響主機資料如何轉換成自動化資料型別。 - 領導。 對於有符號的 DISPLAY 資料型別， 表示該符號為導向。 此選項會向 TI 執行時環境指示簽署 DISPLAY 資料型態的格式化，並影響主機資料如何轉換成自動化資料型別。 - 領導分離。 對於有符號的顯示資料型別， 表示符號是獨立的。 |
| 大小 | 輸入回傳值大小。 |
| SOSI | 選擇此選項以指定雙位元組字元集資料是否預期以移位（SO）開始，並以移位（SI）字元結束。 可能的值為： - 沒錯。 當從主機應用程式接收資料時，SO 和 SI 字元會被移除，而當資料傳送到主機應用程式時，則會加入 SO 和 SI 字元。 在 PIC G 的長度中，不需要包含 SO 和 SI 字元的兩個位元組，因為 TI 執行時環境會自動處理它們。 - 錯誤 （預設） |
| 字串分界 | 請選擇回傳值字串的分隔符號。 可能的值為： - 添加空白。 告訴 TI 執行時環境，大型主機中字串的表示是以空格字元填充字串定義來界定。 例如，若大型主機的 COBOL 定義為 PIC X（10），但字串中只有三個字元，主機預期後方有七個空格。 因此，選擇此選項會告訴 TI 執行時環境，將送入大型主機的字串的 NULL 終止字元轉換為適當數量的尾隨空格，然後再傳送到大型主機。 例如，若大型主機上的字串定義為 PIC X（10），TI 會傳送一串 ABC 字串，後面有七個空格。 選擇此選項同時會告訴 TI 執行時環境，將從大型主機回傳的輸出字串轉換為 TI 自動化伺服器，將字串的尾隨空間轉換為單一的 null 終止字元。 欲了解更多資訊，請參閱「以空格填充主機字串」相關內容。 (預設) - 以空字元結尾。 告訴 TI 執行時環境，大型主機中字串的表示由空字元（EBCDIC 0x00）分隔。 選擇此選項會告知 TI 執行時環境，若有空間，則在將字串傳送至主機前，在字串末尾添加一個空字元；在從主機接收字串時，則會指示其在遇到的第一個空字元處停止。 因此，選擇這個選項就是告訴 TI 要保留來自大型主機輸出字串的尾部空格，因為 TI 不會將後方空格轉換成單一的 NULL 終止子。 欲了解更多資訊，請參閱 填補大型主機字串以空格。 |
設計特性
| 使用此 | 若要這樣做 |
|---|---|
| 允許32K進出 | 如果你希望 TI 將輸入的 DFHCOMMAREA 與輸出的 DFHCOMMAREA 分開處理，請選擇此選項。 TI 通常將輸入 DFHCOMMAREA 與輸出 DFHCOMMAREA 結合為一個區域。 合併後的資料容量不得超過 32 KB。 當選擇此選項時，TI 會將輸入的 DFHCOMMAREA 獨立於輸出的 DFHCOMMAREA。 每個輸入與輸出區域最多可使用32 KB的資料。 更改此選項會影響目前選擇的方法。 可能的值為： - 沒錯 - 錯誤 （預設） 注意： 你可以將此特性作為輔助工具，在 Windows 啟動處理（WIP）CICS程式模型及任何主機啟動處理（HIP）程式模型中實現「使用連結程式設計模型」。 註： 此屬性僅在 Is 連結 屬性設 為 True 時可用。 |
| 說明 | 請輸入方法的描述。 描述最多可包含 250 個 Unicode 字元。 |
| 幫助上下文識別 | 輸入與此方法相關的幫助上下文識別碼（Help context ID）。 ID 用於連接至此方法的說明文件，並在呼叫此方法時發生例外時返回。 預設值是 0。 |
| 包含上下文參數 | 選擇客戶端物件方法是否自動包含上下文。 可能的值為： - 沒錯。 Visual Basic .NET 會自動將上下文作為額外的參數加入。 如果你在方法呼叫中沒有包含 COMTIContext 參數和其他參數，Visual Basic .NET 會回傳錯誤訊息： microsoft.visualbasic.dll中發生了 'System.MissingMemberException' 型別的未處理異常 ，並告知你無法以你所寫參數數量呼叫該方法。 若收到此訊息，請確認 包含上下文參數 被作為參數包含在方法的參數列表中。 - 錯誤。 Visual Basic .NET 不會自動將上下文作為額外參數加入到參數中。 如果你將此屬性設為 False ，並在方法呼叫中包含 COMTIContext 參數，與其他參數一同加入，Visual Basic .NET 會回傳錯誤訊息：microsoft.visualbasic.dll中 發生了 'System.MissingMemberException' 型別的未處理 異常，並告知你無法以你所寫參數數量呼叫該方法。 如果你收到此訊息，請從方法參數列表中移除 COMTIContext 參數。 預設值為 True。 |
| 初始緩衝值 | 輸入初始的緩衝區值。 預設值是 null。 |
| 是連結 | 選擇主機物件方法是否使用 Link 程式設計模型。 Windows 發起處理（WIP）可能的值為： - 沒錯。 使用連結模型。 連結程式設計模型僅能搭配 CICS 連結協定使用。 - 錯誤。 不要使用連結模型。 預設值為 false 。 主機發起處理（HIP）可能的值為： - 沒錯。 使用連結模型。 連結程式設計模型可用於所有協定。 - 不。 不要使用連結模型。 - Link 使用 32K 輸入/輸出。使用 Link 模型，並設定 From Host 和 To Host 屬性。 預設值為 [No]。 |
| 元資料 | 選擇如何處理元資料。 可能的值為： - （無）。 預設情況下，主機應用程式不會傳送或接收特殊資料。 如果你只想傳送和接收該方法的資料，請選擇此選項按鈕。 - 包含方法資訊。 此方法名稱需與參數資料一併傳送給主機。 方法名稱以緩衝區前 32 位元組的形式傳送。 這個選項在多個方法呼叫同一筆交易時很有用，你可以區分不同呼叫中的資料。 - 包含所有資訊。 所有元資料都可以隨你的方法資料一起傳送和接收。 關於元資料格式的詳細資訊，請參閱「可選元資料」的說明。 |
| 名稱 | 輸入方法名稱。 名稱最多可包含 250 個 Unicode 字元。 該名稱必須與同一專案中任何其他方法名稱不同。 預設是 null。 |
| 位置返回值之後 | 輸入 Automation 方法的回傳值，該回傳值會在主機接收到所選資料項目時緊接著出現。 這個選項不會影響自動化端。 當你想指定為自動化回傳值的資料項目不是資料宣告中描述主機接收資料的第一個欄位時，請使用此選項。 |
| 初步填充 | 查看從主機接收或傳送的 FILLER 位元組數。 |
| 來自主持人 | 請輸入伺服器接收的緩衝區中緊接此資料項目後的 FILLER 位元組數。 FILLER 會導致緩衝區產生未平移的空隙。 FILLER 在自動化端看不到。 |
| 成為主辦人 | 請輸入傳送到伺服器的緩衝區中緊隨此資料項目之後的 FILLER 位元組的數量。 FILLER 會導致緩衝區產生未平移的空隙。 FILLER 在自動化端看不到。 |
| 傳回類型 | 選擇返回值類型。 可能的值為： - 虛無 - 布林值 - 位元組 - 日期 - 貨幣 - 十進位 - 整數 - 長 - 雙倍 - 單曲 - 繩子 - 使用者定義型別 - 紀錄集 - （無）（ 預設） |
| 可變大小最終場 | - 當最後一個資料項目為字串時，選擇此選項以表示字串大小會變動。 此選項也用於定義資料表或記錄集是有限界限的，或是包含所有按參數中的最大出現次數所定義的列。 |
| 來自主持人 |
-
沒錯 - 錯誤 （預設） |
| 成為主辦人 |
-
沒錯 - 錯誤 （預設） |
宿主定義特性
| 使用此 | 若要這樣做 |
|---|---|
| 連結至程式名稱 | 輸入連結程式名稱（CICS LINK/DPL）。 |
| 鏡像交易識別碼 | 如果你想覆蓋該元件所關聯的遠端環境（RE）的鏡像 TRANID，請輸入此方法所使用的鏡像 TRANID。 將此框留空，遠端環境描述中的鏡像 TRANID 會被使用。 TRANID 長度可達四個字元。 可接受的字元為 A-Z、A-Z 0-9 $ @ # 。 / _ % & ？ ! : |= , ; <>。 以 C 開頭的交易名稱保留給 CICS，不應使用。 若啟用了交易安全，則 % 和 & 字元可能會在資源存取控制設施（RACF）中造成問題。 |
| TP 名稱 | 當 CICS 應用程式必須存取 DB2 資料庫時，輸入原始交易程式（TP）名稱。 TP 名稱會在 CICS 資源控制表（RCT）項目中被引用，該項目將 CICS 交易與 DB2 計畫關聯起來。 指定主機交易程式名稱（IMS 或 CICS）或連結程式名稱（CICS LINK/DPL）。 |
紀錄集屬性
| 使用此 | 若要這樣做 |
|---|---|
| 請包含實際尺寸 | 主機程式不會包含或期望提供任何指示實際傳送或接收的列數（記錄集）或元素數（陣列）的資訊。 可能的值為： - 沒錯 - 錯誤 （預設） 此屬性是唯讀的，並且除非在建立 COM Transaction Integrator 第一版的型別庫時設為 True，否則它將始終被設定為 False。 |
| 最大出現率 | 最大行出現次數。 表示主機最多可傳送或接收的列數。 相當於在 COBOL 群組項目上的 OCCURS n TIMES 關鍵字。 預設為 1。 |
| 事件的發生取決於 | 相當於 COBOL 中的可變長度表格。 表示表格前的數字資料項目（自動化中的記錄集或陣列）顯示實際傳送或接收的列數或元素數。 請使用下拉選單選擇指定此值的數值資料項目。 對於 CICS Link，記錄集或陣列及其相關的長度指定符必須是輸入/輸出。緩衝區中緊接可變長度資料表的資料，會緊接著資料表中最後一個資料項目，無論該資料表的最大大小為何。 對於多維度陣列，只能用於最外層迴圈（COBOL）或最右側維度（Visual C++ 或 Visual Basic）。 根據條件，回傳的記錄集可能會有所不同。 預設是（無）。 |
| 無界 | 表示該紀錄集為無界。 表示可以向主機發送或接收任意數量的列。 當傳送或接收的資料列來自資料庫且未知最大列數時，會選擇此選項。 可能的值為： - 沒錯。 當最後一個資料項目是字串時，字串大小會有所變化。 - 錯誤。 當最後一個資料項目是陣列時，表示陣列中的元素數量會有所變化。 當最後一個資料項目是記錄集時，這表示記錄集中的列數會有所不同。 (預設) |
謹慎
元件的屬性並非設計用來透過程式設定或更改的。 程式化設定或更改屬性可能會導致元件運作異常。