Contents
Welcome to Qedit 13
Introduction......................................................................................................... 13
Documentation..................................................................................................... 14
User Manual........................................................................................ 14
Printed Documentation........................................................................ 14
Other Documentation............................................................................................. 14
Printdoc Program................................................................................. 14
Other Manuals of
Interest.................................................................... 15
Customer Support................................................................................................. 15
Robelle Newsletter................................................................................................ 15
QLIB and Bonus
Contributed Software..................................................................... 15
Notation.............................................................................................................. 16
Highlights 18
Highlights In Version 6.3........................................................................................ 18
Highlights In Version 6.2........................................................................................ 18
Highlights In Version 6.1........................................................................................ 18
Highlights In Version 6.0........................................................................................ 18
Installing Qedit 19
General Installation
Notes....................................................................................... 19
Who Should Use These
Instructions?................................................. 19
Summary of
Installation Steps............................................................ 19
Qedit Compiler
Interfaces................................................................... 19
Important Note About
Passwords........................................................ 20
STREAMX Users................................................................................ 20
Step 1: Install
Qedit............................................................................................... 20
Step 2: Install QLIB
and Bonus Programs.................................................................. 22
Building the Spell
Dictionary.............................................................. 22
Step 3: Install NM
Compiler Interface....................................................................... 23
Installing the
Interface......................................................................... 23
Compiling
Instructions........................................................................ 23
Step 4: Install CM
Compiler Interface....................................................................... 24
Choosing a CM
Installation Method................................................... 24
Integrating CM
Compiler Changes..................................................... 24
Isolating CM
Compiler Changes......................................................... 25
Step 5: Saving Disc
Space...................................................................................... 25
Purging Obsolete
Files........................................................................ 25
Minimal Set of Files............................................................................ 25
Moving Qedit to
Another Account............................................................................ 26
Moving All the Files............................................................................ 27
Redirecting the File
Names................................................................. 27
Moving a
"Hooked" Qedit................................................................... 27
Running the
MPEXHOOKed Qedit.................................................... 28
Removing the
Compiler Interface............................................................................. 29
Removing the NM
Interface................................................................ 29
Removing the
Integral CM Interface.................................................. 29
Removing the
Isolated CM Interface.................................................. 30
Getting a Quick
Start with HP Full-Screen Editing 31
Introduction......................................................................................................... 31
Starting Visual Mode............................................................................................. 32
Screen Layout...................................................................................................... 33
Home Line........................................................................................... 33
Status Line........................................................................................... 33
Text Lines............................................................................................ 34
Template Line..................................................................................... 34
Special Indicator
Columns.................................................................. 34
Using Your Keyboard............................................................................................ 35
Moving the Cursor............................................................................... 35
Editing the Text
Lines......................................................................... 35
Control Functions................................................................................ 36
Reflection for DOS
Keyboards........................................................... 36
Other PC Keyboards............................................................................ 37
Function Keys...................................................................................................... 37
Browsing Through
Your File................................................................................... 39
Cut-and-Paste....................................................................................................... 40
Cutting Operations.............................................................................. 40
Pasting Operations............................................................................... 40
Resetting
Cut-and-Paste...................................................................... 41
Copying a Block of
Text..................................................................... 41
Cut-and-Paste
Between Files.............................................................. 42
Dividing and Gluing
Operations......................................................... 42
Dividing Lines in
Visual Mode........................................................... 42
Gluing Lines in
Visual Mode.............................................................. 43
Excluding
Lines From Visual Mode Display...................................... 43
Justifying Lines in
Visual Mode......................................................... 44
Renumbering Lines............................................................................. 44
Inserting Blank
Lines.......................................................................... 44
Hold Files............................................................................................ 44
Marking Changes
Without Using Line Numbers................................ 45
Paste from a
Non-Qedit File................................................................ 45
Home Line Commands........................................................................................... 46
Finding Strings.................................................................................... 46
Changing Strings................................................................................. 47
Help on Visual Mode.......................................................................... 47
Compile, Link, and
Run...................................................................... 47
Formatting
Paragraphs........................................................................ 48
Undoing Changes in
Visual Mode...................................................... 48
Refreshing the
Screen.......................................................................... 48
Other Line Mode
Commands.............................................................. 49
Truncated Home Line.......................................................................... 49
Exit from Visual.................................................................................. 49
Getting a Quick
Start with Line Mode Editing 51
Introduction......................................................................................................... 51
Adding Lines to a
File............................................................................................ 51
Looking at the File................................................................................................ 52
Browsing the File.................................................................................................. 53
Searching the File................................................................................................. 53
Editing Lines........................................................................................................ 54
Global Changes.................................................................................................... 55
Copying Lines...................................................................................................... 57
Moving Lines....................................................................................................... 57
Deleting Lines...................................................................................................... 58
Help Command.................................................................................................... 58
Saving the File..................................................................................................... 59
Open and Shut for
Instant Access............................................................................. 59
Running Qedit under
MPE 61
Introduction......................................................................................................... 61
Edit in Line Mode or
in Full-Screen Mode................................................................. 61
Edit Several Files
at Once....................................................................................... 62
Qeditmgr
Configuration Files.................................................................................. 62
Limiting Compile
Priority................................................................... 63
Default Set Commands........................................................................ 63
Using Qedit in Batch............................................................................................. 64
Summary of Parm=
Values..................................................................................... 64
From the Posix Shell........................................................................... 65
Exit and Entry
Options........................................................................................... 65
Exit with Verify................................................................................... 65
Info= First File to
Edit......................................................................... 66
Random Name for
Primary Scratch File............................................. 66
"Discard
Changes?" on Exit................................................................ 66
Info= "-p
99" Specifies Parm Value.................................................... 67
Info= "-c
cmdstring"............................................................................ 67
Parm 512 to Edit a
Single File............................................................ 68
Info= An Empty File
to Fill................................................................. 68
Info= Temporary File.......................................................................... 68
Info= Can Create New
Files................................................................ 69
Parm Values to
Suspend or Not.......................................................... 69
Info= Commands Only........................................................................ 69
Basicentry Option................................................................................ 70
JCWs That Drive
Qedit.......................................................................................... 70
RCRTMODEL JCW........................................................................... 71
RPCVERSION JCW........................................................................... 73
RCRTWIDTH JCW............................................................................ 73
RCRTSTRAPSGH for
Handshaking.................................................. 74
RLABELDEFAULT JCW.................................................................. 76
QEDITMGRTRACE JCW.................................................................. 76
QEDPARMBITS JCW........................................................................ 77
QEDCURWFILE Variable.................................................................. 77
QEDSTOREDPWD and
QEDPROMPTEDPWD Variables.............. 77
Qedit for Microsoft
Windows 79
Introduction......................................................................................................... 79
Server Process...................................................................................................... 79
Logon Sequence.................................................................................. 79
QEDSERVMODE JCW...................................................................... 80
Log Files............................................................................................................. 81
Qedit Issues and
Solutions 83
Running Qedit with
Reflection................................................................................ 83
RPCVERSION JCW........................................................................... 83
Using a Command File
to Start Up..................................................... 83
Alt-Y vs. :Reflect................................................................................ 84
Qedit and Reflection
File Transfers.................................................... 84
Form Feed Causing
Return/Line Feed................................................ 85
Typeahead and Visual
Mode............................................................... 86
Completion Codes............................................................................... 86
Controlling the PC............................................................................... 86
Accidental Exit from
Reflection......................................................... 86
Changing the Exit
Keystroke.............................................................. 87
Running Qedit in
MPE/iX....................................................................................... 88
Unresolved Externals
on MPE/iX 4.0................................................. 88
Compiling on MPE/iX......................................................................... 88
XDB: the Symbolic
Debugger............................................................ 88
Command Files and
Variables............................................................ 89
Visual Mode........................................................................................ 89
EOF vs. LIMIT.................................................................................... 89
Disc Space for Files
and Xltrim.......................................................... 89
Extents................................................................................................. 90
Qedit as the HPDesk
Editor..................................................................................... 90
Configuring HPDesk........................................................................... 90
Configuring Qedit in
HPDesk............................................................. 91
DeskQed.............................................................................................. 91
Getting Programs to
Read Qedit Files....................................................................... 92
Qinput.................................................................................................. 92
Qcompxl.............................................................................................. 92
Qeditaccess
Subroutine....................................................................... 93
Qedify.................................................................................................. 93
Qedify and $Include............................................................................ 94
Editing Wide Files................................................................................................ 95
Using the New
Command................................................................... 95
Using the Text
Command.................................................................... 95
Lines, Strings and
Ranges....................................................................................... 96
Using Qedit with MPE
Programming Languages 99
Introduction......................................................................................................... 99
Editerr: Trapping
Compiler Errors............................................................................ 99
Limitations and
Restrictions.............................................................. 100
Linking PowerHouse
with Qedit............................................................................. 101
Invoking PowerHouse
from Qedit.................................................... 102
Configuring Qedit as
Your Editor..................................................... 103
Editing PowerHouse
Subfiles............................................................ 104
COBOL............................................................................................................. 104
Selecting a Compiler......................................................................... 104
Sequence Numbers and
Comments................................................... 104
Tagging Source
Changes................................................................... 105
Copylib Members.............................................................................. 105
Trapping Syntax
Errors..................................................................... 106
FORTRAN........................................................................................................ 106
Pascal............................................................................................................... 106
C Language........................................................................................................ 107
SPL.................................................................................................................. 107
TRANSACT...................................................................................................... 108
RPG.................................................................................................................. 108
BASIC.............................................................................................................. 109
Segmenter.......................................................................................................... 109
Common Uses of Qedit 111
Introduction....................................................................................................... 111
Qedit as Word
Processor....................................................................................... 111
QNote UDC for
Occasional Memos................................................. 111
Justify Capability............................................................................... 112
Check Spelling.................................................................................. 112
Prose: A Text
Processor.................................................................... 113
Using TDP from
within Qedit........................................................... 114
Qedit as a File
Utility........................................................................................... 114
Sorting a Range of
Lines................................................................... 115
Searching Groups of
Files for Strings............................................... 115
Editing Data Files.............................................................................. 116
Editing Program
Files........................................................................ 119
Qedit as an
Operations Tool.................................................................................. 119
Editing Stream Files.......................................................................... 119
Native-Mode Output
Spool Files...................................................... 119
Editing Bells, Tabs
and Escapes....................................................... 120
Aborting All Users
to Back Up......................................................... 120
Qedit Commands 123
Introduction....................................................................................................... 123
General Notes..................................................................................................... 123
Abbreviations.................................................................................... 123
Uppercase or
Lowercase................................................................... 124
Multiple Commands
per Line........................................................... 124
Comments on Command
Lines......................................................... 124
STREAMX Warning......................................................................... 125
Stopping Commands
with Control-Y................................................ 125
Implicit Commands........................................................................... 125
Function Keys.................................................................................... 126
Command Files and
UDCs................................................................ 126
MPE Commands................................................................................ 127
Differences from MPE...................................................................... 127
Calculator Commands....................................................................... 128
QEDITCOUNT JCW........................................................................ 128
QEDCURWFILE Variable................................................................ 128
External Program
Commands........................................................... 128
:Activate Command [AC/:A]................................................................................. 129
Add Command [A].............................................................................................. 130
Add (Adding New
Lines).................................................................. 130
Add (Adding a String
as a Line)....................................................... 132
Add (Copying Lines
within a File)................................................... 133
Add (Moving Lines
within a File)..................................................... 134
Add (Copying Lines
Between Files)................................................. 135
Append Command [AP]....................................................................................... 136
Backward Command
[BA/F5]................................................................................ 137
Before Command [B]........................................................................................... 138
:Beginfile and
:Endfile Commands......................................................................... 140
Change Command [C].......................................................................................... 141
Change (Changing
Strings)............................................................... 141
Change (Changing
Columns)............................................................ 144
Close Command [CL].......................................................................................... 146
Colcopy
Command [COL]................................................................................... 147
Colmove
Command [COLM]................................................................................ 150
:Compile Command
[CO/:C]................................................................................. 153
Delete Command [D]........................................................................................... 157
Destroy Command
[DES/:D]................................................................................. 159
:Display Command
[DISPLAY]............................................................................. 160
Divide Command [DI].......................................................................................... 161
:Do Command [DO]............................................................................................ 162
:Editerror Command
[EDITERROR]....................................................................... 163
:Escape Command
[ESCAPE]............................................................................... 165
Exit Command [E/F8].......................................................................................... 166
Find Command [F/F4].......................................................................................... 167
Findup Command
[FINDU/F3].............................................................................. 169
Form
Command [FORM]...................................................................................... 170
Forward Command
[FO/F6].................................................................................. 171
Garbage Command
[GAR].................................................................................... 172
Glue Command [G]............................................................................................. 174
Help Command [H/?]........................................................................................... 176
Hold Command [HO]........................................................................................... 178
:If, :Endif, :Else,
:Elseif Commands........................................................................ 179
Justify Command [J]............................................................................................ 180
Keep Command [K]............................................................................................. 187
:Kill Command
[KI/:K]........................................................................................ 191
List Command [L]............................................................................................... 192
:Listredo Command
[LISTREDO/F7]...................................................................... 207
:Listundo Command
[LISTU]................................................................................ 208
Lsort Command [LS]........................................................................................... 209
Merge Command [ME]........................................................................................ 210
Modify Command [M]......................................................................................... 212
New Command [N].............................................................................................. 225
Open Command [O]............................................................................................. 227
:Pause Command
[PAUSE]................................................................................... 231
:Prep Command
[PREP/:P]................................................................................... 232
Proc Command [P].............................................................................................. 234
Q Command [Q]................................................................................................. 237
/Qedit Command................................................................................................. 238
:Qhelp Command
[QHELP].................................................................................. 239
:Redo Command [REDO]..................................................................................... 240
:Reflect Command
[REFLECT]............................................................................. 242
Renumber Command
[REN].................................................................................. 245
Replace Command [R]......................................................................................... 246
:Return Command
[RETURN]............................................................................... 248
:Run Command [RU/:R]....................................................................................... 249
Run, Implied...................................................................................................... 253
:Segmenter Command
[SEG/:S]............................................................................. 254
Set Command [S]................................................................................................ 255
Account............................................................................................. 257
Alias................................................................................................... 258
Autocont............................................................................................ 260
Check................................................................................................. 260
Decimal............................................................................................. 261
DL size.............................................................................................. 261
Editinput............................................................................................ 262
Expandtabs........................................................................................ 263
Extentsize.......................................................................................... 263
Extprog.............................................................................................. 263
Filename............................................................................................ 264
FORTRAN........................................................................................ 264
HFS.................................................................................................... 265
Halfbright.......................................................................................... 266
Hints.................................................................................................. 266
Hppath............................................................................................... 266
Increment........................................................................................... 266
Interactive.......................................................................................... 267
Justify................................................................................................ 267
Keep................................................................................................... 268
Language........................................................................................... 273
Left.................................................................................................... 276
Length................................................................................................ 277
Lib..................................................................................................... 277
Limits................................................................................................. 277
List..................................................................................................... 278
Maxdata............................................................................................. 279
Modify............................................................................................... 279
Open.................................................................................................. 281
Pattern................................................................................................ 282
Priority............................................................................................... 282
Prompt............................................................................................... 283
Redo................................................................................................... 283
Right.................................................................................................. 285
RL file name...................................................................................... 285
Shift................................................................................................... 285
Spell................................................................................................... 286
Statistics............................................................................................. 287
Stringdelimiters................................................................................. 287
Suspend............................................................................................. 288
Tabs................................................................................................... 289
Term.................................................................................................. 289
Text.................................................................................................... 290
Totals................................................................................................. 292
UDC................................................................................................... 292
Undo.................................................................................................. 293
Varsub............................................................................................... 293
Visual................................................................................................. 294
Warnings........................................................................................... 307
Whichcomp....................................................................................... 307
Window............................................................................................. 308
Work.................................................................................................. 309
Wraparound....................................................................................... 311
X........................................................................................................ 312
YNone............................................................................................... 316
Zip..................................................................................................... 316
Shut Command [SH]............................................................................................ 318
Spell Command [SP]............................................................................................ 320
:Stream Command
[STREAM].............................................................................. 322
:Tdpfinal and
:Tdpdraft Commands........................................................................ 323
Text Command [T].............................................................................................. 324
Undo Command [UN].......................................................................................... 332
Up Command [UP/F2]......................................................................................... 334
Use Command [U]............................................................................................... 335
Verify Command [V]........................................................................................... 336
Visual Command
[VI/F1]...................................................................................... 337
:While and :Endwhile
Commands........................................................................... 339
Words Command [W].......................................................................................... 340
:Xltrim Command
[XLTRIM]................................................................................ 341
Zave Command [Z]............................................................................................. 342
ZZ Command..................................................................................................... 343
User Defined Commands...................................................................................... 344
Command Files................................................................................................... 349
Calculator Command
[=]...................................................................................... 353
POSIX Commands [!].......................................................................................... 356
Troubleshooting and
Error Messages 357
Introduction....................................................................................................... 357
Messages........................................................................................................... 357
System Errors..................................................................................................... 360
Quit Errors......................................................................................................... 361
Errors in Visual................................................................................................... 361
Using Visual with
X.25..................................................................... 361
Using Visual on
MPE/iX................................................................... 361
Accidental
Invocation of MPE/iX CI................................................ 361
Using Visual on
HP-UX.................................................................... 362
Terminals Supported
by Visual......................................................... 362
Problems with 700/9x
Terminals...................................................... 362
Visual Error
Messages....................................................................... 363
Analyzing Compiler
Problems............................................................................... 365
QCOMPXLTRACE JCW................................................................. 366
Control-Y and NM
Compiles............................................................ 366
How to Bypass
Qcompxl................................................................... 366
Problems with HP's C
Compiler........................................................ 366
Unresolved External
Reference......................................................... 367
Illegal Characters............................................................................... 367
Pascal/V Compiler
Stack Overflow.................................................. 367
File Formats 369
Introduction....................................................................................................... 369
Qedit Workfiles.................................................................................................. 369
Original Format
Workfiles.................................................................................... 369
Jumbo Workfiles................................................................................................. 370
External Files..................................................................................................... 371
Error Files for
Editerror........................................................................................ 374
Prefix Characters
& Data.................................................................. 374
User Routines 377
Introduction....................................................................................................... 377
Wide Lines and User
Procedures............................................................................ 377
"Init"
Interface Procedure...................................................................................... 378
"Com"
Interface Procedure.................................................................................... 379
"Add"
Interface Procedure.................................................................................... 380
"Exit"
Interface Procedure..................................................................................... 381
Installing Your
Interface Procedures....................................................................... 381
Alternate Activation............................................................................................. 382
The Modify User Hook......................................................................................... 383
Writing a User
Procedure...................................................................................... 383
DL Space........................................................................................................... 384
Passing Procspace
Values..................................................................................... 384
Communication Flags
for User Code....................................................................... 385
Qcopy 387
Introduction....................................................................................................... 387
Accessing Qcopy................................................................................................. 387
Qcopy Documentation.......................................................................................... 388
Qedit-Compatible
Software Tools 389
Introduction....................................................................................................... 389
Compare/iX....................................................................................................... 389
OMNIDEX........................................................................................................ 390
Adager.............................................................................................................. 390
CCS - Corporate
Computer Systems....................................................................... 390
Reflection.......................................................................................................... 390
ROBOT............................................................................................................. 391
PowerHouse....................................................................................................... 391
Splash for
Native-Mode SPL................................................................................. 391
Documentation/3000............................................................................................ 391
Prose Text Formatter............................................................................................ 391
Spell: Spelling
Checker........................................................................................ 392
Qhelp Help System.............................................................................................. 392
TRANSACT...................................................................................................... 392
MPEX and STREAMX........................................................................................ 392
SCOMPARE and
ANALYZER.............................................................................. 393
Xpedit Full-Screen
Editor..................................................................................... 393
Nuggets............................................................................................................. 393
Fantasia............................................................................................................. 394
TDP.................................................................................................................. 394
Network Engine.................................................................................................. 394
Regular Expressions 395
Introduction....................................................................................................... 395
Metacharacters.................................................................................................... 395
Character Class................................................................................................... 397
Escape Character................................................................................................. 399
Escaped Sequences in
Regular Expressions.............................................................. 400
Backreferences in
Regular Expressions.................................................................... 401
Escaped Characters
in Replacement String............................................................... 402
Qedit Glossary 403
Introduction....................................................................................................... 403
Terms............................................................................................................... 403
Abbreviating...................................................................................... 403
Batch.................................................................................................. 403
Calculator.......................................................................................... 404
Column.............................................................................................. 404
Command.......................................................................................... 405
Control Character.............................................................................. 405
Copylib Members.............................................................................. 406
CRT................................................................................................... 406
Current Line...................................................................................... 406
Defaults............................................................................................. 407
External File...................................................................................... 407
File Names......................................................................................... 408
Full-Screen Editing........................................................................... 409
Hold File............................................................................................ 409
J Option............................................................................................. 409
Jumbo Files........................................................................................ 409
Keep File........................................................................................... 410
Language........................................................................................... 410
Left.................................................................................................... 410
Length................................................................................................ 410
Line.................................................................................................... 411
Linenum............................................................................................. 411
Looping............................................................................................. 412
Margins.............................................................................................. 412
Member............................................................................................. 412
Memory Lock.................................................................................... 412
MPE Command................................................................................. 413
Patterns.............................................................................................. 413
Procedure........................................................................................... 414
Qeditscr............................................................................................. 414
Quiet-Q Option.................................................................................. 415
Range................................................................................................. 415
Rangelist............................................................................................ 416
Relative Line
Numbers...................................................................... 417
Right.................................................................................................. 418
Shifting.............................................................................................. 418
Size.................................................................................................... 418
Spool Files......................................................................................... 418
$Stdin / $Stdinx................................................................................. 419
$Stdlist............................................................................................... 419
String................................................................................................. 419
Tab..................................................................................................... 420
Template-T Option............................................................................ 420
UDC................................................................................................... 420
Visual Editing.................................................................................... 420
Window............................................................................................. 420
Workfile............................................................................................. 422
Special Characters............................................................................................... 422
? Means Help,
Nonprinting Characters, Alphanumeric (in Patterns) or Optional (in Regexp) 422
$ Means Hex,
Standard File, Memory Lock, List Option, Previous File or End-Of-Line (in
Regexp) 423
^ Means Findup,
Control-Char, Start-of-line (in Regexp) or Negate (in Regexp) 424
. Means Nonprinting,
Reset, Decimal Point or Any Character (in Regexp) 424
! Means Posix
Command or Too Long............................................. 425
% Means Octal or
String................................................................... 425
* Means Current,
Refresh, Multiply or Quantifier (in Regexp)........ 425
\ Means Previous,
String, Literal Match (in Regexp) or Special Characters (in Regexp) 426
/ Means Prompt,
Range Delimiter, Stop, Exit, or Divide.................. 427
[ Means FIRST,
[default] or Start Class (in Regexp)........................ 427
] Means LAST or End
Class (in Regexp).......................................... 427
{ } Are for Comments
or Indentation................................................ 428
@ Means ALL................................................................................... 428
& Means Literal
Match or Continue MPE Command...................... 428
: Means MPE or
String...................................................................... 429
; Means Multiple
Commands............................................................ 429
, Means a List.................................................................................... 429
= Means Copy or
Calculate............................................................... 430
< Means Move, I/O
Redirection or Backward Page......................... 430
> Means Forward
Page, I/O Redirection, Modify or Qhelp.............. 430
" Means String................................................................................... 431
( Means Start
Parameter, Member, Command or Subpattern (in Regexp) 431
) Means End
Parameter, Member, Command or Subpattern (in Regexp) 431
+ Means Ahead Some
Lines, Add or Quantifier (in Regexp)........... 432
- Means Back Some
Lines, Minus or Range (in Regexp)................. 432
# Means Numeric
Pattern, Spool File or Previous Result................. 433
~ Means Spaces
(Pattern), Recent Page or Field.............................. 433
How to Contact
Robelle 435
Introduction....................................................................................................... 435
Index 437
Welcome to Qedit, the fast, full-screen
text editor for MPE and HP-UX. To get into Qedit, enter this MPE command:
Qedit version 6.1
has screen-editing, function keys and commands:
Commands:
|
Add
|
FINDUp
|
Open
|
ZZ
|
|
Add(=copy)
|
FORM
|
Proc
|
%ext
|
|
Add(<move)
|
FORward
|
Q
|
shell
|
|
Add(=file)
|
GARbage
|
REDO
|
|
|
Append
|
Glue
|
RENum
|
|
|
BAckward
|
Help
|
Replace
|
|
|
Before
|
HOld
|
Set
|
|
|
Change
|
Justify
|
SHut
|
|
|
COLcopy
|
Keep
|
SPell
|
|
|
COLMove
|
List
|
Text
|
|
|
Delete
|
LISTREDO
|
UNDo
|
COmp
|
|
DEStroy
|
LISTUndo
|
Use
|
RUN
|
|
Divide
|
LSort
|
Verify
|
Mpe
|
|
DO
|
MErge
|
VIsual
|
Udc
|
|
Exit
|
Modify
|
Words
|
Cmdfile
|
|
Find
|
New
|
Zave
|
=calc
|
Function
Keys:
|
F1 Upd Next/Visual
|
F2 Roll Up
|
F3 Findup
|
F4 Find
|
|
F5
Backward
|
F6
Forward
|
F7
Do ===>
/LISTREDO
|
F8
Exit
|
Qedit
comes with a User Manual and a Change Notice. You may have received printed
copies of these. If you wish to have printed copies, you can order them by
filling out the form on our web site.
They
are also available as PDF or HTML files. You can download the files from the
Robelle web site at: http://www.robelle.com/library/manuals/.
The
user manual contains the full description of all the Qedit commands, as well as
usage tips. The manual is up-to-date with all the latest changes incorporated
in Qedit.
The
latest user manual and change notice are available in Adobe PDF format. If you
do not already have the Adobe Acrobat reader, you can get a copy from http://www.adobe.com/prodindex/acrobat/readstep.html. If you wish to have
printed copies, you can order them by filling out the form on our web site.
In addition to the Qedit User Manual and
Qedit Change notice, there are other
manuals that come with Qedit. Manuals for bonus programs and the
contributed library are available in Robelle's Prose format, not in PDF format.
They are found in the Robelle account on
the HP e3000, and are printed using the Printdoc program. Printdoc prints the manual on your
printer, whether LaserJet or line printer.
To print them on your printer, whether
LaserJet or line printer, run the Printdoc program.
:run
printdoc.pub.robelle
Printdoc is menu-driven, and very easy to
use. Printdoc asks you for information, and if you are not sure of your answer,
you can ask for help by typing a question mark (?) and pressing the Return key.
There are two steps for printing a manual: first, choose one of the manuals on
the menu; second, select a printer. Printdoc supports most types of LaserJet
printers and regular line printers.
You may want to print at least one copy
of these manuals:
prose.qlibdoc.robelle {text formatter}
spell.doc.robelle {Bonus spelling checker}
contents.qlibdoc.robelle {contributed library}
howmessy.doc.robelle {Bonus database analyzer}
You can print any Robelle document if you
know the file name. If you wish, you can include the file name in the :Run
command. For example, to print the Spell User Manual, type
:run
printdoc.pub.robelle;info="spell.doc.robelle"
When you purchase Qedit, customer support
is included for the first year. After the first year, there is a yearly
Maintenance fee. If you are a Right-to-Copy user at a branch of a larger
company, you have two options. If you pay only the one-time Extra CPU surcharge,
then you must obtain your support from your own corporate resources. If you
wish to have support at your own location, you may obtain this by also paying
the regular Maintenance fee. With this yearly support for Qedit, you are
entitled to call with questions. Service also supplies you with a yearly update
to Qedit.
Do you receive a copy of What's Up, DOCumentation?, our regular
news memo about Robelle, MPE, and HP-UX? We distribute our news memos only to
sites with current service. Your copy may be going to your corporate
headquarters.
The lastest newsletter is also available
from our Web site at www.robelle.com/newsletter/.
Qedit comes with an array of contributed software in the QLIB
library (in the QLIB groups of the Robelle account). The tools in QLIB, such as
Prose to print manuals, can be extremely handy. As well, your Robelle license
may entitle you to receive our Bonus programs: Compare/iX, a file comparison
tool, HowMessy, an analyzer for database efficiency, Select, a menu processor,
Spell, an English spelling checker, and Xpedit, a VPLUS text editor.
If you have the Bonus programs, you may
only use them on appropriately licensed CPUs; you may not give a Bonus program
away. However, QLIB programs may be used on any CPU and given away freely.
To
browse through the Robelle account, including QLIB, use our Select
"menu" program. Select allows you to run programs, get help, and
print manuals, all without knowing any MPE commands.
:run
select.pub.robelle,qlib
Compare/iX compares two
text files (Keep or Qedit format) and prints out the differences. The basic comparison
unit is a line. Compare/iX identifies three types of differences: lines that
are in the first file but not in the second; lines that are in the second file
but not in the first; and lines that are in both files, but don't match. There
is no Classic version of Compare/iX for MPE V.
HowMessy analyzes a
database and prints a report on its internal efficiency, 10 to 20 times faster
than similar programs. To access HowMessy, log on as the database creator in
the same group as the database and enter:
:file
loadrept;dev=lp;cctl
:run
howmessy.pub.robelle
Enter database:CUSTMR
Spell is a spelling
checker that reads a file and produces a list of misspelled words. Spell comes
with an 80,000 word English dictionary, and you can add your own words into
global or local auxiliary dictionaries. Spell reads Qedit files, and has an
option to generate an error file that is compatible with the :Editerror
command.
This manual uses a standard notation to describe commands. Here is a
sample definition:
VERIFY [ @ | ALL ]
[
keyword ...]
UPPERCASE - If the commands and keywords
are shown in uppercase characters in a syntax statement, they must be entered
in the order shown (example: ALL).
However, you can enter the characters in either uppercase or lowercase.
1.
Lowercase, highlighted - These are
"variables" to be filled in by the user (example: keyword). The variables may be
highlighted by underlining or italics. Each such "variable" is
defined elsewhere (see the "Qedit
Glossary"
on page 331 when you have trouble). In the Help command, highlighting is not
available, so these variables appear simply in lowercase.
2.
Brackets - enclose optional
fields (example: [ALL]).
3.
Braces - enclose comments which
are not part of the command. However, braces and comments are accepted in
actual Qedit commands.
/listq filename {Q means without line numbers}
4.
Up lines - separate
alternatives from which you select (example: SET CHECK [ON|OFF]). The choices
are sometimes listed on several lines without "up lines".
5.
Dot-dot-dot (...) - indicates
that the variable may be repeated many times in the command.
6.
Other special characters -
literal symbols that must appear in the command as they appear in the manual
(for example, "=" in Add linenum
= rangelist).
In examples, there is an implied Return
key at the end of each line.
Control characters, generated by holding down Control while striking
another key, are either spelled out (e.g., Control-H) or abbreviated with a
circumflex prefix (e.g., ^H).
When
Qedit asks you a question, the default answer is shown in [brackets]. The
default is the answer that Qedit will assume if you press only the Return key.
This is
an overview of all the changes implemented in this version.
·
More
work has been done on reducing the dependence on the Calendar Intrinsic.
This is
an overview of all the changes implemented in this version.
·
The
Qedit Server Login on HP-UX would not honour administrative lock and other
security measures. The MPE release has had no changes.
This is
an overview of all the changes implemented in this version.
·
The
Verify command incorrectly parsed certain entries near the end of the verb
table such as ZZ, String etc.
·
The
Calendar intrinsic is being phased out of Qedit and all Robelle products, which
will help all products run past 2028.
· UDC’s would stop working properly if a Calc
command longer than 138 characters was entered.
Here we describe how to install and configure Qedit, and how to
integrate it with your compiler tools. The following are general notes about
installing Qedit.
Use the following
installation instructions if you have just purchased Qedit and are installing
it for the first time. If you already have Qedit on your system, and are
installing an update or pre-release of Qedit, you will find specific
installation instructions in the change notice included with your tape.
TRIAL
USERS: Refer to the Robelle Trial Handbook that accompanied your trial tape.
To install Qedit, follow these steps:
1.
Install Qedit
2.
Install the QLIB and/or Bonus
programs
3.
Fix the NM compilers (XL only)
4.
Fix the MPE V compilers (both
systems)
5.
Save disc space (optional)
Qedit edits compact files of a special
format called workfiles. In order to
be able to compile these files without doing a Keep command, you must
"fix" the MPE compilers. This applies to the Classic 3000 compilers
(CM), which might exist on either an MPE V or MPE/iX system, and the NM
compilers on MPE/iX only. The methods and installation steps are quite
different between the CM and NM Qedit compiler interfaces.
Many third-party tools either read Qedit
files already (e.g., PowerHouse, MPEX) or can be altered to read Qedit files
(techniques for doing this are discussed here).
None of the jobs that we supply have
passwords in them. Before streaming a job, you may have to add your system's
passwords to the first line. Users of MPE XL version 3.0 and higher do not have
to do this because the operating system prompts for missing passwords. The same
is true for some MPE V users who have security software that inserts passwords.
Most MPE V users have to edit the jobs. For example, if the system manager
logon password is Qwerty, you would do the following:
:editor
HP32201A.07.22
EDIT/3000
/text
robelle.job.robelle
FILE UNNUMBERED
/modify 1
MODIFY 1
!job
robelle,manager.sys,pub;hipri
i/qwerty
!job
robelle,manager.sys/qwerty,pub;hipri
/keep robtemp
/exit
END OF SUBSYSTEM
:stream robtemp
:purge robtemp
Users of STREAMX, a part of SECURITY/3000
from VESOFT Inc., must set a Job Control Word before streaming jobs. This step
prevents STREAMX from generating an error if the Robelle account does not yet
exist. For example,
:setjcw
streamxtempnonest 1
:stream
robelle.job.robelle
This step requires three separate
procedures: restoring all Robelle files from tape to disc, building (or
upgrading) the Robelle account using the job stream that we provide, and
streaming the installation job stream. All these procedures can easily be
accomplished if you log on as Manager.Sys.
Restore
Files
First, you have to restore all the Robelle files from tape.
:hello
manager.sys {log on as
system manager}
:file
rtape;dev=tape {mount
Robelle tape}
:restore *rtape;
@.@.@; create {=reply on the console}
Check
the :Restore listing for files that could not be restored because they were
busy for any of the following reasons: someone was using them, they are held as
suspended son processes (menu system), they are allocated, or someone was
backing them up! Chase away any users and deallocate any busy programs. Then
try the :Restore again.
Create/Update
Robelle Account
You must build (or upgrade) the Robelle account with the job stream
we provide. Stream the job that builds and updates the Robelle account.
:stream
robelle.job.robelle
If the Robelle account already exists on
your system, the installation job preserves the current passwords.
If the account does not exist, it is
created with the password XXXX. The Mgr.Robelle user does not have a password.
You should change the passwords to something that will be hard for outsiders to
guess.
:altacct
robelle;pass={robelle account password}
:altuser
mgr.robelle;pass={mgr.robelle user
password}
Please note that during installation, we
add OP capability to the Robelle account. When the Qedit installation is
complete, you can, if you wish, remove the OP capability.
File
Names
The Qedit program files are located in
the Pub group of the Robelle account. These are the names of the various files:
|
Qeditnm
|
|
NM Qedit program
|
|
Qeditcm
|
Qeditpm
|
CM Qedit programs
|
|
Qcompxl
|
|
NM compiler interface
|
|
Qedify
|
Qcompusl
|
CM compiler interface
|
|
Qloadxl
|
|
NM Qedit options
|
|
Ederrnm
|
Ederrcm
|
:Editerror support
|
|
Qmap
|
|
reformat MPE V PMAP
|
Install
Program Files
Our installation job installs Qedit. No
one can be using these programs when you do the installation. Warn people not
to use Qedit for a while, and then stream our installation job:
:hello mgr.robelle
:warn @;please exit
from Qedit NOW!
:stream
install.qeditjob {supply passwords}
Check the installation job $stdlist. If
anyone was using Qedit or attempting to back it up, the job will fail. Chase
away any users, ensure that backup is not in progress, then stream the
installation job again.
The installation job renames your current
versions of Qedit to the PubOld group of the Robelle account. If you need to
move these versions back into production, use the Previous.QeditJob job stream.
You can now access Qedit by entering
If you wish to print manuals, move Qedit
to another account, read on in this chapter for instructions.
Qedit comes with an array of contributed
software in the QLIB library (in the QLIB groups of the Robelle account). QLIB
programs may be used on any CPUs and given away freely. Your Robelle license
may also entitle you to receive our Bonus programs: Compare/iX, HowMessy,
Select, Spell, and Xpedit. These programs reside in the Pub group of the
Robelle account. Bonus programs can only be used on authorized machines, and
you may not distribute them to your friends.
If you
received Bonus programs with this version of Qedit, use the job stream called
Bonus.Job.Robelle to install both the QLIB and Bonus programs. If you did not
receive Bonus programs, use the job stream Qlib.Job.Robelle to install the QLIB
programs. If you skip this step, you may end up running old versions of these
programs.
:hello mgr.robelle
:stream bonus.job.robelle {or Qlib.Job.Robelle}
The Spell Bonus program requires an additional install job to build
its main dictionary. This job is required if you want to use Spell, and the
Spell and Words commands in Qedit. By default, the American spellings are used.
To use British spellings, modify the line that sets the SpellAmerican JCW so
that the JCW is set to False. This job stream could take 30 to 60 minutes to
complete; there is no reason to wait for it to finish before going on to the
next step.
:run
qedit.pub.robelle {or use
:Editor}
/text dictmain.spjob
/modify "setjcw
SpellAmerican" {for British
spelling, }
/keep robtemp { change True to False}
/exit
:stream robtemp
:purge robtemp
See the Spell user manual for more
information on using Spell.
On
MPE/iX, if you use any NM compilers, you will want to install the new NM
compiler interface. If you still use the CM compilers as well, you will want to
install that compiler interface too, as described under step 4.
Assuming
that you have Restored the Robelle files onto your system and that you have not
done this step before, stream Savecmdf.Qeditjob to make backup copies of the
existing HP command files in the Stdcmd.Sys group. You need to know the
Manager.Sys password:
:stream
savecmdf.qeditjob.robelle {wait for it to finish}
:listf @.stdcmd.sys
Then
stream Qcompxl.Qeditjob to make changes to the Pub.Sys compiler command files.
:stream
qcompxl.qeditjob.robelle
This stream makes the following changes
to the files:
1.
Change the run of the compiler
program to
;xl
="qcompxl.pubnew.robelle, qcompxl.pub.robelle",
2.
Add ";shr" to the
File commands for the text and master files.
At any point, either within Qedit or at the MPE/iX prompt, you now
should be able to compile a Qedit file or a Keep file, just by invoking the
normal command file:
:pasxl source {from MPE}
:run qedit.pub.robelle
/pasxl source {from Qedit}
Within Qedit, you can specify
"*" for the current workfile:
:run
qedit.pub.robelle
/text source
/pasxl *
/exit
:pasxl qeditscr
When
installing Qedit on MPE/iX, you may have to install the NM compiler interface
(described earlier) and the CM compiler interface (described here). MPE V, on
the other hand, has only the original "CM" compilers to worry about.
After Restoring the files from tape, you have to choose an installation method:
integral or isolated.
There
are two methods of fixing the compilers on your system: integral into Pub.Sys
or isolated in the Robelle account. The isolated method is best for new or
trial-period users, because it is faster to install and easier to remove later.
You can start with the isolated method and convert easily to the integral
method later.
Integral Method. The
compilers in Pub.Sys are "fixed" directly and a segment is added to
the System SL. The standard :Cobol and :Pascal commands of MPE will then
compile Qedit workfiles. :Sysdump is used to make a new cold load tape for the
next time you must boot the system.
Isolated Method. The MPE compilers are
copied into the Q.Robelle group and the original compilers are left in the
Pub.Sys group. No code is added to the System SL. Because the "Qedit"
compilers are not in Pub.Sys, you cannot compile Qedit workfiles except from
within Qedit.
The
job stream Qeditj1.Qeditjob.Robelle makes integral compiler fixes. Use it
either to update the fixes to a new version or to re-install the fixes after a
MPE update from HP. Because this job modifies the compiler program files in
Pub.Sys, you should :Store @.Pub.Sys before starting and save the tape. You need
another small tape for a new cold load tape.
Ensure that no one compiles until the
installation is complete. Stop all jobs and send an operator warning. Log on as
Manager.Sys, modify the first line of the Qeditj1 job to include the passwords,
then :Stream the job.
:stream
qeditj1.qeditjob.robelle
The
job runs Qedify.Pub.Robelle to update the compilers in Pub.Sys and install
nonprivileged hooks into them, so that they can access Qedit workfiles. The job
adds a code segment from Qcompusl.Pub.Robelle into Sl.Pub.Sys and then requests
a tape mount for a new cold load tape.
Mount a tape with a write ring and
:Reply. Save this tape and use it for any future cold loads. The CM compiler
interface is now installed. Compiles done inside or outside Qedit work on
either Qedit workfiles or on regular Keep files.
The
job stream Qeditj1a.Qeditjob.Robelle fixes the compilers, but isolates the
changes in the Q.Robelle group. Ensure that no one compiles until the
installation is complete. Stop all jobs and send an operator warning. Modify
the first line of Qeditj1a to include the Robelle password, then stream the
job:
:stream
qeditj1a.qeditjob.robelle
The job uses Qedify.Pub.Robelle to copy the compilers from Pub.Sys
to the Q.Robelle group, then "fix" them to read Qedit files. The
original compilers in the Pub.Sys group are not modified. Once this step is
completed you can use the CM compilers on Qedit files from within Qedit, but
not at the MPE prompt.
There may be obsolete or unnecessary files in the Robelle account
that you can remove to save disc space.
If you have been a Qedit user for several
years, you may have obsolete files in the Robelle account. For example, the
file Qapply.Doc.Robelle is an older version of part of the Qedit User Manual.
It should be purged.
To remove all obsolete files that were
part of the Qedit product, stream the job Obsolete.Qeditjob.Robelle.
If you are extremely short of disc space, you can purge many files
in the Robelle account after you complete all installation steps. The only
files you must have to run Qedit are those listed below. Of course, if you have
other Robelle products such as Suprtool, you do not want to purge the files
needed for them, which are listed in their User Manuals.
|
Filename
|
Purpose
|
|
qedit.pub.robelle
|
|
|
qloadxl.pub.robelle
|
optional NM run-time
|
|
qeditpm.pub.robelle
|
allows BS priority
|
|
qcompxl.pub.robelle
|
MPE/iX only
|
|
qedify.pub.robelle
|
CM compiler interface
|
|
qcompusl.pub.robelle
|
CM compiler routines
|
|
@.q.robelle
|
copies of CM compilers
|
|
qedit.help.robelle
|
|
|
qedhint.help.robelle
|
|
|
qzmodhlp.help.robelle
|
|
|
qmap.pub.robelle
|
for QMAP in :Prep command
|
|
prose.qlib.robelle
|
to print manuals, you need this
|
|
f92286f.qlibdata.robelle
|
and at least one font files
|
There are a number of jobs in the
Purgejob.Robelle group which can help clean up the Robelle account of unwanted
files. One in particular that you may want to use is Cleanup.Purgejob.Robelle.
After you have completed the Qedit installation, Cleanup gets rid of all the
pre-installation files.
:stream
cleanup.purgejob.robelle
Although
the Qedit program file is normally installed on the system Qedit.Pub.Robelle,
you can move the program to any account and group that has PH and DS
capability. There are some file names that are built into Qedit:
|
Filename
|
Purpose
|
|
qedit.help.robelle
|
the Qedit help text
|
|
qedhint.help.robelle
|
the hint-of-the-day file
|
|
qzmodhlp.help.robelle
|
help text for Qzmodify
|
|
qmap.pub.robelle
|
for QMAP option of :Prep
|
|
cobol.q.robelle
|
etc., the CM compilers
|
|
qeditmgr.pub.robelle
|
a configuration file
|
|
qloadxl.pub.robelle
|
NM run-time routines
|
Qedit follows the location of the program file in deciding what file
names to open. If you move the Qedit program to the PUB group of the UTIL
account, Qedit looks for the files listed above in that account rather than
Robelle. If Qedit resides in a group named Pubnew (or Pubxxx), the three
"help" files will be searched for in HELPNEW (or HELPxxx). The
Qeditmgr file is always assumed to be in the same group as the Qedit program,
while Qmap must be in the Pub group and the CM compilers in the Q group.
:hello mgr.util,pub
:fcopy
from=qedit.pub.robelle;to=qedit.pub.util;new
:fcopy
from=qloadxl.pub.robelle;to=qloadxl.pub.util;new
:fcopy
from=qedit.help.robelle;to=qedit.help.util;new
:fcopy
from=qedhint.help.robelle; &
to=qedhint.help.util;new
:fcopy
from=qzmodhlp.help.robelle; &
to=qzmodhlp.help.util;new
:fcopy
from=qmap.pub.robelle; &
to=qmap.pub.util;new
The Verify Account command shows what account Qedit searches for the
Qeditmgr file, Qmap.Pub, and the CM compilers. Use Set Account to override the
default. The Verify Filename command shows the names assumed for the
"help" files and Set Filename allows you to override them.
Suppose you run Qedit in the Util
account, but you don't want to move the rest of the files to that account. You
would use Set Account Robelle and Set Filename commands to force Qedit to look
back into Robelle for the files instead of in Util.
When
you install MPEX and the Vesoft account, they make a copy of Qedit in
Pub.Vesoft and "hook" it for closer cooperation with MPEX.
:run
qedit.pub.vesoft;lib=p
Since Qedit looks for compilers, help
files, and other supporting files in the same account where the program
resides, the hooked Qedit looks for those files in the Vesoft account. If you
are on MPE/iX and you want I/O redirection of command files, copy the file
Qloadxl from Robelle to Vesoft. Put the following Set commands in a
configuration file named Qeditmgr.Pub.Vesoft:
/set account
robelle {e.g., Cobol.Q.Robelle}
/set filename help
qedit.help.robelle
/set filename hint
qedhint.help.robelle
/set filename qzmodhlp
qzmodhlp.help.robelle
/set extprog
mpex.pub.vesoft com on
The Set Extprog command assumes that you
want Qedit to explicitly pass % commands to MPEX, rather than have the
"hook" intercept all % lines at every prompt in Qedit. It is
desirable to handle % commands within Qedit this way, rather than through the
hook, because it ensures that your current workfile is properly posted to the
disc and it allows you to Add % commands into a file as data without executing
them. To achieve this result, you must rehook Qedit with the Nopercent option:
:run
mpex.pub.vesoft
%hook
qedit.pub.robelle;nopercent {SM or
Vesoft logon}
You may not find that you need a hooked
Qedit, now that Qedit has a :Listredo stack and accepts the VESOFT-style
shorthand ("," for Redo). Some remaining benefits of hooking Qedit
are that the System Manager can Keep across account boundaries (but watch out
for Creator name), and ACD information is retained from Text to Keep.
The
MPEXHOOK procedure, which intercepts file system calls made by Qedit, is
activated differently based on whether the program to be executed is a
native-mode or a compatibility-mode program. On Classic systems, or on Spectrum
systems running compatibility-mode or OCT-mode Qedit, you run the hooked
program with lib=p.
:run
qedit.pub.vesoft;lib=p
Lib=P works equally well with the native
mode version of Qedit. However, with Qedit/iX, you can specify an XL file
instead of the Lib parameter:
:run
qedit.pub.vesoft;xl="mpexhknl.pub.vesoft"
The hooked version will work version either
way. The Lib parameter is there for MPE compatibility reasons (Classic vs
PA-RISC). The XL file parameter is the "correct" way of doing it on
MPE/iX.
The following sample User Command, which
can be used to run the hooked version of Qedit, determines if Qedit is
native-mode or compatibility- mode, and invokes it accordingly.
parm runparm=0
if
finfo("qedit.pub.vesoft",9)="NMPRG" then
run
qedit.pub.vesoft;xl="mpexhknl.pub.vesoft";parm=!runparm
else
run qedit.pub.vesoft;lib=p;parm=!runparm
endif
VESOFT advises that you be running MPEX
version 23.11115 or later, so that the Keep-across-accounts feature will work
properly with Qedit/iX.
If Qedit/iX aborts with quit parm -50 or
-1041, this indicates that the MPEXHOOK support routines are not correctly
installed on your system. You will have to stream the VESOFT-supplied job
Veproc.Job.Vesoft. If the hooked Qedit/iX still aborts after running this job,
you will need to contact VESOFT for a software update.
If you remove Qedit from your system, you
will want to revert to the original MPE compilers. Once you remove the compiler
interface you can no longer compile Qedit workfiles. you may either Keep them
with Qedit, or use the contributed program Qcopy.Qlib.Robelle to convert them
to Keep files.
If you did an integral installation of
the CM compiler interface, you now do an integral removal. If you did an isolated
installation, you now do an isolated removal.
Reverting to the original NM compilers is
a simple matter of going back to the original command files. You should have
saved those in @.Stdcmd.Sys. Purge the command files in Pub.Sys, such as Pasxl,
and Rename or Copy the originals from Stdcmd.Sys.
Qeditj3.Qeditjob.Robelle removes the
Qedit CM compiler interface that had been integrated into MPE. The original
compilers are Restored and the CM Interface is removed from the system SL. If
you are on MPE V, a new cold load tape is created.
Ensure that no one compiles for the next
half hour. Stop all jobs and send an operator warning. Log on as Manager.Sys,
modify the first line of the Qeditj3 job to include the passwords, then :Stream
the job.
Qeditj3 first attempts to :Restore the
original compilers from a backup tape (you can use the last Hewlett-Packard
update tape). Mount the tape and :Reply on the console. It then removes the
Qedit interface segment from Sl.Pub.Sys and requests a tape to make a new cold
load tape. Please mount a blank tape with a write ring and :Reply. Save this
tape and use it on your next cold load.
Qeditj3a.Qeditjob.Robelle removes the
isolated CM compiler interface from the Robelle account, leaving you only the
original ones in Pub.Sys. Ensure that no one compiles or uses Qedit until this
job finishes. Stop all jobs and send a warning to all users. Modify the first
line of Qeditj3a to include the Robelle account password and stream the job.
Qeditj3a purges fixed compilers from the
Robelle account, removing the interface.
Qedit aims to provide everything an MPE or HP-UX programmer could
need to write COBOL, PowerHouse, or other programs, and to prepare
documentation. Therefore, Qedit has Line mode for batch editing and full-screen
mode for interactive editing. On HP terminals, Qedit's full-screen mode is
called Visual mode.
Qedit's Visual mode is a powerful but friendly
full-screen editor designed specifically for programmers. It gives you full
access to the editing capabilities of your terminal in block-mode, with low
system overhead. You can move, copy, mark and delete blocks of text with
Visual's cut-and-paste functions, and page backward and forward through your
file with function keys. To use Visual mode, you must have an HP terminal or an
HP terminal emulator (e.g., Reflection from WRQ).
NOTE:
As of HP-UX 11.0, HP has dropped support for block-mode terminals. For this
reason, full-screen editing is only available in Screen mode on HP-UX 11.0 and
later.
In Visual mode, you have access to all
Line mode commands (including UDCs, command files, compiling, linking and
running programs, shell scripts, and string searching and changing). Qedit's
search and replace functions aim to be simple, fast and powerful (e.g., ignore
embedded words, etc.). The Undo command allows you to cancel any previous edits
to your file, working back to the state at which you started. Using the
optional Open and Shut feature, you can switch between files instantly. With
the Justify command, the Prose text formatter and the Spell checker, you can
format documents such as memos and manuals.
Visual mode is a good introduction to the
HP operating systems for users who don't work on HP computers all day. Those
who may particularly benefit are novice users, or users who run Qedit only to
update a report skeleton once a week. These occasional users no longer have to
memorize editing commands. Visual mode provides a familiar environment where
novices can make changes to the entire screen, just as they do on PC editors.
You can even configure some electronic mail packages (HPDesk, elm), to put your
users directly into Visual mode when they edit a message.
After you have invoked Qedit, and Texted or Opened a file, you
switch from Line mode to Visual mode by typing VI or pressing F1. If you don't
have a file open, Qedit opens a scratch file and, if empty, fills it with a
screenful of blank lines.
VI
[ linenum | "string" ] or press F1
(Default: linenum = *)
Whereas in Line mode you type in command and text lines ending each
with a Return, in Visual you edit a full screen of text in block-mode using the
terminal keyboard. Since your terminal is off-line from the computer, you can
use its cursor and editing keys. You edit by moving the cursor around the
screen, inserting and deleting lines and characters. Press Enter to save your
changes. To move through the file, you have the convenience of eight function
keys, such as F6 Forward One Page.
Visual mode in Reflection for Windows,
showing cut-and-paste indicators
You copy, move, hold, and delete blocks
of text easily by placing "cut-and-paste" indicators at the start of
the line. You may type Line mode commands at the home line ===>
and execute them via the Enter or the F7 key. Combining
the cut-and-paste functions with the Open and Shut commands, you can also copy
and move text quickly between different Qedit files. Use the ZZ cut-and-paste
indicator with any command to mark text easily.
The Set Visual command controls how
Visual mode operates and allows great latitude in configuring Visual to your
own liking. For example, you can choose to have automatic update; decide where
the current line or cursor appears; and select how many lines will carry over
when you page up or down.
When you are done, exit Visual mode using
F8, then Keep or Shut your file. Press F8 again to leave Qedit.
===>
Okay 1691.75
WFILE.DOC.TACCT
"verify"(u) Move Ready
*
procedure abc;
+1 begin
+2 integer def;
// ....+....10...+....20...+...
The screen starts with the home
Line, followed by the status Line,
several text Lines, and ends with
the template Line. Columns 3 and 4
of text lines sometimes contain special characters and are called the indicator columns.
You type commands, search for strings and for line numbers after the
===> on the home line.
These are executed when the F7 or Enter
key is pressed.
The home line is also used by Qedit to
print error messages. You must clear the error message by pressing the F7 or
Enter key before you can type another command in the home line.
The second line shows the status, the current line number (i.e.,
that of the * line), the name of the file you are editing, the current string
with its window, and any pending cut-and-paste task.
Okay 1691.75
WFILE.DOC.TACCT
"verify"(u) Move Ready
If you have Texted a file into Qeditscr,
the status line shows the name of the Text file, which is also your default
Keep file.
By default you see the * (current) line and 19 lines after it. Each
line is prefixed by the relative line number, and two columns for special
indicators.
*
procedure abc;
+1 begin
+2 integer def;
Use Set Vis Above and Set Vis Below to
adjust the number of lines shown above and below the current line.
The
last line has // and a column template. The // signals end-of-screen to Qedit
and must not be erased.
// ....+....10...+....20...+...
Visual uses more than 76 columns for text on Reflection, Qcterm, a
2393/97, 2626, or 700/9x terminals.
Qedit leaves columns 3 and 4 of the text
lines for you to enter cut-and-paste operators (i.e., MM, CC, HH, etc.). Also,
Qedit may print one of two special indicators in these columns:
|
!
|
line extends beyond the visible right
margin
|
|
?
|
line contains control characters, shown
as dots
|
An !
means the line extends beyond the right terminal margin. To shift the screen
image left, type Set Left 55 at the Visual home line and press F7.
A ? means the line contains nonprinting characters such as Nulls,
Escapes, Bells, Tabs or possibly Roman-8 extended characters. Qedit replaces
these characters with dots (.) in Visual mode, and does not allow you to make
changes. These ? lines are not updated when you press Enter.
To
edit Bells, Escape sequences, Tabs, ShiftOuts and ShiftIns in Visual, use Set
Vis Bell, Set Vis Esc, Set Vis Tab, Set Vis SO and Set Vis SI. All these
specify substitute characters to be shown instead of dots. To edit other
control codes, use Modify or Change from the ===> line. If you turn Set
Editinput Extend Off, Qedit regards Roman-8 characters as nonprinting noise and
show them as dots.
In Visual mode, the keyboard gives you the power to move around the
screen, edit text, and control the flow of Qedit.
You
move around the screen using the cursor keys and others:
|
Cursor Left
|
Move one space to left
|
|
Backspace
|
Move one space to left
|
|
Cursor Right
|
Move one space to right
|
|
Cursor Up
|
Move one space up
|
|
Cursor Down
|
Move one space down
|
|
Return
|
Down to next line, back to column 5
|
|
Home Up
|
Move to ===> line
|
|
Shift-Home
|
Move to bottom of screen
|
|
Tab
|
Move to next right Set TAB column
|
|
Shift-Tab
|
Move to next left Set TAB column
|
|
Prev Page
|
Only moves around terminal memory
|
|
Next Page
|
Only moves around terminal memory
|
You revise the screen image using these keys:
|
Space bar
|
Move cursor right and erase character
|
|
any
char
|
Overwrite cursor and move it right
|
|
Del Char
|
Remove character at current cursor
|
|
Ins Char
|
Enable "insert"; use again to
disable
|
|
Ins Line
|
Insert blank line above current line
|
|
Del Line
|
Delete line at current cursor
|
|
Clear Line
|
Erase to the end of the line
|
|
Clear Display
|
Avoid!
Recovery: Home Up,*,F7
|
To save the changes you have made on the
screen,
|
Enter
|
Send screen image to Qedit, update file
|
To return from Visual mode to Line mode:
Some other keys:
|
Select
|
Useless in Qedit
|
|
Stop
|
Do not use in Visual
|
|
Break
|
Disabled in Visual
|
|
Reset
|
Use if screen locks up, press Enter
|
|
Esc
|
First key of Escape sequences
|
|
Del
|
Does not delete anything!
|
If you are using a PC with Reflection for DOS, you need to map the
PC keys into the HP keys.
Note that the PC keyboard has two keys
labeled Enter, which are used differently in Qedit. The Enter key above the
Right Shift key is called the Return key in this manual, and is used to execute
commands in Line mode. In Visual mode, this key moves the cursor down by one
line. The other Enter key (on the numeric keypad) is called the Enter key, and
is used to update the screen in Visual mode.
Here are the default Reflection
keystrokes for common functions:
|
Terminal Keyboard
|
Reflection Key Sequence
|
|
Enter
|
Enter on the numeric keypad. If that
doesn't work, try the "+" on the numeric keypad, or try Shift-F10
|
|
Home Up
|
Control-Home
|
|
Shift-Home
|
Control-End
|
|
Ins Line
|
Alt-I
|
|
Del Line
|
Alt-D
|
|
Clear Line
|
Alt-K
|
|
Clear Display
|
Alt-J (avoid in Visual!)
|
|
User keys
|
F9
|
|
System keys
|
F10 (then F7 for help)
|
|
Additional Functions
|
Reflection Key Sequence
|
|
Begin Line (Column 1)
|
Home
|
|
End Line
|
End
|
|
Help about Reflection
|
Alt-H
|
|
Exit
|
Alt-X
|
AdvanceLink
is similar (Alt-H is help, Alt-I is Insert Line, Alt-D is Delete Line), but
Clear Line is Alt-L, and Enter is Alt-F3. Other terminal emulators have their
own keystrokes for common functions. See your emulator's manual for details.
Much of the convenience of Visual mode is
due to the power built into the eight user function keys: F1 through F8.
|
F1
|
Update and go to next page
|
|
F2
|
Roll Up Screen n lines, as per Set Vis Roll
|
|
F3
|
Findup (search back for current string)
|
|
F4
|
Find (search ahead for current string)
|
|
F5
|
Backward One Page
|
|
F6
|
Forward One Page
|
|
F7
|
Execute command typed in ===> line
|
|
F8
|
Exit from Visual back to Line mode
|
F1: Update and Go to Next Page
Qedit reads the current page and updates the file, then displays the
next page. The F1 key combines the
Enter key and F6 (Forward) in a single key. However, F1 does not execute any
command typed in the home line as the Enter key would.
F2: Roll Up Screen
Qedit clears the screen and displays a new one that is rolled up n lines (default: 6), where n is controlled by Set Vis Roll.
F3: Findup - Previous String
Qedit searches backward in the file, starting from the * line, until
it finds a line that contains the current string. Qedit clears the screen and
displays a new page, with * positioned at the line that contains the found
string. Visual also displays the target string on the Status line.
Before you can use F3, you must establish
the string for which to search. Type the string in quotes prefixed by a
circumflex (^"string") at the ===>
on the home line and press F7, to do the first Findup.
F4: Find - Next String
Qedit searches forward in the file, starting from the * line, until
it finds a line that contains the current string. Qedit clears the screen and
displays a new page, with * positioned at the line that contains the found
string. Visual also shows the target string on the Status line.
Before you can use F4, you must enter the
target string. Type the string in quotes ("string") at the ===> on the
home line and press F7, to do the first Find.
F5: Backward One Page
Qedit clears the screen and displays the previous page. By default,
the top line of the original screen becomes the bottom line of the new screen.
Use Set Vis Carry to change the number of lines carried over to the new screen.
F6: Forward One Page
Qedit clears the screen and displays the next page. By default, the
bottom line of the original screen becomes the top line of the new screen. Use
Set Vis Carry to change the number of lines carried over to the new screen.
F7: Execute a Command
Use the F7 key to execute commands. The current screen is not
updated, unless you have Set Vis Update On. Type whatever command you want to
execute after the ===>. This
includes "strings" to find, Qedit Line mode commands such as Open or
Justify, MPE commands, calculator commands (=5/6), and special Visual commands
(e.g., * for Refresh, ? for Help). Then press F7. Qedit reads only the home
line and executes the function. To first save your screen changes and then
execute, use Enter instead of F7.
See the section "Home Line
Commands" for complete details.
F8: Exit from Visual
To
return from Visual mode to Line mode, use the F8 key. Press F8 again once you
are in Line mode to exit Qedit and return to MPE (: prompt). If for some reason
F8 fails to exit from Visual, type / at the ===> and press F7 or the
Enter key. This should get you back to Line mode.
Line Number. Move to a specific line
(e.g., to line 45).
===>45 F7
>
and <. Move ahead or back a page. Use with a
number to move several pages (e.g., ahead 3 pages).
===>>3 F7
+
and -. Move forward or backward any number of lines
(e.g., back 200 lines). If you do not specify a number, the default is the
number of lines configured by Set Vis Roll.
===>-200 F7
~
The Tilde Key. Return to the "most
recent" screen. If you jump from line 1500 to line 451, ~ sends you back
to 1500. This is handy if you jump briefly to another part of your file to
check something then want to get back to your original location.
The tilde is also available from
line-mode but it has to be enabled by removing it from the list of string
delimiters. In order to do this, you could do the following:
/V stringd
Set STRINGDelimiters
"|\~{}[]_@?!#>%&:'"
/S stringd
"|\{}[]_@?!#>%&:'"
Notice that tilde has been removed from
the delimiter list entered on the Set command.
===>~ F7
FIRST
and LAST. Move to start or end of file.
===>first F7
Scrollup Character. This character can be entered in the cut-and-paste
columns to scroll up in the file. A single character scrolls the number of
lines defined by Set Visual Roll. If the character is entered more than once,
Qedit scrolls up that many times the number of Roll lines. For example, enter 4 minus signs anywhere to scroll
4 X Roll lines. The default scrollup character is a minus sign. It can be
changed to something else with Set Visual Scrollup.
It is never necessary to remember line numbers in full-screen mode.
Visual allows you to mark, hold, move, copy, replicate, or delete a block of
text, all visually. This is called "cut-and-paste" and is done by
putting special indicators in the two blank columns at the left of each text
line before you press the Enter key. For example, DD indicates a block of text
to be deleted.
Order
Is Not Important (But One at a Time). You can enter
the indicators in any order and on different screens, but 10,000 is the maximum
number of lines you can cut. When you have defined a complete cut-and-paste
task, Qedit completes the task and removes the indicators. You can only perform
one cut-and-paste task at a time.
|
Single Line
|
Block of Text
|
Function
|
|
M
|
MM
|
Move line or block of text
|
|
C
|
CC
|
Copy line or block of text
|
|
D
|
DD
|
Delete line or block of text
|
|
H
|
HH
|
Hold a line or block of text
|
|
|
HJ
|
Append block of text to Hold file
|
|
|
JJ
|
Justify a block of text
|
|
Z
|
ZZ
|
Mark a line or block of text
|
|
|
XX
|
Exclude a block of
text from the display
|
|
A
|
Insert text "after" this line
(or use F for "following")
|
|
B
|
Insert text "before" this line
(or P for "preceding")
|
|
AH
|
Insert Hold file after this line (or use
FH)
|
|
BH
|
Insert Hold file before this line (or use
PH)
|
|
A0
|
Insert Hold0 file after this line (or F0)
|
|
B0
|
Insert Hold0 file before this line (or
P0)
|
|
R
|
A line to be replicated after itself
|
|
Rn
|
A line or block to be replicated n times (max. 9). (See "Copying a
Block of Text" below.)
|
Display Enhanced. When the
cut-and-paste task is partly defined, Qedit highlights the indicated lines and
adds a warning to the status line.
You
can cancel a pending cut-and-paste task (if you have not pressed the final
Enter) by entering a period (.) in the ===> line and pressing
F7.
===>. F7
Paste One Copy at a Time. Suppose
you want to copy a section of text from one place in your file to another. Here
is one way to do it. First, locate the screen containing the start of the block
that you want to copy, using a string search via the home line. Move the cursor
down to the first line you want to copy, then press Cursor Left twice and type
"CC" in the blank columns provided. Press Enter and you should see
that line highlighted in inverse video.
Second, find the end of the text section
and mark the last line with another "CC". After you press Enter, you
should see the entire block highlighted.
Third, go to the screen where you want to
insert a copy of the text. Move the cursor down to the line before the desired insertion point,
Cursor Left once and type "A" (for after). Press Enter and the block
should appear.
Paste
Multiple Copies at Once.
When
working with a block of text, you can use the same cut-and-paste codes to mark
the beginning and the end of the block (i.e., HH on the first line of the block
and HH again on the last line). The only exception to this is the block
replication code.
In this case, you would use RR to mark
the beginning of the block and Rn to
mark the end of the block, where n represents
the number of times you want that block replicated. For example, to have the
same block replicated five times, you would enter R5. The new blocks are
inserted immediately after the last line of the copied block.
The original lines marked for replication
are written to the Hold0 file.
Using
Visual mode's cut-and-paste functions, you can copy and move blocks of text between files.
You can only edit one file at a time in
Qedit, but you can switch quickly between different Qedit files by Opening and
Shutting them.
