X/NETBRIDGE

 

User Manual

 

 


 


                                                                            Table of contents

 

1.          Running X/Netbridge......................................................................................................................................................................   3

1.1.        Introduction.....................................................................................................................................................................................   3

1.2.        Start of X/Netbridge.......................................................................................................................................................................   3

1.3.        Exit from X/Netbridge.....................................................................................................................................................................   3

1.4.        TAMOS user environment............................................................................................................................................................   3

1.5.        Standard keyboard layout.............................................................................................................................................................   4

1.6.        SCOPE commands..........................................................................................................................................................................   4

1.7.        BASIC commands...........................................................................................................................................................................   5

1.7.1.      Editor commands...........................................................................................................................................................................   5

1.7.2.      BASIC commands..........................................................................................................................................................................   5

1.7.3.      BASIC functions............................................................................................................................................................................   5

1.7.4.      Screen functions............................................................................................................................................................................   5

1.7.5.      CALL routines (Documented).....................................................................................................................................................   5

1.7.6.      SPC functions.................................................................................................................................................................................   5

1.8.        Troubleshooting.............................................................................................................................................................................   6

 

2.          Installation........................................................................................................................................................................................   7

2.2.        The X/Netbridge DONGLE............................................................................................................................................................   7

2.3.        Configuration of MS-DOS.............................................................................................................................................................   7

2.4.        Installing the X/Netbridge software............................................................................................................................................   7

2.5.        Configuration of LU's.....................................................................................................................................................................   7

2.6.        XN_PAR parameter configuration...............................................................................................................................................   8

2.6.1.      Standard parameters......................................................................................................................................................................   8

2.6.1.1.    Display current parameters.........................................................................................................................................................   8

2.6.1.2.    Display type..................................................................................................................................................................................   9

2.6.1.3.    Connected printer.........................................................................................................................................................................   9

2.6.1.4.    Special print char..........................................................................................................................................................................   9

2.6.1.5.    Colourcodes..................................................................................................................................................................................   9

2.6.2.      Amend printer driver...................................................................................................................................................................   10

2.6.2.1.    Change printerdriver..................................................................................................................................................................   10

2.6.2.2.    Create new printerdriver............................................................................................................................................................   11

2.6.2.3.    Delete printer...............................................................................................................................................................................   11

2.6.2.4.    Export printer...............................................................................................................................................................................   11

2.6.3.      Amend keyboard layout.............................................................................................................................................................   12

2.6.3.1.    Amend function key...................................................................................................................................................................   12

2.6.3.2.    Delete function key....................................................................................................................................................................   12

2.6.3.3.    Set to standard............................................................................................................................................................................   12

2.6.4.      Amend codetables.......................................................................................................................................................................   13

2.7.        Starting X/Netbridge....................................................................................................................................................................   14

2.7.1.      Error codes returned from XN_STRT.......................................................................................................................................   14

2.7.2.      Direct start of a basic program from DOS................................................................................................................................   14

2.8.        Exit from X/Netbridge...................................................................................................................................................................   14

2.9.        The INDEX file and DOS file structure......................................................................................................................................   15

2.9.1.      Sizing the INDEX file with SZ_INDEX.EXE............................................................................................................................   15

2.9.2.      Errors in the INDEX file after system breakdown...................................................................................................................   15

2.9.2.1.    Testing the consistency of INDEX (PRUEF_IF.EXE)...........................................................................................................   15

2.9.2.2.    Recovering from errors in the INDEX file...............................................................................................................................   15

2.10.       DOS files included in X/Netbridge............................................................................................................................................   16

2.11.       BASIC files included in X/Netbridge........................................................................................................................................   17

2.12.       Installation in NET.......................................................................................................................................................................   17

 

3.          Basic extensions in X/Netbridge.................................................................................................................................................   18

3.1.        ALOAD and ADUMP basic file dump to DOS........................................................................................................................   18

3.2.        LIBR % filelist with DOS names.................................................................................................................................................   18

3.3.        Basic program size........................................................................................................................................................................   18

3.4.        CALL 201 DOS file interchange..................................................................................................................................................   18

3.5.        CALL 202 Test/set XNET parameters.......................................................................................................................................   19

3.6.        CALL 203 Physical printer/port connection.............................................................................................................................   19

3.7.        CALL 204 Exit to DOS..................................................................................................................................................................   19

 

4.          Migration to X/Netbridge.............................................................................................................................................................   20

4.1.        Migration using a LIBR list.........................................................................................................................................................   20

4.1.1.      Sample migration using a libr list...............................................................................................................................................   20

4.1.1.1.    Filenames in CHXNET.xxx.........................................................................................................................................................   21

4.2.        Conversion of single files from DOS.........................................................................................................................................   21

4.2.1.      TEXTTRAN..................................................................................................................................................................................   21

4.2.2.      CHXNET.XCO..............................................................................................................................................................................   21

4.2.2.1.    Transferring more files in one run of CHXNET.XCO............................................................................................................   22

4.2.2.2.    Exit to START or DOS after CHXNET.XCO...........................................................................................................................   22

4.3.        Making batch jobs for ERNA.....................................................................................................................................................   22

4.4.        Installing RAPGEN / DATAMASTER / IQ on X/Netbridge..................................................................................................   22

 

5.          Other X/Netbridge utility functions............................................................................................................................................   23

5.1.        Making a DMAP file (diskmap)..................................................................................................................................................   23

5.2.        Transporting a complete LU to another X/Netbridge system...............................................................................................   23

5.3.        Recovering using the DMAP file...............................................................................................................................................   23

5.4.        CHA.EXE Code conversion / program compression on DOS...............................................................................................   23

 

Figures..........................................................................................................................................................................................................   24

 

Keyword index............................................................................................................................................................................................   25

 


1.          Running X/Netbridge.

 

2.1.        Introduction.

  

   X/Netbridge enables you to run Nixdorf 8870/Quattro Business-Basic applications on any PC-AT under DOS.

 

   X/Netbridge Basic-interpreter and the Basic-editor works just like 8870. Also the most important SCOPE commands are included together with the TAMOS user environment.

 

   In multiuser-environment under NOVELL-network more users are able to access the same resources as files and printers.

 

   X/Netbridge requires no hardware extension.

 

2.3.        Start of X/Netbridge.

 

   You start X/Netbridge from DOS by:

 

                                      cd xnet

                                      start.bat

 

   The startscreen will be displayed and after a short while or when you press escape you can enter ACCOUNT ID.

(MANAGER or TEAM).

 

2.5.        Exit from X/Netbridge.

 

   You may leave X/Netbridge by entering DOS or END as ACCOUNT ID or by pressing ALT+A when you are at SCOPE.

 

   NOTE: DO NOT just switch off the PC during an X/Netbridge session.

                    This may destroy the file INDEX and you may have to recover from you last backup.

 

2.7.        TAMOS user environment.

 

   The TAMOS selector functionality is just like on 8870. You will go to SCOPE or TAMOS dependent of the ACCOUNT ID you enter (TEAM or MANAGER).

 

   A system information screen will be displayed when you login:

 

 

Figure 1 Start screen.

 

X / N E T B R I D G E                                             92.12.14

 

 

 PU   LU    ARCHIVE               FREE BLOCKS    % FULL     M-SYSTEM:   0

 

  0    0    Configurated LU            37744      83,83 %

  0    1    Configurated LU       same DOS-Partition

  0    2    Configurated LU       same DOS-Partition

  0    3    Configurated LU       same DOS-Partition

  0    4    Configurated LU       same DOS-Partition

  0    5    Configurated LU       same DOS-Partition

  0    6    Configurated LU       same DOS-Partition

  0    7    Configurated LU       same DOS-Partition

  0    8    Configurated LU       same DOS-Partition

  0    9    Configurated LU       same DOS-Partition

 

 SIZE OF LOGFILE:  725  BYTES

 

 FREE BASIC-MEMORY:  85016  WORDS

 

 

 

TYPE CR (OR BYE TO LOG-OFF)                       ........

 

MESSAGE :

 

 

 

 

   The logfile is an normal ASCII file XN_LOGF.001 on the XNET directory and may be edited from DOS.

 

   The disk configuration/directories is contained in XN_CONF.001 also as plain ASCII text.

 

   When you press ENTER you will get the first TAMOS selector level:

 

 

Figure 2 TAMOS selector level 1.

 

X / N E T B R I D G E                         SYSTEM MAINTENANCE  92.12.14

 

 

 

                   S Y S T E M   S E L E C T O R

 

                    1...SELECTOR MAINTENANCE

                    2...PRINTER ASSIGNMENT

                    3...DAILY PROCEDURES

                    4...--------------------

                    5...MIGRATION TOOLS

 

                   SELECT NO (OR CR)          ........

 

 

 

 

 

 

 

 

 

 

 

MESSAGE :

 

 

 

 

   From the selector you may exit to SCOPE using # or to ACCOUNT ID using BYE.

 

2.9.        Standard keyboard layout.

 

   As standard you may use the following keys on the PC:

 

                                      F1-F10       Cr.01-10

                   ALT          F1-F7         Cr.11-17

                   CTRL        F1-F9         Softkey 1-9

 

                   ALT          1-4              Lamp keys 1-4 ON/OFF

                   ALT          A                Exit from scope to DOS

                   ALT          L                 Display of status line ON/OFF

                   CTRL        E                 Switch input echo off

                   CTRL        T                Switch on typewriter keyboard

                   CTR+SH   T                Switch off typewriter keyboard

                   CTRL        Y                Followed by ESC ==> break basic program

 

                                      INS            Insert character

                                      DEL           Delete character

                                      HOME       Clear field

                                      PGUP         Y

                                      PGDN        N

                                      END           Cr.13

 

2.11.        SCOPE commands.

 

   The following SCOPE commands are available:

 

                   BASIC  filename          Call the basic-interpreter

                   RUN    filename                      Execute basic program

                   CHANGE source,dest       Change filename

                   COPY   dest=source       Copy file

                   KILL   filename                      Delete file

                   LIBR   options           Libr list of files

                   QUERY  filename                      File information

                   BYE                      Exit to account id.

 

 

2.13.        BASIC commands.

 

   X/Netbridge BASIC is a full emulation of NIXDORF 8870/Quattro BASIC interpreter, it is the full syntax from the BASIC manual may be used.

 

   Hardware specific functions as tape drivers and direct disc read are not implemented due to technical reasons.

 

   Backup procedures, teleprocessing programs and other maintenance programs should be run from DOS and is not included in X/Netbridge. The following tables gives a overview of implemented commands:

 

2.14.1.      Editor commands.

 

                   CREF                            DEBUG                        DELETE                       DUMP

                   EDIT                            HELP                            LIST                             LOAD

                   NEW                            RENUMBER               RUN                             SAVE

                   SIZE                             TRACE

 

 

 

2.14.3.      BASIC commands.

 

                   BUILD #                      CALL                           CHAIN                        CLEAR

                   CLOSE #   DATA                          DEALLO   DEF

                   DIM                             END                              FOR                              GLOBAL

                   GOSUB                        GOTO                           IF                                  IF ERR 0

                   IF ESC                          INPUT                          IOM                             KILL

                   LET                              LGERR                         LINK                            MAT

                   NEXT                           ON                                OPEN #                        PRINT

                   PRINT #                      RANDOM                   READ                          READ #

                   REM                             RESTOR                      RETURN  SEARCH #

                   SIGNAL                       STOP                            WRITE #

 

2.14.5.      BASIC functions.

 

                   ABS                             CHN                             CHF                              CHR

                   CKY                             FLN                              FRA                             INT

                   IXR                               KEY                              LEN                              LKY

                   MAN                           NOT                             PRN                              RND

                   SPC

 

2.14.7.      Screen functions.

 

                   'BEL'                             'BS'                                'BP'                               'CF'

                   'CFF'                             'CH'                               'CP'                               'CR'

                   'CS'                               'DS'                               'DF'                               'DLC'

                   'DM'                             'DRK'                            'DW'                             'LD'

                   'LI'                                 'MP'                              'NTY'                            'SB'

                   'SF'                                'TB'                               'TY'                               'X'

                   USING                         TAB

 

2.14.9.      CALL routines (Documented).

 

       1   2   3   4   6   7   9  20  21  22  23  24  25

      26  28  29  31  32  51  59  60  61  62  63  64  65

      66  72  73  74  80  84  90  91  93  96  97  98  99

 

2.14.11.      SPC functions.

 

       0*  1*  2   3   4   5   6   8   9  10  12* 14  15  20  22

 

                   *Returns always 0.

 

2.15.        Troubleshooting.

 

   To avoid the most common problems you should:

 

                   a. NEVER switch off or reboot the PC without leaving X/Netbridge probably.

                   b. Always be sure you have got enough free discspace to run.

                   c. Make frequently copies of the X/Netbridge directories.

 

   If X/Netbridge does not start first check that your DONGLE is present and correct mounted at the parallel printer port. If you have a printer attached through the dongle it may be necessary to switch this on and have it online when using X/Netbridge.

 

   If you have switched off the PC without leaving X/Netbridge the file index may be destroyed. You may try to start X/Netbridge using START RESET to rebuild this but it may be necessary to restore a copy of the system.


3.          Installation.

 

4.1.        Hardware requirements.

 

   X/Netbridge can be installed on any PC-AT using MS-DOS 3.3 or newer.

 

   At least 640 KB memory is required, as X/Netbridge supports XMS-memory we will recommend at least 2 MB RAM to get the best performance.

 

   The disc space required is of course dependent of the ported applications, X/Netbridge itself requires only approximately 1.5 MB. Note that the system is extremely compressible, if you use programs like STACKER a compression factor of 4 will not be unusual.

 

   Any standard graphics card may be used, however only with a VGA card you may have additional 2 lines on screen for softkeys and statusline.

 

4.2.        The X/Netbridge DONGLE.

 

   The X/Netbridge system is copy protected with a dongle, which must be present at the parallel port (LPT1).

 

   To install the dongle switch off the PC, remove the printer cable if present, and insert the dongle at the port. You may connect the printer through the dongle.

 

   NOTE: If a printer is connected it may be necessary to have this switched on when running X/Netbridge

              in order to activate the dongle.

 

4.4.        Configuration of MS-DOS.

 

   X/Netbridge requires no additional drivers installed. If you have XMS memory HIMEM.SYS must be installed, and we recommend the use of SMARTDRV or other disc cashing software. Do not use FASTOPEN as this program is old.

 

   As some basic programs may use more than 30 files open you should place

 

                   FILES=50                     in CONFIG.SYS

 

4.6.        Installing the X/Netbridge software.

 

   To install X/Netbridge just make a directory on one of your harddisks and copy the programs from the enclosed diskette this.

                   A:INSTALL A: C:                         will do the following job:

  

                   md XNET

                   cd XNET

                   xcopy A:*.* C:\XNET\ /S /E

                   start                                                                    will start X/Netbridge

 

4.8.        Configuration of LU's.

 

   The file XN_CONF.001 is a small textfile which may be edited with any editor (EDIT or EDLIN) and contains the connection between a BASIC LU number (00-99) and a DOS directory. The file may look like:

 

                   LU00:./lu0

                   LU01:d:/xnet/lu1

                   LU02:e:/xnet/lu2

 

   You may add new LU's or change existing using the editor.

 

   NOTE: Before the new table becomes active in X/Netbridge the file XN_MESS.001 must be deleted. This will be rebuilded when you restart X/Netbridge. Unfortunately this file contains the TAMOS printer assignments for the system so these must be set up again.

 

   You may use START LU to start EDIT and delete XN_MESS.001 in one go.

 

4.10.        XN_PAR parameter configuration.

 

   The program XN_PAR.EXE can be selected from DOS and is used to set up colors, printers etc. You may also call START PAR to call this program.

 

   The program is menu driven and you use the cursor keys to point to a topic, press enter to select and ESC to return to the main menu or dos. The main menu looks as:

 

 

Figure 3 XN_PAR main menu.

 

Amendment of the parameterfile for X / N E T B R I D G E                    

 

 

 

 

                    

                               MAIN MENU          

                    

                     Amend standard parameters   

                        Amend printer drivers     

                        Amend keyboard layout     

                         Amend codetables         

                          Print all parameters    

                    

 

 

 

 

 

  - Select                  <ENTER> - Amend                    <ESC> - Back

 

 

 

   When you press ESC to exit you can select with/without update:

 

Figure 4 Exit with/without update from XN_PAR

 

                    

                               MAIN MENU          

                    

                     Amend standard parameters   

                        Amend printer drivers     

                        Amend keyboard layout     

                         Amend codetables         

                      

                                EXIT          

                       

                        Exit WITH    update     

                        Exit WITHOUT update     

                        

 

 

 

4.11.1.      Standard parameters.

 

   When you select standard parameters you will get the following menu:

 

Figure 5 Amendmend of standard parameters.

 

                                  

                     AMEND STANDARD PARAMETERS   

                               MAI

                       Display current params.    

                     Amend standa      Display type           

                        Amend prin   Connected printer         

                        Amend keyb      Special print char     

                         Amend cod         Colourcodes          

                          Print al

                    

 

 

4.11.2.1.    Display current parameters.

 

Figure 6 Display of current parameter settings.

 

 

  1.) Display type              = Text 25x80 (HGC/EGA/VGA)                  

  2.) Connected printer         = Canon LBP-II4                             

  3.) Special print char        = @ (Hexadecimal : 40)                      

  4.) Background                = Blue                                       

  5.) Forground                 = Red                                       

  6.) Status window             = Coboltblue                                

 

 


4.11.2.3.    Display type.

 

   Here you can change the display type and no.of lines on screen. To get a permanent statusline and function key display for the IOM select 28 lines.

 

Figure 7 Selecting display type.

 

Text 25x80 (HGC/EGA/VGA) Text 43x80 (EGA)         Text 50x80 (VGA)          

Text 28x80 (VGA)                                                             

 

 

 

4.11.2.5.    Connected printer.

 

   Here you can select the printer type. Even if your printer is not listed one of the emulations may fit for it (refer to your printer manual). In the menu Amend printer drivers you may copy/define new printers if needed.

 

 

Figure 8 Selecting printer type.

 

Epson LQ-550        IBM Proprinter      HP-Laserjet II      Canon           

Canon LBP-II8       Canon LBP-II4       NEC                 NEC P70         

NEC P9-XL           OKI 400/800         Epson                               

 

 

4.11.2.7.    Special print char.

 

   The special print character is as default @. When the printer receives this character + next character these are translated to printer codes according to the definitions done in Amend printer drivers. Using this function can ease your use of special printer functions.

 

Figure 9 Special print character.

 

Please enter the print special char :                                       

 

 

 

4.11.2.9.    Colourcodes.

 

   With this function you may change the screen colors.

 

Figure 10 Amending colours for forground/background/statuswindow.

 

                                  

                     AMEND STANDARD PARAMETERS   

                 I

                   COLOURCODES    Display current params.    

                 a      Display type           

                   Background   n   Connected printer         

                   Forground    b      Special print char     

                 Status window d         Colourcodes         

                 l

                    

 

 

 

 

Figure 11 Selecting a colour.

 

                 

              COLOUR ATTRIB AMEND STANDARD PARAMETERS   

              I

                  Black          Display current params.    

                   Blue      a      Display type           

                   Gren        n   Connected printer         

                Coboltblue     b      Special print char     

                    Red      w d         Colourcodes         

                  Violet     l

                  Orange    

                 bri.gray   

             

 


4.11.3.      Amend printer driver.

 

   This function enables you to amend / define new printers.

 

 

Figure 12 Menu for amending printer drivers.

 

                                  

                     AMEND PRINTER DRIVER    

                               MAI

                        Change printerdriver  

                     Amend standa Create new printerdriver

                        Amend prin     Delete printer      

                        Amend keyb   Export printer        

                         Amend cod

                          Print all parameters    

                    

 

 

   After selecting one of the functions you should select a printer:

 

Figure 13 Selecting printer type.

 

Epson LQ-550        IBM Proprinter      HP-Laserjet II      Canon           

Canon LBP-II8       Canon LBP-II4       NEC                 NEC P70         

NEC P9-XL           OKI 400/800         Epson                               

 

 

 

4.11.4.1.    Change printerdriver.

 

   With this function you may change all controlcodes for the given printer. Max. 22 characters can be entered for each control code.

 

Figure 14 Amending the print control characters.

 

         

            No.of half LFs/MCL   

          Initialise string      MEND PRINTER DRIVER    

              Wide print ON      

              Wide print OFF      Change printerdriver  

          10,0 CPI chars/inch    reate new printerdriver

          12,0 CPI chars/inch       Delete printer      

          15,0 CPI chars/inch    Export printer        

          16,6 CPI chars/inch   

               3 LPI Forwards     arameters    

               4 LPI Forwards    

         

 

Being changed  (hexadecimal) : Wide print ON                                

     1B 57 31 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ..       

<DEL> <INS> - Amend                                          <ESC> - Back

 

 

   You must enter the printer codes in hexadecimal form. The cursor down/up may be used to select the next/previous control code during input of the hexadecimal values.

 

   The INITIALIZE STRING will be printed whenever the printer is opened.

 

   If you select one of the specialstrings you get the question:

 

Figure 15 Defining a special print string.

 

Please enter character for the special string :        

 

 

and you enter eg. X if the print of @X should be replaced with the given hexadecimal string.

 

   When you exit the function using ESC you can decide if this printer should be activated:

 

Figure 16 Activating the new printer definition.

 

          

           Activate new printer definition in X/NETBRIDGE (J/N) ? 

          

 

 

 

 

4.11.4.3.    Create new printerdriver.

 

   With this function you may copy another printer definition and then amend the copy or you may define a new printer all from scratch. The input of control characters works just as described above.

 

Figure 17 Copying / defining a new printer.

 

          

           Copy printer definition from another printer (J/N) ?   

          

 

Printername  :                                                              

 

 

 

4.11.4.5.    Delete printer.

 

   Here you a able to delete a printer definition, you have to confirm this:

 

Figure 18 Deleting a printer definition.

 

               

                Epson LQ-550        : Confirm deletion (J/N) ?

               

 

 

 

4.11.4.7.    Export printer.

 

   With this function you can extract a printer definition from XN_PARA.001 file where all printer definitions are stored to a separate DOS file, eg. EPSON.PRT. However you will not (yet) be able to use this file for anything.

 

Figure 19 Exporting a printer definition.

 

Printer driver name (.PRT) :                                                

 


4.11.5.      Amend keyboard layout.

 

   Here you are able to place softkeys / enterkeys / lampkeys on any ALT or Fxx function key on the keyboard.

 

 

Figure 20 Menu for amending keyboard layout.

 

                                  

                     AMEND KEYBOARD LAYOUT  

                               MAI

                       Amend function keys   

                     Amend standa Delete function keys   

                        Amend prin    Set to standard     

                        Amend keyb

                         Amend codetables         

                          Print all parameters    

                    

 

 

 

4.11.6.1.    Amend function key.

 

   When you select amendment of function keys you get a list of possibly keys and can select from here using the cursor down/up and the enter key. When you selected a function you should simply press the key / key combination you want to associate with this function.

 

   If you press SCROLLLOCK (or ROLL) the program will automatically jump to the next function after you have entered a keycombination.

 

Figure 21 Amending the keyboard layout.

 

         

                 Delete char.         

                Insert char.           KEYBOARD LAYOUT  

             Delete field (CLEAR)     

                      N-CR             function keys   

                      Y-CR             function keys   

             Change window   1 <> 2    to standard     

          Display statusline ON/OFF  

                   I(S)-Key                    

            ?-Key (HELP processor)     ters    

                   HOME-key           

         

 

Please press the desired key for :              Delete field (CLEAR)        

 

 

   You can connect more keys to one functions as eg. CR13 and END to the ENTERKEY13 function.

 

   It is not all functions which are active in X/Netbridge (yet), eg. the WINDOW 1/2 and the HELP processor is not implemented.

 

4.11.6.3.    Delete function key.

 

   Here you can release a function key for other use.

 

Figure 22 Deletion of function keys.

 

       

        Please enter the key or key-combination here:          

       

 

 

 

4.11.6.5.    Set to standard.

 

   If you select this function the keyboard layout will be completely reset.

 

Figure 23 Resetting all function keys to standard.

 

                         

                          Are You sure (J/N) ?     

                         

 


4.11.7.      Amend codetables.

 

   Here you can modify any codetable for printer, screen, keyboard and transfer between DOS and X/Netbridge.

 

 

Figure 24 Amending codetables.

 

                                  

                          AMEND CODE TABLES        

                               MAI

                           Printer outputtable     

                     Amend standa   Display output table       

                        Amend prin ASCII conversion --> PC      

                        Amend keyb ASCII conversion PC -->      

                         Amend cod      EDP keyboard table      

                          Print al      Typewriter keyb.        

                    

 

 

 

   When you select one of the codetables you get a screen like:

 

 

Figure 25 A printer output codetable.

 

 

          0   1   2   3   4   5   6   7   8   9   A   B   C   D   E   F    

      0  00  01  02  03  04  05  06  07  08  09  0A  0B  0C  0D  0E  0F    

      1  10  11  12  13  14  15  16  17  18  19  1A  1B  1C  1D  1E  15    

      2  20  21  22  23  24  25  26  27  28  29  2A  2B  2C  2D  2E  2F    

      3  30  31  32  33  34  35  36  37  38  39  3A  3B  3C  3D  3E  3F    

      4  40  41  42  43  44  45  46  47  48  49  4A  4B  4C  4D  4E  4F    

      5  50  51  52  53  54  55  56  57  58  59  5A  5B  5C  5D  5E  5F    

      6  E1  61  62  63  64  65  66  67  68  69  6A  6B  6C  6D  6E  6F    

      7  70  71  72  73  74  75  76  77  78  79  7A  7B  7C  7D  20  20    

      8  20  20  20  20  20  20  20  20  20  20  20  20  20  20  20  20    

      9  20  20  20  20  20  20  20  20  20  20  20  1B  20  20  20  20    

      A  20  20  20  20  20  20  20  20  20  20  20  20  20  20  20  20    

      B  20  20  20  20  20  20  20  20  20  20  20  20  20  20  20  20    

      C  20  20  20  20  20  20  20  20  20  20  20  20  20  20  20  20    

      D  20  20  20  20  20  20  20  20  20  20  20  20  20  20  20  20    

      E  FC  FD  E6  20  20  AC  AB  20  20  20  20  20  20  20  20  20    

      F  C4  B3  C0  D9  BF  DA  C3  C1  B4  C2  C5  20  20  20  20  20    

                                                    

  Printer outputtable

                            

  <HOME> <END> - Select                                        <ESC> - Back

 

 

 

   You use the cursor keys to go to the desired place in the table and enter the new value. The code tables are not updated until you leave XN_PAR with update.

 

4.11.9.      Print all parameters.

 

   With this function you can print all parameter settings. You just have to confirm that the printer is ready before go.

 

Figure 26 Print all parameters.

 

                         

                          Printer ready  (J/N) ?  

                          

 


4.12.        Starting X/Netbridge.

 

   The .bat file START.BAT will call the following programs:

 

                   XN_SINTV >NUL                         Activate the resident interruptdriver

                   XN_DISP  >NUL                           Activate the resident displaydriver

                   XN_STRT  >NUL                         Start of X/Netbridge

                   XN_FREE  >NUL                          Remove the resident drivers from memory

 

   If you often shift between DOS and X/Netbridge you can remove XN_FREE and just call XN_STRT for next sessions.

 

   The start / end of X/Netbridge will be logged in XN_LOGF.001 and so will any errors returned by XN_STRT. You should delete this logfile manually when it grows to big.

 

4.13.1.      Error codes returned from XN_STRT.

 

   XN_STRT may return the following errorcodes in the DOS variable ERRORLEVEL. The standard START.BAT job will translate these into a prober error message.

 

                   01 - Start parameter error.

                   02 - INDEX file not found.

                   05 - XN_SINTV resident program not installed.

                   06 - DONGLE not present.

                   07 - Invalid DOS version.

                   08 - INDEX file locked.

                   09 - Error in open MESSAGE system files.

                   10 - NET - No IPX present.

                   11 - NET - Netdriver not present.

                   12 - XN_DISP resident program not installed.

                   13 - NET - Error in NETBIOS execution.

 

4.13.3.      Direct start of a basic program from DOS.

 

   You may specify a basic program name as parameter for XN_STRT. This will cause XN_STRT to login automatically (account MANAGER, SPC(5)=2) and run the program.

 

   An additional numeric parameter may be given which can be used in the program:

 

                   START 01/TESTPROG 4711

 

will start TESTPROG on LU#1 and this program can get the parameter by the call:

                  

                   D1=7

                   CALL 202,D1,0

                   PRINT D1                    /* D1 NOW CONTAINS 4711

 

4.14.        Exit from X/Netbridge.

 

   You exit from X/Netbridge by entering DOS or END as ACCOUNT ID or by pressing ALT+A from scope.

 

   A program may also be coded to exit directly to DOS by either by CALL 204,1 (exit now) or:

 

                   120 LET D2=3

                   130 CALL 202,D2,1   /* DISABLE SCOPE ==> GO TO START AFTER USE.

                   135 LET D2=0

                   136 CALL 202,D2,-1  /* GO TO DOS AFTER USE (SET SPC 5 = -1)

                   .

                   .

                   999 CHAIN ""

 

   NOTE: If X/Netbridge is left open when the PC is switched off the INDEX file may be destroyed.

 

4.16.        The INDEX file and DOS file structure.

 

   As BASIC file names may be 14 characters long and DOS files only 8+3 it has not been possible just to store the files on DOS using the BASIC file name.

 

   All files are named XFnnnnnn.yyy on DOS, nnnnnn being the next free number in the X/Netbridge sequence and yyy the LU number. A new number is taken only when a new file is created, when you overwrite an existing file using SAVE or OPEN ! the DOS filename is kept.

 

   The connection between the BASIC filename and the DOS filename are kept in the file INDEX. On your release of X/Netbridge we have placed this also on LU#0 so it may be read by basic programs.

 

4.17.1.      Sizing the INDEX file with SZ_INDEX.EXE.

 

   The index file may be between 500 and 15000 records and comes as standard with 3000 records.

 

   You can use the program SZ_INDEX to extend the file:

 

                   SZ_INDEX 5000

 

will extend the file to 5000 records.

 

4.17.3.      Errors in the INDEX file after system breakdown.

 

   If new files are created on X/Netbridge and the PC is switched off the INDEX file will probably be destroyed. If no new files was created the index file will be OK.

 

   As standard X/Netbridge will block the system completely if the system is marked as not correct ended. As this is not necessary under many circumstances your START.BAT contains the call of:

 

                   CHXNET W

 

which checks and resets this flag (byte F2 in INDEX), it is the system will open always. If the INDEX is destroyed the former created file may be lost and problem with new creation of files may occur.

 

   If desired you may remove the call of CHXNET to force the customer to take action upon any error.

 

4.17.4.1.    Testing the consistency of INDEX (PRUEF_IF.EXE).

 

   With the DOS program PRUEF_IF.EXE you can check if the INDEX file is consistent:

 

                                      PRUEF_IF INDEX

 

will run this check and display the result on the screen. PRUEF_IF will not correct any errors found.

 

   PRUEF_IF requires a workfile PRUEF_IF.DAT with at least the same number of records as the INDEX file itself and this must be builded using the DOS program MAKE_IF.EXE

 

                                      MAKE_IF pruef_if.dat 3000 17 3

 

will build such a workfile with 3000 records.

 

4.17.4.3.    Recovering from errors in the INDEX file.

 

   You can do one of following to rescue your index:

 

                   a. Try to run SZ_INDEX to build a new file.

 

                   b. Make frequently copies using DOS: COPY INDEX INDEX.OLD and then restore this copy.

 

                   c. Restore a complete backup of the system. This is a sure way to solve the problem.


4.18.       DOS files included in X/Netbridge.

 

                   START.BAT              Start batch job

                   XN_DISP.EXE            Resident display driver

                   XN_FREE.EXE           Remove resident programs XN_SINTV and XN_DISP

                   XN_SINTV.EXE         Resident interrupt driver

                   XN_STRT.OVL          X/Netbridge start overlay

                   XN_STRT.EXE          X/Netbridge start program

 

                   XN_BYE.OVL             BYE processor

                   XN_CHNG.OVL         CHANGE processor

                   XN_COPY.OVL          COPY processor

                   XN_KILL.OVL           KILL processor

                   XN_LIBR.OVL           LIBR processor

                   XN_MAIN.OVL         Basic main processor

                   XN_QURY.OVL         QUERY processor

 

                   XN_CONF.001           Disk LU configuration, Basic LU# ==> DOS drive/path

                   XN_LOGF.001            Logfile for start/stop X/Netbridge

                   XN_MESS.001           TAMOS printer assignments etc.

                   XN_PARA.001           Parameter file for printer/display setup

 

                   XN_PAR.EXE            Parameter definition program

                   XN_DRUCK.PAR      Printer definition parameters

                   XN_DY001.VDD        Display driver

                   XN_DY002.VDD        Display driver

                   XN_DY003.VDD        Display driver

                   XN_DY006.VDD        Display driver

 

                   INDEX                         Connections between BASIC names and DOS file names

                   MAKE_IF.EXE          Create workfile for PRUEF_IF.EXE

                   PRUEF_IF.DAT         Workfile for PRUEF_IF.EXE

                   PRUEF_IF.EXE          Test program for INDEX consistency

                   SZ_INDEX.EXE         Extend INDEX file

 

                   LU0\XF??????.000     Basic program files

                   LU1\                             Other free LU

 

   Basic files are stored as eg:

 

                   LU7\47\XF002397.007                  where

                   LU7\                                                DOS directory as specified in XN_CONF.001

                   47\                                                   Subdirectory automatic created for suffix of files 47 and 97

                   XF002397                    XF followed by next X/Netbridge number

                   .007                                                  Indicates the file is placed on lu#7


4.20.

2.11.       BASIC files included in X/Netbridge.

 

                   BASIC      Basic processor

                   BUILDXF                    Build index file

                   BYE                              Account id processor

                   CHANGE                     Change filename

                   COPY                           Copy file

                   KILL                             Kill file

                   LIBR                             Libr processor

                   QUERY    Query file

                   RUN          Run program

                   START    Start menu program

                   TA.ABO                      Abort program

                   TA.END                      Standard end program

                   TA.NCO                      Next end program

                   TA.PRTASGN            Printer assignment

                   TA.PSWMAIN          Password maintenance

                   TA.SELCRE                Create selectors

                   TA.SELMAI               Maintenance of selectors

                   TA.SELPDL                Print / Delete selectors

                   TA.STRPIQ                Start of day program

                   XN.COPYALL            Copyall program

                   XN.FILEBRIDGE        File migration tool for complete streamer LU

                   XN.KILLALL              Killall program

                   XN.PROGBRIDGE     Program migration tool for complete streamer LU

                   XN.TEXTTRAN        Transfer textfiles from/to DOS

 

   Furthermore the essential parameterfiles as ACCOUNTS, MESSAGES, TF.PARAM, TF.PORT and the selector for account MANAGER are included.

 

   The functionality of the TAMOS user environment is as described in the TAMOS manuals.

 

   Other TAMOS programs / files may be migrated to X/Netbridge if needed. However you should NOT migrate the modules

START, TA.END, TA.NCO and TA.ABO as these are special for X/Netbridge.

 

4.22.       Installation in NET.

 

   When X/Netbridge should be running in network you must have a multiuser dongle present at the server PC only.

 

   In AUTOEXEC.BAT SHARE must be installed as eg. SHARE /L:50

 

   The processors XN_DISP.EXE, XN_STRT.EXE, XN_MAIN.OVL, XN_STRT.OVL and XN_BYE.OVL must be installed as multiuser versions.

 

   The parameter files *.001 must be copied to .002 to indicate multiuser parameters.

 

   The DOS environment variable XN_PORT must be set in START.BAT to the portnumber, eg. SET XN_PORT=2


5.

3.          Basic extensions in X/Netbridge.

 

   X/Netbridge contains some extensions to the 8870 basic to communicate with the DOS operating system.

 

6.1.        ALOAD and ADUMP basic file dump to DOS.

 

   The ALOAD and ADUMP commands may be used just like the LOAD and DUMP commands in BASIC.

 

   The filename should not refer to a BASIC file but to a DOS file and may include drive and pathname. The file will be in normal DOS format and may be edited / transferred to another system as such. The codetables setup using XN_PAR is used for character conversion in these functions.

 

                   ADUMP A:/XXX/FILE.NNN                         Dumps the program to diskette

                   ALOAD AAA                                                  Loads /XNET/AAA

 

6.3.        LIBR % filelist with DOS names.

 

   LIBR % will display the BASIC filename and the through INDEX connected DOS filename:

 

Figure 27 LIBR % listning of DOS names.

 

#LIBR TA %

LOGICAL UNIT:  0        14.12.92  12:56:11

 

   FILENAME

*

B  TA.ABO              ./lu0/xf000010.000

B  TA.END              ./lu0/xf000011.000

B  TA.NCO              ./lu0/xf000012.000

B  TA.PRTASGN          ./lu0/xf000013.000

B  TA.PSWMAIN          ./lu0/xf000014.000

B  TA.SELCRE           ./lu0/xf000015.000

B  TA.SELMAI           ./lu0/xf000017.000

B  TA.SELPDL           ./lu0/xf000016.000

B  TA.STRPIQ           ./lu0/xf000018.000

 

 

38784  FREE BLOCKS ON LU NO.     0

 

#

 

 

 

6.5.        Basic program size.

 

   The size of a basic program on X/Netbridge is not restricted to 32 KB but only limited by the free DOS memory which means a program may be up to 200 KB large depending on the DOS configuration.

 

6.7.        CALL 201 DOS file interchange.

 

   This call is used to transfer files between BASIC and DOS and to insert entries into the INDEX file.

 

    Format 1:                                    CALL 201,<Nvar>,<Svar>

                  

                   <Nvar>                        Function code and return status (0=OK)

                                                         2 = Open  DOS-file <SVAR> for READ

                                                         5 = Open  DOS-file <SVAR> for WRITE

                   <Svar>                         DOS filename, may include drive and path

 

    Format 2:                                    CALL 201,<Nvar1>,<Numpar>,<Nvar2>,<Svar>

                  

                   <Nvar1>                      Function code and return status (0=OK)

                                                         4 = READ  DOS-file from byte Numpar into Svar, Nvar2 bytes.

                                                         6 = WRITE DOS-file from byte Numpar from Svar, Nvar2 bytes.

                                                         7 = READ  DOS-file from byte Numpar into Svar, Nvar2 bytes.

                   <Numpar>                   Start bytedisplacement

                                                         -1 = current position in file

                   <Nvar2>                      Length in bytes to read/write

                                                         Returns no. of bytes read/written

                   <Svar>                         String for read / write

 

    Format 3:                                    CALL 201,<Nvar1><Nvar2>

 

                   <Nvar1>                      Function code and return status (0=OK)

                                                         9 = Get size of open DOS file to Nvar2

                   <Nvar2>                      Return value

 

    Format 4:                                    CALL 201,<Nvar>

 

                   <Nvar>                        Function code and return status (0=OK)

                                                         3 = Close DOS-file

 

    Format 5:                                    CALL 201,<Numpar1>,<String1>,<String2>,<Numpar2>

 

                   <Numpar1>                 Function code 0, insert entry in INDEX file

                   <String1> Basic filename

                   <String2> Dos filename

                   <Numpar2>                 Basic file type

 

6.9.        CALL 202 Test/set XNET parameters.

 

                   CALL 202,<Nvar>,<Numpar>

 

                   <Nvar>                        Function code and return value

                                                         0 = Set SPC  5 = Numpar (Userno.), -1 ==> go to DOS from TA.END/START

                                                         1 = Set SPC 14 = Numpar (started from Tamos/Scope)

                                                         2 = Ctrl.Y + ESC, Numpar = 0:Enable, 1:Disable

                                                         3 = Scope, Numpar = 0:Enable, 1:Disable

                                                         4 = Get X/Netbridge version no. (108)

                                                         5 = Get size of free memory for basic programs

                                                         6 = Get size in bytes of logfile XN_LOGF.001

                                                         7 = Get start parameter from command line (#PROGRAM 4711)

                                                         8 = Get PU# of LU#Numpar

                                                         9 = Get single/multiuser, returns Nvar=1:single user, 2=Multiuser

                   <Numpar>                   Parameter as stated above

 

6.11.        CALL 203 Physical printer/port connection.

 

   X/Netbridge is as standard setup with just $RPL0 as standard printer.

 

   By use of call 203 you are able to create other physical printers, which you can assign logical printernames using the TAMOS printerassignment. The syntax is:

 

                   CALL 203,0,<String1>,<Numpar1>,<Numpar2>,<Nvar> [,<String2>]

 

                   <String1> Device name, eg. $LPT

                   <Numpar1>                 Class: 1=leperello, 2=single sheet feeder

                   <Numpar2>                 DOS port: -1=LPT1, -2=LPT2, -4=file, -5=COM1, -6=COM2

                   <Nvar>                        Status variable, 0=OK

                   <String2> Filename when <Numpar2> = -4

 

                   CALL 203,0,"$LPT",1,-2,S                                                 Assigns $LPT to LPT1 as normal printer

                   CALL 203,0,"$TXT",1,-4,S,"TXT.PRN"       Assigns $TXT to the DOS file /XNET/TXT.PRN

 

6.13.        CALL 204 Exit to DOS.

 

                   CALL 204,<Numpar>

 

                   <Numpar>                   Function code

                                                         1 = Exit to DOS

                                                         2 = ? Empty buffers, zero INDEX file error flag if set.


7.          Migration to X/Netbridge.

 

   Programs and files can be ported to X/Netbridge in different ways:

 

   1. Streamer tape backup - the fastest way.

      Hardware (streamer tape and controller) is available for installation on PC to read a complete backup LU from 8870

      to DOS together with software to convert the LU into X/Netbridge files.

      Please contact us if you need fast conversion of large files.

 

   2. Transfer to PC with an 8870 emulation as TRACE or ERNA.

      As this transfer is rather slow at 9600 or max. 19200 baud it make take some time to get files over, but no additional

      cost on hardware is necessary.

      Basic programs must be dumped into textfiles and then loaded with ALOAD in X/Netbridge.

      As this procedure is rather circumstantial SW-TOOLS has made a couple of tools for easy migration of many files

      which will be described in the following.

  

8.1.        Migration using a LIBR list.

 

   On the X/Netbridge directory you will file the DOS-textfile CHXNET.UD which first of all must be transferred to the 8870 and saved as a basic program. This program can process a libr list of files and combine these into one textfile which can be transferred to DOS with a 8870 emulation program.

     

   As basic programs in X/Netbridge you have got CHXNET.XCO for reading DOS files into X/Netbridge and CHXNET.IND to split the combined textfile to single programs / files.

 

   These 3 programs are designed to be able to run as batch programs without any input at all the program names may contain information of filename of libr list and LU as described below.

 

   The files produces by CHXNET.UD and read by CHXNET.IND are plain textfiles which can be transferred without any tricks with any emulation program. Basic programs will be dumped out and contiguous / indexed files will be converted into an compressed hexadecimal dump format. Due to this compression and as only used records in indexed files are taken into consideration the size to transmit will normally just be 25 % of the original file sizes.

 

   Formatted files are only supported in selector format TF.PROG and TF.SYSTEM as these files requires special read statements for each format. However the programs may easily be extended to support other record layouts.

 

8.2.1.      Sample migration using a libr list.

 

   8870 site:                  1. LIBR 2/MYFILES (2/XXX)      Make a libr list XXX

                                      2. COPY 2/XXX.UD=CHXNET.UD               Make a OUT program for this

                                      3. RUN  2/XXX.UD                       And run it

   ---                               4. Transfer the textfile 2/XXX.UDC to DOS /XNET/XXX.UDC

   DOS site:                  5. COPY 2/XXX.XCO=CHXNET.XCO         Make an IN program

                                      6. RUN  2/XXX.XCO                    And run it.

 

   By naming the programs 2/XXX. you tell:

                   CHXNET.UD    (2/XXX.UD)  to take libr list 2/XXX and produce 2/XXX.UDC containing files from lu#2

                   CHXNET.XCO   (2/XXX.XCO) to take the DOS file /XNET/XXX.UDC to 2/XXX.UDC and copy

                   CHXNET.IND to 2/XXX.IN2  which loads files from 2/XXX.UDC to lu#2 and

                                 removes 2/XXX.UDC after use and goes back to DOS.

 

   8870 site:                  1. LIBR 0/MYFILES (2/X00)                           Make a libr list X00

                                      2. COPY 2/X00.UD=CHXNET.UD                 Make a OUT program for this

                                      3. RUN  2/X00.UD                                            And run it

   ---                               4. Transfer the textfile 2/X00.UDC to DOS /XNET/X00.UDC

   DOS site:                  5. COPY 2/X00.XCO=CHXNET.XCO           Make an IN program

                                      6. RUN  2/X00.XCO                      And run it.

 

   Using the prefix X00 instead specifies that all programs/files should be taken from LU#0 but as the programs are placed on LU#2 the textfile 2/X00.UDC is produced on lu#2.

 

 

8.2.2.1.    Filenames in CHXNET.xxx.

 

   The filename prefix can contain the following information:

 

     2/XXX   Use libr list 2/XXX and input files on 2/

       X     Produce one outputfile 2/XXX.UDC only containing all files

             After loading in CHXNET.IND: Remove 2/XXX.UDC and goto DOS

       Y     Separate 2/XXX.UDC, 2/XXX.UDB and 2/XXX.UDT for *C,*B,*T

          07 Use LU#7 for input files

 

   Libr lists may be combined by using #COPY XXX=LIB1,LIB2,LIB3 on 8870.

 

   An LU may be given between the file type and filename in the libr.list, eg. T05TEXTFILE

 

8.3.        Conversion of single files from DOS.

 

   Basic programs can be converted to/from DOS using ADUMP / ALOAD.

 

8.4.1.      TEXTTRAN.

 

   For users of the 8870/PC-emulation ERNA the program XN.TEXTTRAN matches the 8870 TEXTTRAN program and may be used for textfile transfer to/from DOS:

 

Figure 28 TEXTTRAN conversion.

 

T E X T T R A N

-----------------------------------------------------

 

 

               (1) Copy files TO   DOS

               (2) Copy files FROM DOS       :  .

 

               8870 (XNET) filename          :

 

               PC DOS filename               :

 

               With codeconversion      Y/N  :

 

 

 

8.4.3.      CHXNET.XCO.

 

    With the program CHXNET.XCO you are also able to convert single files just by calling this from scope:

 

Figure 29 CHXNET.XCO conversion of single files.

 

#CHXNET.XCO

Transfer file between DOS and XNET.

 

Enter XNET file with LU   as eg. 0/A!

Enter DOS  file with PATH as eg. D:/XNET/A or just A

 

   Source filename:A

   Destination filename:0/A!

   With conversion (Y/N):N

 

A 0/A!    20729

#

 

 

   Here you specify the direction by giving an LU for the basic program. This program is much quicker as texttran due to the handling of codetables and buffering of data.

 

   Whenever possible try to avoid any code conversions during transfer from 8870 to PC and from PC to X/Netbridge as this is only a waste of time both on 8870 and the PC. X/Netbridge uses exactly the same characters as 8870 (also with parity as on 8870).


8.4.4.1.    Transferring more files in one run of CHXNET.XCO.

 

   You may give a parameter for the program CHXNET.XCO:

 

                                                         #CHXNET.XCO 1

will instead take the DOS file /XNET/LIB which may be created with DOS EDIT and transfer the files specified here, eg:

 

                   /XNET/LIB:                 DOSFIL 00/XNETFIL

                                                         02/XNETFILE DOSFILE N

                                                         AA 02/FIL Y

                                                         #MYPROGRAM

 

You can specify FROM TO CONVERSION(Y/N) in the LIB file and transfer as many files you want in one go. After transfer you can call up a program by #PROGRAMNAME. Note that also #COPY AA=BB &PROGRAM may be used.

 

8.4.4.3.    Exit to START or DOS after CHXNET.XCO.

 

                   CHXNET.XCO 11      will go to START after the LIB files has been transferred.

                   CHXNET.XCO 21      will go to DOS.

 

8.5.        Making batch jobs for ERNA.

 

   If you are using the ERNA 8870/PC emulation it is possible to make a batch job to build libr lists/transmit files between X/Netbridge and 8870. An example could be:

 

   XFER.BAT               CALL \ERNA\XFER1 00 MYPROG

                                      CALL \ERNA\XFER1 00 Y.MYPROG

                                      CALL \ERNA\XFER1 00 MYFILES *C*T

 

   XFER1.BAT             cd \xnet

                                      del XXX.UDC

                                      cd \erna

                                      echo TEAM                                                                          >xstart

                                      echo #                                                                                   >>xstart

                                      echo LIBR %1/%2 %3 @^ (%1/XXX!)         >>xstart

                                      echo %1/XXX.UD                                           >>xstart

                                      echo 00/TEXTTRAN                                                         >>xstart

                                      echo 1                                                                                   >>xstart

                                      echo %1/XXX.UDC                                        >>xstart

                                      echo /xnet/XXX.UDC                                                        >>xstart

                                      echo N                                                                                  >>xstart

                                      echo DOS                                                                             >>xstart

                                      emix xstart

                                      cd \xnet

                                      start 2/XXX.XCO 21

 

   This job will run 3 transfers by making an input file for ERNA (EMIX) and execute the commands on 8870, switch to XNET and convert the result to X/Netbridge.

 

8.7.        Installing RAPGEN / DATAMASTER / IQ on X/Netbridge.

 

   If you have got a RAPGEN diskette for X/Netbridge this contains a full demo version of RAPGEN, DATAMASTER an IQ together with COMET file definitions and small COMET demo files.

 

   To install insert the diskette and type A:INSTALL A: C:

 

   You may move RAPGEN to another disk after installation if desired. RAPGEN is not part of X/Netbridge and requires a seperate license. The account DMS and the selectors TF.SYSTEMDMS/TF.PROGDMS1 are included in X/Netbridge, after installation you can just log on on ACCOUNT ID: DMS

 

NOTE: RAPGEN will be installed to C:/XNET/LU3 which means LU#3 should be free for any files !

      800 files will be copyed using 6.0 MB of diskspace.


9.          Other X/Netbridge utility functions.

 

   The CHXNET.XCO contains a couple of additional functions for X/Netbridge, these are specified by the parameter given on the command line. The parameter syntax is:

 

                   #CHXNET.XCO xxyz xx = Optional LU# or subfunction code

                                                                             y = Exit code, 0=Scope, 1=START, 2=DOS

                                                                             z = Function code

 

10.1.        Making a DMAP file (diskmap).

 

                   #CHXNET.XCO 2

   will read the complete INDEX file and on each LU produce a file with the name DMAP, the DOS file name also being DMAP. This file contains a LIBR % listing, it is the connection between BASIC filenames and DOS filenames.

 

                   #CHXNET.XCO 102

   does also check if the DOS files are present and gives an error message if not. Also consistency between the INDEX key and INDEX record data are checked.

 

                   #CHXNET.XCO 202

   will also CORRECT any errors found by deleting all INDEX entries where the DOS file is missing and correcting the INDEX record if this does not match the INDEX key.

 

10.3.        Transporting a complete LU to another X/Netbridge system.

 

   When a DMAP file is builded for a LU all data on the LU directory may be copied to another machine using DOS XCOPY or compressing programs as PKZIP / PKUNZIP as X/Netbridge is extremely compressible.

 

   This LU can be activated in another X/Netbridge system using

 

                   #CHXNET.XCO 0903

where 09 is the LU number, 3 the function code. The source and destination LU does not necessary have to be the same.

 

10.5.        Recovering using the DMAP file.

 

   If a fresh DMAP file is present on a LU the INDEX file can be reconstructed using the above mentioned command.

 

   As there may exist INDEX entries without DOS files and these cannot be removed with KILL the following:

 

                   #CHXNET.XCO 0904

                   #CHXNET.XCO 0903

will first REMOVE ALL FILES IN INDEX for lu#9 (function 4) and the REINSERT these (function 3) using the DMAP file.

 

10.7.        CHA.EXE Code conversion / program compression on DOS.

 

   When transporting files between different systems you may somtimes need code conversions. This is done fastes way on DOS using the small utility program CHA.EXE

 

Figure 30 Functions in CHA.EXE

 

D:\XNET>cha

Usage: CHA -n -c -d -t -u -p +p xx=yyzz xxyy=zz file1 file2 ...

 

-n       Unix cr            ==> Dos  crlf    (0D==>0D0A)

-c       Dos  crlf          ==> Unix cr      (0D0A==>0D)

-d       Unix æøåÆØÅ        ==> Dos  æøåÆØÅ  (Danish)

-t       Unix äöüÄÖÜß       ==> Dos  äöüÄÖÜß (German)

-u       Dos  æøåÆØÅäöüÄÖÜß ==> Unix æøåÆØÅß (Danish & German)

-p       Remove parity

+p       Set parity

-b       Compress  BASIC programs to smallest possible size

-r       UNCOMMENT BASIC programs exept on first line

-R       UNCOMMENT BASIC programs completely

0D=0D0A  Convert 0D   to 0D0A

0d0a=0d  Convert 0D0A to 0D

 


                                                                            Figures

 

Figure 1 Start screen.....................................................................................................................................................................................   3

Figure 2 TAMOS selector level 1...............................................................................................................................................................   4

Figure 3 XN_PAR main menu.....................................................................................................................................................................   8

Figure 4 Exit with/without update from XN_PAR....................................................................................................................................   8

Figure 5 Amendmend of standard parameters.........................................................................................................................................   8

Figure 6 Display of current parameter settings........................................................................................................................................   8

Figure 7 Selecting display type..................................................................................................................................................................   9

Figure 8 Selecting printer type....................................................................................................................................................................   9

Figure 9 Special print character..................................................................................................................................................................   9

Figure 10 Amending colours for forground/background/status­window.............................................................................................   9

Figure 11 Selecting a colour........................................................................................................................................................................   9

Figure 12 Menu for amending printer drivers.........................................................................................................................................   10

Figure 13 Selecting printer type................................................................................................................................................................   10

Figure 14 Amending the print control characters..................................................................................................................................   10

Figure 15 Defining a special print string.................................................................................................................................................   10

Figure 16 Activating the new printer definition.....................................................................................................................................   10

Figure 17 Copying / defining a new printer............................................................................................................................................   11

Figure 18 Deleting a printer definition.....................................................................................................................................................   11

Figure 19 Exporting a printer definition...................................................................................................................................................   11

Figure 20 Menu for amending keyboard layout.....................................................................................................................................   12

Figure 21 Amending the keyboard layout..............................................................................................................................................   12

Figure 22 Deletion of function keys.........................................................................................................................................................   12

Figure 23 Resetting all function keys to standard.................................................................................................................................   12

Figure 24 Amending codetables...............................................................................................................................................................   13

Figure 25 A printer output codetable......................................................................................................................................................   13

Figure 26 Print all parameters....................................................................................................................................................................   13

Figure 27 LIBR % listning of DOS names...............................................................................................................................................   18

Figure 28 TEXTTRAN conversion..........................................................................................................................................................   21

Figure 29 CHXNET.XCO conversion of single files..............................................................................................................................   21

Figure 30 Functions in CHA.EXE.............................................................................................................................................................   23

 


                                                                            Keyword index

 


ADUMP............................................................................ 18, 21

ALOAD....................................................................... 18, 20, 21

AUTOEXEC.BAT.................................................................. 17

BYE............................................................................ 3, 4, 16, 17

CHA.EXE................................................................................ 23

CHANGE................................................... 4, 7, 9, 10, 12, 16, 17

CHXNET...................................................................... 15, 20‑23

CHXNET.IND................................................................... 20, 21

CHXNET.UD.......................................................................... 20

CHXNET.XCO.................................................................. 20‑23

Colours...................................................................................... 9

CONFIG.SYS............................................................................. 7

COPY................................................. 4, 6, 7, 9, 11, 15‑17, 20‑22

DATAMASTER.................................................................... 22

DMAP..................................................................................... 23

Dongle....................................................................... 6, 7, 14, 17

EDIT................................................................................. 5, 7, 22

ERNA................................................................................. 20‑22

FASTOPEN............................................................................... 7

HIMEM.SYS............................................................................. 7

INDEX............................................................ 3, 6, 14‑19, 23, 25

IOM........................................................................................ 5, 9

IQ.............................................................................................. 22

KILL..................................................................... 4, 5, 16, 17, 23

LIBR.................................................................... 4, 16‑18, 20‑23

Logfile...................................................................... 3, 14, 16, 19

MAKE_IF......................................................................... 15, 16

Netbios.................................................................................... 14

PKUNZIP................................................................................ 23

PKZIP...................................................................................... 23

Printerdriver...................................................................... 10, 11

PRUEF_IF......................................................................... 15, 16

QUERY.......................................................................... 4, 16, 17

RAPGEN.................................................................................. 22

SCOPE........................................................... 3, 4, 14, 19, 21, 23

SHARE.................................................................................... 17

SMARTDRV............................................................................. 7

Softkeys.............................................................................. 7, 12

STACKER................................................................................. 7

Statusline........................................................................ 7, 9, 12

SZ_INDEX........................................................................ 15, 16

TAMOS........................................................... 3, 4, 7, 16, 17, 19

TEXTTRAN................................................................ 17, 21, 22

XCOPY................................................................................ 7, 23

XN_CONF....................................................................... 3, 7, 16

XN_DISP..................................................................... 14, 16, 17

XN_FREE.......................................................................... 14, 16

XN_LOGF............................................................... 3, 14, 16, 19

XN_PAR................................................................. 8, 13, 16, 18

XN_SINTV........................................................................ 14, 16

XN_STRT................................................................... 14, 16, 17