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/statuswindow............................................................................................. 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