Lerneinheit 1.2: Funktion performAction zu PDS-RAM für Übereinstimmung mit benutzerdefinierter Aktion 'HowTo' hinzufügen

Online bearbeiten

In der letzten Lerneinheit haben Sie einen Beispiel-PDS-RAM mit der benutzerdefinierten Aktion 'HowTo' und ihren vier Parametern konfiguriert. In dieser Lerneinheit erstellen oder ändern Sie die Funktion auf dem Host, von dem die Aktion 'HowTo' verarbeitet wird.

Informationen zu dieser Task

Die Aktion 'HowTo' wurde erstellt, um zu veranschaulichen, wie das Dialogfenster angezeigt wird, auf das später die Erweiterungspunkte actionValidators, parameterValidators und customParameterControl angewendet werden. In diesem Beispiel muss diese Aktion jedoch nicht auf dem Host ausgeführt werden. Aus diesem Grund wird durch die Funktion, die für die ID der Aktion 'HowTo' für den Beispiel-PDS-RAM bereitgestellt wird, keine Aktion ausgeführt.

Prozedur

  1. Öffnen Sie die C-Datei auf dem Host, der die Beispiel-PDS-RAM-Quelle enthält; sie sollte FEL.SFELSAMP(CRASPDS)lauten. Sie können diese Datei direkt in Developer for z/OS®öffnen.
  2. Wenn Sie angepasste Aktionen haben, die bereits im Beispiel-PDS-RAM implementiert sind, wollen Sie die Funktion performAction so ändern, dass sie keine Aktion ausführt, wenn die Aktions-ID HowTo übergeben wird und erfolgreich zurückgegeben wird.

    Verwenden Sie das folgende Beispielcodefragment, um dies zur Funktion performAction zu hinzuzufügen:

    if(actionID == 100)
{
	return 0;
}
    Wenn von der benutzerdefinierten Aktion 'HowTo' die Funktion performAction aufgerufen wird, wird sie jetzt zwar erfolgreich zurückgegeben, es wird jedoch keine Aktion auf dem Host ausgeführt. Überspringen Sie die Schritte 3 und 4.
    Hinweis: Wenn Sie die Funktion performAction bereits implementiert haben, sollten Sie überprüfen und sicherstellen, dass für actionId 100 noch keine andere angepasste Aktion festgelegt wurde.
  3. Wenn Sie keine angepassten Aktionen für den Beispiel-PDS-RAM implementiert haben, möchten Sie die Funktion performAction implementieren und die Funktion so ausführen lassen, wie dies der Codeausschnitt oben tut.
    Beginnen Sie mit dem Hinzufügen der folgenden Exportanweisung zu den Vorprozessoranweisungen ganz oben in der C-Quelle: #pragma export(performAction).
  4. Fügen Sie im nächsten Schritt die folgende Methode zum PDS-RAM hinzu: 
    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;
}
    Hinweis: Wenn Sie später weitere angepasste Aktionen zum PDS-RAM hinzufügen, möchten Sie für jede ID der angepassten Aktion angeben, welche Aktion ausgeführt werden soll, ähnlich dem Code-Snippet in Schritt 2.
  5. Speichern Sie die Quelle und korrigieren Sie alle Fehler.