6530 Programmer s Guide

Transcription

1 6530 Programmer s Guide 2Tadem

2 6530 Programmer s Guide Part Number

3 Copyright All rights reserved. No part of this documet may be reproduced i ay form, icludig photocopyig or traslatio to aother laguage, without the prior writte coset of Tadem Computers Icorporated. Copyright 1996 by Tadem Computers Icorporated. Documet History Editio Part Number Date First Editio November 1996 New editios icorporate all updates issued sice the previous editio. Update packages, which are issued betwee editios, cotai additioal ad replacemet pages that you should merge ito the most recet editio of the maual. The material cotaied i this maual is subject to chage without otice. Please cotact your authorized Tadem represetative to make sure that you have the most recet iformatio. Trademarks or Service Marks The followig are trademarks or service marks of Tadem Computers Icorporated: Multila, NoStop, TACL, Tadem. All brad ad product ames are trademarks or registered trademarks of their respective compaies. Examples Disclaimer Examples ad sample programs are for illustratio oly ad may ot be suited for your particular purpose. Tadem does ot warrat, guaratee, or make ay represetatios regardig the use or the results of the use of ay examples or sample programs i ay documetatio. You should verify the applicability of ay example or sample program before placig the software ito productive use.

4 Preface This book describes the 6530 set of termial fuctios ad explais how to use 6530 Escape ad Cotrol sequeces i applicatios you write for hosts that commuicate with either of the followig Tadem products which perform 6530 fuctios: PC6530 software TS530 termial Except where specifically oted otherwise, the term 6530 is used i a geeric sese to mea either the PC6530 software or the TS530 termial whe the software or the termial is actig i its capacity to perform 6530 termial fuctios. The iformatio i this maual is orgaized as follows: Chapter 1 - Overview. Itroduces the 6530 by describig 6530 features, the host commuicatios iterface, the applicatio programmig iterface, ad 6530 cofiguratio parameters that ca be programmed by the host. Chapter 2 - Coversatioal Mode Operatio. Gives details about coversatioal mode ad describes all the cotrol codes, escape sequeces, ad keyboard operatios available i this mode. Chapter 3 - Block Mode Operatio. Provides details about block mode ad describes all the cotrol codes, escape sequeces, ad keyboard operatios available i this mode. Chapter 4 - Tadem NoStop Kerel Applicatio Iterface. Briefly explais the iterface betwee applicatio programs, the Tadem NoStop Kerel file system ad commuicatios software, ad the Also provides a example program writte i TAL. Appedix A - ASCII Character Set. Lists the cotrol ad graphics characters ad their correspodig codes for the ASCII character set. Appedix B - Iteratioal Character Set. Provides iformatio about iteratioal laguage characters supported by the Appedix C - Cotrol Codes ad Escape Sequeces. Summarizes the cotrol codes ad escape sequeces used to cotrol operatio of the Appedix D - Data Type Table. Lists the predefied data type table for the ASCII character set Programmer s Guide iii

5 Preface Related Publicatios For iformatio about publicatios that cotai iformatio related to the 6530, see the Tadem Iformatio Maager (TIM), which is available o CD-ROM ad o the Iteret. The TIM icludes iformatio about documets available for these products: PC6530 software Tadem TS530 termials the Tadem NoStop Kerel operatig system the Trasactio Applicatio Laguage (TAL) the Tadem Commuicatios Maagemet Iterface (CMI) Multila Sytax Notatio This maual uses the followig otatio to idicate the sytax of cotrol sequeces set to the emulator ad the format of messages retured to your applicatio: [ ] Square brackets idicate that the eclosed item(s) is optioal.... Ellipses idicate that the precedig item(s) ca be repeated as may times as ecessary. lc Lowercase italics idicate a variable item that must be replaced by data. Cotrol characters are represeted by two- or three-character abbreviatios show i uppercase letters, for example, ESC, CR, LF ad so o. Whe you sed a cotrol character to the 6530, you must sed the ASCII code for the character as listed i Appedix A. The spaces show i the format descriptios ad examples are for clarity oly. Uless specifically stated otherwise, the spaces are ot part of escape sequece or retured message format, ad will cause a error if icluded. A H followig a umber idicates a hexadecimal value, for example, 10H. iv 6530 Programmer s Guide

6 Preface Numberig Covetio The bit-umberig covetio used i this book differs from that assiged to the Tadem NoStop Kerel systems. The Tadem system umberig scheme is based o a 16-bit word (umbered 0-15) with bit 15 beig the least sigificat bit (lsb). O the workstatio or PC, the umberig scheme is based o a 8-bit byte (umbered 7-0) with bit 0 beig the least sigificat bit. I this maual, the 8-bit scheme refers to data accessed i the workstatio or PC. Note I byte operatios, the Tadem system allocates two bytes per word rather tha oe byte per word. For example, the system places the status bytes read from the workstatio or PC ito a applicatio buffer startig o a word boudary. This meas that the most sigificat byte from the workstatio or PC is writte ito bits 0-7 of the word addressed i the applicatio buffer. Tadem NoStop Kerel System: lsb Byte 0 Byte 1 Workstatio or PC: lsb Byte Programmer s Guide v

7 Preface vi 6530 Programmer s Guide

8 Table of Cotets 1 Overview 6530 Features Scree Format Message/Status Lie Error Lie Modes of Operatio Coversatioal mode Block mode Display Memory Orgaizatio Coversatioal Mode Memory Orgaizatio Block Mode Memory Orgaizatio Video Attributes Data Attributes Character Codes Escape Sequeces Keyboard Operatio Cofiguratio Parameters Device Cotrol Host Commuicatios Iitializatio Sequeces Termial Reset Soft Reset Program Reset System Reset Applicatio Programmig Iterface Programmer s Guide vii

9 Table of Cotets Cofiguratio Parameters Aux1 device ame Aux2 device ame baud rate bell colum bell volume character set character size compressio ehace cursor type device ame duplex EM3270 support host ame keyboard laguage local trasmit colum ormal itesity packet blockig parity PFKey support Power O mode prit form feed prit lie termiator resource ame Retur fuctio key RTM support save cofiguratio scree format scree saver sessio ame SPS status lie border trasmit lie viii 6530 Programmer s Guide

10 Table of Cotets TS530 scree video attributes TS530 switch refresh rate widow ame Coversatioal Mode Operatio Cotrol Codes ad Escape Sequeces Cursor Locatio Set Cursor Address (DC3) Set Cursor Address Exteded (Esc - D) Read Cursor Address (Esc a) Cursor Movemet Cursor Up (Esc A) Lie Feed (LF) Cursor Right (Esc C) Backspace (BS) Carriage Retur (CR) Cursor Home (Esc H) Cursor Home Dow (Esc F) Horizotal Tab (HT) Tab Settigs Set Tab (Esc 1) Clear Tab (Esc 2) Clear All Tabs (Esc 3) Roll/Page Operatios Roll Up (Esc S) Roll Dow (Esc T) Page Up (Esc V) Page Dow (Esc U) Display Page (Esc ;) Clear Display Memory Clear Memory to Spaces (Esc I) Erase to Ed of Memory (Esc J) Erase to Ed of Lie (Esc K) Programmer s Guide ix

11 Table of Cotets Video Attributes Set Video Attributes (Esc 6) Set Video Prior Coditio Register (Esc 7) Color Video Attributes Color Ehacemet Query (Esc?) Read 6530 Color Mappig Table (Esc - v) Set/Reset Color Map Table (Esc - q) Read Color Mappig Table (Esc - v) Read Color Cofiguratio (Esc - u) Set Color Cofiguratio (Esc - t) Cofiguratio Values Read Termial Cofiguratio (Esc?) Set Termial Cofiguratio (Esc v) Read I/O Device Cofiguratio (Esc y) Set I/O Device Cofiguratio (Esc x) Read Strig Cofiguratio Parameter (Esc - d) Set Strig Cofiguratio Parameter (Esc - c) Read VTLAUNCH 6530 Cofiguratio Parameter ( Esc - g ) RTM Support RTM Cotrol (Esc - i) RTM Data Upload (Esc - j) Status Iformatio Read Termial Status (Esc ^) Read Full Revisio Level (Esc _) Get Machie Name (Esc - e) Get Curret Directory ad Redirectio Iformatio (Esc - f) Device Cotrol Prit Scree (Esc 0) Write to Aux1 or Aux2 Device (Esc - O) Write to File or Device Name (Esc { ) Write/Read to File or Device ame (Esc } ) Load ad Execute a Operatig System Program (Esc - V) x 6530 Programmer s Guide

12 Table of Cotets Report Exec Retur Code (Esc - W) Discoect Modem (Esc f) Geeral Operatios Bell (BEL) Delay Oe Secod Ulock Keyboard (Esc b) Lock Keyboard (Esc c) Simulate Fuctio Key (Esc d) Write to Message Field (Esc o) Reiitialize (Esc q) Defie Eter Key Fuctio (Esc u) Termiate Remote 6530 Operatio (Esc - z) Execute Self Test (Esc z) Shift Out to G1 Character Set (S0) Shift I to G0 Character Set (S1) Fuctio Keys Keyboard Operatios Block Mode Operatio Fields ad Field Attributes (Protect Submode) Modified Data Tags Data Types Auto-Tab Disable Upshift Alterate Iput Device Cotrol Codes ad Escape Sequeces Page Operatios Display Page (Esc ;) Select Page (Esc :) Set Max Page Number (Esc p) Cursor ad Buffer Addressig Set Cursor Address (DC3) Set Cursor Address Exteded (Esc - D) Read Cursor Address (Esc a) Programmer s Guide xi

13 Table of Cotets Set Buffer Address (DC1) Set Buffer Address Exteded (Esc - C) Cursor Movemet Cursor Up (Esc A) Lie Feed (LF) Cursor Right (Esc C) Backspace (BS) Carriage Retur (CR) Cursor Home (Esc H) Cursor Home Dow (Esc F) Horizotal Tab (HT) Back Tab (Esc i) Tab Settigs Set Tab (Esc 1) Clear Tab (Esc 2) Clear All Tabs (Esc 3) Video Attributes Set Video Attributes (Esc 6) Set Video Prior Coditio Register (Esc 7) Color Video Attributes Color Ehacemet Query (Esc?) Read 6530 Color Mappig Table (Esc - v) Set/Reset Color Map Table (Esc - q) Read Color Mappig Table (Esc - v) Read Color Cofiguratio (Esc - u) Set Color Cofiguratio (Esc - t) Set 6530 Color Mappig (Esc - x) Start Ehaced Color Field (Esc ) Read Scree With All Attributes (Esc Q) Protect Submode Eter Protect Submode (Esc W) Exit Protect Submode (Esc X) Start Field (GS) Start Field Exteded (Esc [ ) xii 6530 Programmer s Guide

14 Table of Cotets Reset Modified Data Tags (Esc >) Defie Data Type Table (Esc r) Defie Data Type Table Exteded (Esc-r) Set 40-character lie width (Esc 8) Set 80-character lie width (Esc 9) Set 40-character scree width (Esc t) EM3270 Submode Read Page Read Whole Page / Buffer (Esc <) Read with Address (Esc =) Read with Address Exteded (Esc - J) Read with Address All (Esc ]) Read with Address All Exteded (Esc - K) Clear Display Memory Clear Memory to Spaces (Esc I) Clear Memory to Spaces Exteded (Esc - I) Erase to Ed of Page (Esc J) Erase to Ed of Lie/Field (Esc K) Editig Isert Lie (Esc L) Delete Lie (Esc M) Isert Character (Esc O) Delete Character (Esc P) Cofiguratio Values Read Termial Cofiguratio (Esc?) Read Field-Selectable Color Cofiguratio Set Termial Cofiguratio (Esc v) Read I/0 Device Cofiguratio (Esc y) Set I/0 Device Cofiguratio (Esc x) Read Strig Cofiguratio Parameter (Esc - d) Set Strig Cofiguratio Parameter (Esc - c) Read VTLAUNCH 6530 Cofiguratio Parameter ( Esc - g ) Programmer s Guide xiii

15 Table of Cotets RTM Support RTM Cotrol (Esc - i) RTM Data Upload (Esc - j) PFKey Support EM3270 Support Set EM3270 Mode (Esc - m) Read All Locatios (Esc - ) Read Keyboard Latch (Esc - o) Outboud Compressio Start Limited Data Compressio (DC4) Start Exteded Data Compressio (DC2) Status Iformatio Read Termial Status (Esc ^) Read Full Revisio Level (Esc _) Get Machie Name (Esc - e) Get Curret Directory ad Redirectio Iformatio (Esc - f) Device Cotrol Prit Page (Esc 0) Write to Auxl or Aux2 Device (Esc - 0) Write to File or Device Name (Esc { ) Write/Read to File or Device Name (Esc } ) Load ad Execute a Operatig System Program (Esc - V) Report Exec Retur Code (Esc - W) Discoect Modem (Esc f) Geeral Operatios Bell (BEL) Defie Field Attribute (FS) Defie/Update Variable Table (Esc - s) Delay Oe Secod 3-90 Disable Local Lie Editig (Esc N) Ulock Keyboard (Esc b) Lock Keyboard (Esc c) Simulate Fuctio Key (Esc d) Write to Message Field (Esc o) xiv 6530 Programmer s Guide

16 Table of Cotets Reiitialize (Esc q) Termiate Remote 6530 Operatio (Esc - z) Execute Self Test (Esc z) Shift Out to G1 Character Set (S0) Shift I to G0 Character Set (S1) Fuctio Keys Keyboard Operatios Tadem NoStop Kerel Applicatio Iterface File System Procedure Calls Programmig Example A B C D ASCII Character Set Iteratioal Characters Cotrol Codes ad Escape Sequeces Data Type Table Idex 6530 Programmer s Guide xv

17 Table of Cotets xvi 6530 Programmer s Guide

18 1 Overview This chapter briefly describes the features of the This chapter also provides descriptios of 6530 cofiguratio parameters Features The 6530 provides the followig features to ehace termial operatio i olie trasactio processig eviromets: A 25 row by 80 colum scree format, with a message/status ad error lie separate from the display of other scree data. Two major operatig modes: coversatioal ad block. Display memory for storage of displayable (graphics) data etered from the keyboard or received from the host. Video ad data attributes for specifyig how characters are displayed o the scree ad what type of characters ca be etered from the keyboard. Support for both 7-bit ad 8-bit character codes, icludig the stadard ASCII character set ad iteratioal character sets compatible keyboard operatio, icludig local editig capabilities, fuctio keys to ivoke applicatio-specific fuctios, ad several levels of reset from the keyboard. Cofiguratio parameters for selectig optios ad settig up host commuicatios. Scree Format The 6530 scree format cosists of 25 rows by 80 colums. The cursor type, which is selected by a cofiguratio parameter, ca appear as either a blikig uderscore or blikig reverse video block. The first 24 rows of the scree display the characters writte ito display memory. The bottom (25th) row is reserved ad alterately displays two types of lies: a message/status lie ad a error lie. Both lies are stored i a area of memory separate from the rest of the scree display Programmer s Guide 1-1

19 Overview Message/Status Lie The bottom row of the scree cotais the message/status lie, which has the followig format: Colum b Message Area b Status Area Colums 1 ad 66 always cotai a blak space. The message area occupies colums 2 through 65. It ca cotai ay character strig set through a escape sequece from either your applicatio program or the keyboard i coversatioal mode.text i the message area remais visible util it is cleared or reset by aother escape sequece. The status area, occupyig colums 67 through 80, cotais termial status iformatio such as the curret mode of operatio. Oly the 6530 ca write ito this area; your applicatio caot address this area. The user ca eable ad disable the display of the status area by pressig the Ctrl-Next Page ad Ctrl-Prev Page keys, respectively. Error Lie Whe the 6530 detects a error, it temporarily replaces the message/ status lie with a error lie. The error lie has the followig format: Colum b Error Message Area These types of error ca occur: Geeral errors. Operator errors, device errors, ad other errors detected by the operatig system or by the Commuicatios errors. Ivalid commads to the 6530 (detected ad reported by the Commad errors). While the error lie is displayed, ay keypress removes the error lie ad restores the message/status lie Programmer s Guide

20 Overview Modes of Operatio The 6530 ca operate i oe of two major modes: Coversatioal Block The mode selected determies how data is trasmitted to the host, as well as how certai cotrol codes, escape sequeces, ad keyboard operatios fuctio. You ca select the mode best suited for your particular applicatio. You ca also switch modes at differet poits i your applicatio. Coversatioal mode Coversatioal mode is useful for applicatios that eed to iteract with the 6530 o a lie-by-lie basis, such as the host Tadem Advaced Commad Laguage (TACL). I this mode, the 6530 trasmits data to the host character by character as it is typed o the keyboard. The trasfer is termiated whe the host receives a lie termiatio character, such as a carriage retur (CR) character. Half duplex Whe the commuicatios lie is cofigured for half duplex, the 6530 processes characters etered from the keyboard as it trasmits them to the host. The 6530 iterprets these characters as graphics (displayable) characters or as cotrol characters. Graphics characters are stored i display memory ad appear o the scree. Cotrol characters are ot displayed or stored locally; istead, they cause the 6530 to perform various fuctios. Characters received from the host are also iterpreted as graphics or cotrol characters ad are hadled i the same way. Full duplex Whe the commuicatios lie is cofigured for full duplex, the 6530 oly processes characters received from the host. Characters etered from the keyboard are trasmitted to the host, but they are ot processed by the 6530 util they are echoed back by the host. Characters received from the host are iterpreted ad processed i the same maer as i half duplex. Chapter 2 describes the details of coversatioal mode operatio. Block mode Block mode allows the applicatio program to cotrol the format of data o the scree. I additio, the 6530 ca perform more local processig fuctios, such as editig tasks, ad thus reduce host applicatio processig requiremets Programmer s Guide 1-3

21 Overview I block mode, the 6530 displays characters typed o the keyboard ad stores them i display memory. The 6530 does ot trasmit ay data util the host applicatio issues a read request. Thus, a user ca eter multiple lies of data or eve a complete scree betwee trasfers to the host. The 6530 trasmits data as a block. A block ca be a full scree or page of data. Each block begis with a start of text (STX) or start of header (SOH) character ad is termiated by a ed of text (ETX) ad logitudial redudacy check (LRC) character. Block mode has two submodes: Noprotect (default). The user ca positio the cursor aywhere o the scree ad eter ay type of data. Protect. Your applicatio program ca divide the scree ito fields with assiged video ad data attributes. Chapter 3 describes the details of block mode operatio Programmer s Guide

22 Overview 6530 Display Memory Orgaizatio A portio of the 6530 memory is reserved for storig data that ca be show o the scree. This icludes displayable (graphics) characters etered from the keyboard or received from the host. Note The message/status ad error lies are hadled separately. Eough memory is allocated to fill the scree several times over. Usig various cursor or display cotrol keys, the user ca select which portio of memory actually appears o the scree. How 6530 display memory is orgaized ad accessed depeds o the mode of operatio selected. Coversatioal Mode Memory Orgaizatio Display memory i coversatioal mode is orgaized as oe cotiuous area, similar to a roll of paper. Oly 24 cotiguous lies of display memory ca appear o the scree at oe time. The user or your applicatio ca move the cursor aroud ad roll display memory up or dow o the scree. Iformatio rolled off the top or bottom of the scree cotiues to be stored i display memory util all the available display memory lies are used. At this poit, a attempt to move the cursor past the last lie of memory causes a scroll operatio to occur. The scroll operatio deletes the first lie of display memory, moves all remaiig memory lies up oe lie, ad iserts a ew blak lie at the bottom of display memory Chapter 2 provides more details about display memory ad cursor cotrol i coversatioal mode. Block Mode Memory Orgaizatio Display memory i block mode is divided ito logical pages, each cosistig of 24 lies. The maximum umber of pages that ca be allocated depeds o the umber of fields defied whe protect submode is used. Oly oe page ca be displayed at a time, ad the scree display caot cross page boudaries, so rollig operatios are disabled. Your applicatio program cotrols which page is displayed. Typically, the user requests a ew page to be displayed through oe of the fuctio keys Programmer s Guide 1-5

23 Overview Character iput from the keyboard occurs at the cursor locatio o the curretly displayed page. Each page has its ow cursor, ad the cursor for a particular page ca be moved without affectig the cursors o other pages. The cursor locatio is addressed by row ad colum positios relative to the page. The default cursor address is the home locatio (row 1, colum 1). Whe a ew page is displayed, the cursor moves to the cursor locatio stored for that page. This locatio may be the same as whe the page was last displayed, a ew locatio set by your applicatio, or the default home positio. The user ca oly modify data at the curretly displayed page ad oly at the curret cursor locatio. Your applicatio program, however, ca select ay page for I/O. For example, while the user is displayig ad modifyig data o page 1, your applicatio program ca read ad write to page 3. However, o I/O ca be performed across page boudaries. A ew page must be selected before its cotets are accessible. Your applicatio program uses buffer addresses for writig data to the curretly selected page. Buffer addresses are also row ad colum positios withi the page. The curret buffer address is idepedet of the cursor address for that page ad may be the same or differet o each page. All explicit cursor movemet operatios iitiated by your program referece the cursor positio o the selected page. Display memory is orgaized i the same maer for both protect ad oprotect submodes. Protect submode adds the additioal fuctioality of fields. Your applicatio ca defie ay cotiguous subset of character positios o a page as a field. Each field ca the be assiged its ow video ad data attributes. The cursor caot be positioed ito a protected field, either from the keyboard or from your applicatio. A attempt to place the cursor i a protected field results i the cursor movig to the first positio of the ext uprotected field. Because your applicatio uses buffer addressig for I/O, it ca write ito ay positio o the page Programmer s Guide

24 Overview Video Attributes Video attributes ca be used i ay of the operatig modes. They specify how characters appear o the scree. The video attributes available with the 6530 are: Blikig or oblikig Normal or alterate itesity Normal or reverse video Normal or uderscored Normal or ivisible (ot displayed) Some restrictios for attribute combiatios exist. Moochrome moitors are uable to display reverse video ad uderscored characters simultaeously, because display of the reverse video attribute masks the appearace of the uderscore attribute. If the workstatio or PC is equipped with EGA, CGA, or VGA, video attributes ca be mapped that allow display of color. See subsequet chapters for details o color mappig i each operatig mode. Data Attributes Data attributes are available oly i the protect submode of block mode. They provide various forms of cotrol over data etered by the user. I additio to video attributes, a field ca be assiged combiatios of the followig data attributes: Protect - Cotrols write-accessibility. Oly your applicatio program ca write ito a protected field. Data Type - Idetifies the type of data that ca be etered ito a uprotected field. Auto-Tab Disable - Prevets automatic cursor jump. Modified Data Tag (MDT) - Idetifies fields for subsequet read operatios. Upshift - Coverts all lowercase letters etered from the keyboard to uppercase before displayig them i the field. Alterate Iput Device (AID) - Defies a field to accept iput from the keyboard oly, from a AID oly, or from either the keyboard or AID. Chapter 3 provides more details o the data attributes ad how to select them Programmer s Guide 1-7

25 Overview Character Codes The 6530 ca be cofigured to trasmit either 7-bit or 8-bit character codes, with or without parity. The lower 7 bits are used for the stadard ASCII character set, which represets 128 differet characters. The eighth bit is used for a upper 128-character set, which is the same as the workstatio s or PC s stadard alterate character set. Both the 7-bit ad 8-bit codes represet two types of characters: Cotrol characters Graphics (displayable) characters With the 7-bit ASCII codes, cotrol characters are represeted i the rage of 00H to 1FH. This is referred to as the C0 set. Graphics characters are represeted i the rage of 20H to 7FH, referred to as the G0 set. The 8-bit codes iclude the C0, G0, C1, ad G1 sets. The C1 set is aother set of cotrol characters, represeted i the rage of 80H to 9FH. The G1 set is a additioal set of graphic characters, represeted i the rage of A0H to FFH. Table 1-1 summarizes the character set rages. Table 1-1. Character Set Rages Set Rage Descriptio C0 00H to 1FH ASCII cotrol characters G0 20H to 7FH ASCII graphics characters C1 80H to 9FH Upper (alterate) cotrol characters G1 A0H to FFH Upper (alterate) graphics characters The graphics characters cosist of alphaumeric ad special symbols, such as puctuatio marks. Whe the 6530 receives a graphics character code, it stores the specified character i display memory at the curret cursor or buffer address ad icremets the address by oe positio. Your applicatio program ca sed graphics code i the G0 set simply by sedig the ASCII character. If the 6530 is cofigured for 8 bits, you ca also sed graphics codes i the G1 set by sedig the 8-bit character code. If the 6530 is cofigured for 7 bits, you ca sed graphics codes i the G1 set by first sedig a SO (shift out) cotrol character to shift to the G1 set ad the sedig the correspodig ASCII character. The SI (shift i) cotrol character shifts back to the G0 set. The SO ad SI cotrol characters ca also be used i 8-bit cofiguratios. Appedix A lists the graphics characters i the G0 set, alog with their correspodig ASCII codes. For characters i the G1 set, see your workstatio or PC documetatio Programmer s Guide

26 Overview The cotrol characters specify a set of commuicatios ad termial cotrol fuctios, such as movig the cursor o the scree. Whe the 6530 receives a recogized cotrol character, it performs the specified fuctio. Urecogized cotrol characters are igored. Cotrol characters are ot stored i display memory, ad are ot show o the scree. Your applicatio program ca sed cotrol characters to the 6530 by sedig the code associated with that character. I coversatioal mode, the user ca geerate ASCII cotrol characters from the keyboard by pressig the Ctrl key followed by a alphaumeric key or by pressig special keys such as the backspace key. Escape Sequeces Cotrol codes are exteded by escape sequeces to icrease termial fuctioality. A escape sequece cosists of a strig of ASCII characters, startig with the Esc (1BH) cotrol character ad followed by oe or more graphic characters that comprise the escape code ad ay additioal parameters. Whe the 6530 receives a recogized escape sequece, it performs the fuctio specified. Urecogized escape sequeces cause the 6530 to issue a commad error: the DEL symbol appears at the cursor positio. Your applicatio program ca sed escape sequeces to the 6530 by sedig the ASCII code for the Esc character (1BH) followed by the appropriate graphic character(s). I coversatioal mode, the user ca geerate escape sequeces from the keyboard by pressig the Esc key followed by oe or more alphaumeric keys. Appedix A lists the cotrol characters i the C0 ad Cl sets. Not all of these are recogized by the Appedix C summarizes all the recogized cotrol codes ad escape sequeces. The cotrol codes ad escape sequeces available deped o the mode of operatio selected. Chapters 2 ad 3 describe the codes ad sequeces available i coversatioal ad block mode. The 6530 also supports character sets ad keyboards for use i coutries other tha the U.S. The user or your applicatio ca set the laguage to be used with a cofiguratio parameter. The supported laguages are: ASCII (U.S. Eglish) Belgia Cyrillic Daish Eglish (UK) Frech (AZERTY ad QUERTY) Germa 6530 Programmer s Guide 1-9

27 Overview Italia (supported i 8-bit versios oly) Norwegia Portuguese Spaish Swedish/Fiish Swiss-Frech Swiss-Germa Whe a particular laguage is selected, certai ASCII characters i the graphic rage are replaced by characters used i that coutry. These are listed i Appedix B. Keyboard Operatio Whe a PC or workstatio is ruig PC6530, these keys perform 6530 fuctios: Alphaumeric keys geerate displayable (graphic) characters. Cursor/display cotrol keys move the cursor o the scree ad roll display memory (coversatioal mode). Fuctio keys trasmit messages to the host to ivoke applicatiodefied fuctios. Special-purpose keys perform a variety of termial fuctios, such as pritig the cotets of the scree. The keyboard operatios available deped o the mode of operatio selected. The type of workstatio or PC keyboard layout ca be selected by a cofiguratio parameter. Chapters 2 ad 3 describe the codes ad sequeces available for cofiguratio i coversatioal ad block modes. Cofiguratio Parameters Cofiguratio parameters allow users to select 6530 optios, such as cursor type, bell colum, ad scree image itesity. Cofiguratio parameters are also used for commuicatios lie settigs, such as baud rate ad parity. Iitially, the 6530 assumes default values for these parameters. The user ca chage these values by specifyig ew settigs i a 6530 iitializatio file. For more iformatio about the 6530 iitializatio file or about the 6530 cofiguratio utility, refer to the user s guide for the termial or termial emulator. Your applicatio program ca use escape sequeces to read the cofiguratio parameters curretly selected ad reset them, if ecessary Programmer s Guide

28 Overview Device Cotrol The 6530 provides access to operatig system devices or fileames, such as priters or disk files. Supported features iclude: Scree pritig Allows the user or your applicatio to prit the cotets of the display scree or the selected page. Pass-through pritig Allows your applicatio to prit ay type of data. Write ad write/read operatios Allows your applicatio to perform I/O operatios o ay operatig system fileame or device. Exec fuctio (coversatioal ad block modes oly) Eables your applicatio to start executio of PC operatig system programs. See Device Cotrol o page 2-41 ad o page 3-77 for specific iformatio regardig your applicatio s implemetatio of escape sequeces for 6530 device cotrol fuctios i coversatioal ad block modes. Host Commuicatios The 6530 supports a variety of commuicatios cofiguratios with the host system. O a NoStop host system, the 6530 ca be coected as show i the followig tables: Table 1-2. Termial Coectios Termial Host Descriptio ASYNC TP To the host system patch pael, through direct coectio (via RS-232 or 20mA curret loop) or remote coectio (via RS-232 asychroous modems). I this cofiguratio, the 6530 commuicates with TERMPROCESS software o the host. ASYNC ATP To a 6100 Commuicatios Subsystem (CSS), via direct coectio (RS-232 or 20mA curret loop) or remote coectio (via RS-232 asychroous modems). I this cofiguratio, the 6530 commuicates with ATP6100 software o the host. ASYNC SNAX/6600 Via a Model 6600 Itelliget Cluster Cotroller, via RS-232 or 20mA curret loop coectio. I this cofiguratio, the 6530 commuicates with SNAX or SNAX6600 software o the host. ASYNC X25/PAD Via a X.25 etwork (by meas of a X.3 PAD). I this cofiguratio, the 6530 commuicates with X25AM software o the host Programmer s Guide 1-11

29 Overview Table 1-3. Emulator Coectios Emulator Host Descriptio Emulator o Multila Emulator with Telet cliet ad TCP/IP Emulator with Telet cliet ad SPX/IPX Multila/ WS6530 Telet server, TCP/IP Telet Server, SPX/IPX Emulator to Multila lik to host system with Multila/WS6530. Emulator with Telet cliet ad TCP/IP lik to host system with TCP/IP ad Telet server. Emulator o system with TC/SPX/IPS to host system with Telet Server ad SPX/IPX. TERMPROCESS, ATP6100, SNAX, SNAX6600, X25AM, ad WS6530 are I/O processes or access methods that maage ad cotrol the commuicatios lik. The I/O processes hadle data blockig ad establish the commuicatios protocols required. For the most part, the commuicatios iterface is trasparet to your applicatio. 1. The 6530 respods with either a ACK or NAK cotrol character depedig o whether the LRC is good or bad. If the request is to eter the same mode that the termial is already i, the ACK or NAK is still set, but o other actio occurs. 2. O a NAK, the host retrasmits the mode-switch message. 3. O a ACK, the mode switch completes with the 6530 ready to receive data from the host Iitializatio Sequeces The 6530 starts operatio i the mode selected by the mode cofiguratio parameter. Usually, this should be set to coversatioal mode whe the workstatio or PC is coected to a NoStop host. Whe the mode cofiguratio parameter is set to coversatioal mode, the 6530 trasmits two cotrol characters, ENQ (05H) ad CR (0DH), to the host to idicate that the 6530 has bee started. The user ca the log o to the host ad access applicatio programs. O a NoStop host system, your applicatio program ca switch modes by issuig a SETMODE 8 file system procedure call. The I/O process hadles the protocol required to esure a smooth trasitio betwee modes. The mode-switchig protocol is as follows: Programmer s Guide

30 Overview The host seds the termial a mode switch message of the form: where: SOH mode ETX LRC SOH, ETX, ad LRC are commuicatios cotrol characters. SOH acts as a start of header for the message. ETX idicates the ed of text for the message. LRC is a logitudial redudacy check character used to detect errors i the trasmissio. mode is either C for coversatioal or B for block, to specify the ew mode of operatio. Whe the 6530 chages modes, it performs oe of the followig iitializatio sequeces: Switch from coversatioal to block mode Locks the keyboard. Sets the submode to oprotect. Sets the maximum umber of pages to the default or the last settig of the set max page umber (Esc p) escape sequece. See Set Max Page Number (Esc p) o page Clears all pages to spaces except page 1, which retais the text that was displayed o the scree i coversatioal mode. Sets the display page ad the select page to page 1. Sets the cursor address ad buffer address for all pages to row 1, colum 1 (home positio). Clears all horizotal tab stops. Eables local lie editig. Sets isert mode to off. Sets the video prior coditio register to ormal video. Sets the data type table to its default values. (See Appedix D.) Clears the message area i the message/status lie ad displays BLOCK i the status area Programmer s Guide 1-13

31 Overview Switch from block to coversatioal mode Blak fills all lies i display memory. Sets the cursor address to row1, colum 1, ad displays the first 24 lies of memory o the scree. Clears all horizotal tab stops. Sets the video prior coditio register to ormal video. Clears the message area i the message/status lie ad displays CONV i the status area. Ulocks the keyboard. Termial Reset A PC6530 user ca perform a reset from the keyboard. The 6530 supports three types of reset, allowig differet levels of recovery from errors. Soft Reset A soft reset is typically used to ulock the keyboard whe it becomes accidetally locked by the applicatio. The soft reset fuctio performs the followig fuctios: Souds the bell. Ulocks the keyboard (uless page 0 is displayed). Termiates ay escape sequece i progress. Flushes the Aux1 prit buffer. Resets the SI/SO state (that is shifts ito the G0 character set). Erases ay error message i the error lie ad restores the message/ status lie. Turs off character isert mode. The soft reset fuctio restarts the 6530 from its curret state ad does ot alter or erase ay part of display memory. The user ca ivoke a soft reset with the Ctrl-Backspace keys. Program Reset A program reset ca be used to abort a host applicatio program. The program reset clears display memory ad restarts the The user ca ivoke a program reset with the Alt-Backspace keys Programmer s Guide

32 Overview System Reset A system reset clears all workstatio or PC memory ad reloads the operatig system. It is equivalet to cyclig power off ad o, except that the power-o self test is ot performed. After a system reset, the user must restart the The user ca ivoke a system reset with the Ctrl-Alt-Del keys. Applicatio Programmig Iterface The way i which your applicatio program iteracts with the 6530 depeds o the host operatig system. O a NoStop host, your applicatio program iteracts with the 6530 through procedure calls to the Tadem NoStop Kerel file system. These procedure calls request various I/O operatios, such as: CONTROL Executes device-depedet operatios o a ope device. Used for forms cotrol ad modem coect/discoect. SETMODE Sets or clears device-depedet fuctios for the workstatio or PC, such as switchig to block or coversatioal mode. WRITE Seds data to the 6530 (displayable data, cotrol codes, ad escape sequeces). READ Gets data from the WRITEREAD Seds data to the 6530 ad waits for a respose. Useful for promptig the user for iformatio i coversatioal mode ad for sedig cotrol codes ad escape sequeces that iitiate reads from the 6530, such as read cursor address. These are geeric procedure calls that ca be used regardless of the actual commuicatios cofiguratio. The file system accesses the appropriate I/ O process to hadle the trasfer of data over the commuicatios lie. Chapter 4 provides more iformatio o the Tadem NoStop Kerel programmig iterface ad gives a example applicatio Programmer s Guide 1-15

33 Overview Cofiguratio Parameters This sectio provides descriptios of 6530 cofiguratio parameters that ca be programmed by the host. The 6530 has a umber of cofiguratio parameters, which select optios ad set up the lie for commuicatios with the host system. The user ca set the 6530 parameters o the MS-DOS commad lie or by usig the 6530 iitializatio file. Through escape sequeces, your applicatio ca read curret cofiguratio parameters. If ecessary, your applicatio ca chage may of these parameters to esure proper operatio. The followig paragraphs describe the parameters that ca be set from your applicatio. Chapters 2 ad 3 describe the escape sequeces used to read ad set cofiguratio parameters i each of the operatig modes. The descriptio of escape sequeces icludes tables that list values allowed for each parameter. With PC6530, some parameters ca oly be set at the workstatio or PC (such as the exec fuctio ad the commad error respose). Your applicatio caot reset the values for these parameters, ad o values are retured for them o a read operatio. These parameters are explaied i the PC6530 user s guide. A few other parameters are maitaied for compatibility with the 6530 (such as key click volume). The 6530 returs values for them to your applicatio o read operatios, but they have o meaig for the workstatio or PC. Aux1 device ame Specifies a operatig system device or file ame to which scree data or data geerated by your applicatio ca be directed. Set with the Esc x T sequece. For coversatioal mode, see Set I/O Device Cofiguratio (Esc x) o page For block mode, see Set I/0 Device Cofiguratio (Esc x) o page Aux2 device ame Specifies a operatig system device or file ame to which data geerated by your applicatio ca be directed. Set with the Esc x T sequece. For coversatioal mode, see Set I/O Device Cofiguratio (Esc x) o page For block mode, see Set I/0 Device Cofiguratio (Esc x) o page Programmer s Guide

34 Overview baud rate Sets the speed of commuicatios whe the workstatio or PC is coected to the host over a asychroous lie. (The baud rate settig is igored o a Multila coectio.) The settig must match the host system ed. Values are: Set baud rate with the Esc v H sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page bell colum Specifies the colum o the display scree i which the bell will soud whe the cursor passes through it. It is typically used to alert the user whe the cursor is approachig the right margi. The value ca be set to colum A value of 0 disables the feature. Set with the Esc v B sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page bell volume Eables (ON) or disables (OFF) the bell. I additio to the bell colum feature, the bell is used by the 6530 or a host applicatio program to audibly idicate some coditio such as a error. Set with the Esc v C sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page character set ISO ISO 8859/1.2 compliat, with 8-bit extesios available. (This is a read-oly parameter.) character size Sets the umber of bits used to defie characters trasmitted betwee the workstatio/pc ad the host system. The settig must be the same at both the workstatio/pc ad the host. Set with the Esc v V0 sequece (7 bits) or the Esc v V1 sequece (8 bits). For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page Programmer s Guide 1-17

35 Overview compressio ehace Turs outboud data compressio o or off (for block mode oly). (See Outboud Compressio o page 3-72.) cursor type Determies how the cursor appears o the scree: a uderscore or a reverse video block. Set with the Esc v A sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page device ame Sets the ame for the commuicatios driver used. (This value is set by the user. For more iformatio, see the PC6530 or TS530 user s guide.) duplex Selects either half or full duplex commuicatios with the host whe coversatioal mode is used. Set with the Esc v J sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page EM3270 support For block mode oly, eables/disables support of certai IBM 3270 termial fuctios (such as uformatted mode, wraparoud fields, hadlig of ull/spaces, ad cursor positioig). See Set EM3270 Mode (Esc - m) o page host ame For Multila coectios, sets the ame of the host. (This value is set by the user. For more iformatio, see the PC6530 or TS530 user s guide.) Programmer s Guide

36 Overview keyboard Selects the type of keyboard, which i tur determies how certai keys are mapped. Eleve keyboard optios are available: Table 1-4. Keyboard Optios Parameter 6AX 6AXl01 654X PSX101 PSX102 PSX105 PSX106 INTL PCXT PCAT PCAT101 Associated Keyboard Tadem 6AX stadard keyboard Tadem 6AX ehaced 101-key keyboard Tadem 654X keyboards Tadem PSX stadard keyboard Tadem PSX 102-key keyboard Tadem PSX ehaced 105-key keyboard Tadem PSX ehaced 106-key keyboard Tadem Iteratioal keyboard for 6AX ad PSX IBM PC/XT keyboard IBM PC/AT keyboard IBM PC/AT ehaced 101-key keyboard Set with the Esc v X sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page Programmer s Guide 1-19

37 Overview laguage Defies which laguage character set is used for displayig the graphics characters. The supported laguages are: ASCII (U.S. Eglish) Belgia Cyrillic Daish Eglish (UK) Frech (AZERTY ad QUERTY) Germa Italia (supported i 8-bit versios oly) Norwegia Portuguese Spaish Swedish/Fiish Swiss-Frech Swiss-Germa Set with the Esc v F sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page local trasmit colum Used for local actio (Alt-Eter keys) i coversatioal mode. It specifies the begiig colum for a lie that is to be retrasmitted to the host. For example, the user ca use local actio to retrasmit a log commad strig already etered. Oly the characters betwee the colum specified by this parameter ad the colum precedig the curret cursor positio are trasmitted. Set with the Esc v U sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page ormal itesity Sets the ormal scree itesity for the It ca be set to high or low. Set with the Esc v T sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page Programmer s Guide

38 Overview packet blockig Specifies the block size used with the X25AM access method whe the workstatio or PC is coected to a X.25 commuicatios lie. The settig must match the PAGE6520BLKSIZE modifier set for the X25AM access method. Values are: 256 or ON or OFF Set with the Esc v L sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page parity Sets the type of parity used whe the workstatio or PC is coected to the host over a asychroous lie. (The parity settig is igored o a Multila coectio.) The settig must match the host system ed. The choices are eve, odd, or oe. Set with the Esc v I sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page PFKey support Whe eabled, the device returs the PF fuctio key sequece plus all modified fields i a sigle trasmissio i respose to a read operatio by a Tadem host applicatio. For block mode oly. See PFKey Support o page Power O mode Defies the mode whe the 6530 is first started. (This value is set by the user. For more iformatio, see the PC6530 or TS530 user s guide.) prit form feed Selects whe form feeds are issued to the priter (Aux1 device) durig prit scree operatios. The choices are: after a scree is prited (trailig), before a scree is prited (begiig), or o automatic form feed (oe). Set by the Esc x T2 sequece. For coversatioal mode, see Set I/O Device Cofiguratio (Esc x) o page For block mode, see Set I/0 Device Cofiguratio (Esc x) o page Programmer s Guide 1-21

39 Overview prit lie termiator Selects the fuctio that termiates a lie o the priter (Auxl device) durig prit scree operatios. The choices are: carriage retur (CR), lie feed (LF), ad carriage retur plus lie feed (CR_LF). Set by the Esc x T2 sequece. For coversatioal mode, see Set I/O Device Cofiguratio (Esc x) o page For block mode, see Set I/0 Device Cofiguratio (Esc x) o page resource ame O Multila coectios, specifies the ame of the host system process to be started whe establishig a dyamic lik. This parameter is set by the user. For more iformatio, see the PC6530 or TS530 user s guide, or the Multila documetatio. Retur fuctio key Defies whether the Retur key is regarded as a additioal fuctio key i block mode. Set by the Esc v M sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page RTM support Allows implemetatio of Respose Time Measuremet fuctios (eabled automatically i block mode) that provide collectio of iformatio based o termial-to-host respose times. Cofigurable as a measuremet of the iterval of time betwee the press of a F-key at the termial ad the first character received i respose from the host, or betwee the press of a F-key at the termial ad the receipt of the keyboard ulock commad from the host. The 6530 allows cofiguratio of RTM data collectio parameters from 0 cetisecods to ifiity. RTM support also icludes a Defiite Respose facility based o the measuremet of the iterval of time betwee a host request ad a expected 6530 respose. Set by the Esc v j sequece. For coversatioal mode, see Set Termial Cofiguratio (Esc v) o page For block mode, see Set Termial Cofiguratio (Esc v) o page save cofiguratio Saves cofiguratio parameters ad values i o-volatile memory. For the TS530 oly. scree format This read-oly parameter idicates whether ormal addressig or extedig addressig is used. Normal addressig allows access to all positios curretly available o the scree (25 lies x 80 colums). Exteded addressig capability is provided for access to possible future ehacemets i scree formats, such as more rows or colums. For more iformatio, see Cursor Locatio o page Programmer s Guide