A +------------------------------------------------------------------+ | Readme-Datei fuer VTSU-B V13.3 | | | | Dezember 2007 | +------------------------------------------------------------------+ In dieser README-Datei werden die gueltigen Erweiterungen fuer VTSU-B Version 13.3 und aller Versionen ab VTSU-B V11.0 beschrieben. Diese Erweiterungen beziehen sich auf das folgende Handbuch: VTSU-B V11.0 (BS2000/OSD, TRANSDATA) Benutzerhandbuch Bestellnummer: U22328-J-Z135-1-7600 Inhalt ------ 1. Einfuehrung ........................................... Seite 2 2. Neue Funktionen ab TIAM V13.0 Seite 3 2.1. Dynamische Bedienerfuehrung Seite 3 2.2. Roll-Up-Betrieb der Datenstation Seite 3 2.3. Unicode Anzeige fuer eine Datensichtstation Seite 3 3. VTSU-Control-Block: VTSUCB............................ Seite 4 4. Statische Definition von 8-Bit/Unicode-Geraeten ueber eine Konfigurationsdatei Seite 13 4.1. Dateiname, Standort der Datei Seite 13 4.2. Format der Konfigurationsdatei Seite 14 4.3. Konsistenz des Geraetetyps Seite 15 4.4. Beispiele fuer Definitionszeilen Seite 15 A - Seite 2 - 1. Einfuehrung =========== VTSU-B V11.2 erweitert die Funktionen von VTSU-B V11.0 wie folgt: * VTSU-B wurde modifiziert, um POSIX-Unterstuetzung aus BS2000/ OSD-BC V2.0 zu ermoeglichen. VTSU-B V12.0 erweitert die Funktionen von VTSU-B V11.2 wie folgt: * VTSU-B unterstuetzt die Verschluesselung der Ein- bzw. Ausgabe, wenn das Produkt VTSU-SEC installiert ist und wenn die Verbindung zu einer Emulation hergestellt ist, die die Verschluesselung von Nachrichten unterstuetzt. Eine vollstaendige Beschreibung der Unterstuetzung fuer die Verschluesselung wird mit dem Produkt VTSU-SEC V1.0 geliefert. VTSU-B V13.0 erweitert die Funktionen von VTSU-B V12.0 wie folgt: * VTSU-B wurde angepasst, um neue Funktionen von TIAM V13.0 zu unterstuetzen. Zwei neue Operanden des Kommandos /MODIFY-TERMINAL-OPTIONS ermoeglichen es, die Bedienerfuehrungen (prompt) des Systems und des Programms und die Systemeinstellungen bezueglich des Roll-Up-Betriebs der Datenstation zu aendern. * VTSU-B ermoeglicht (mit der neuen VTSU-Control-Block-Option INFOLR) das Zuruecksetzen der Informationszeile. * Ueber eine Konfigurationsdatei kann ein 8-Bit-CCSNAME aktiviert werden. Die Aktivierung basiert auf einer statischen Variante und haengt vom Prozessornamen und/oder dem Stationsnamen und/oder dem Geraetetyp ab. VTSU-B V13.1 erweitert die Funktionen von VTSU-B V13.0 wie folgt: * Anpassung von VTSU-B an BS2000/OSD V5.0A VTSU-B V13.2 erweitert die Funktionen von VTSU-B V13.1 wie folgt: * Anpassung von VTSU-B an BS2000/OSD V7.0A * Unterstuetzen von Unicode VTSU-B V13.3 erweitert die Funktionen von VTSU-B V13.2 wie folgt: * Anpassung von VTSU-B an BS2000/OSD V8.0A A - Seite 3 - 2. Neue Funktionen ab TIAM V13.0 ============================= 2.1. Dynamische Bedienerfuehrung -------------------------- Dank des TIAM-Kommandos /MODIFY-TERMINAL-OPTIONS kann der Benutzer die Bedienerfuehrung seines Systems und seines Programms anpassen. Die Bedienerfuehrung kann maximal 32 Zeichen lang sein und sich aus fuenf Schluesselworten (#H, #J, #P, #S und #U) zusammensetzen, wobei der Host-Name, der Job-Name, der Prozessorname, der Stationsname und die Benutzererkennung automatisch eingefuegt werden. Weitere Informationen zu diesem Thema enthaelt die README-Datei, die mit TIAM V13.0 und groesser geliefert wird. 2.2. Roll-Up-Betrieb der Datenstation -------------------------------- Der Roll-Up-Betrieb der Datenstation kann vom Systemverwalter fuer alle Dialog-Tasks mit Hilfe des folgenden Betriebsparameters aktiviert werden: TERMROLL. Ueber VTSU-B und TIAM V13.0 ist es jetzt fuer jede Dialog-Task moeglich, diese Einstellung mit dem TIAM-Kommando /MODIFY-TERMINAL-OPTIONS zu aendern. Der Benutzer kann den Roll-Up-Betrieb der Datenstation aktivieren oder deaktivieren oder ihn auf den Standardwert des Systems zuruecksetzen (Wert TERMROLL). Weitere Informationen zu diesem Thema enthaelt die README-Datei, die mit TIAM V13.0 und groesser geliefert wird. 2.3. Unicode Informationen zu einer Datensichstation ----------------------------------------------- Zur Unterstuetzung von Unicode wurde ab TIAM V13.1C die Anzeige durch das Kommando /SHOW-TERMINAL-ATTRIBUTES erweitert. Angezeigt werden der Coded-Character-Set UTFE und der neue Character-Set fuer Unicode mit dem Wert 240. Eine genauere Beschreibung ist in dem Manual BS2000/OSD V7.0 Kommandos zu finden. A - Seite 4 - 3. VTSU-Control-Block: VTSUCB ========================== Die folgenden Beschreibungen des VTSU-Control-Blocks ergaenzen die Seiten 92-111 des Handbuchs. Die Parameter ENCOUT, ENCIN und INFOLR sind neu. Operation | Operanden ------------+-------------------------------------------------------- VTSUCB | | D | | | C | | [MF=| L |], [PREFIX=],[MACID=] | | ~ | | | M | | | | | NO | | | |[,MODE=(MIXED,inmode,outmode)] [,LOW= | |] | | | | YES | | | | | | | | NO | | NO | | | | [,BELL = | ~~ |] [,GETFC= | ~~ |] | | | | YES | | YES | | | | | | | | NO | | NO | | | | [,HCOPY= | ~~ |] [,LOCIN= | ~~ |] | | | | YES | | YES | | | | | | | | NO | |*NONE| | | | [,NOLOG= | ~~ |] [,RETINF=|~~~~~|] | | | | YES | | xx | | | | | | | | YES | | NO | | | | [,IHDR= | ~~~ |] [,OHDR= | ~~ |] | | | | NO | | YES | | | | | | | | YES | | I | | | | [,CODETR=| ~~~ |] [,SPECIN=| C |] | | | | NO | | N | | | | ~ | | | |*EXTEND| | NO | | | | [,CCSNAME=| |] [,HOM= | ~~ |] | | | |ccsname| | YES | | | | | | | | STD | | NO | | | | [,AUTOTAB=| ~~~ |] [,NOPOS= | ~~ |] | | | | NO | | YES | | | | | YES | | | | | | | | NO | | UNPROT | | | | [,CURPOS=| ~~ |] [,READ=| ~~~~~~ |]| | | | YES | | MODIFIED| | | | | | | | NO | | | | [,UPDATE=| ~~ |] | | | | YES | | | | | A - Seite 5 - | | | | | | NO | | NO | | | | [,ENCOUT=| ~~ |] [,ENCIN= | ~~ |] | | | | YES | | YES | | | | | | | | NO | | | | [,INFOLR=| ~~ |] | | | | YES | | | | | | | | NO | | NO | | | |[,MODE=LINE] [,BELL = | ~~ |] [,GETFC= | ~~ |] | | | ~~~~~~~~~ | YES | | YES | | | | | | | | NO | | NO | | | | [,HCOPY= | ~~ |] [,LOW= | ~~ |] | | | | YES | | YES | | | | | | | | NO | |*NONE| | | | [,NOLOG= | ~~ |] [,RETINF=|~~~~~|] | | | | YES | | xx | | | | | | | | I | |*EXTEND| | | | [,SPECIN=| C |] [,CCSNAME=| |]| | | | N | |ccsname| | | | ~ | | | | NO | | NO | | | | [,HOM= | ~~ |] [,NOPOS= | ~~ |] | | | | YES | | YES | | | | | | | | NO | | NO | | | | [,ENCOUT=| ~~ |] [,ENCIN= | ~~ |] | | | | YES | | YES | | | | | | | | NO | | | | [,INFOLR=| ~~ |] | | | | YES | | | | | | | | NO | | NO | | | |[,MODE=INFO] [,BELL = | ~~ |] [,GETFC= | ~~ |] | | | | YES | | YES | | | | | | | | NO | | NO | | | | [,NOLOG= | ~~ |] [,LOW= | ~~ |] | | | | YES | | YES | | | | | | | |*EXTEND| | | | [,CCSNAME=| |] | | | |ccsname| | | | | | | | NO | | NO | | | | [,ENCOUT=| ~~ |] [,ENCIN= | ~~ |] | | | | YES | | YES | | | | | A - Seite 6 - | | | | | | NO | | NO | | | |[,MODE=EXTEND][,BELL= | ~~ |] [,GETFC= | ~~ |] | | | | YES | | YES | | | | | | | | NO | | NO | | | | [,LOCIN= | ~~ |] [,LOW= | ~~ |] | | | | YES | | YES | | | | | | | |*EXTEND| | NO | | | | [,CCSNAME=| |] [,CURPOS=| ~~ |] | | | |ccsname| | YES | | | | | | | | UNPROT | | NO | | | | [,READ=| ~~~~~~ |] [,UPDATE=| ~~ |] | | | | MODIFIED | | YES | | | | | | | | STD | | | | [,AUTOTAB=| ~~~ |] | | | | NO | | | | | YES | | | | | | | | NO | | NO | | | | [,HCOPY= | ~~ |] [,INFOLR= | ~~ |] | | | | YES | | YES | | | | | | | | NO | | NO | | | | [,ENCOUT= | ~~ |] [,ENCIN= | ~~ |] | | | | YES | | YES | | | | | | | | YES | | YES | | | |[,MODE=PHYS][,IHDR= | ~~~ |] [,LOW= | ~~~ |] | | | | NO | | NO | | | | | | | | NO | | YES | | | | [,OHDR= | ~~ |] [,CODETR= | ~~~ |] | | | | YES | | NO | | | | | | | |*EXTEND| | NO | | | | [,CCSNAME=| |] [,INFOLR=| ~~ |] | | | |ccsname| | YES | | | | | | | | NO | | NO | | | | [,ENCOUT= | ~~ |] [,ENCIN= | ~~ |] | | | | YES | | YES | | | | | | | | NO | |*EXTEND| | | |[,MODE=FORM] [,LOW= | ~~ |] [,CCSNAME=| |]| | | | YES | |ccsname| | | | | | | | NO | | NO | | | | [,ENCOUT=| ~~ |] [,ENCIN= | ~~ |] | | | | YES | | YES | | | | | | | | NO | | | | [,INFOLR=| ~~ |] | | | | YES | | | | | A - Seite 7 - | | | | | | NO | | NO | | | |[,MODE=TRANS] [,ENCOUT=| ~~ |] [,ENCIN= | ~~ |] | | | | YES | | YES | | | | | | | | NO | | | | [,INFOLR=| ~~ |] | | | | YES | | | | | | | | NO | | NO | | | |[,MODE=CHIP] [,ENCOUT=| ~~ |] [,ENCIN= | ~~ |] | | | | YES | | YES | | | | --------------------------------------------------------------------- Beschreibung der Operanden: --------------------------- ENCOUT= Gibt an, ob die aktuelle Ausgabe verschluesselt werden muss oder nicht (gilt nur, wenn die Verbindung von einer Emulation aufgebaut wird, die die Verschluesselung unterstuetzt). YES Die Ausgabe muss verschluesselt sein. NO Die Ausgabe darf nicht verschluesselt sein (dennoch kann eine Verschluesselung der Nachricht nicht verhindert werden, wenn die Verschluesselung auf andere Weise angefordert wurde). ENCIN= Gibt an, ob die naechste Eingabe verschluesselt sein muss oder nicht (gilt nur, wenn die Verbindung von einer Emulation aufgebaut wird, die die Verschluesselung unterstuetzt). YES Die naechste Eingabe muss verschluesselt sein. Die naechste Eingabe darf nicht verschluesselt sein (dennoch kann eine Verschluesselung der Nachricht nicht verhindert werden, wenn die Verschluesselung auf andere Weise angefordert wurde.) INFOLR= Gibt an, ob die Informationszeile zurueckgesetzt werden muss. YES Die Informationszeile muss zurueckgesetzt werden. NO Die Informationszeile muss nicht zurueckgesetzt werden. A - Seite 8 - RETURN CODE : Der Returncode wird in die Standardkopfzeile der Parameter- liste gestellt. Er kann die folgenden Werte haben: X'00 00 0000' Funktion wurde erfolgreich ausgefuehrt X'00 01 FFFF' Funktions- oder Geraetenummer wird nicht unterstuetzt X'00 03 FFFF' Ungueltige Versionsnummer fuer Schnittstelle X'00 04 FFFF' Pl wurde nicht mit Maschinenwort abgeglichen X'08 01 0004' Fehlerhafte VTSUCB-Laenge X'10 01 0004' Ungueltiger Meldungsmodus X'11 01 0004' Fehlerhafter HARDCOPY-Parameter X'12 01 0004' Fehlerhafter BELL-Paramter X'13 01 0004' Fehler bei NOLOG-Parameter X'14 01 0004' Fehlerhafter READ-Parameter X'15 01 0004' Fehlerhafter HOM-Parameter X'16 01 0004' Fehler bei RETINF-parameter X'17 01 0004' Fehler bei LOCIN-Parameter X'18 01 0004' Fehler bei OHDR-Parameter X'19 01 0004' Fehler bei CODETR-Parameter X'1A 01 0004' Fehler bei IHDR-Parameter X'1B 01 0004' Fehler bei LOW-Parameter X'1C 01 0004' Fehler bei SPECIN-Parameter X'1D 01 0004' Fehler bei GETFC-Parameter X'1E 01 0004' Fehler bei CCSNAME-Parameter X'1F 01 0004' Fehler bei CURPOS-Parameter X'20 01 0004' Fehler bei UPDATE-Parameter X'21 01 0004' Fehler bei WARINFO-Parameter X'22 01 0004' Fehler bei AUTOTAB-Parameter X'23 01 0004' Fehler bei NOPOS-Parameter X'24 01 0004' Fehler bei ENCOUT-Parameter X'25 01 0004' Fehler bei ENCIN-Parameter X'26 01 0004' Fehler bei INFOLR-Parameter X'40 01 0004' Ungueltige Kopfzeilenlaenge der Ausgabe X'50 01 0004' Laenge des Benutzerpuffers fuer Eingabe nicht gueltig X'80 01 0004' Modus fuer Kommandotyp nicht gueltig X'xx 20 0004' Interner VTSU-Fehler X'00 40 00OC' Ausgabe wurde abgeschnitten X'00 40 0010' Eingabe wurde abgeschnitten X'00 40 0018' NL in Eingabemeldung fuer erweiterte Zeile X'81 40 0004' Mode=CHIP, es wurde jedoch keine Datenstation mit Chipkarte angegeben X'82 40 0004' Chipkarte von Datenstation nicht verfuegbar X'83 40 0004' Fehlercode von DSS durch CKT-Meldung X'86 40 0004' VTSUCB CCSN mit Geraet nicht kompatibel X'87 40 0004' Verschluesselung fuer Ausgabe wird nicht unterstuetzt X'88 40 0004' Verschluesselung fuer Eingabe wird nicht unterstuetzt X'89 40 0004' Zuruecksetzen der Informationszeile mit Modus ungueltig X'10 40 0020' Funktion wird derzeit nicht unterstuetzt X'60 01 0004' Angeforderte XHCS-Funktion nicht verfuegbar X'61 01 0004' Angeforderte XHCS-Funktion fuer eine 7-Bit-Datenstation X'62 01 0004' XHCS-Funktion wird nicht unterstuetzt X'7A 01 0004' Kein freier Bereich fuer Eingabe von SI/SO-Zeichen X'7B 01 0004' Kein freier Bereich fuer Eingabe von PAR01L-Zeichen X'1E 01 0004' Ungueltiger CCSNAME A - Seite 9 - VTSUCB DSECT : ------------ VCBDSECT VTSUCB MF=D,PREFIX=Y VCBDSECT IDLKG VER=350,SECT=D VCBDSECT DSECT FHDR MF=(C,YVTC),EQUATES=NO DS 0A YVTCFHE DS 0XL8 0 GENERAL OPERAND LIST HEADER * YVTCIFID DS 0A 0 INTERFACE IDENTIFIER YVTCFCTU DS AL2 0 FUNCTION UNIT NUMBER * BIT 15 HEADER FLAG BIT, * MUST BE RESET UNTIL FURTHER NOTICE * BIT 14-12 UNUSED, MUST BE RESET * BIT 11-0 REAL FUNCTION UNIT NUMBER YVTCFCT DS AL1 2 FUNCTION NUMBER YVTCFCTV DS AL1 3 FUNCTION INTERFACE VERSION NUMBER * YVTCRET DS 0A 4 GENERAL RETURN CODE YVTCSRET DS 0AL2 4 SUB RETURN CODE YVTCSR2 DS AL1 4 SUB RETURN CODE 2 YVTCSR1 DS AL1 5 SUB RETURN CODE 1 YVTCMRET DS 0AL2 6 MAIN RETURN CODE YVTCMR2 DS AL1 6 MAIN RETURN CODE 2 YVTCMR1 DS AL1 7 MAIN RETURN CODE 1 YVTCFHL EQU 8 8 GENERAL OPERAND LIST HEADER LENGTH * * SUBCODE 1 VALUES * YVTCECPM EQU X'01' ERROR CLASS PARAMETER ERROR YVTCECIN EQU X'20' ERROR CLASS INTERNAL ERROR YVTCECSP EQU X'40' ERROR CLASS SPECIAL ERROR * * SUBCODE 2 VALUES * YVTCERLN EQU X'08' ERROR IN LENGTH OF VTSUCB YVTCERMO EQU X'10' ERROR IN MODE PARAMETER YVTCERHC EQU X'11' ERROR IN HARDCOPY PARAMETER YVTCERBE EQU X'12' ERROR IN BELL PARAMETER YVTCERNO EQU X'13' ERROR IN NOLOG PARAMETER YVTCERRD EQU X'14' ERROR IN READ PARAMETER YVTCERHO EQU X'15' ERROR IN HOM PARAMETER YVTCERRE EQU X'16' ERROR IN RETINF PARAMETER YVTCERLO EQU X'17' ERROR IN LOCIN PARAMETER YVTCEROH EQU X'18' ERROR IN OUTPUT HEADER PARAMETER YVTCERCO EQU X'19' ERROR IN CODETR PARAMETER YVTCERIH EQU X'1A' ERROR IN INPUT HEADER PARAMETER YVTCERLW EQU X'1B' ERROR IN LOWER INPUT PARAMETER YVTCERSP EQU X'1C' ERROR IN SPECIAL INPUT PARAMETER YVTCERGE EQU X'1D' ERROR IN GET FUNCTION CODE PARAMETER YVTCERCC EQU X'1E' INVALID CCSNAME YVTCERCP EQU X'1F' ERROR IN CURPOS PARAMETER YVTCERUP EQU X'20' ERROR IN UPDATE PARAMETER YVTCERWA EQU X'21' ERROR IN WARINFO PARAMETER YVTCERAT EQU X'22' ERROR IN AUTOTAB PARAMETER YVTCERNP EQU X'23' ERROR IN NOPOS PARAMETER YVTCEREO EQU X'24' ERROR IN ENCOUT PARAMETER YVTCEREI EQU X'25' ERROR IN ENCIN PARAMETER YVTCERIR EQU X'26' ERROR IN INFOLR PARAMETER A - Seite 10 - YVTCERXH EQU X'60' XHCS FCT REQUESTED BUT XHCS NOT LOADED YVTCER7B EQU X'61' XHCS FCT REQUESTED FOR 7-BIT TERMINAL YVTCERBS EQU X'62' XHCS FCT SUPPORT ONLY FROM BS2000 V10 * YVTCERIN EQU X'7A' NO PLACE ENOUGH TO INSERT SI/SO CHARS YVTCER1L EQU X'7B' NO PLACE ENOUGH TO INSERT PAR01L CHARS * YVTCERM1 EQU X'80' MODE NOT VALID FOR COMMAND TYPE YVTCERM2 EQU X'81' MODE=CHIP USED BUT NO CKT ANNOUNCED YVTCERC1 EQU X'82' CKT NOT AVAILABLE FROM TERMINAL YVTCERC2 EQU X'83' OTHER ERROR CODE FROM DSS BY CKT-MSG YVTCERX2 EQU X'86' VTSUCB CCSN INCOMPATIBLE WITH DEVICE YVTCERE1 EQU X'87' ENCRYPTION FOR OUTPUT NOT SUPPORTED YVTCERE2 EQU X'88' ENCRYPTION FOR INPUT NOT SUPPORTED YVTCERE3 EQU X'89' INFO LINE RESET INVALID WITH MODE * YVTCERO1 EQU X'40' HEADER LENGTH OF OUTPUT MSG NOT VALID YVTCERI1 EQU X'50' USER BUFFER LEN FOR INPUT NOT VALID * * MAINCODE VALUES FOR SUBCODE 1 = X'40' * YVTCMRPM EQU X'04' WRONG PARAMETER FOR DEVICE YVTCMROT EQU X'0C' OUTPUT TRUNCATION YVTCMRIT EQU X'10' INPUT TRUNCATION YVTCMRNL EQU X'18' NL IN EXT LINE INPUT MESSAGE * * MAINCODE VALUES FOR SUBCODE 1 = X'00' * YVTCMRCO EQU X'08' CORRECTED ERROR * * YVTCLEN DS H LENGTH OF VTSUCB * YVTCINM DS C INPUT MODE FOR MODE=MIXED YVTCOUTM DS C OUTPUT MODE FOR MODE=MIXED * DS XL4 RETURN INFO (NOT YET USED) * YVTCMODE DS C MODE OF MESSAGE YVTCLINE EQU C'L' LINE MODE YVTCEXT EQU C'E' EXTENDED LINE YVTCINFO EQU C'I' INFO LINE MESSAGE YVTCPHYS EQU C'P' PYHSICAL MODE YVTCTRAN EQU C'T' TRANSPARENT MODE YVTCFORM EQU C'F' FORM MODE YVTCCHIP EQU C'C' CHIPCARD MODE (FOR CKT) YVTCMIXD EQU C'M' MIXED MODE * YVTCHC DS C HARCOPY FUNCTION YVTCHCN EQU C'N' NO HARDCOPY YVTCHCY EQU C'Y' LOCAL/CENTRAL HARDCOPY * YVTCBEL DS C BELL FUNCTION YVTCBELN EQU C'N' NO BELL YVTCBELY EQU C'Y' BELL AFTER OUTPUT * YVTCNLG DS C NO LOG CHARS TO INTERPRET FUNCTION YVTCNLGN EQU C'N' LOGICAL CHARACTERS TO INTERPRET YVTCNLGY EQU C'Y' NO LOGICAL CHARACTERS TO INTERPRET A - Seite 11 - YVTCRBYT DS CL2 RETURN INFO BYTES * YVTCRIN DS C RETURN INFORMATION FUNCTION YVTCRINN EQU C'N' NO RETURN INFORMATION YVTCRINY EQU C'Y' RETURN INFORMATION REQUIRED * YVTCLOC DS C INPUT OF LOCAL CHARACTERS YVTCLOCN EQU C'N' NO LOCAL CHARACTERS REQUIRED YVTCLOCY EQU C'Y' LOCAL CHARACTERS REQUIRED * YVTCOHD DS C OUTPUT HEADER FUNCTION YVTCOHDN EQU C'N' NO OUTPUT HEADER IN USER MSG YVTCOHDY EQU C'Y' OUTPUT HEADER IN USER MESSAGE * YVTCCTR DS C CODE TRANSLATION FUNCTION YVTCCTRN EQU C'N' NO CODE TRANSLATION DONE BY VTSU YVTCCTRY EQU C'Y' CODE TRANSLATION TO/FROM CCS REQ. * YVTCIHD DS C INPUT HEADER FUNCTION YVTCIHDN EQU C'N' NO INPUT HEADER REQUIRED YVTCIHDY EQU C'Y' INPUT HEADER REQUIRED * YVTCLOW DS C LOWER CHARACTERS FUNCTION YVTCLOWN EQU C'N' TRANSLATE LOWER CHARACTERS YVTCLOWY EQU C'Y' RETAIN LOWER CHARACTERS * YVTCSPIN DS C SPECIAL INPUT FUNCTION YVTCNSPI EQU C'N' NO SPECIAL INPUT YVTCIDIN EQU C'I' INPUT FROM ID-CARD READER YVTCCOIN EQU C'C' CONFIDENTIAL INPUT * YVTCFC DS C FUNCTION CODE YVTCFCN EQU C'N' NO FUNCTION CODE REQUIRED YVTCFCY EQU C'Y' FUNCTION CODE REQUIRED * YVTCHOM DS C HOMOGENEOUS OUTPUT YVTCHOMN EQU C'N' NO HOMOGENEOUS OUTPUT REQUIRED YVTCHOMY EQU C'Y' HOMOGENEOUS OUTPUT REQUIRED * YVTCNOP DS C OUTPUT ON SAME LINE YVTCNOPN EQU C'N' OUTPUT STARTS ON NEXT LINE YVTCNOPY EQU C'Y' OUTPUT STARTS ON CURRENT LINE * YVTCCCNA DS CL8 CODED CHARACTER SET NAME * YVTCCUR DS C CURSOR POSITION REQUESTED YVTCCURN EQU C'N' CURSOR POSITION NOT RETURNED YVTCCURY EQU C'Y' CURSOR POSITION GIVEN AFTER INPUT * YVTCPOSL DS XL1 CURSOR POSITION (LINE) YVTCPOSC DS XL1 CURSOR POSITION (COLUMN) * YVTCREAD DS C READ MODE (EXTENDED LINE MODE) YVTCRDUN EQU C'U' READ UNPROTECTED YVTCRDMO EQU C'M' READ MODIFIED * YVTCUPD DS C SCREEN UPDATE IN EXTENDED LINE MODE YVTCUPDN EQU C'N' NO SCREEN UPDATE -> REFRESH YVTCUPDY EQU C'Y' SCREEN UPDATE A - Seite 12 - YVTCWAR DS C WAR BYTE REQUESTED YVTCWARN EQU C'N' NO INFO ABOUT WAR BYTE YVTCWARY EQU C'Y' VALUE OF WAR BYTE TO RETURN * YVTCWARI DS XL1 RETURNED WAR BYTE VALUE * YVTCAT DS C AUTOMATIC TABULATION YVTCATS EQU C'S' STANDARD AUTOMATIC TABULATION YVTCATN EQU C'N' AUTOMATIC TABULATION NOT REQUESTED YVTCATY EQU C'Y' AUTOMATIC TABULATION REQUESTED * YVTCEO DS C ENCRYPTION FOR OUTPUT YVTCEON EQU C'N' ENCRYPTION FOR OUTPUT NOT REQUESTED YVTCEOY EQU C'Y' ENCRYPTION FOR OUTPUT REQUESTED * YVTCEI DS C ENCRYPTION FOR INPUT YVTCEIN EQU C'N' ENCRYPTION FOR INPUT NOT REQUESTED YVTCEIY EQU C'Y' ENCRYPTION FOR INPUT REQUESTED * YVTCIR DS C INFO LINE RESET YVTCIRN EQU C'N' INFO LINE RESET NOT REQUESTED YVTCIRY EQU C'Y' INFO LINE REQUESTED * DS XL1 RESERVED * YVTC# EQU *-YVTCFHE LENGTH OF DSECT *,VTSUCB 350 A - Seite 13 - 4. Statische Definition von 8-Bit/Unicode-Geraeten ueber eine Konfigurationsdatei =============================================== Die folgende Beschreibung ergaenzt die Beschreibung der Moeglich- keiten zur Aktivierung von 8-Bit/Unicode-Varianten, die auf den Seiten 211-213 des Handbuchs enthalten ist. Eine Konfigurationsdatei kann zur permanenten Aktivierung einer 8-Bit/Unicode-Variante verwendet werden. Die vorhandene Variante erhaelt dieselben Eigenschaften wie eine Variante, die ueber folgendes TIAM-Kommando aktiviert wurde: /MODIFY-TERMINAL-OPTION CODED-CHARACTER-SET=variant_name Dies bedeutet, dass Informationen bezueglich dieser Variante durch VTSU-B an TU-Anwendungen (EDT, FHS, Benutzeranwendungen...) zurueckgegeben werden, wenn ein TSTAT-Aufruf ausgegeben wird. Wenn z. B. eine Variante auf andere Weise aktiviert wurde, gilt folgendes : VTSUCB, Standardeinstellung fuer Benutzer oder explizit aktivierte Variante (TIAM-Kommando). Diese Funktion ist ab BS2000/OSD-BC V1.0 verfuegbar. 4.1. Dateiname, Standort der Datei ----------------------------- Wenn das VTSU-B-Subsystem nicht mit IMON installiert wird, muss die Datei unter der Kennung TSOS verfuegbar sein und folgenden Namen haben: SYSPAR.VTSU-B.132.EHCS. Wenn das VTSU-B-Subsystem mit IMON installiert wird, kann der Systembetreuer die Konfigurationsdatei mit der logischen ID SYSPAR.EHCS verbinden. Der Systembetreuer kann dann den Namen und den Standort der Datei frei waehlen. Wird diese Funktion nicht verwendet, muss der obige Standarddateiname verwendet werden. A - Seite 14 - 4.2. Format der Konfigurationsdatei ------------------------------ In der Datei definiert eine Zeile eine Verbindung (mit moeglichen Platzhalterzeichen). Beim Aufbau der Verbindung wird die Konfiguration in der Reihenfolge der Zeilen ausgewertet. Dies bedeutet, dass die erste Zeile mit den passenden Verbindungsmerkmalen beruecksichtigt wird. 2. 11. 20. 29. 38. Spalte +--------+--------+--------+--------+ pppppppp ssssssss tttttttt vvvvvvvv l pppppppp ist der Prozessorname, acht Zeichen lang ssssssss ist der Stationsname, acht Zeichen lang tttttttt ist der Geraetetyp, acht Zeichen lang Fuer den Prozessornamen, den Stationsnamen und den Geraetetyp steht das Zeichen '*' in der ersten Spalte des Feldes dementsprechend fuer alle Prozessornamen, alle Stationsnamen und alle Geraetetypen. An anderen Positionen in den Feldern fuer den Prozessornamen und den Stationsnamen kann der '*' fuer jedes beliebige Zeichen stehen. Der Stationsname und der Prozessorname muessen genau acht Zeichen lang sein. Kuerzere Namen muessen durch Leer- zeichen ergaenzt werden. vvvvvvvv ist der Name der Variante, acht Zeichen lang l ist der Zeilentyp (7- oder 8-Bit), wobei 7 angenommen wird, wenn ein anderer Wert als 8 angegeben wird. Es ist moeglich, eine Zeile fuer Anmerkungen durch die Plazierung eines '*' in Spalte 1 einzufuegen. Gueltige Zeilen muessen ein Leerzeichen in Spalte 1, 10, 19, 28 und 37 enthalten. Die Zeilenlaenge muss mindestens 38 Zeichen lang sein. Zeichen nach Spalte 38 werden ignoriert. Zeilen koennen nicht mehr als 72 Zeichen enthalten! Wird dieses Format nicht eingehalten, wird die Meldung DCM0222 an die Konsole mit den Informationen zum verwendeten Dateinamen und zur fehlerhaften Zeilennummer gesendet. Ist der Geraetetyp ungueltig, wird die Meldung DCM0224 an die Konsole mit den Informationen zum verwendeten Dateinamen, zur fehlerhaften Zeilennummer und zum zurueckgewiesenen Geraetetyp gesendet. Gueltige Geraetetypen sind: DSS#9750, DSS#9755, DSS#9763, DRS#9001, DRS#9011, DRS#9012, DRS#9013, DRS#9014, DRS#9021 A - Seite 15 - Wird die Variante nicht im XHCS-SYS-Subsystem definiert oder ist die Variante nicht gueltig (z. B. ISO-Variante), wird die Meldung DCM0223 an die Konsole mit den Informationen zum verwendeten Dateinamen, zur entsprechenden Zeilennummer und zur zurueckgewiese- nen Variante gesendet. Alle Eintraege oder Aenderungen an der Konfigurationsdatei beeinflussen den naechsten Start des VTSU-Subsystems. 4.3. Konsistenz des Geraetetyps -------------------------- Fuer die Konsistenz zwischen tatsaechlichem Geraetetyp (dem VTSU-B bekannten und vom Verbindungsbericht empfangenen Geraetetyp) und dem in der Konfigurationsdatei enthaltenen Geraetetyp ist der Systembetreuer verantwortlich. Dennoch erhaelt VTSU-B beim Aufbau der Verbindung fuer die Geraete, die im Verbindungsbericht als 9763-Geraete definiert wurden, bezueglich unterstuetzter Varianten direkte dynamische Informatio- nen von dem Geraet (Emulation). Nur fuer diesen Geraetetyp ueber- prueft VTSU-B die Konsistenz zwischen den unterstuetzten Varianten und dem vorgegebenen Typ in der Konfigurationsdatei. Wenn die vor- handene Variante in der Datei nicht vom Geraet unterstuetzt wird, wird diese ohne Ausgabe einer Fehlermeldung ignoriert. Das Geraet kann dennoch als ein standardmaessiges 8-Bit-Geraet mit der standardmaessigen 8-Bit-Unterstuetzung verwendet werden. 4.4. Beispiele fuer Definitionszeilen -------------------------------- * * Definition von statischen Verbindungen mit 8-bit-Varianten * *vvvvvvvv wwwwwwww xxxxxxxx yyyyyyyy z * D241KR30 DSN30107 * EDF041 8 (1) * * * DSS#9763 EEHCLC 7 (2) * D241**** * * EDF042 X (3) * * Dateiende * (1) - Die anhand des Prozessornamens D241KR30 und des Stations- namens DSN30107 erkannte Verbindung wird mit der Variante EDF041 aktiviert. - Der Geraetetyp wurde nicht ausgewertet. - Der Zeilentyp ist ein 8-Bit-Zeilentyp. (2) - Alle 9763-Geraete werden mit der Variante EEHCLC aktiviert. - Der Stationsname und der Prozessorname werden nicht ausgewertet. - Der Zeilentyp ist ein 7-Bit-Zeilentyp. (3) - Alle Verbindungen mit einem Prozessornamen, der mit 'D241' beginnen, werden mit der Variante EDF042 aktiviert. - Der Geraetetyp und der Stationsname werden nicht ausgewertet. - Die Zeile wird als 7-Bit-Zeilentyp erkannt.