------------------------------- Readme-Datei zu XHCS-SYS V02.2A ------------------------------- April 2012 Die vorliegende Readme-Datei zu XHCS-SYS V02.2A enthaelt Aenderungen zu folgendem Handbuch: XHCS V2.0A 8-bit-Code- und Unicode-Unterstuetzung im BS2000/OSD Benutzerhandbuch Ausgabe Maerz 2007 Bestellnummer U9232-J-Z135-5 A Seite 1 ------------------ Inhaltsverzeichnis ------------------ 1 Kapitel "Komponenten und Programmschnittstellen" ....... Seite 2 2 Makro NLSCOD ........................................... Seite 4 3 Makro NLSCMP ........................................... Seite 5 4 Makro NLSCNV ........................................... Seite 8 5 Zusaetzliche Unicode-Zeichen definieren ............... Seite 9 6 Kommando /ADD-CODE-TABLES ............................. Seite 10 A Seite 2 1 Kapitel "Komponenten und Programmschnittstellen" -------------------------------------------------- Ergaenzung auf Seite 29 im Handbuch: Ab XHCS V2.2A enthaelt der Modul GNLMTAB zusaetzlich noch die folgende Information: - Tabelle mit der Zuordnung der MIME-Namen zu den CCS-Namen Jedem CCS, der bei Auslieferung bei XHCS bekannt ist, ist ein MIME-Name zugeordnet (MIME = Multipurpose Internet Mail Extensions), sofern der Zeichensatz bei der IANA (Internet Assigned Numbers Authority) registriert ist. Die bei der IANA registrierten Zeichensaetze findet man unter http://www.iana.org/assignments/character-sets In XHCS V2.2A wurde dabei der Stand vom 4.11.2010 dieser Liste verwendet. In der XHCS-Tabelle ist als MIME-Namen der in der IANA-Liste als "preferred MIME name" bezeichnete Name eingetragen, sofern es einen solchen gibt; andernfalls wurde die unter "Name:" aufgefuehrte Bezeichnung als MIME-Name verwendet. A Seite 3 Folgende Zeichensaetze wurden in die XHCS-Tabelle aufgenommen: XHCS-CCS-Name | MIME-Name --------------+--------------------- EDF03IRV | OSD_EBCDIC_DF03_IRV EDF04F | OSD_EBCDIC_DF04_15 EDF041 | OSD_EBCDIC_DF04_1 --------------+--------------------- ISO646 | ISO_646.irv:1983 ISO8859F | ISO-8859-15 ISO88591 | ISO-8859-1 ISO88592 | ISO-8859-2 ISO88593 | ISO-8859-3 ISO88594 | ISO-8859-4 ISO88595 | ISO-8859-5 ISO88597 | ISO-8859-7 ISO88599 | ISO-8859-9 --------------+--------------------- NEW1252P | windows-1252 NEW646 | ISO_646.irv:1983 NEW8859F | ISO-8859-15 NEW88591 | ISO-8859-1 NEW88592 | ISO-8859-2 NEW88593 | ISO-8859-3 NEW88594 | ISO-8859-4 NEW88595 | ISO-8859-5 NEW88597 | ISO-8859-7 NEW88599 | ISO-8859-9 --------------+--------------------- UNICODE | UTF-16 UTF8 | UTF-8 UTF16 | UTF-16 --------------+--------------------- WCP1252P | windows-1252 --------------+--------------------- Siehe hierzu auch die Beschreibung des Makros NLSCMP. A Seite 4 2 Makro NLSCOD -------------- Hinweis zu den Returncodes auf den Seiten 78 - 79 im Handbuch: Wird bei Systemstart ein Modul GNLMTAB verwendet, das keine Unicode-Tabellen enthaelt, so wird bei einer der Angaben - CCSNAME = UNICODE oder UTFE - TOCCS = UNICODE der Returncode "Name des Codes unbekannt" zurueckgegeben. A Seite 5 3 Makro NLSCMP -------------- Seite 81 im Handbuch Neues Schluesselwort *MIME-NAME beim Operanden INFO (nur bei Angabe des Operanden CCSNAME, nicht bei Angabe von ISOVAR): Makroaufrufformat: MF=L / S ,CCSNAME= <7-/8-bit-Code> / / *SYSDEF / *USRDEF [,INFO= *LIST-OF-CCS / *ONLY-SPECIFIED-CCS / *REFERENCE-CODE / *MIME-NAME ] Seite 83 im Handbuch Beschreibung des neuen Schluesselworts *MIME-NAME beim Operanden INFO = *MIME-NAME Es wird nur der Eintrag des angegebenen CCS ausgegeben. Der Operand INFO = *MIME-NAME ist nur in Kombination mit dem Operanden CCSNAME erlaubt. Es wird die gleiche Information ausgegeben wie bei INFO=*ONLY-SPECIFIED-CCS ; zusaetzlich wird jedoch noch der sogenannte "MIME-Name" des Zeichensatzes ausgegeben, so wie er bei der IANA (Internet Assigned Numbers Authority) unter http://www.iana.org/assignments/character-sets registriert ist. (MIME = Multipurpose Internet Mail Extensions) Existiert der unter "CCSNAME = " angebene Zeichensatz nicht in der IANA-Liste, so wird der neue Returncode X'004000D0' zurueckgegeben. Dies gilt z.B. fuer die meisten der EBCDIC-Zeichensaetze. und auch fuer UTFE.. A Seite 6 Seite 85 im Handbuch Ergaenzung der Beschreibung der Ausgabedaten: INFO = *LIST-OF-CCS / *ONLY-SPECIFIED-CCS / *REFERENCE-CODE Der Datenteil setzt sich aus einer Folge von 10 Byte langen Zeichenketten zusammen. Davon enthalten die ersten 8 Byte den Code-Namen (CCSN). Das 9-te Byte wird auf den Wert ' ' gesetzt, falls der Code mit der entsprechenden ISO-Code- Variante ISO 8859 voll kompatibel ist. Ist der Code begrenzt kompatibel, enthaelt das 9. Byte ein 'P' (siehe Abschnitt "Gruppierung kompatibler Codes" auf Seite 116). Das 10-te Byte der jeweils 10 Bytes umfassenden Eintraege enthaelt die Art des Codes: Art des Codes Wert ISO-Code 'I' (ISO) EBCDIC-Code 'E' (EBCDIC) UTF-16 'I' (ISO) UTF-8 'I' (ISO) UTFE 'E' (EBCDIC) INFO = *MIME-NAME Jeder Eintrag ist 58 Bytes lang und hat die folgende Struktur: - Byte 0 - 9 Die ersten 10 Bytes des ausgegebenen Eintrags sind genauso aufgebaut wie oben bei INFO = *LIST-OF-CCS beschrieben. - Byte 10 - 57 MIME-Name des CCS Die maximale Laenge von 48 Zeichen wurde dabei willkuerlich festgelegt. A Seite 7 Ergaenzung der Programmierhinweise bzw. der Returncodes auf den Seiten 85 - 86 im Handbuch: Wird bei Systemstart ein Modul GNLMTAB verwendet, das keine Unicode-Tabellen enthaelt, so wird * bei der Angabe CCSNAME = der Returncode "Name des Codes unbekannt" zurueckgegeben. * bei der Angabe ISOVAR = *ALL die Liste der Namen aller im System definierten Codes ohne die Namen der drei Unicode-Varianten UTF-16, UTF-8 und UTFE geliefert. * neuer Returncode ab XHCS V2.2A SUBCODE MAINCODE Bedeutung 2 1 2 1 X'00' X'40' X'00' X'D0' Fuer den angegebenen CCS gibt es keinen Eintrag in der Liste der bei der IANA registrierten Character Sets. A Seite 8 4 Makro NLSCNV -------------- Ergaenzung der Programmierhinweise bzw. der Returncodes auf den Seiten 106 - 110 im Handbuch: Wird bei Systemstart ein Modul GNLMTAB verwendet, das keine Unicode-Tabellen enthaelt, so wird * bei einer der Angaben - CCSNAME = oder TOCCS = - ACTION = COMPOSE oder DECOMPOSE oder LENGTH der Returncode "Name des Codes unbekannt" zurueckgegeben. * bei der Angabe DEFAULT = *STD oder *UTF16 oder *SPECIAL der Returncode "Ungueltige Angaben bei der Ersatzzeichen-Angabe" zurueckgegeben. A Seite 9 5 Zusaetzliche Unicode-Zeichen definieren ----------------------------------------- Ergaenzung zur Einbindung der erweiterten Code-Basis auf Seite 133 im Handbuch: Eine Aenderung in der Sortierinformation fuer Unicode oder anderer Unicode-Tabellen im Modul GNLMTAB kann nur dann dynamisch mit dem Kommando /ADD-CODE-TABLES ins System eingebunden werden, wenn beim Systemstart ein Modul GNLMTAB verwendet wurde, das keine Unicode-Tabellen enthaelt. Andernfalls kann eine Aenderung der Unicode-Tabellen nur beim Start des Subsystems XHCS-SYS eingebunden werden. Naeheres zur Uebernahme von Unicode-Tabellen siehe unter "Ergaenzung zu den Programmierhinweisen auf Seite 134 im Handbuch" in 5 Kommando /ADD-CODE-TABLES. A Seite 10 6 Kommando /ADD-CODE-TABLES --------------------------- Ergaenzung zu den Programmierhinweisen auf Seite 134 im Handbuch: Uebernahme von Unicode-Tabellen: Enthaelt der im Kommando /ADD-CODE-TABLES angegebene Modul GNLMTAB Unicode-Tabellen, so sind die folgenden Faelle zu unterscheiden: - Beim Systemstart wurde ein Modul GNLMTAB verwendet, das mit den Makros aus XHCS-SYS V02.0A (oder einer hoeheren Version) assembliert wurde, und das alle Unicode-Tabellen vollzaehlig enthaelt (dies trifft z.B. dann zu, wenn das standardmaessig ausgelieferte Modul GNLMTAB verwendet wird): In diesem Fall werden die Unicode-Tabellen aus dem im Kommando /ADD-CODE-TABLES angegebenen Modul GNLMTAB nicht uebernommen, da das Kommando /ADD-CODE-TABLES nicht dafuer verwendet werden kann, Aenderungen an bereits im System vorhandenen Code-Tabellen vorzunehmen. - Beim Systemstart wurde ein Modul GNLMTAB verwendet, das mit Makros aus XHCS-SYS V02.0A (oder einer hoeheren Version) assembliert wurde, das aber keine Unicode-Tabellen enthaelt: In diesem Fall werden die Unicode-Tabellen aus dem im Kommando /ADD-CODE-TABLES angegebenen Modul GNLMTAB uebernommen, vorausgesetzt, das sie vollzaehlig vorhanden sind. - Beim Systemstart wurde ein Modul GNLMTAB verwendet, das noch mit den Makros aus XHCS-SYS V01.5A (oder einer kleineren Version) assembliert wurde, und das keine Unicode-Tabellen enthaelt: In diesem Fall werden die Unicode-Tabellen aus dem im Kommando /ADD-CODE-TABLES angegebenen Modul GNLMTAB nicht uebernommen. Enthaelt das im Kommando /ADD-CODE-TABLES angegebene Modul GNLMTAB auch neue 7-bit- oder 8-bit-Codes, so werden diese auch dann akzeptiert, wenn eine Uebernahme der Unicode-Tabellen abgelehnt wird. A Seite 11 Aenderung der Tabelle mit der Zuordnung der MIME-Namen zu den XHCS-CCS-Namen: Eine Aenderung der Tabelle mit der Zuordnung der MIME-Namen zu den in XHCS verwendeten CCS-Namen im Modul GNLMTAB kann nur dann dynamisch mit dem Kommando /ADD-CODE-TABLES ins System eingebunden werden, wenn beim Systemstart ein Modul GNLMTAB verwendet wurde, das keine Unicode-Tabellen enthaelt. Andernfalls kann eine Aenderung dieser Tabelle nur beim Start des Subsystems XHCS-SYS eingebunden werden. Ergaenzung zu den moeglichen Warnungen auf Seite 135 im Handbuch: - Die im Modul GNLMTAB enthaltenen Unicode-Tabellen werden nicht uebernommen, da sie im System bereits vorhanden sind. - Die im Modul GNLMTAB enthaltenen Unicode-Tabellen werden nicht uebernommen, da sie unvollstaendig sind. - Die im Modul GNLMTAB enthaltenen Unicode-Tabellen werden nicht uebernommen, da das beim Systemstart verwendete Modul GNLMTAB ein Format aus einer XHCS-SYS-Version < V02.0A besitzt.