應用程式可以設定 SelectionHint 屬性,以程式設計方式指定遠程環境(RE)。 藉由指定 RE,應用程式可以識別出當交易整合器 (TI) 執行時間環境處理對 TI 元件方法的呼叫時,執行交易程式的 CICS 或 IMS 區域。
下列 Visual Basic 程式代碼示範如何設定 SelectionHint 屬性:
Dim objExample As Object
Dim Store As String
Set objExample = CreateObject("MyComponent.MyInterface")
Open "My REList.txt" for Input as #1
Line Input #1, strRE
Close #1
objExample.SelectionHint = strRE
RtrnVal = objExample.method1(parm1, , parmN) 'Use RE named "MyRemEnvName"
此範例示範應用程式如何在處理 對method1的呼叫時,明確指示 TI 運行時間環境使用名為 MyRemEnvName 的 RE。 在這裡範例中, MyRemEnvName 是檔案中的第一個字串 MyREList.txt。 在指派之後method1SelectionHint進行的任何方法呼叫,都會使用指派給元件的原始 RE 來處理,而不是新的 RE。 換句話說,預設 RE 的程式化覆寫在單一方法呼叫後便不再持續。
如果應用程式嘗試將 SelectionHint 屬性設定為未對應至 RE 名稱的字串,則會報告錯誤,並使用原始 RE。
SelectionHint 屬性可以被設定為已停用的 RE。 不過,對該物件的下一次方法調用將會失敗,因為已選取了一個停用的 RE。
SelectionHint 是選用屬性。
SelectionHint如果 屬性未指定 RE,TI 執行時間環境會使用原始 RE。