Der 3. Teil der jährlichen Tips und Techniken jetzt online:
Thema: APIs
Blitz Links:
Senden von Benutzernachrichten mit API QEZSNDMG
Liste der eingetragenen Benutzer
Nachrichten senden mit QMHSNDPM
Anzeige langer Texte
APIs
Senden von Benutzernachrichten mit API QEZSNDMG
Mit dem API QEZSNDMG (Nachricht senden) können Sie Durchbruchnachrichten an einen oder mehrere Benutzer senden (und auch Antworten empfangen). Damit bietet QEZSNDMG einen deutlichen Vorteil gegenüber dem Befehl SNDBRKMSG (Durchbruchnachricht senden), mit dem die Nachricht nur an eine Workstation gesendet werden kann. Wenn Sie QEZSNDMG interaktiv von der Befehlszeile aus aufrufen, wird die Anzeige „Operational Assistant Send a Message“ eingeblendet. Geben Sie hier die Nachricht ein, die gesendet werden soll. Sie können QEZSNDMG auch in einem Stapelprogramm verwenden, indem Sie das API aufrufen und die notwendigen Parameter ohne eine Anzeige weitergeben. (Siehe das Beispiel in Abbildung 7.) Weitere Infomationen zu QEZSNDMG finden Sie in der Dokumentation OS/400 Operational Assistant APIs (SC41-5867).
Liste der eingetragenen Benutzer
Mit dem API QEZLSGNU (Eingetragene Benutzer auflisten) können Sie eine Liste aller eingetragenen Benutzer erstellen. QEZLSGNU plaziert die Liste in einem Benutzerbereich, den Sie anschließend mit anderen Benutzerbereich-APIs bedienen können, um die Benutzerliste zu extrahieren. Verwenden Sie QEZLSGNU als Teil eines täglichen Sicherungsprogramms, um sicherzustellen, daß sich alle Benutzer abgemeldet haben, bevor Sie die Datenbibliothek abspeichern. Das API kann auch getrennte Benutzer anzeigen – eine wichtige Funktion, da auch durch diese Benutzer Dateien gesperrt sein können. Abbildung 8 zeigt ein Beispiel des API-Aufrufs. Weitere Infomationen zu QEZLSGNU finden Sie in der Dokumentation OS/400 Operational Assistant APIs (SC41-5867).
Nachrichten senden mit QMHSNDPM
Das API QMHSNDPM (Programmnachricht senden) sendet eine Nachricht an eine Programmnachrichten-Warteschlange. Das API wird häufig zum Senden von Nachrichten an das aufrufende Programm verwendet, um Fehler zu melden.
Die folgenden C-Spezifikationen zeigen, wie QMHSNDPM aufgerufen wird:
C Call ‘QMHSNDPM’ C Parm MsgId C Parm QMsgFile C Parm MsgText C Parm MsgTextLen C Parm MsgType C Parm MsgQueue C Parm MsgStack C Parm MsgKey C Parm APIErrDs
Noch nicht Abonnent? Sonderaktion nutzen.