


Nokia ASC/AWS / UTILITY                                  Mar 31, 1988


                              READ.ME
                              =======

This file  contains information on how to use the additional utility
programs which are in the  UTIL  subdirectory  of  the  Nokia AWS
operation system diskette.


Note  that  Nokia  does  not  assume  any  responsibility  for these
additional utility programs. They are presented to you by courtesy of
Nokia because we think that you may find them useful in your work.




EXPRO
-----

EXPRO is a memory-resident program which performs code conversions on
the datastream that is sent to the printer.

The program checks every character which is sent to the  printer via
the PRN  device or  the INT17  handler. If the conversion program is
activated and the character code is included in the conversion table,
the code is replaced by the corresponding converted code before it is
passed to the printer.

The program is loaded into memory by giving the command EXPRO.

The activating and inactivating  of the  conversion program  and the
selection of  the conversion  table is  performed by sending special
sequences to the printer.


The sequences are:

          &*&0    7-bit ASCII   -> 8-bit Extended ASCII
          &*&1    7-bit ASCII   -> Roman 8
          &*&2    Extended ASCII-> 7-bit ASCII
          &*&3    Roman 8       -> 7-bit ASCII
          &*&4    Roman 8       -> 8-bit Extended ASCII
          &*&5    Extended ASCII-> Roman 8
          &*&6    conversion off



The program on the  distribution  diskette  contains  the conversion
tables  for  the  Finnish/Swedish  character set. You can change the
character codes or increase the number of characters to be converted
with DEBUG. There are three tables in the program. Each is 256 bytes
long. The corresponding codes are at the same position in each table.
The last character of the table has to be 0FFH.



If you  have to set the line parameters of the printer port with the
MODE command, you must do it before starting the EXPRO program. Since
EXPRO remains resident in memory, the command should be executed only
once at start-up. You can include  the command  in your AUTOEXEC.BAT
file.

Keep the following in mind when using EXPRO:

         If your  text ends  with the characters "&", "&*", or "&*&"
         the characters  will not  be sent  to the  printer, but the
         EXPRO program  will wait  for the next characters to see if
         it is an activation sequence.

         The INT17 and PRN device handling of the  EXPRO program are
         independent of each other. If the RS232.SYS driver is loaded
         into the system, the INT17  handler  calls  the  PRN device
         handler.  If  the  RS232.SYS  is not loaded, the PRN device
         handler calls the INT17 handler. The conversion program may
         be active  for one  handler and not for the other. This may
         lead to situations where  one program  uses the conversions
         and another  does not. Assume that RS232.SYS is not loaded.
         You can activate the conversion program for the PRN device,
         for example,  with the  command "COPY  CON PRN (RET) &*&0^Z
         (RET)". In this case WordPerfect, which normally uses INT17,
         will send  its data to the printer without any conversions.
         Now, if you activate  the conversions  from a  WP text file
         and  later  inactivate  them  again by sending the sequence
         "&*&6" to  the PRN  device handler,  the conversion program
         will still  affect the INT17 handling. Since the PRN device
         handler calls INT17, the datastream will be converted.


         The activation/inactivation  sequence  must  have  the form
         &*&n (where n is 1...6). For example the sequence &*&*&n is
         passed to the printer as such  and  has  no  affect  on the
         conversions.

         EKEYB.SYS or  NKEYB.SYS and  LAST.SYS must be loaded. EXPRO
         does not work in the Nokia MS-Net.




SETP
----

The SETP program sends a control sequence to the EXPRO
program. SETP is used by selecting an option from a menu or by
including a parameter in the command.

1. Using the SETP Menu

Start the program by typing:

                  SETP <RET>

Select the type of conversion with the cursor control keys 
and press <RET>, or press one of the letter keys (A-G) shown on the
left.


2. Using a Parameter in the Command

Call the program by typing:

                  SETP x <RET>

where "x" one of the following: A, B, C, D, E, F, G, a, b, c, d, e,
f, g, 0, 1, 2, 3, 4, 5, or 6.  Parameters A, a, and 0 send
the seqence &*&0 to the EXPRO program, parameters B, b, and 1
send &*&1, and so on.

Example:

SETP D <RET>

activates Roman 8 to extended ASCII conversion. 


SETP 6 <RET>

ends any conversion. Instead of "6", you could use "G" or "g" in the
command.



SKAND
-----

SKAND reads characters from the  terminal  one  at  a  time.  If the
character is  Scandinavian, it  is converted into the selected mode.
After the conversion the character is sent back to the terminal. The
process continues until an EOF character is received (usually CTRL-Z).


 
Options:

SKAND /I   Conversion from 7-bit ASCII mode to extended ASCII mode.
SKAND /N   Conversion from extended ASCII mode to 7-bit ASCII mode. 
SKAND /H   Conversion from 7-bit ASCII mode to ROMAN 8 mode. 
SKAND /P   Conversion from extended ASCII mode to ROMAN 8 mode. 
SKAND /B   Conversion from ROMAN 8 mode to extended ASCII mode.
SKAND /O   Conversion from ROMAN 8 mode to 7-bit ASCII mode.
SKAND /W   Conversion from WINDOWS mode to extended ASCII mode. 
 
Purpose:  Reading and writing is done by using the standard MS-DOS 
          terminal input and  output system (STDIN and STDOUT). 
          If you wish to convert an existing disk file, you can
          use I/O redirection or pipes on the MS-DOS command level. 
          You can also redirect output directly to a printer
          (see the last example).

 
Examples:


TYPE text.nok | SKAND /I   Displays the contents of "text.nok" on an
                           extended ASCII mode terminal. 
 
SKAND /I <text.nok         Same as above. 
 
 
TYPE text.ibm | SKAND /N >text.nok 
                           Converts "text.ibm" into 7-bit ASCII mode
                           and saves the converted file to "text.nok".

 
SKAND /N <text.ibm >text.nok
                           Same as above.

SKAND /I <text.nok >PRN    Converts and prints the file "text.nok"
                           to a printer which uses an extended ASCII
                           character set. 
 
The other switches also have the same command syntax.

 
Note:

There are three sample files in this directory. EXAMPLE.NOK has
been written with the 7-bit ASCII character set, EXAMPLE.IBM
with the extended ASCII character set, and EXAMPLE.HP with the
ROMAN 8 character set. You can practice the syntax of the command by
converting these files.




KDEF
----


Conversion tables of KEYBxx.COM keyboard drivers can be modified
with KDEF. KEYBxx.COM version should be 2.2 or later. The whole
national conversion table cannot be modified, only base and shift
levels of the alphanumeric keypad and the <.>-key in the numeric
keypad.

To start the program just enter 'KDEF'. First KDEF asks for the name
of the file to be modified. If the file is not in the current
directory, the whole path should be written, e.g. 'C:\SYS\KEYBSU.COM'.

Next KDEF wants to know the type of your keyboard. Note: you can
modify conversion tables of both keyboards (the Nokia 100 and Nokia
102). However, to check the changes you must use the correct keyboard
when you load KEYBxx.COM.

To get instructions for the configuration process press key <F1>.

To avoid any confusion later on, do not use the name of the original
KEYBxx.COM when you save the modified file.


