Rational Developer for System z


課程 1.2:將 performAction 函數新增至 PDS RAM 以與 HowTo 自訂動作對應

在上一課程中,您使用 HowTo 自訂動作及其 4 個參數配置了「PDS RAM 範例」。在本課程中,您將建立或修改主機上用來處理 HowTo 動作的函數。

HowTo 動作是因示範所需而建立的,以顯示您稍後將套用 actionValidatorsparameterValidatorscustomParameterControl 延伸點的對話框。然而,針對本範例的目的,您不需要此動作在主機上執行任何動作。因此,為「PDS RAM 範例」上的 HowTo 動作識別碼提供的函數將不執行任何動作。
  1. 在包含「PDS RAM 範例」原始檔的主機上開啟 C 檔案;它應該是 FEK.SFEKSAMP(CRASPDS)。您可以在 Rational® Developer for System z® 中直接開啟此檔案。
  2. 如果已在「PDS RAM 範例」上實作了自訂動作,您可以修改 performAction 函數,在有 HowTo 動作識別碼傳遞給該函數時不執行任何動作,並順利返回。

    請利用下列範例程式碼 Snippet 將此新增至 performAction 函數:

    if(actionID == 100)
    {
    	return 0;
    }
    現在,如果 HowTo 自訂動作呼叫 performAction 函數,它將順利返回而不在主機上執行任何動作。跳過步驟 3 和步驟 4。
    註: 如果已實作 performAction 函數,則應該檢查並確保未將 actionId 100 設為另一個自訂動作。
  3. 如果未實作「PDS RAM 範例」的任何自訂動作,您將要實作 performAction 函數,讓該函數執行上述程式碼 Snippet 所執行的相同動作。 請從新增下列 export 陳述式至 C 原始檔頂端的前處理器指引開始:#pragma export(performAction)
  4. 接下來,將下列方法新增至 PDS RAM:
    int performAction(int actionID, 
                      char instanceID[256], 
                      char memberID[256], 
                      void** params,
                      void** customReturn,
                      char error[256])
    {
        /*Accept any actionID and return successfully*/
        return 0;
    }
    註: 如果稍後您將其他自訂動作新增至 PDS RAM,您將要為每一個自訂動作識別碼指定應該執行的動作,這與步驟 2 中的程式碼 Snippet 類似。
  5. 儲存原始檔,並對任何錯誤進行除錯。

使用條款 | 意見



本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)