Toolmaker Produkt-Dokumentation
GSMText-Befehle
Inhaltsübersicht
Alle GSMText-Befehle werden während der Installation in die QGPL-Bibliothek kopiert.
Ein Befehl kann während seiner Ausführung die Bibliotheksliste ändern. Die Bibliotheksliste wird wiederhergestellt, wenn der Befehl ausgeführt worden ist.
CHGGSMTOPR
CHGGSMTOPR USID(Benutzer-ID oder Verteilergruppen-ID) SYSN(Systemname, Standard *LOCAL)
Zweck
Dieser Befehl dient zum Ändern des Empfängers der Betriebsnachrichten in einem System.
Parameter
USID
Benutzer-ID oder Verteilergruppe für den neuen Empfänger der Betriebsnachrichten.
SYSN
Systemname für das System, für das der Empfänger geändert werden soll. Standardwert *LOCAL
CRTGSMTSRV
CRTGSMTSRV RSCN(Ressourcenname)
Zweck
Dieser Befehl dient zum Erstellen von Kommunikationsobjekten, die von Ihrem Service Provider für MidJet GSM Text zum Anmelden an Ihrem System verwendet werden. Normalerweise wird das IBM-Modem verwendet.
Der Befehl erzeugt eine Zeile, einen Controller und Geräte. Die Konfiguration wird angehängt, tritt beim Anhängen ein Fehler auf, erscheint eine Fehlermeldung.
Außerdem wird ein Benutzerprofil erstellt. Es hat die ID und das Kennwort GSMSRV und die Benutzerklasse *PGMR.
Benutzen Sie nach Abschluss des Service-Jobs den Befehl DLTGSMTSRV, um unerwünschte Sicherheitsrisiken zu vermeiden.
Parameter
RSCN
Der zu verwendende Ressourcenname.
DLTGSMTSRV
DLTGSMTSRV
Zweck
Dieser Befehl dient zum Abhängen und Entfernen aller Objekte, die mit dem Befehl CRTGSMTSRV erstellt wurden.
Dieser Befehl hat keine Parameter.
ENDGSMTSBS
ENDGSMTSBS
Zweck
Der Befehl ENDGSMTSBS dient zum kontrollierten Beenden des MidJet GSM Text-Subsystems.
Verwenden Sie diesen Befehl immer anstelle des Befehls ENDSBS.
Dieser Befehl hat keine Parameter.
RUNGSMTRPP
RUNGSMTRPP SELECT (Programmname, Standard *ALL) ORDER(Sortierreihenfolge, Standard *FIFO)
Zweck
Dieser Befehl löst die Beantwortungsverarbeitungsprogramme aus, die im XSBMGTM-API angegeben sind, wobei die Auswahl „verzögert" gewählt ist.
SELECT
Mit diesem Parameter können Sie den Namen des Beantwortungsverarbeitungsprogramms, dass durchgeführt werden soll, festlegen. Standardwert ist *ALL.
ORDER
Legt die Art der Reihenfolge fest, in der die Beantwortungsverarbeitungsprogramme ausgeführt werden. Gültige Einträge sind *FIFO oder *PGMNAME.
SNDGSMTMSG
SNDGSMTMSG USID(Benutzer-ID oder Verteilergruppe) GSMI(GSM-Nummer in internationalem Format) MTXT(Nachrichtentext) SNAC(0,1 oder 2) NDMT(0 oder 1)
Zweck
MidJet GSM Text bietet eine Befehlsschnittstelle für das Versenden von Nachrichten direkt von den Anwendungsprogrammen aus. Außerdem steht auch eine Schnittstelle auf Anrufebene zur Verfügung. Weitere Informationen dazu finden Sie auf der Seite MidJet GSM Text APIs im Kapitel XSBMGTM.
Diese kann auch in vielen weiteren Situationen eingesetzt werden, zum Beispiel:
Bestätigungen, dass ein wichtiger Job normal beendet wurde. Beispiele dafür sind Jobs wie sichern, Abschlüsse für bestimmte Zeiträume oder die abendliche Rechnungsstellungsroutine.
Senden von Nachrichten von den Anwendungsprogrammen unter bestimmten Bedingungen, die Aufmerksamkeit erfordern, zum Beispiel dringende Service-Anrufe an Servicepersonal unterwegs.
Durchführen von Personen-Pagings (City-Ruf) durch Senden von Standard-Nachrichten.
Ist aus irgendeinem Grund die MidJet GSM Text-Anwendung nicht verfügbar, benutzen Sie außerdem den Befehl MONMSG CPF0000.
Parameter
USID
Die Benutzer-ID kann ein einzelner Benutzer, eine Verteilergruppe oder *GSMTOPR, die Pseudo-Benutzer-ID für den aktuellen Empfänger der Betriebsnachrichten.
GSMI
GSM-Nummer in internationalem Format. Kann zur gleichen Zeit wie der USID-Parameter verwendet werden. Dieser Parameter steht nur für die Lizenzarten LO, LB, UO und UB zur Verfügung.
MTXT
Der Nachrichtentext kann bis zu 160 Zeichen lang sein. Wenn die zu sendende Nachricht mehr als 160 Zeichen lang ist, teilen Sie den Text einfach in Blöcke zu jeweils 160 Zeichen und senden Sie mehrere Nachrichten.
SNAC
Alarmruf senden. Geben Sie 0 für nein an, 1 für ja. Der Sonderwert „2" verursacht nur eine Alarmnachricht, ohne begleitende SMS.
NDMT
Nicht sichtbare Nachricht in der Protokolldatei. Geben Sie 0 für eine sichtbare Nachricht, 1 für eine nicht sichtbare Nachricht ein.
STRGSMT
Zweck
Startet das GSMTEXT Subsystem. Eine detaillierte Beschreibung dieses Befehls finden Sie in Kapitel 5.
UPDGSMTFSD
UPDGSMTFSD
Zweck
Dieser Befehl dient zum Aktualisieren der Benutzer in der MidJet GSM Text-Benutzerdatei mit der im zweiten Telefonnummernfeld im Systemverzeichnis gespeicherten Namen und GSM-Telefonnummer. Das ist nützlich, wenn das Systemverzeichnis der wichtigste Platz zum Speichern der GSM-Nummern ist.
Wenn der Benutzer in MidJet GSM Text nicht existiert, wird ein neuer Benutzerdateieintrag erstellt, wenn die zweite verwendete Telefonnummer gefunden wird.
Dieser Befehl hat keine Parameter.