GKREG - Gatekeeper Registrierung

Mit dem AMO GKREG werden Gatekeeper Registrierungsdaten fuer interne und externe Gateways konfiguriert
Die internen Gateways müssen zunächst mit dem AMO CGWB konfiguriert werden. Dabei werden die Gateway IP Adresse und die Gateway Rufnummer festgelegt und können anschliessend nicht mehr geändert werden.
Bei der Konfiguration eines Gateways werden zusätzliche Daten für den Kennzahlpunkt Gateway eingetragen falls dieser zuvor mit dem AMO WABE für die entsprechende Gateway Rufnummer konfiguriert wurde. Falls die Konfiguration mit dem AMO WABE zu einem späteren Zeitpunkt erfolgt, kann die Zusatzinformation (Gatewaynummer) für den Kennzahlpunkt Gateway durch Aufruf eines beliebigen GKREG AENDERN Kommandos für die jeweilige Gatewaynummer eingetragen werden.
Als externes Gateway bezeichnet man jedes Gateway in einer remote PBX. Als internes Gateway bezeichnet man jedes Gateway in der lokalen PBX.

Querbeziehungen zu anderen AMOs:

AMO DIMSU: Leistungsmerkmals-Mengen in der SWU
AMO ZANDE: Zentrale Anlagendaten - Erweiterung
AMO BCSU: Konfiguration von Baugruppen
AMO CGWB: Konfiguration von HG3500 Baugruppendaten
AMO WABE: Wahlbewertung

Zielprozessor: BP (Switching Unit)

Funktionen

EINRICHTEN Gateway Registrierungs-Daten einrichten Passwort-Klasse 2
AENDERN Gateway Registrierungs-Daten ändern Passwort-Klasse 2
LOESCHEN Gateway Registrierungs-Daten löschen Passwort-Klasse 2
ABFRAGEN Gateway Registrierungs-Daten abfragen Passwort-Klasse 0
REGENERIEREN Gateway Registrierungs-Daten regenerieren Passwort-Klasse 2

Prozedurübersicht

EINRICHTEN-GKREG

EINRICHTEN-GKREG GWNR=<number>, GWATTR=<param>, [GWIPADR=<number>], [GWRNR=<key-num>], WAPLNUM=<number>, WABE=<number>, LBER=<number>, [INFO=<string>], [SECLEVEL=<param>], [PORT=<number>];

Mit dieser Aktion können die Gatekeeper Registrierungsdaten für interne und externe Gateways konfiguriert werden.
Interne Gateways müssen zuvor mit dem AMO CGWB eingerichtet werden.

Beispiel

Eingabe:

 EINR-GKREG:1,INTGW,,,12,123,840,8,2&6;
EINR-GKREG:2,EXTGW,210.12.75.134,4567,9,80,340,4,5&6;

AENDERN-GKREG

AENDERN-GKREG GWNR=<number>, {(min 1) GWATTR=<param>, GWIPADR=<number>, GWRNR=<key-num>, WAPLNUM=<number>, WABE=<number>, LBER=<number>, INFO=<string>, SECLEVEL=<param>, PORT=<number>};

Mit dieser Aktion können die Gatekeeper Registrierungsdaten fuer interne und externe Gateways geändert werden.
Ein Ändern des Gatewayattributes intern auf extern und umgekehrt ist nicht möglich.

Beispiel

Eingabe:

 AE-GKREG:1,INTGW&HG3550V2; 

LOESCHEN-GKREG

LOESCHEN-GKREG GWNR=<number>;

Mit dieser Aktion können die Gatekeeper Registrierungsdaten fuer interne und externe Gateways gelöscht werden.
Bei internen Gateways werden sowohl die Daten, die mit dem AMO GKREG als auch die Daten, die mit dem AMO CGWB konfiguriert wurden, gelöscht.

Beispiel

Eingabe:

 LOES-GKREG:1&3&&6;; 

ABFRAGEN-GKREG

ABFRAGEN-GKREG {(max 1) GWNR=<number>, GWATTR=<param>, GWIPADR=<number>, PORT=<number>}, [INFO=<string>];

Mit dieser Aktion können die Gatekeeper Registrierungsdaten für interne und externe Gateways abgefragt werden.

Beispiel

Eingabe:

 AB-GKREG; 

Ausgabe:

 +-----------------------------------------------------------------------------+
| GWNR 2 GWATTR INTGW SIP |
| GWIPADR 139.25 .43 .80 GWRNR 1 |
| WAPLNUM 840 DPLN 8 |
| LBER 2&6 |
| GATEWAY REGISTRIERT: NEIN |
| IP GATEWAY WIRD KONFIGURIERT MIT GKREG |
| INFO: HG1_1_79SEV_2 |
+-----------------------------------------------------------------------------+
| GWNR 21 GWATTR EXTGW SIP |
| GWIPADR 218.1 .63 .114 GWRNR 885591 |
| WAPLNUM 0 WABE 0 |
| LBER 5&6 |
| GATEWAY REGISTRIERT: NEIN |
| IP GATEWAY WIRD KONFIGURIERT MIT GKREG |
| INFO: |
+-----------------------------------------------------------------------------+

REGENERIEREN-GKREG

REGENERIEREN-GKREG {(max 1) GWNR=<number>, GWATTR=<param>, GWIPADR=<number>, PORT=<number>}, [INFO=<string>];

Mit dieser Aktion können die Gatekeeper Registrierungsdaten für interne und externe Gateways regeneriert werden.

Beispiel

Eingabe:

 REGEN-GKREG; 

Ausgabe:

 EINRICHTEN-GKREG:1,INTGW&HG3550V1,,,1234,12,23,;
EINRICHTEN-GKREG:6,EXTGW,212.220.212.210,44,6,9,44,;

Parameterbeschreibung

GWATTR Gateway Attribut
Eingabeart: 1 bis 4 Einzelwerte, gekettet mit &, 1. Parameter einer min-1-Gruppe (AENDERN)
1 bis 4 Einzelwerte, gekettet mit &, 2. Parameter einer max-1-Gruppe (ABFRAGEN / REGENERIEREN)
1 bis 4 Einzelwerte, gekettet mit &, erforderlich (EINRICHTEN)
Mögliche Werte: EXTGW externes gateway DB_AM_LEGK_GW_EXTERNAL
H323 Gateway unterstuetzt H323 DB_AM_LEGK_GW_H323
H323ANN Gateway unterstuetzt H323ANN DB_AM_LEGK_GW_H323ANN
HG3550V1 HG3550 V1 gateway DB_AM_LEGK_GW_HG3550_V1
HG3550V2 HG3550 V2 gateway DB_AM_LEGK_GW_HG3550_V2
INTGW internes gateway DB_AM_LEGK_GW_INTERNAL
REGGW gateway - registrierung ist erlaubt DB_AM_LEGK_GW_REG_ALLOWED
SIP Gateway unterstuetzt SIP DB_AM_LEGK_GW_SIP
SIPQ Gateway unterstuetzt SIPQ DB_AM_LEGK_GW_SIPQ
GWIPADR Gateway IP Adresse
Eingabeart: 4 Einzelwerte, gekettet mit ., 2. Parameter einer min-1-Gruppe (AENDERN)
4 Einzelwerte, gekettet mit ., 3. Parameter einer max-1-Gruppe (ABFRAGEN / REGENERIEREN)
4 Einzelwerte, gekettet mit ., wahlfrei (EINRICHTEN)
Mögliche Werte: numerisch, 0-255
GWNR HG3550 Gateway Nummer)
Eingabeart: 1 bis 10 Einzelwerte, gekettet mit & oder &&, 1. Parameter einer max-1-Gruppe (ABFRAGEN / REGENERIEREN)
1 bis 10 Einzelwerte, gekettet mit & oder &&, erforderlich (LOESCHEN)
Einzelwert, erforderlich (AENDERN / EINRICHTEN)
Mögliche Werte: numerisch, 1-9999
GWRNR Gateway Rufnummer
Eingabeart: Einzelwert, 3. Parameter einer min-1-Gruppe (AENDERN)
Einzelwert, wahlfrei (EINRICHTEN)
Mögliche Werte: 0-9,*,#,A-D, max. 22-stellig
INFO service info
Eingabeart: Einzelwert, 7. Parameter einer min-1-Gruppe (AENDERN)
Einzelwert, wahlfrei (ABFRAGEN / EINRICHTEN / REGENERIEREN)
Mögliche Werte: beliebige Zeichen, max. 50-stellig
LBER lcr Berechtigung
Eingabeart: 1 bis 16 Einzelwerte, gekettet mit &, 6. Parameter einer min-1-Gruppe (AENDERN)
1 bis 16 Einzelwerte, gekettet mit &, erforderlich (EINRICHTEN)
Mögliche Werte: numerisch, 1-64
PORT PORT for external gateways
Eingabeart: Einzelwert, 4. Parameter einer max-1-Gruppe (ABFRAGEN / REGENERIEREN)
Einzelwert, 9. Parameter einer min-1-Gruppe (AENDERN)
Einzelwert, wahlfrei (EINRICHTEN)
Mögliche Werte: numerisch, 0-65535
SECLEVEL security level of the gateway
Eingabeart: Einzelwert, 8. Parameter einer min-1-Gruppe (AENDERN)
Einzelwert, wahlfrei (EINRICHTEN)
Mögliche Werte: SECURE SECURE gateway DB_SPE_SEC_LEV_SECURE
STANDARD STANDARD gateway DB_SPE_SEC_LEV_STANDARD
TRADITIO Traditional gateway DB_SPE_SEC_LEV_TRADITIONAL
WABE Wabegruppe
Eingabeart: Einzelwert, 5. Parameter einer min-1-Gruppe (AENDERN)
Einzelwert, erforderlich (EINRICHTEN)
Mögliche Werte: numerisch, 0-63
WAPLNUM lcr Waehlplan Nummer
Eingabeart: Einzelwert, 4. Parameter einer min-1-Gruppe (AENDERN)
Einzelwert, erforderlich (EINRICHTEN)
Mögliche Werte: numerisch, 0-2047

Fehlermeldungen

F01
F01: ES IST KEIN GATEKEEPER AUF DIESER ANLAGE VORGESEHEN (AMO ZANDE, GATEKPR)
F02
F02: DIE WERTE 0.0.0.0 UND 255.255.255.255 SIND KEINE GUELTIGEN GATEWAY
     IP ADRESSEN
F03
F03: FUER EIN INTERNES GATEWAY MUESSEN DIE GATEWAY IP ADRESSE UND DIE GATEWAY
     RUFNUMMER ZUVOR MIT DEM AMO CGWB KONFIGURIERT WERDEN
F04
F04: DIE KONFIGURATION EINES GATEWAYS IST NICHT ERLAUBT, WENN FUER DEN PARAMETER
     GWATTR SOWOHL DER WERT INTGW ALS AUCH DER WERT EXTGW ANGEGEBEN SIND
F05
F05: WENN DAS GATEWAY ATTRIBUTE GWEXT ANGEGEBEN WIRD MUESSEN AUCH
     WERTE FUER DIE PARAMETER GWIPADR UND GWRNR EINGEGEBEN WERDEN
F06
F06: GWATTR KANN NICHT VON INTERN AUF EXTERN UND UMGEKEHRT GEAENDERT WERDEN
F07
F07: DER PARAMETER GWATTR MUSS EINEN DER WERTE INTGW ODER EXTGW ENTHALTEN
F08
F08: GWNR @@@@ IST BEREITS KONFIGURIERT
F09
F09: GWNR @@@@ IST NICHT KONFIGURIERT
F10
F10: GATEWAY WURDE MIT DEM AMO CGWB ALS INTERNES GATEWAY KONFIGURIERT
F11
F11: SPEICHERMANGEL (AMO DIMSU: PARAMETER GWREG)
F12
F12: DER SEKTOR IST NOCH EINEM GATEWAY AN LAGE @@-@@-@@@ ZUGEWIESEN
     (AMO CGWB/AMO GKREG).
F13
F13: DER SEKTOR IST NOCH EINEM GATEWAY ZUGEWIESEN IN GWNR = @@@@ (AMO GKREG).
F14
F14: DIE IM PARAMETER GWRNR EINGEGEBENE GATEWAY RUFNUMMER IST BEREITS BEI 
     GATEWAY @@@@ EINGERICHTET
F15
F15: THE GATEWAY IP-ADDRESS AND THE GATEWAY PORT NUMBER 
     ARE ALREADY CONFIGURED FOR GATEWAY @@@@.
F16
F16: SERVICEINFO KONNTE NICHT GESCHRIEBEN WERDEN.
     MOEGLICHE URSACHEN:                         
     - ALLE INFO FELDER IM DATAPOOL BEREITS      
       VERWENDET. ANZAHL MUSS ERHOEHT WERDEN.    
     - NICHT GENUG SPEICHER FUER DATAPOOL.       
     ERHOEHEN SIE DEN SPEICHER MIT               
       EINR-DIMSU:INFO=;                         
F17
F17: GATEWAY ATTRIBUTE H323, H323ANN, SIP UND SIPQ DUERFEN NICHT
     ZUSAMMEN VERWENDET WERDEN
F19
F19: DAS ANGEGEBENE GATEWAY ATTRIBUT FUER DAS TRUNK  PROTOKOLL
    (GWATTR = @@@@@@@) STIMMT NICHT MIT DEM IM AMO CGWB
     KONFIGURIERTEN PROTOKOLL (@@@@@@@@ = 0) UEBEREIN.

Hinweismeldungen

H01
H01: GATEWAY ATTRIBUT INTERN IST ANGEGEBEN, DIE WERTE FUER DIE GATEWAY 
     IP ADRESSE ,DIE GATEWAY RUFNUMMER UND SECLEVEL WERDEN IGNORIERT
H02
H02: DIE ZUSAETZLICHEN DATEN FUER DEN KENNZAHLPUNKT GATEWAY WURDEN KONFIGURIERT
H03
H03: ELEMENT @@@@ WURDE GELOESCHT
H04
H04: SERVICEINFO KONNTE NICHT GESCHRIEBEN WERDEN.
     MOEGLICHE URSACHEN:                         
     - ALLE INFO FELDER IM DATAPOOL BEREITS      
       VERWENDET. ANZAHL MUSS ERHOEHT WERDEN.    
     - NICHT GENUG SPEICHER FUER DATAPOOL.       
     ERHOEHEN SIE DEN SPEICHER MIT               
       EINR-DIMSU:INFO=;                         
H05
H05: FUER EIN EXTERNES GATEWAY KANN DAS TRUNKPROTOKOLL IM PARAMETER GWATTR
     NICHT AUF PLAUSIBILITAET GEPRUEFT WERDEN. STELLEN SIE SICHER,
     DASS DAS RICHTIGE ATTRIBUT KONFIGURIERT IST,
     DA SONST KEINE VERBINDUNG ZUM GATEWAY AUFGEBAUT WERDEN KANN!
H06
H06: EXTERNES GATEWAY WURDE REGISTRIERT, BITTE DEN SECURITY LEVEL DES
     ZUGEWIESENEN TRUNKS PRUEFEN UM INKONSISTENZEN ZU VERMEIDEN.
H07
H07: DHCP IST AKTIVIERT, KONFIGURATIONEN BZGL. LEGK SIND DAHER
     FUER DIESES GATEWAY AUSSER KRAFT GESETZT.
H08
H08: REGGW WIRD NICHT BERUECKSICHTIGT.