Technical Reference

Wordprocessing Notes

6.1 Install for Wordstar

Brief notes on the use of Install supplied with Wordstar Ver 3.21 (MS DOS VERSION)

The install program allows you to change Wordstar to suit different installations.

When you invoke Install (by typing INSTALL ) it logs on and provides you with most of the information you require. It then asks a number of questions.

Please read the questions carefully before answering. Below are some of the questions (in brief) with the usual answer.

Q.

A.

Which MicroPro product do you wish to install?

WS <cr>
Q.

A.




Name of file to install, or <RETURN> for WSU.COM

<RETURN> or WS.COM
(The file WSU.COM is an uninstalled version of Wordstar WS.COM has been installed for the Sirius and Diablo printer. Normally you would simply want to make minor changes to an already installed version. If you want to start from scratch then install WSU.COM

Q.

A.

Name of file for installed WORDSTAR, or <RETURN> for WS.COM

<RETURN> or filename.COM

(You can write your installed WORDSTAR back to WS.COM if you like but make sure you have a backup of the old version just in case.)


A
B
C
E
F
X
Menu of Terminals
Custom Installation of Terminals
Menu of Printers
Menu of WORDSTAR features
Custom Modification of WORDSTAR
Exit

In more detail -

A    Menu of Terminals
B    Custom Installation of Terminals

Normally you would make no changes here since WS is already installed for the Sirius terminal, otherwise select option E from Menu 2.

If you want to install Wordstar for use with 132 column mode or you don't like the method of highlighting, then try option B.

If you want to change any of the screen attributes you must refer to the screen driver escape codes found in the Dealer Users Guide.

C    Menu of Printers

Select your printer from the list given. If your printer cannot be found (eg MT180) then select "I - Teletype-like printer".

Communication protocol.

Answer A.    (handled outside Wordstar by the interface if your cable is correct).

List device is normally "Primary List Device".

E    Menu of WORDSTAR features

This section allows you to choose such things as initial help level, decimal tab character, initial justification etc.

F    Custom Modification of Wordstar

Allows you to change individual bytes. Use in conjunction with listing of user-definable section.

This section only allows you to change bytes at addresses in the range 100H-949H. (Use DEBUG to change bytes outside this range.)

6.2 Summary of the WordStar Patch Locations

Use the "F" command in Install to make these changes:

Example 1:

The byte at location 2D2H (hexadecimal notation) controls the length of time the WordStar Sign-on banner remains on the screen. Its initial value is 16 (10H). To change this to a smaller value (say zero) enter the Install program and select the "F" option (custom modification of WordStar).

Enter a starting address of 2D2H and Install will display the contents of 2D2H and the next 15 characters (bytes). Check that the first byte has the value 10H and if so, answer the next question with "Y". Enter the new value 0 then enter a full stop "." to exit this mode. Follow the remaining instructions to return to the main menu.

Example 2:

WordStar on the Sirius uses reverse video to highlight menus and other messages. Some people prefer to use high intensity for this. The strings required by Sirius to set and clear reverse video are "Esc p" and "Esc q" respectively (hex: 1B,70 and 1B,71). The strings required to set and clear high intensity are "Esc,(" and "Esc,)" respectively (hex: 1B,28 and 1B,29).

The "turn on highlighting" string starts at location 284H, therefore we must enter three bytes starting at this location. The first byte is a byte count (in this case 2) followed by the required bytes. Thus we enter the three bytes (in hex) 02, 1B, 28 starting at location 284H and the three bytes 02, 1B, 29 starting at location 28BH.

STARTING
ADDRESS
(in hex)
NAME
NUMBER OF BYTE
AVAILABLE
FOLLOWING
BYTE COUNT
(IF ANY)
PURPOSE

248
249
284
28B
2D2
2D3
360
362
363
385
386
387
388
389
38A
38B
38C
38D
38E
746


747
748
74C
757
75E
765
76B
770
775
77A
77F
784
789
78E
793
798
79D
7AE
HIGHT
WID
IVON
IVOFF
DEL4
DEL5
ITHELP
ITITOG
ITDSDR










POSMTH


BLDSTR
DBLSTR
PSCRLF
PSCR
PSHALF
PBACKS
PALT
PSTD
POLUP
POLDOW
USR1
USR2
USR3
USR4
RIBBON
RIBOFF
PSINIT
PSFINI
NIL
NIL
6
6
NIL
NIL
NIL
NIL
NIL
NIL
NIL
NIL
NIL
NIL
NIL
NIL
NIL
NIL
NIL
NIL


NIL
NIL
10
6
6
5
4
4
4
4
4
4
4
4
4
4
16
16
Screen height (in lines)
Screen width (in characters)
Turn on highlighting
Turn off highlighting
Sign-on delay 0-16
Screen refresh delay 0-10
Initial help level 0-3
Set to zero to boot with Insert Off
Set to zero for initial no file display
Word wrap flag
Justify flag
Variable tabs flag
Soft hyphen flag
Hyphen help flag
Print control & soft hyphen display flag
Display ruler flag
Dynamic page break flag
Page break display flag
Initial line spacing flag
=1 for daisy wheel
=0 for backspacing printer
=FF for CR then another whole line
Number of strikes for "boldface"
Number of strikes for "double strike"
String to printer to next line
String to return carriage to start of same line
String to do carriage return & half line feed
String to backspace
String to set alternate character width
String to reset to standard character width
String to roll carriage up partial line
String to roll carriage down partial line
String for user function 1
String for user function 2
String for user function 3
String for user function 4
String to change ribbon to alternate colour
String to reset ribbon colour
String to initialise printer
String to reset printer at end

6.3 Summary of the keyboard table AUSWP4.KB
                                  

KEY LABEL      UNSHIFTED              SHIFTED               ALTERNATE

ESC            ESCAPE                 ESCAPE                ABANDON FILE
                 ESC                    ESC                   ^KQ

INT ON/OFF     BOLD ON/OFF            LEFT END              RIGHT END
                                      OF LINE               OF LINE
                 ^PB                    ^QS                   ^QD

RVS ON/OFF     DISPLAY HELP           SET MIN. HELP         SET MAX. HELP
               MENU
                 ^J                     ^JH0                  ^JH3

UNDL ON/OFF    UNDERLINE              DIRECTORY             HIDE MARKERS
               ON/OFF                 ON/OFF
                 ^PS                    ^KF                   ^KH

F1             SET TEMP.              SET LEFT MARGIN       SET LEFT MGN
               LEFT MARGIN            AT CURSOR             AT COL. ENTRY
                 ^OG                    ^OL,ESC               ^OL

F2             MARK BEGINNING         MARK END              COPY MARKED
               OF BLOCK               OF BLOCK              TEXT
                 ^KB                    ^KK                   ^KC

F3             READ FILE              WRITE MARKED          MOVE MARKED    
               INTO TEXT              TEXT                  TEXT
                 ^KR                    ^KW                   ^KV

F4             REFORM PARAGRAPH       CENTRE TEXT           PAGE BREAK
                 ^B                     ^OC                   .PA

F5             FIND (ONLY)            FIND & REPLACE        GLOBAL CHANGE
                 ^QF                    ^QA                   G,W,

F6             BACK UP FILE           END EDIT              EXIT WS       
               AND RETURN             WITH SAVE             WITH SAVE
                 ^KS^QP                 ^KD                   ^KX

F7             SET RIGHT MARGIN       SET RIGHT MARGIN      TOGGLE JUSTIFY
               AT CURSOR              AT COL. ENTRY                
                 ^OR,ESC                ^OR                   ^OJ

BACKSPACE      BACKSPACE &            DELETE WORD           BACKSPACE
               DELETE                 LEFT
                 DEL                    ^A^T                  ^H

CLR            GO TO TOP OF           GO TO BOTTOM          
               SCREEN                 OF SCREEN
                 ^QE                    ^QX

DEL CHAR       DELETE CHAR            DELETE WORD      
               RIGHT                  RIGHT
                 ^G                     ^T

INS MODE/LINE  INSERT ON/OFF          INSERT CARRIAGE       
                                      RETURN
                 ^V                     ^N

DEL EOL/LINE   DELETE EOL             DELETE LINE           DELETE BLOCK
                 ^QY                    ^Y                    ^KY

SCROL          SCROLL DOWN            SCROLL UP             SCROLL UP
                                                            CONTINUOUSLY
                 ^W                     ^Z                    ^Q^Q^C

LTRL           REPEAT FIND/           RE-ENTER LAST     
               REPLACE                FILE     
                 ^L                     ^R

CURSOR UP      CURSOR UP ONE          CURSOR UP           
               LINE                   ONE SCREENFULL
                 ^E                     ^R

CURSOR DOWN    CURSOR DOWN            CURSOR DOWN           
               ONE LINE               ONE SCREENFULL
                 ^X                     ^C

CURSOR LFT     LEFT ONE               LEFT ONE WORD
               CHARACTER
                 ^S                     ^A

CURSOR RGHT    RIGHT ONE              RIGHT ONE WORD
               CHARACTER
                 ^D                     ^F

TAB            TAB                    SET TAB @ CURSOR      DEL. TAB AT
                                                            CURSOR
                 ^I                     ^OI,ESC               ^ON,ESC

Z              (NORMAL)               (NORMAL)              SUBSCRIPT       
                                                            ON/OFF
                                                              ^PV

X              (NORMAL)               (NORMAL)              SUPERSCRIPT
                                                            ON/OFF
                                                              ^PT

-/+/o key      CANCEL FUNCTION        TOP OF FILE           BOTTOM OF FILE
                 ^U                     ^QR                   ^QC

00             (COMMA)                (COMMA)                  00


6.4 How to turn a CP/M version of WordStar 3.21 into an MS-DOS version using DDT86

 
DDT86
DDT86 1.1
-RWS.CMD
START
03C0:0000
END
03C0:52FF
-S0324
03C0:0324 E9 90
03C0:0325 39 90
03C0:0326 00 C3
03C0:0327 E9 90
03C0:0328 4A 90
03C0:0329 00 C3
03C0:032A 01 00
03C0:0328 00 .
-S0356
03C0:0356 00 FF
03C0:0357 00 .
-WWS.COM,180,52FF

Use RDCPM to copy WS.COM and all overlays to an MS-DOS disc.Depending on the version of DDT86, and the version of the operating system, DDT86 may load to a different segment address. Start changing bytes at location 324 anyway. You may also find that some of your original bytes differ from those shown above, change them regardless.


6.5 Using the C.Itoh F10 printer with WordStar

To use the F10 with WordStar the switch pack SW41 (the right-hand set of switches under the front panel) should be set as follows:

O O C C C C C O C O

where O=Open and C=Closed.

Using the Install program supplied with WordStar select the C.Itoh/Starwriter printer option.

If you are using the Easifeed cut-sheet feeder then use the following codes at the top of each file:

.PL90
.MB32


to set the page length at 90 lines and the bottom margin at 32 lines.

6.6 Benchmark

Function keys 6 and 7 are implemented within Benchmark 3.0M Rev C, as described below:

ALT-function key 6 - Prints Content of Screen to Printer

This allows either a menu or any page within a document displayed on the screen to be sent out to a printer. Once ALT-function key 6 (ALT-F6) is pressed, the following message will be displayed on the bottom of the screen:

"Press:CONT to Print theScreen; F1 to Go to Top of Form; CAN to Skip"

To obtain a printout of the screen, press the PAUSE/CONT key.

Note: On the Sirius the CAN key is the DEL EOL key.

ALT-function key 7 - System Interrupt/Stop Print

While in "Print" mode, depression of ALT-function key 7 (ALT-F7) will stop the printing of a document. The following message will appear at the bottom of the screen:

"Printer Interrupt, Restart Printer?; Press Y -Yes or N-No"

If "Y" is pressed, the document will continue to print. If "N" is pressed, all printing stops and the program will return to the main screen (create, revise, print, etc.).

6.7 XON/XOFF Printer Driver for WordStar

This patch uses the user-installed patch areas. To use this patch install Wordstar for user-installed printer driver and XON/XOFF protocol. Enter the patch starting at location 0811h.

Use the Wordstar Install program to make the patches. With Wordstar version 3.3 you must use DDT-86 (CP/M) or DEBUG (MS-DOS) to make the patches because the install program does not give you full access to the code.

Refer to the Wordstar Installation Guide and patch listings for further information

Before exiting the Wordstar Install program (or DDT-86 or DEBUG), check that the following locations have these values:

LOCATION
7C9h
7CAh
879h
NAME
CSWITCH
HAVBSY
PROTCL
VALUE
2
FFh
2

The patch uses direct I/O to the Sirius hardware serial port B. To use port A, change iostat to 2 and iodat to 0.


  E004         iobase  equ     0e004h      ; i/o port address
  0003         iostat  equ     3           ; status port (2=A, 3=B)
  0001         iodat   equ     1           ; data port (0=A, 1=B)  
  0001         instat  equ     1           ; input status mask
  0004         outstat equ     4           ; output status mask

                       org     811h
0811 E9 06 00          jmp     pubsy       ; test for printer busy
0814 E9 16 00          jmp     pusend      ; print a character
0817 E9 20 00          jmp     puinp       ; input a character
               pubsy:
081A BB 04 E0          mov     bx,iobase   ; point to i/o port
081D 8E C3             mov     es,bx
081F BB 03 00          mov     bx,iostat   ; point to status port
0822 26 8A 07          mov     al,es:[bx]  ; get status in AL
0825 24 04             and     al,outstat  ; bit 2=0 if busy
0827 75 02             jnz     pubsy1
0829 F9                stc                 ; return CY=1 if busy
082A C3                ret
               pubsy1:
082B F8                clc                 ; return CY=0 if not busy
082C C3                ret
                                 
               pusend:
082D BB 04 E0          mov     bx,iobase   ; point to i/o port
0830 8E C3             mov     es,bx   
0832 BB 01 00          mov     bx,iodat    ; point to data port
0835 26 88 07          mov     es:[bx],al  ; print data from AL
0838 F8                clc                 ; return CY=0 if done
0839 C3                ret
               puinp:
083A BB 04 E0          mov     bx,iobase   ; point to i/o port
083D 8E C3             mov     es,bx
083F BB 03 00          mov     bx,iostat   ; point to status port
0842 26 8A 07          mov     al,es:[bx]  ; get status byte in AL
0845 24 01             and     al,instat   ; bit 0=0 if no data
0847 74 08             jz      puinp1
0849 BB 01 00          mov     bx,iodat    ; data ready, so get it
084C 26 8A 07          mov     al,es:[bx]
084F F8                clc                 ; CY=0 if we have data
0850 C3                ret
               puinp1:
0851 F9                stc                 ; CY=1 if no data ready
0852 C3                ret






All contents of this website (including text, images, design, and presentation) are Copyright � 1999-2005,
ACT Sirius 1 User Group (UK) unless explicitly stated otherwise. All Rights Reserved.

Last revision 29/01/2005