Toolmaker Produkt-Dokumentation
gsmtext - Fehlersuche und -behebung
- Robert E. Schneider
- Elisa Knapp (Unlicensed)
Inhaltsübersicht
Lizenz prüfen
DSPPFM GSMTEXT/LCLICDP
Bibliotheken und Verzeichnisse für gsmtext
Fehlersuche und -behebung auf IBM i
Version feststellen
IBM i-Version
GO LICPGM, Auswahl 10, Taste F11
gsmtext Version
STRGSMT - Die Versionsnummer steht oben links auf dem Bildschirm (z.B. "6.13")
Befehle zur Konfiguration
Start/Stop -Befehle
STRGSMT
- Auswahl 21 zum Starten
- Auswahl 22 zum Beenden
Kompletter ("sauberer") Neustart
1.. Das Subsystem über STRGSMT Punkt 22 beenden
2. Mit WRKUSRJOB GSMTEXT prüfen, dass kein Job des Benutzers mehr aktiv ist
a) Wenn doch: mit Auswahl 4 (F4) den Job beenden (Auswahl: *IMMED)
3. GSM Modul vom Strom trennen
4. Den ComServer vom Strom trennen
5. alle Kabel/Stecker am Gerät auf festen Sitz prüfen
5a - wenn von der Hotline angefordert: SIM-Karte auf sichern Sitz prüfen
6. Stromzufuhr des ComServer wieder aktivieren, kurz (2 Minuten) warten
7. Stromzufuhr des GSM-Moduls wieder aktivieren, kurz (2 Minuten) warten
8. Das Subsystem mit Punkt 21 wieder starten und ca. 10 Min. laufen lassen.
Subsystem und Jobs
Subsystem GSMTEXT
Minimum-Jobs:
- GSMTCTL - PGM-GSMTCTL
- GSMTPR1 - PGM-GSMTPR1
- GSMTSY1 - PGM-GSMTSY1
- GSMTSY2 - PGM-GSMTSY2
Weitere mögliche Jobs
- GSMTNTM - PGM-GSMTNTM
- GSMTPR2 - PGM-GSMTPR2
- GSMTSRV - PGM-GSMTSRV
- GSMTSC1 - PGM-GSMTSC1
- GSMTSC2 - PGM-GSMTSC2
- GSMTSY3 - PGM-GSMTSY3
- GSMTSY4 - PGM-GSMTSY4
- GSMT35CC - PGM-GSMTCMS
- GSMT35CM - PGM-GSMTCMN
Logs/Protokolle/Dumps
Die SPLF GSM490P (WRKSPLF GSMTEXT)
Diese SPLF wird immer erzeugt, wenn es irgendwelche Unregelmässigkeiten gibt. In ihr ist die gesamte Kommunikation für einen Vorgang abgebildet, die zwischen der IBM i und der GSM-Einheit stattfindet. Anhand der Befehle der IBM i (D1) und der Antworten der Einheiten (D2) kann man den Fortgang des Vorganges erkennen.
CMS ERROR- Codes in der GSM490P
Der CREG-Befehl und seine Antworten
siehe auch: http://www.ozekisms.com/index.php?owpn=691
Der CNMI-Befehl: Umgang mit unverlangt eingehenden SMS
Auszug aus: http://www.nobbi.com/atgsm.html#+cnmi
Der Befehl AT+CNMI? ruft die aktuellen Einstellungen an
Der Befehl AT+CNMI=... legt fest, wie neu eintreffende Nachrichten behandelt werden sollen.
Standard-Fehlersituationen aus verschiedenen Support-Cases
Weitere links zum Thema GSM-Hayes-Befehle
https://m2msupport.net/m2msupport/atcreg-network-registration/
https://doc.qt.io/archives/qtopia4.3/atcommands.html
https://www.codeproject.com/Articles/85636/Introduction-to-AT-commands-and-its-uses
http://www.ozekisms.com/index.php?owpn=691
https://www.computerhope.com/atcom.htm
telit_at_commands_reference_guide_r23_1_.pdf (PDF-Datei mit vermutlich vollständigem Befehlssatz - inklusive SLED)
Liste der GSM-Fehlercodes "CME Error xxx" und "CMS Error xxx"
Diese Seite ist eine von vielen mit einer Übersicht über die Fehlercodes:
https://momoiot.co.kr/5g-at/cmd/cme-cms-error-codes/
SMTP / Email -Protokoll-Dateien im IFS, Verzeichnis /midjet/gsm/log
Für jedes Email, das von gsmtext versendet wird, werden zwei Dateien im IFS erstellt:
- Sxxxxxxx.dat
- Mxxxxxx.dat
Beispiele:
Diese logs werden immer geschrieben. Die Aufbewahrungszeit entspricht der "Gültigkeitsperiode eing. SMS".
Diese wird in der Allgemeinen Konfiguration, Seite 3 bestimmt (STRGSMT, Aw. 20, Aw. 1, 2x Enter):
Protokoll-Dateien in Bibliothek GSMTEXT
- EGEMLGP
ELELOGP
- EREMLRP
EGEMLGP - Beispiel für einen Eintrag
Mail send status
- 9 = nicht gesendet
- 5 = gesendet
Protokoll-Dateien im IFS
Verzeichnis: /acme/gsm/log
Einträge im Nachrichtenprotokoll (STRGSMT, Aw 5)
Bei über E-Mail versandten Nachrichten bleibt der Status "N.verfügb.", auch wenn das E-Mail erfolgreich gesendet wurde.
Anhand des Datums/Uhrzeit neben der E-Mail-Adresse kann man erkenne, dass der Versand stattfand.
Erfolgreich gesendet: Versanddatum/-zeit sind angegeben
Information zum Comserver (Comport)
Fehlersuche GSM-Einheit
Verfügbare GSM-Einheiten
Eine Übersicht über die verfügbarten GSM-Einheiten befindet sich auf der Seite: Hardware für die Kommunikation mit dem SMS-Netzwerk
Konfiguration der GSM-Einheit prüfen/korrigieren
Wenn eien GSM-Einheit ausgetauscht wurde, dann ist die neue Einheit oft ein neueres/anderes Modell, als die vorherige. In diesem Fall muss der korrekte Typ konfiguriert werden.
Prüfen, welche Einheit tatsächlich angeschlossen ist
STRGSMT, Aw. 20, Aw 4, Option 8 für die Einheit:
Hier: TC63i
Ermitteln des Namens, den man in gsmtext konfigurieren muss
Die Seite Hardware für die Kommunikation mit dem SMS-Netzwerk enthält eine Liste der Einheiten, die von gsmtext unterstützt werden, wie sie sich bei Auswahl 8 melden und mit welchem "Einheitentyp" sie konfiguriert werden müssen:
In diesem Fall ist für "Cinterion TC63i" der Einheitentyp "ETM9350" angegeben.
Den ermittelten Einheitentyp konfigurieren
STRGSMT, Aw 20, Aw, 4 - Option 2 für die Konfiguration (GSMT34 oder GSMT35)
siehe auch: Konfiguration - GSM-Modul-Verbindungsart 5 (beim Anschluss über einen Comport).
Wenn die GSM-Einheit direkt per V.24-Kabel angeschlossen ist (sehr selten), dann wäre es die Verbindungsart 4 (GSMT34).
Hinweise zum Einheitentyp ETM9350 (Cinterion TC63i)
Kommunikation zwischen Comserver und GSM-Einheit prüfen
Wenn die Verbindung zur GSM-Einheit über einen Comserver läuft.
Wenn das Log GSM490P (zu finden mit WRKSPLF GSMTEXT), zeigt, dass keine Verbindung zur GSM-Einheit zustande kommt (siehe hier: Standard-Fehler - Keine Verbindung zur GSM-Einheit), dann kann man über TELNET prüfen, ob der Comserver die Box erkennt:
1. Die IP-Adresse des Comservers ermitteln mit STRGSMT, Aw. 20, Aw 4 - Auswahl 2 für die Verbindung
2. TELNET RMTSYS('<ip-name-oder-adresse-aus-config>') PORT(1111)
3. ggf. Anmelden
4. Setup Highspeed Serial port auswählen
5. Opt. 1 - Port state auswählen
5. Opt. 1 - Connection state auswählen
- "FREE" - die angeschlossene GSM-Einheit wurde nicht erkannt
- "In Use" - die GSM-Einheit wurde erkannt
Support-Fälle
Email-Versand funktioniert nicht (18030213)
Problem
Bei einer Installation ohne GSM-Einheit sollen die Nachrichten nur per E-Mail gesendet werden. E-Mail ist korrekt konfiguriert.
Siehe auch https://toolmaker.atlassian.net/wiki/spaces/DOKU/pages/652214484/Konfiguration#Konfiguration-_Toc317576535Teil3
STRGSMT, Auswahl 20, Auswahl 1, dann 2 x Enter:
|
Für den Benutzer ist eine E-Mail-Adresse hinterlegt.
Auch die Benutzeroptionen sind korrekt:
|
|
Lösung
Im Benutzerprofil von GSMText muss immer eine Mobil-Tel.nummer angegeben werden. Auch wenn das System keine GSM-Einheit hat und nur gemailt werden soll.
STRGSMT, Auswahl 11, Auswahl 2 für die Benutzer-Registrierung:
|
Nachrichten an einen so konfigurierten Benutzer gehen als E-Mails raus:
|
Hinweis: der Status bleibt bei E-Mails immer N.verfügb., weil das System nur für SMS-Nachrichten eine Antwort vom Netzwerk bekommt.
Autor: RSC
IBM i – betroffenes System | |
– Betr.System-Version | V7R3 |
Produkt – Version auf IBMi | 6.13 |
QSYSOPR zeigt "GSM Einheitenfehler"
GSM490P zeigt "+CMS ERROR: PS busy"
Schritte zur Fehlerbehebung:
- Sauberer Neustart, inkl. Prüfung, dass die SIM-Karte sicher und eingelegt ist
Wenn das nicht hilft
2. Sicherstellen, dass die Nummer der Nachrichtenzentrale ("Service-Center-Adresse") korrekt ist
Hier ein Beispiel:
Im Web prüfen, ob die Nummer stimmt.
ggf. korrigieren: STRGSMT → Auswahl 20 → Auswahl 5
Wenn das nicht hlft
3. die SIM-Karte in einem Mobiltelefon prüfen: können SMS geschickt werden?
Wenn das möglich ist.
4. Noch einmal Schritt 1 "Sauberer Neustart" versuchen (inkl. SIM-Karten-Prüfung)
Wenn es immer noch nicht geht:
5. WRKSPLF GSMTEXT - den Inhalt der neuesten SPLF-GSM490P an's helpdesk schicken
Autor: RSC
Produkt – Version auf IBMi | alle |
GSM490P zeigt "+CMS ERROR: operation not supported"
In diesem Fall war eine falsche GSM-Einheit konfiguriert.
Angeschlossen war eine Einheit "Cinterion - PLS62-W". Diese muss in gsmtext als "ETM9440" konfiguriert werden. Es war aber eine "ETM9350" konfiguriert.
Autor: RSC
Produkt – Version auf IBMi | alle |
SMS gehen nicht raus - GSM490P zeigt: +CREG 0,2 (18030226)
Problem
Es gehen keine Nachrichten raus. Mit WRKSPLF GSMTEXT bekommt man viele SPLF mit dem Namen GSM490P angezeigt.
Darin findet man:
D1 11:28:28 AT+CREG?D2 11:28:29 +CREG: 0,2 OK
D2 11:28:39
D1 11:28:39 AT+CNMI=1,0,0,0,1
Und nach einiger Zeit wechselt die Zeile mit dem #CREG in:
D2 11:28:29 +CREG: 0,0 OK
Lösung
Die GSM-Einheit hat nicht hinreichend Empfangsstärke. Sie muss woanders aufgestellt werden.
- +CREG: 0,2 heisst: Nicht mit einem Netzwerk verbunden, sucht danach
- +CREG: 0,0 heisst: Nicht mit einem Netzwerk verbunden, keine Suche (mehr)
Autor: RSC
Produkt – Version auf IBMi | 6.13 |
SMS gehen nicht raus - GSM490P zeigt: +CREG 0,3
Problem
Es gehen keine Nachrichten raus. Mit WRKSPLF GSMTEXT bekommt man viele SPLF mit dem Namen GSM490P angezeigt.
Zunächst sieht alles gut aus:
D1 0000 23:49:27 AT+CPIN?D2 0000 23:49:33 +CPIN: READY OKD1 0000 23:49:33 AT&FD2 0000 23:49:34 OKD1 0000 23:49:34 ATE0 D2 0000 23:49:35 ATE0 OKD1 0000 23:49:35 AT+CMEE=2D2 0000 23:49:36 OKD1 0000 23:49:36 AT^SLED=?D2 0000 23:49:37 ^SLED: (0-2),(1-50) OKD1 0000 23:49:37 AT^SLED=2,40D2 0000 23:49:38 OK
Aber der CREG wird beantwortet mit: nicht registriert (0), Zugang verweigert (3)
D1 0000 23:49:44 AT+CREG?D2 0000 23:49:45 +CREG: 0,3 OKD2 Y 0310 23:49:57
Diese Einträge wiederholen sich einige Minuten
D1 0000 23:49:57 AT+CREG?D2 0000 23:49:58 +CREG: 0,3 OKD2 Y 0310 23:50:09
...
D1 0000 23:52:27 AT+CREG?D2 0000 23:52:28 +CREG: 0,3 OKD2 Y 0310 23:52:40
..und dann schliesst das Protokoll mit:
D1 0000 23:52:40 AT+CNMI=1,0,0,0,1D2 0000 23:52:41 OK
Lösung
In einem Fall musste die SIM-Karte getauscht werden (streiche O2, setze vodafone).
- +CREG: 0,3 heisst: Nicht mit einem Netzwerk verbunden, vom Provider abgelehnt
Alle SMS bleiben im Status "N.verfügb." (19000003)
Bei einer ganz neuen Installation bleiben alle SMS im Status "N.verfügb.". Es wird keine SMS verschickt.
- Es gibt keine GSM490P spooled files (WRKSPLF GSMTEXT zeigt leere Liste)
- Im IFS (/acme/gsm/logs) gibt es keine Einträge
- Die Joblogs der Jobs im SBS GSMTEXT zeigen keine Besonderheiten
- Der COMSERVER ist korrekt konfiguriert
- Man kann auf einem PC über den Port 8000 eine Telnet-Verbindung zur GSM-Einheit aufbauen und auch „vernünftig" mit der Box „sprechen", z.B
AT AT OK ATE0 ATE0 OK AT+CPIN? +CPIN: SIM PIN OK AT+CPIN="nnnn" OK <-- hier die PIN der SIM-Karte eingebenAT&F OK ATE0 ATE0 OK AT+CSCA="+491710760000" <-- Nr. Der Nachrichtenzentrale (STRGSMT, 20, 5)OK AT+CREG? +CREG: 0,1 OK <-- Verbindung zum Netz bestehtAT+CMEE=2 OK ATS0=0 OK AT+CSMS=0 +CSMS: 1,1,1 OK AT+CMGF=0 OK AT+CPMS="SM","SM","SM" +CPMS: 0,20,0,20,0,20 OK AT+CGMI Cinterion OK AT+CGMM TC63i OK AT+CGMR REVISION 01.100 OK AT+CGSN 353229026868180 OK AT+CSQ +CSQ: 21,99 OK AT+CMGS=022 >0011000D91947136584769F40000AA07D4F29C0E82C900 +CMGS: 195 OK
- Die Lampen auf dem COMSERVER zeigen Betriebsberitschaft. Die Error-LED ist aus.
Lösung
Beim Netzwerk-Betreiber (STRGSMT, 20, 5) waren die Werte für die Konfiguration auf *NONE gestellt:
Nach Änderung auf „*SYS" lief es:
Autor: RSC
Produkt – Version auf IBMi | 6.22 |
MSG-RNX0100 T/GSM320 – Stmt 1607 - Alarmierung fkt. nicht (19000176)
Der Job GSMTSY1 bleibt mit den Meldungen stehen:
Länge oder Anfangsposition liegt außerhalb des gültigen Bereichs für die ZeichenfolgeoperationFunktionsprüfung. RNX0100 nicht überwacht durch GSM320 Bei Anweisung 1607
Alarmierung funktioniert nicht mehr.
Lösung
Aktualisierung auf Version 6.23
Autor: RSC
Produkt – Version auf IBMi | 6.22 |
Job GSMTCTL ends unexpectedly - RNX0100 F/QRNXIE T/GSM400 Stmt 2495 (19000174)
Man versucht, eine Antwort auf eine SMS-Inquiry-Nachricht zu schicken (z.B. "I" oder "G"). GSMText erkennt aber nicht, auf welche Inquiry-Nachricht geantwortet werden soll und interpretiert den Text als Befehlsaufruf. Das führt zu einem Abbruch im Programm GSM400.
Lösung
Aktualisierung auf Version 6.24
Autor: RSC
Produkt – Version auf IBMi | 6.23 |
SMS gehen nicht 'raus - Kein Kontakt zum Comserver
Die Lampen auf dem Comserver zeigen an, dass er in Betrieb ist. Trotzdem ist er nicht erreichbar:
- weder über die WUTiliies
- noch über den Browser
- noch über TELNET auf Port 1111
- die GSM490P-Splf zeigt
AT+CNMI=1,0,0,0,1
PF E MJMN Time Data SV 12:28:33 7862E1X 6.13 PM 12:28:33 SCF Benelux ENG 31 *LOCAL GSMT35 GSMT35 GSMT35 CD 12:28:33 GSMT35 3 5 TC35 20408 NW 12:28:33 20408 GSMT35 GSMT35 GSMT35 31 +31xxxxxxxxxxx IC Y 12:31:42 INZCLI - Socket connect error D1 Y 12:31:42 AT+CNMI=1,0,0,0,1
Normalerweise passiert dies, wenn die GSM-Einheit defekt ist.
Lösung
In diesem Fall war das Netzteil des Comservers defekt. Nach Austausch des Netzteiles läuft wieder alles.
Autor: RSC
Produkt – Version auf IBMi | alle |