Für den Objekttyp KC_ACCESS_POINT ist die Datenstruktur kc_access_point_str definiert. In kc_access_point_str liefert UTM bei KC_GET_OBJECT Namen und Adresse eines lokalen OSI TP-Zugriffspunkts zurück.
Ein lokaler OSI TP-Zugriffspunkt wird mit der KDCDEF-Steueranweisung ACCESS-POINT statisch generiert.
Datenstruktur kc_access_point_str |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Die Felder der Datenstruktur haben die folgende Bedeutung:
ap_name
Name des OSI TP-Zugriffspunktes. Innerhalb der lokalen UTM-Anwendung wird der OSI TP-Zugriffspunkt durch diesen Namen eindeutig identifiziert.
application_entity_qualifier
Application Entity Qualifier (AEQ) des Zugriffspunktes. Der AEQ wird bei der Kommunikation mit einigen heterogenen Kommunikationspartnern für die Adressierung benötigt. Diese Kommunikationspartner adressieren den Zugriffspunkt über den Application Process Titel (APT) der lokalen Anwendung und den AEQ des Zugriffspunktes.
Der AEQ ist eine positive ganze Zahl zwischen 1 und 67108863 (= 226-1). Näheres zum AEQ finden Sie im openUTM-Handbuch „Anwendungen generieren“.
application_entity_qualifier='0' bedeutet, dass für den Zugriffspunkt kein AEQ definiert ist.
presentation_selector
enthält den Presentation-Selektor der Adresse des OSI TP-Zugriffspunktes.
presentation_selector ist ein Feld vom Typ kc_selector:
union kc_selector |
|
|
UTM liefert den Presentation-Selektor i.A. als Character-String (c) in Maschinen-spezifischer Codierung (presentation_selector_code='S') zurück. Der Character-String ist maximal 16 Zeichen lang. Das Feld presentation_selector ist ab der in presentation_selector_lth angegebenen Länge mit Leerzeichen aufgefüllt.
In Ausnahmefällen wird der Presentation-Selektor als hexadezimale Zeichenfolge (x) zurückgeliefert. Jedes Halb-Byte wird dabei als ein Zeichen dargestellt, z.B. die Hexadezimalzahl A2 wird als String 'A2 ' (2 Zeichen) zurückgeliefert. Ist der Presentation-Selektor eine Hexadezimalzahl, dann liefert UTM bis zu 32 Byte zurück.
Wie der Inhalt von presentation_selector zu interpretieren ist, entnehmen Sie dem Feld presentation_selector_type.
Enthält die Adresse des Zugriffspunktes keinen Presentation-Selektor, dann ist das Feld presentation_selector mit Leerzeichen belegt. In diesem Fall ist presentation_selector_type='N' und presentation_selector_lth='0'.
session_selector
enthält den Session-Selektor der Adresse des OSI TP-Zugriffspunktes.
session_selector ist eine Union vom Typ kc_selector (siehe presentation_selector).
UTM liefert den Session-Selektor i.A. als Character-String (c) in Maschinen-spezifischer Codierung (session_selector_code='S') zurück. Der Character-String ist maximal 16 Zeichen lang. Das Feld session_selector ist ab der in session_selector_lth angegebenen Länge mit Leerzeichen aufgefüllt.
In Ausnahmefällen wird der Session-Selektor als hexadezimale Zeichenfolge (x) zurückgeliefert. Jedes Halb-Byte wird dabei als ein Zeichen dargestellt. Ist der Session-Selektor eine Hexadezimalzahl, dann liefert UTM in session_selector bis zu 32 Byte zurück.
Wie der Inhalt von session_selector zu interpretieren ist, entnehmen Sie dem Feld session_selector_type.
Enthält die Adresse des Zugriffspunktes keinen Session-Selektor, dann ist das Feld session_selector mit Leerzeichen belegt. In diesem Fall ist session_selector_type='N' und session_selector_lth='0'.
presentation_selector_type
gibt an, ob die Adresse des Zugriffspunktes einen Presentation-Selektor enthält und wie die Rückgabe in presentation_selector zu interpretieren ist.
'N' | steht für *NONE. Die Adresse des Zugriffspunktes enthält keinen Presentation-Selektor, presentation_selector ist mit Leerzeichen belegt und presenta tion_selector_lth='0'. |
'C' | Die Angabe des Presentation-Selektor in presentation_selector ist als Character-String zu interpretieren. Es sind maximal die ersten 16 Byte von presentation_selector belegt. |
'X' | Der Presentation-Selektor in presentation_selector ist eine Hexadezimalzahl. |
presentation_selector_lth
enthält die Länge des Presentation-Selektors (presentation_selector) in Byte. Ist presentation_selector_lth='0', dann enthält die Adresse des OSI TP-Zugriffspunktes keine Presentation-Komponente
(presentation_selector enthält Leerzeichen).
Sonst liegt der Wert von presentation_selector_lth zwischen '1' und '16'.
Ist presentation_selector_type='X', dann ist die Länge des in presentation_selector angegebenen Strings: 2 * presentation_selector_lth Byte.
Beispiel
Der Presentation-Selektor des Zugriffspunktes ist X'A2B019CE'. presentation_selector enthält dann den String 'A2B019CE', presentation_selector_type='X' und presentation_selector_lth=' 4' (vier Hexadezimalziffern).
presentation_selector_code
gibt an, wie der Presentation-Selektor in presentation_selector codiert ist.
UTM liefert 'S' zurück, wenn der Presentation-Selektor als Character-String zurückgeliefert wird
(presentation_selector_type='C').
'S' bedeutet: Maschinen-spezifische Codierung (Standardcodierung, EBCDIC auf BS2000-Systemen, ASCII auf Unix-, Linux- und Windows-Systemen).
Ist presentation_selector_type='X' oder 'N', dann liefert UTM im Feld presentation_selector_code ein Leerzeichen zurück.
session_selector_type
gibt an, ob die Adresse des Zugriffspunktes einen Session-Selektor enthält und wie die Rückgabe in session_selector zu interpretieren ist.
'N' | steht für *NONE. Die Adresse des Zugriffspunktes enthält keinen Session-Selektor. Das Feld session_selector enthält Leerzeichen und session_selec tor_lth='0'. |
'C' | Die Angabe des Session-Selektors in session_selector ist als Character-String zu interpretieren. Es sind maximal die ersten 16 Byte von session_selector belegt. |
'X' | Der Session-Selektor in session_selector ist eine Hexadezimalzahl. |
session_selector_lth
enthält die Länge des Session-Selektors (session_selector) in Byte.
Ist session_selector_lth='0', dann enthält die Adresse des Zugriffspunktes keine Session-Komponente (session_selector enthält Leerzeichen). Sonst liegt der Wert von session_selector_lth zwischen '1' und '16'.
Ist session_selector_type='X', dann ist die Länge des in session_selector enthaltenen Strings:
2 * session_selector_lth Byte.
session_selector_code
gibt an, wie der Session-Selektor in session_selector codiert ist.
UTM liefert 'S' zurück, wenn der Session-Selektor als Character-String zurückgeliefert wird
(session_selector_type='C').
'S' bedeutet: Maschinen-spezifische Codierung (Standardcodierung, EBCDIC auf BS2000-Systemen, ASCII auf Unix-, Linux- und Windows-Systemen).
Ist session_selector_type='X' oder 'N', dann liefert UTM im Feld session_selector_code ein Leerzeichen zurück.
transport_selector
enthält den Transport-Selektor der Adresse des OSI TP-Zugriffspunktes. transport_selector enthält immer einen gültigen Wert, da jedem Zugriffspunkt bei der KDCDEF-Generierung ein Transport-Selektor zugeordnet werden muss. Der Transport-Selektor ist immer als Character-String zu interpretieren, er besteht aus 1 bis 8 abdruckbaren Zeichen.
Auf BS2000-Systemen ist der Wert von transport_selector ein lokaler BCAM-Anwendungsname.
listener_id (nur auf Unix-, Linux- und Windows-Systemen)
enthält die Listener-Id des Zugriffspunktes. Die Listener-Id ist eine positive ganze Zahl zwischen 0 und 32767.
Mit der Listener-Id wird festgelegt, welche Verbindungen von demselben Netzprozess verwaltet werden sollen. Alle Verbindungen, die über Zugriffspunkte und BCAMAPPL-Namen mit derselben Listener-Id aufgebaut werden, werden von einem Netzprozess verwaltet.
Ausnahmen sind BCAMAPPL-Namen für die Kommunikation über die Socket-Schnittstelle (SOCKET). Diese bilden einen eigenen Nummernkreis. Es werden also keine Access-Points mit solchen BCAMAPPL-Namen in einem Netzprozess zusammengefasst, auch wenn die listener-id gleich ist.
Die folgenden Felder haben nur für Zugriffspunkte einer UTM-Anwendung auf Unix-, Linux- und Windows-Systemen eine Bedeutung. Die Felder enthalten die Komponenten der Adresse des Zugriffspunktes innerhalb des lokalen Systems. Siehe dazu auch openUTM-Handbuch „Anwendungen generieren“.
listener_port
enthält die Portnummer des Zugriffspunktes für den Aufbau von TCP/IP-Verbindungen. Es wird die Portnummer angegeben, die bei der KDCDEF-Generierung angegeben wurde.
listener_port='0' bedeutet, dass bei der Generierung keine Portnummer angegeben wurde.
t_prot
enthält das Adressformat, das dem Zugriffspunkt bei der KDCDEF-Generierung zugeordnet wurde.
Die Adressformate werden wie folgt angegeben:
'R' | RFC1006, ISO-Transportprotokoll Klasse 0 über TCP/IP und Konvergenzprotokoll RFC1006. |
Enthält t_prot nur Leerzeichen, dann wurde bei der KDCDEF-Generierung kein Adressformat definiert.
tsel_format
gibt das Format der T-Selektoren in der Adresse des Zugriffspunkts an (Formatindikator).
'T' | TRANSDATA-Format |
'E' | EBCDIC-Zeichenformat |
'A' | ASCII-Zeichenformat |
Enthält tsel_format ein Leerzeichen, dann wurde bei der KDCDEF-Generierung kein Formatindikator definiert.
Zur Bedeutung der Adressformate siehe „Dokumentation zu PCMX“ im Abschnitt "openUTM-Dokumentation".