VMS Workstation Software Release
Notes
Order Number: AA-KP45B-TE
May 1988
This document provides supplemental information about
Version 3.3 of VMS Workstation graphics software. It
describes all the changes and new features for Version
3.3 and lists problems and restrictions.
Revision Information: This manual supersedes
the MicroVMS Workstation
Release Notes, Version
3.2 and MicroVMS
Workstation Release
Notes, Version 3.1.
Software Version: VMS Workstation Software
Version 3.3
Operating System Version: VAX/VMS Version 4.6
digital equipment corporation maynard, massachusetts
________________________
May 1988
__________
The information in this document is subject to change
without notice and should not be construed as a
commitment by Digital Equipment Corporation. Digital
Equipment Corporation assumes no responsibility for
any errors that may appear in this document.
The software described in this document is furnished
under a license and may be used or copied only in
accordance with the terms of such license.
No responsibility is assumed for the use or
reliability of software on equipment that is not
supplied by Digital Equipment Corporation or its
affiliated companies.
__________
Copyright (c)1988 by Digital Equipment Corporation
All Rights Reserved.
Printed in U.S.A.
__________
The postpaid READER'S COMMENTS form on the
last page of this document requests the user's
critical evaluation to assist in preparing future
documentation.
The following are trademarks of Digital Equipment
Corporation:
DEC DIBOL UNIBUS
DEC/CMS EduSystem VAX
DEC/MMS IAS VAXcluster
DECnet MASSBUS VMS
DECsystem-10 PDP VT
DECSYSTEM-20 PDT
DECUS RSTS
DECwriter RSX DIGITAL
This document was prepared using VAX DOCUMENT, Version
1.0
_______________________________________________________
Contents
_________________________________________________
PREFACE vii
_______________________________________________________
CHAPTER 1 VMS WORKSTATION SOFTWARE VERSION 3.3
CHANGES AND NEW FEATURES 1-1
_________________________________________________
1.1 NEW HARDWARE SUPPORT 1-1
_________________________________________________
1.2 15-INCH MONITOR SUPPORT 1-1
_________________________________________________
1.3 SIGHT EDITOR 1-2
_________________________________________________
1.4 BUG FIXES 1-3
_________________________________________________
1.5 ADA SUPPORT 1-4
_________________________________________________
1.6 CHANGE IN PRINTER SETUP OPTIONS 1-5
_________________________________________________
1.7 CHANGES FOR UISENTRY MODULES 1-5
1.7.1 UIS Entry Point Files for
ADA Programmers 1-8
1.7.2 Additional UIS Routine 1-12
_________________________________________________
1.8 CHANGES TO THE TERMINAL EMULATOR 1-14
_________________________________________________
1.9 LOCATOR INPUT FOR VWS TERMINALS 1-16
iii
Contents
1.9.1 ANSI Locator
(mouse/tablet)
Input 1-16
1.9.2 Locator Input Model 1-17
1.9.2.1 Enabling Locator Reporting 1-17
1.9.2.2 DECELR--DEC Enable Locator
Reports 1-17
1.9.2.3 Locator Position Reporting 1-18
1.9.2.4 Filter Rectangles 1-21
1.9.2.5 Selecting Locator Events 1-22
1.9.2.6 Requesting a Locator Position
Report 1-22
1.9.3 Locator Device Support 1-23
_________________________________________________
1.10 VWS TERMINAL EMULATION WINDOW
CONTROL 1-24
_________________________________________________
1.11 ANSI COLOR TEXT SGRS 1-37
_________________________________________________
1.12 VWS VT200 TERMINAL EMULATION COPY
AND PASTE 1-41
1.12.1 Description: 1-41
1.12.1.1 Human Interface (Transparent
Mode) 1-42
1.12.1.2 Button Operation 1-43
1.12.1.3 Copy Operations 1-43
1.12.1.4 Paste Operations 1-45
1.12.2 Programmed Mode 1-45
1.12.2.1 Copy Operations 1-46
1.12.2.2 Paste Operations 1-46
1.12.3 Terminal Sequences 1-47
_________________________________________________
1.13 DEMONSTRATION SOFTWARE 1-50
_________________________________________________
iv
Contents
1.14 HARDCOPY UIS 1-53
_________________________________________________
1.15 LOCAL AREA VAXCLUSTERS 1-54
_________________________________________________
1.16 VAXSTATION 2000 1-54
_________________________________________________
1.17 CHANGES TO THE VT220 EMULATOR 1-54
1.17.1 Version 3.3 1-54
1.17.2 Version 3.2 1-55
_______________________________________________________
CHAPTER 2 VMS WORKSTATION SOFTWARE PROBLEMS
AND RESTRICTIONS 2-1
_________________________________________________
2.1 VERSION 3.3 2-1
2.1.1 ReGIS Restrictions 2-1
2.1.2 SET HOST/DTE 2-2
2.1.3 Tiling 2-2
2.1.4 Listing of Fonts 2-3
2.1.5 Print Destination
Restriction 2-3
_________________________________________________
2.2 VERSION 3.2 2-3
2.2.1 User Interface 2-3
2.2.1.1 VAXstation II/GPX Boot Problem
2-3
2.2.1.2 Restriction with Autologin 2-4
v
Contents
2.2.2 Programming Interface 2-4
2.2.2.1 UIS$C_TEXT_WRITE--16-Bit Text
Problem 2-4
2.2.2.2 UIS$CIRCLE and
UIS$ELLIPSE--Overflow
Problem 2-4
2.2.2.3 UIS$DISABLE_KB and
UIS$DISABLE_VIEWPORT_KB--AST Not
Delivered 2-5
2.2.2.4 UIS$SET_KB_ATTRIBUTES--Spurious
Data 2-5
2.2.2.5 UIS$SET_POINTER_AST--Late
Execution of Exit AST Routines
2-5
2.2.2.6 Drawing Images That Use Eight
Bits/Pixel 2-6
2.2.3 Text Problems 2-6
2.2.3.1 Extracting Transformed Control
Lists 2-6
2.2.3.2 Tabs in Control Lists 2-7
2.2.3.3 Text Placement and Display Lists
2-7
2.2.3.4 Text Formatting Problems 2-7
2.2.3.5 Sloped Text 2-8
2.2.3.6 Restrictions on Writing Modes
That Change the Background 2-9
2.2.4 Device Driver Interface 2-10
2.2.5 System Management
Interface 2-10
2.2.6 User Interface 2-11
2.2.7 Programming Interface 2-12
vi
Contents
_______________________________________________________
TABLES
1-1 Workarounds for PASCAL, C, and ADA
Programs 1-6
1-2 Changes to Source Program
Variables 1-8
1-3 Effects of Data Type Change on
UIS$ Routine Variables 1-9
1-4 Effects of Data Type Change on
UISDC$ Routine Variables 1-12
1-5 Locator Device Status Report
(DSR) 1-24
1-6 Logical Names for SETUP 1-46
vii
_______________________________________________________
Preface
This document provides supplemental information
about VMS Workstation Software Version 3.3. It also
describes all changes to the software since Version
2.0. If you have not already done so, please read the
Read Me First page included with your documentation.
__________________________________________________________________
Intended Audience
This manual is intended for graphics programmers and
users who should know about new features, problems and
restrictions, and changes to existing documentation.
Read this document before using the VMS Workstation
graphics software.
__________________________________________________________________
Document Structure
The VMS Workstation Release Notes, Version 3.3, is
arranged in two chapters that cover the following
topics:
o VMS Workstation software changes and new features
o VMS Workstation software problems and restrictions
__________________________________________________________________
Associated Documents
The following manuals are related to this document:
o VMS Workstation Software Installation Guide
o VMS Workstation Software User's Guide
o VMS Workstation Software Graphics Programming Guide
o VMS Workstation Software Video Device Driver Manual
o VMS Workstation Software Guide to Printing Graphics
vii
Preface
o VMS Workstation Software Sight Installation and
User's Guide
__________________________________________________________________
Conventions
Unless otherwise noted, the following conventions are
used in this manual.
_______________________________________________________
Convention______________Meaning________________________
<RETURN> This symbol indicates that you
press the key marked <RETURN>.
<CTRL/x> This symbol indicates that
you must press the key
labeled <CTRL> while you
simultaneously press another
key, for example, <CTRL/C>,
<CTRL/Y>, <CTRL/O>.
Ellipsis Vertical series of periods, or
ellipsis, mean either that not
. all the data that the system
. would display in response
. to the particular command is
shown or that not all the data
a user would enter is shown.
file-spec, . . . Horizontal ellipsis indicates
that additional parameters,
values, or information can be
entered.
viii
Preface
_______________________________________________________
Convention______________Meaning________________________
[Square brackets] Square brackets indicate that
the enclosed item is optional.
(Square brackets are not,
however, optional in the
syntax of a directory name
in a file specification or
in the syntax of a substring
specification in an assignment
statement.)
Quotation marks The term quotation marks
is used to refer to double
quotation marks ("). The term
apostrophe is used to refer to
a single quotation mark (').
Italics Italicized words indicate that
________________________you_should_supply_a_value._____
ix
_______________________________________________________
1 VMS Workstation Software Version 3.3 Changes and New
Features
This chapter describes major changes in the VMS
Workstation hardware and software since Version 3.2.
__________________________________________________________________
1.1 New Hardware Support
VMS Workstation Software V3.3 now supports the
following hardware:
o VAXstation 3200/3500
o LJ250 Printer
o VAXstation 2000
__________________________________________________________________
1.2 15-Inch Monitor Support
The VR150 and VR160 15-inch monitors have a density
of 106 dpi, which is higher resolution than the 77 dpi
density of 19-inch monitors. Because of this higher
resolution, fonts appear smaller on a 15-inch monitor.
The VMS Workstation V3.3 kit contains scaled fonts
that, when used on a 15-inch monitor, produce text
approximately the same size as that normally displayed
on a 19-inch monitor.
To use these scaled fonts, run SYSGEN and set bit 5
in cell TTY_DIALTYPE. To do so, use the following
commands to add decimal 32 to the existing value.
1-1
VMS Workstation Software Version 3.3 Changes and New Features
$MC SYSGEN
SYSGEN> USE CURRENT
SYSGEN> SHO TTY_DIALTYPE
Parameter Name Current Default Minimum Maximum Unit Dynamic
-----------------------------------------------------------------------
TTY_DIALTYPE 0 0 0 255 Bit-encoded
SYSGEN> SET . 32
SYSGEN> SHO .
Parameter Name Current Default Minimum Maximum Unit Dynamic
-----------------------------------------------------------------------
TTY_DIALTYPE 32 0 0 255 Bit-encoded
SYSGEN> WRITE CURRENT
SYSGEN> EXIT
NOTE: Remember to add 32 to TTYDIALTYPE. If the
current value is 128, the new value is 160. Since TTY
DIALTYPE is not a dynamic parameter, when you change
its value, the change does not take effect until you
reboot. Once you reboot, your workstation displays the
scaled fonts.
__________________________________________________________________
1.3 SIGHT Editor
VMS Workstation Software V3.3 supports the SIGHT
Editor, SIGHT Version 3.3. The previously unsupported
version of SIGHT has been removed from the VWS demo
package.
NOTE: Remove any symbols previously defined for old
versions of SIGHT.
SIGHT is a separately installed saveset. For the
installation procedure and for more information
on installing and using SIGHT, refer to the VMS
Workstation Software SIGHT Installation and User's
Guide, included with this kit.
1-2
VMS Workstation Software Version 3.3 Changes and New Features
__________________________________________________________________
1.4 Bug Fixes
Among others, the following bug fixes are included in
Version 3.3:
Bugcheck Crash
In certain instances, VMS Workstation Software crashed
with a random bugcheck message. Now, the software
deletes the process where the problem occurs rather
than allowing the system to crash.
NOTE: This occurs only if Bugcheck Fatal is false.
Pool Expansion
In certain instances, VWS crashed if it ran out
of memory. This is now corrected so that only the
affected process is deleted. In such a case, perform
a SHOW MEMORY to determine how much paged pool is
currently being used.
o If less than 70 percent of page pool is in use,
you are running out of UIS$QVSS_POOL_SIZE. Increase
UIS$QVSS_POOL_SIZE by increments of 512 as follows--
edit the file STARTVWS.COM in SYS$MANAGER to
include the line:
DEFINE/EXEC/SYS UIS$QVSS_POOL_SIZE xxx
where:
xxx = the default for VWS + amount by which you
are increasing it
NOTE: Increase the SYSGEN parameter PAGEDYN by the
same amount you increase UIS$QVSSPOOLSIZE.
o If more than 70% of paged pool is in use, alter
only the SYSGEN parameter PAGEDYN.
1-3
VMS Workstation Software Version 3.3 Changes and New Features
o If you are using ReGIS windows and the window is
deletedm, you are probably out of P1 space. In this
case, increase UIS$P1_POOL_SIZE by increments of
512 bytes at a time. For each 512-byte increase to
P1 pool, increase the SYSGEN parameter CTLPAGES and
the SYSGEN parameter PQL_PGFLQUOTA by 1. Also, edit
STARTVWS.COM in SYS$MANAGER by adding the following
line:
DEFINE/EXEC/SYS UIS$P1_POOL_SIZE xxx
where:
xxx = the default for QDSS or QVSS (depending on
your system) + the amount by which you increase
P1
If none of the above conditions fit your situation,
you are out of UIS$SYSTEM_POOL_SIZE. Increase this by
increments of 512. Again, edit the file STARTVWS.COM
in SYS$MANAGER by adding the following line:
DEFINE/EXEC/SYS UIS$SYSTEM_POOL_SIZE xxx
where:
xxx = the default for VWS + the amount by which you
are increasing it
NOTE: Update all SYSGEN parameters in
SYS$SYSTEM:MODPARAMS.DAT before you reboot.
__________________________________________________________________
1.5 ADA Support
VMS Workstation Software V3.3 now supports the ADA
programming language.
1-4
VMS Workstation Software Version 3.3 Changes and New Features
__________________________________________________________________
1.6 Change in Printer Setup Options
The Enter new print destination option of the Printer
Setup menu is now disabled. To change the print
destination, assign the logical UIS$PRINT_DESTINATION
to the desired value.
For example:
$ DEFINE/SYSTEM/EXEC UIS$PRINT_DESTINATION "CSA0:"
__________________________________________________________________
1.7 Changes for UISENTRY Modules
In variables of most of the UIS$* procedures listed in
the VMS Workstation Software Graphics Programming
Guide, LONGWORD (UNSIGNED) should now be simply
LONGWORD. All affected variable types in any programs
that use UISENTRY must change if they use the new
UISENTRY. So PL/I users can use the flags argument,
the following routine entry points have been updated
to indicate that the flags parameter is longword
(unsigned) rather than longword:
UIS$ENABLE_DISPLAY_LIST
UIS$GET_NEXT_OBJECT
UIS$GET_PREVIOUS_OBJECT
UIS$READ_CHAR
UIS$SET_INSERTION_POSITION
UIS$SET_POINTER_PATTERN
UIS$SHRINK_TO_ICON
UISDC$SET_POINTER_PATTERN
For PL/I users, the change to the above routines is
necessary because there is no workaround. Because
the change might adversely affect PASCAL, C, and
ADA programs, the UISENTRY file for those languages
contains the following workarounds:
1-5
VMS Workstation Software Version 3.3 Changes and New Features
Table 1-1 Workarounds for PASCAL, C, and ADA Programs
_______________________________________________________
Language____Workaround__Correct_Usage__________________
PASCAL Integer Unsigned
C Int Name Unsigned Int
ADA Integer Unsigned_longword
_______________________________________________________
In general, the following data types remain LONGWORD
(UNSIGNED).
o Any variable that contains *_ID, such as:
- VD_ID
- WD_ID
- OBJ_ID
- VCM_ID
- CMS_ID
- TR_ID
- KB_ID
- KB_ID
- COLOR_ID
- ICON_WD_ID
- FONT_ID
o Any variable that contains FLAG, MASK, or RETSTATE,
such as:
- DISPLAY_FLAGS
- RETSTATE
- ENABLE_ITEMS
- DISABLE_ITEMS
- FLAGS
1-6
VMS Workstation Software Version 3.3 Changes and New Features
- MASK
- ICON_FLAGS
o Any of the following variables:
- KEYBUF
- BUTTON_KEYBUF
- MAJOR_VERSION
- MINOR_VERSION
This change affects the following languages:
o ADA
o C
o PASCAL
o PL/I
This change will probably require alterations to your
source program variable declarations as outlined in
Table 1-1. (Note that for BLISS and FORTRAN there
is no change.) It might be helpful to use your old
UISENTRY temporarily before updating your program. To
do so, copy your current UISENTRY to a safe location
before you start the VWS Version 3.3 upgrade. After
the installation, you can copy back your saved
UISENTRY.
1-7
VMS Workstation Software Version 3.3 Changes and New Features
Table 1-2 Changes to Source Program Variables
_______________________________________________________
Language Original What to Change Variable
File______Variable_Type____Type_To_____________________
ADA INTEGER UNSIGNED_LONGWORD
C INT UNSIGNED LONG INT
PASCAL INTEGER UNSIGNED
PL/I FIXED BIT(32) ALIGNED
BINARY(31)
_______________________________________________________
___________________________
1.7.1 UIS Entry Point Files for ADA Programmers
NOTE: The following information applies only if you
are using the UIS entry point files for programming in
ADA.
Because of some restrictions in VAX ADA, the VMS data
type ITEM_LIST_PAIR, passed by reference, is now the
VMS data type ADDRESS, passed by value. This affects
the following UIS$* routines and their variables:
1-8
VMS Workstation Software Version 3.3 Changes and New Features
Table 1-3 Effects of Data Type Change on UIS$ Routine
Variables
_______________________________________________________
Variables
UIS$_Routine_________________________Affected__________
UIS$COPY_OBJECT matrix
UIS$CREATE_COLOR_MAP vcm_attributes
UIS$CREATE_TERMINAL attributes
UIS$CREATE_WINDOW attributes
UIS$EXECUTE bufaddr
UIS$EXECUTE_DISPLAY bufaddr
UIS$EXPAND_ICON attributes
UIS$EXTRACT_HEADER bufaddr
UIS$EXTRACT_OBJECT bufaddr
UIS$EXTRACT_PRIVATE bufaddr
UIS$EXTRACT_REGION bufaddr
UIS$EXTRACT_TRAILER bufaddr
UIS$FIND_PRIMITIVE extent
UIS$FIND_SEGMENT extent
UIS$GET_COLORS retr_vector,
retg_vector,
retb_vector
UIS$GET_FONT_ATTRIBUTES item_list
1-9
VMS Workstation Software Version 3.3 Changes and New Features
Table 1-3 (Cont.) Effects of Data Type Change on UIS$
Routine Variables
_______________________________________________________
Variables
UIS$_Routine_________________________Affected__________
UIS$GET_INTENSITIES reti_vector
UIS$GET_OBJECT_ATTRIBUTES extent
UIS$IMAGE rasteraddr
UIS$LINE_ARRAY x_vector, y_
vector
UIS$MEASURE_TEXT ctllist, posarray
UIS$MOVE_VIEWPORT attributes
UIS$PLOT_ARRAY x_vector, y_
vector
UIS$SET_COLORS r_vector, g_
vector, b_vector
UIS$SET_INTENSITIES i_vector
UIS$SET_KB_COMPOSE2 table
1-10
VMS Workstation Software Version 3.3 Changes and New Features
Table 1-3 (Cont.) Effects of Data Type Change on UIS$
Routine Variables
_______________________________________________________
Variables
UIS$_Routine_________________________Affected__________
UIS$SET_KB_COMPOSE3 table
UIS$SET_KB_KEYTABLE table
UIS$SET_POINTER_PATTERN pattern_array,
pattern_count
UIS$SHRINK_TO_ICON attributes
UIS$TEXT ctllist
UIS$TRANSFORM_OBJECT matrix
_______________________________________________________
Because of some restrictions in VAX ADA, the VMS data
type VECTOR_*_UNSIGNED, passed by reference, is now
the VMS data type ADDRESS, passed by value. This
change affects the following UISDC$* routines and
their variables:
1-11
VMS Workstation Software Version 3.3 Changes and New Features
Table 1-4 Effects of Data Type Change on UISDC$
Routine Variables
_______________________________________________________
UISDC$_Routine_____________Variables_Affected__________
UISDC$EXECUTE_DOP_ASYNCH dop
UISDC$EXECUTE_DOP_SYNCH dop
UISDC$IMAGE rasteraddr
UISDC$LINE_ARRAY x_vector, y_vector
UISDC$LOAD_BITMAP bitmap_adr
UISDC$MEASURE_TEXT ctllist, posarray
UISDC$PLOT_ARRAY x_vector, y_vector
UISDC$QUEUE_DOP dop
UISDC$READ_IMAGE rasteraddr
UISDC$SET_POINTER_PATTERN pattern_array, pattern_
count
UISDC$TEXT ctllist
_______________________________________________________
___________________________
1.7.2 Additional UIS Routine
The following UIS routine has been added: UIS$SET_VP_
TITLE.
UIS$SET_VP_TITLE places a string of up to 63
characters in the WDB and redraws the border. UIS$SET_
VP_TITLE has the following parameters:
FORMAT:
UIS$SET_VP_TITLE wd_id, string RETURNS:
1-12
VMS Workstation Software Version 3.3 Changes and New Features
UIS$SET_VP_TITLE signals all errors; no condition
values are returned.
ARGUMENTS:
WD_ID
VMS USAGE: identifier
TYPE: longword (unsigned)
ACCESS: read only
MECHANISM: by reference
Display window identifier. The WD_ID argument is
the address of a longword that uniquely identifies
a display window.
STRING
VMS USAGE: char_string
TYPE: character string
ACCESS: read only
MECHANISM: by description
Banner title. The STRING argument is the address of
a descriptor of the character string to be inserted
into the banner of the display viewport.
If the argument STRING is not specified, the
display banner is created without a title.
RESTRICTIONS
The title string buffer is always a minimum of 64
bytes, and its maximum is the length of the original
title (or 64, whichever is larger). An attempt
to change the title to an 80-byte string when the
original was ten, results in truncating the new string
at 64 bytes.
1-13
VMS Workstation Software Version 3.3 Changes and New Features
__________________________________________________________________
1.8 Changes to the Terminal Emulator
The major changes to the terminal emulator follow.
o VT241 ReGIS--VT241 ReGIS emulation has been added.
o Mouse input mode--Terminal applications can now
determine the position of the mouse via an escape
sequence.
o Terminal-to-terminal Copy/Paste--You can now copy
data on the terminal to a buffer and use it as
input to the same terminal window or to any other
terminal window.
o ANSI Color Text support--ANSI Color SGRs are
now supported, providing eight foreground and
background text colors. Select colors just as you
select other attributes (such as BOLD).
o Linefeed scroll optimization--An optimization has
been added to speed up scrolling performance.
You can control this optimization by editing the
logical name values in UIS$SETUP_VT240.COM.
o Ctrl-Shift-Remove (shrink-to-icon)--The key sequence
CTRL-SHIFT-REMOVE causes a terminal window to
shrink to an icon.
o "Live" icon--This new type of icon is actually the
terminal window, reduced to a 2x1 pixel font with
no keyboard attachment. Screen activity is visible
in the window as two-pixel tall characters are
displayed. Read the documentation in UIS$SETUP_
VT240.COM for the logicals that you must define for
this feature. Graphics are lost when the window is
in this icon state and they are not redrawn when
the icon is removed.
o Extended Window Command OSC sequences--New sequences
have been added and existing ones extended. A
number of bugs have been fixed.
1-14
VMS Workstation Software Version 3.3 Changes and New Features
A new command file called UIS$SETUP_VT240.COM is
included in SYS$MANAGER. This is a sample set-up file
for the emulator logicals. It documents some of the
new features and allows tailoring of the terminal
emulator characteristics. You can edit this file to
suit your needs. You should add the line:
$ @SYS$MANAGER:UIS$SETUP_VT240.COM
to your SYS$MANAGER:SYSTARTUP.COM command file to
invoke this at system start-up. By default, this
command file enables ReGIS for the terminals and
provide 8 colors per terminal.
This kit contains a set of fonts originally included
with VMS Workstation V3.2. Load and use these 19-point
fonts if you will be running ReGIS applications that
depend on ANSI text alignment with ReGIS graphics.
If you install the Demonstration software, you get
the extra command files used to load these fonts. (It
might be advisable for you to load that software now.)
After the Demonstration software is loaded, install
the fonts, using the font command procedures in the
directory SYS$SYSDEVICE:[VWSDEMO]:
o LOAD_19P_FONTS.COM
This loads the fonts into memory. You can
invoke this command file if you have Change
Mode to Kernel privileges, or it can be invoked
automatically at startup if you add it to
SYS$SYSTEM:UISUSERFONTS.COM. However, if
SYS$SYSTEM:UISUSERFONTS.COM does not exist, you
must create it. If UISUSERFONTS.COM is present,
invoke it with the normal font load procedure and
use it exclusively to load fonts.
You cannot invoke SYS$SYSTEM:UISUSERFONTS.COM from
SYSTARTUP.COM. You must invoke it after UIS has
completed initialization.
o UIS$SELECT_FONT.COM
1-15
VMS Workstation Software Version 3.3 Changes and New Features
This creates the command file UIS$TERM_FONTS.COM.
It finds all the available fonts loaded in memory
and produces a command file that allows you to
switch to any available font. You must define the
OSC_STRINGS logical name. (See the VMS Workstation
Software User's Guide.
o UIS_19P_FONT.COM
To use the 19-point fonts by default, add USE_
19P_FONT.COM to SYS$MANAGER:SYSTARTUP.COM. If you
do this, make sure you add the LOAD_19P_FONTS.COM
command file also. USE_19P_FONT.COM defines certain
logical names documented in the VMS Workstation
Software User's Guide.
NOTE: In VMS Workstation Software V3.2 and earlier, if
the SYSTEM PASSWORD bit was enabled in the software,
no terminal window would appear and no error message
would display.
In VMS Workstation Software V3.3, if the SYSTEM
PASSWORD bit is enabled in the software, emulator
windows never work. Thus, the VWS software ignores
the fact that the bit is enabled and brings up a
workstation emulator window as usual. Other (non-
emulation) terminals prompt for the system password.
__________________________________________________________________
1.9 Locator Input for VWS Terminals
___________________________
1.9.1 ANSI Locator (mouse/tablet) Input
The workstation is supplied with a locator port that
you can use to connect a mouse or tablet. When locator
reporting is enabled, the cursor changes shape, and
the terminal tracks the locator locally with no host
intervention. You can program individual locator
events such as locator button transitions or movement
to send locator reports to the host.
1-16
VMS Workstation Software Version 3.3 Changes and New Features
Each locator report includes the specific event that
initiated the report, the current state of the locator
keys, and the coordinates of the input cursor at the
time of the event.
The locator is treated as a manual input device
similar to a keyboard. Locator events are queued in
the type-ahead buffer with keystrokes.
___________________________
1.9.2 Locator Input Model
_____________________
1.9.2.1 Enabling Locator Reporting
Locator reporting can be selectively enabled from the
host with a DEC private control sequence. When not
in locator input mode, the cursor remains the system
default shape (arrow). When in locator input mode, the
cursor changes shape to the DECSLCS control sequence
specified shape (default is a small crosshair). You
can program individual locator events like locator
button transitions or movement to send locator reports
to the host.
_____________________
1.9.2.2 DECELR--DEC Enable Locator Reports
CSI Ps ; Pu ' z
2/7 7/10
Ps can assume the following values:
0--Locator disabled (default)
1--Locator reports enabled
2--One shot (allow one report, then disable)
Pu specifies the coordinate units for locator reports.
0--(Or omitted) default to character cells
1--Device physical pixels
2--Character cells
1-17
VMS Workstation Software Version 3.3 Changes and New Features
One shot mode is provided for applications that desire
simple graphics input similar to Tektronix GIN mode
(no unsolicited reports). If you select parameter
value 2, the next trigger event that occurs generates
a single locator report. No further locator reports
occur (the locator is disabled) until another DECELR
sequence is received.
Coordinate units for locator position reports can be
selected to any of the three coordinate systems used
by terminal software at the lowest level. Physical
pixels is the "least common denominator" and is useful
for computing sixel positions.
_____________________
1.9.2.3 Locator Position Reporting
When a selected trigger event occurs such as a button
press or release, the terminal transmits a locator
position report as follows.
DECLRP - DEC Locator Report
CSI Pe ; Pb ; Pr ; Pc ; Pp & w
2/6 7/7
Pe = Event code
Pb = Button code
Pr = Row coordinate
Pc = Column coordinate
Pp = Third coordinate (page number)
The event code Pe indicates what event caused this
report to be generated. The following event codes are
defined:
1-18
VMS Workstation Software Version 3.3 Changes and New Features
0 - Request, the terminal received an explicit
request for a locator report, but the locator
is unavailable
1 - Request, the terminal received an explicit
request for a locator report
2 - Left button down
3 - Left button up
4 - Middle button down
5 - Middle button up
6 - Right button down
7 - Right button up
8 - Fourth button down
9 - Fourth button up
10 - Locator outside filter rectangle
Pb is the button code, ASCII decimal 0-15, that
indicates whether any buttons are down. The state
of the four buttons on the locator correspond to the
low four bits of the decimal value; "1" means button
depressed.
1-19
VMS Workstation Software Version 3.3 Changes and New Features
0 - No buttons down
1 - Right
2 - Middle
4 - Left
8 - Fourth
Pr is the row coordinate of the locator position in
the page, encoded as an ASCII decimal value.
Pc is the column coordinate of the locator position in
the page, encoded as an ASCII decimal value.
Pp is the page coordinate of the locator position
encoded as an ASCII decimal value. The page
coordinate can be omitted (Pp is included for future
compatibility with VT300 series terminals).
Each locator report includes both the specific
transition that caused this event and the current
button state. This report allows software to determine
what event just occurred and which buttons are down
without keeping track of previous events or button
state.
Locator events are queued like keystrokes in the
keyboard input silo keystrokes. The data is inserted
into the VMS typeahead buffer. By default, this buffer
can handle 70 characters ahead. Overflow of the type-
ahead buffer is handled as normal keyboard overflow by
VMS.
1-20
VMS Workstation Software Version 3.3 Changes and New Features
_____________________
1.9.2.4 Filter Rectangles
Filter rectangles add filtered movement events to the
list of locator transitions that can generate reports.
DECEFR -- DEC Enable Filter Rectangle
CSI Pt ; Pl ; Pb ; Pr ' w
2/7 7/7
Pt = Top boundary of filter rectangle
Pl = Left boundary of filter rectangle
Pb = Bottom boundary of filter rectangle
Pr = Right boundary of filter rectangle
The DECEFR control sequence defines the coordinates
of a filter rectangle and activates it. When the
locator is detected outside a filter rectangle,
an outside rectangle event is generated and the
rectangle is disabled. Filter rectangles are always
treated as "one-shot" events. Defining a new rectangle
reactivates it.
Applications can redefine the rectangle any time even
if it is already active. If a rectangle is specified
without a locator, the terminal immediately generates
an outside rectangle report and deactivates it.
Pt, Pl, Pb, and Pr are in coordinate units specified
by the last DECELR sequence. The filter rectangle
includes the boundaries (similar to other rectangular
area operations). The origin is coordinate pair 1:1 in
the upper left corner. If any parameters are omitted,
they default to the current locator position. Sending
DECEFR with no parameters causes the application to
be notified for any locator movement ("unfiltered
movement event").
DECELR always cancels any previous filter rectangle
definition. This guarantees that when an application
enables locator reports, there will never be an
outstanding filter rectangle.
1-21
VMS Workstation Software Version 3.3 Changes and New Features
_____________________
1.9.2.5 Selecting Locator Events
Use the Select Locator Events control to select
individual locator events that can generate
unsolicited reports. The locator can report both up
and down transitions for situations where exact button
activation sequence is significant. This control
allows application software to select the events it
wants reported.
DECSLE - Select Locator Events
CSI P...P ' {
2/7 7/11
P...P is one or more selective parameters that can
assume the following values:
0 = Respond only to explicit host requests
(default, also cancels any pending filter
rectangle)
1 = Report button down transitions
2 = Do not report button down transitions
3 = Report button up transitions
4 = Do not report button up transitions
_____________________
1.9.2.6 Requesting a Locator Position Report
Whenever locator reporting is enabled (DECELR),
the host can explicitly request a locator position
report. Upon receiving such a request, the terminal
immediately sends a single locator report (DECLRP)
with event code 1 indicating the last locator
position. If the session that receives the request
is not currently active (the locator is being used in
another session), the last known locator position and
state for this session are used. If the locator is
disabled or unavailable, the report specifies event
code 0.
DECRQLP - DEC Request Locator Position
CSI Ps ' |
2/7 7/12
1-22
VMS Workstation Software Version 3.3 Changes and New Features
Ps:
0 = (Or omitted) default to 1
1 = Transmit a single DECLRP locator report
All others ignored
DECSLCS - Select Locator Cursor Style
CSI Ps ) u
9/11 3/? 2/9 7/5
Ps:
0 = (Or omitted) crosshair
1 = "Box corner" style
DECSLCS selects the cursor style displayed when
locator input is enabled in ANSI mode.
___________________________
1.9.3 Locator Device Support
Locator support is an extension to the level 2 and
3 character cell architecture. The primary device
attributes response reports the locator extension as
parameter value 29.
NOTE: Do not confuse this with the VT300 ReGIS locator
extension that is parameter number 15.
Host software can request a Device Status Report
(DSR) to determine whether a locator is available.
Upon receiving the appropriate DSR request, if a
locator device is plugged in, the terminal responds
to indicate the locator is ready and has transmitted a
successful self test message.
1-23
VMS Workstation Software Version 3.3 Changes and New Features
Table 1-5 Locator Device Status Report (DSR)
_______________________________________________________
Host request locator CSI ? 55 n
device status
No locator CSI ? 53 n
Locator ready CSI ? 50 n
Locator busy CSI ? 58 n
_______________________________________________________
The locator busy response can occur when an alternate
session has selected locator controller mode.
__________________________________________________________________
1.10 VWS Terminal Emulation Window Control
The following Digital private syntax Operating
System Command (OSC) string has been assigned for VWS
Terminal Emulation Control:
OSC 2 D...D ST
9/13 3/2 ?/?...?/? 9/12
(You can code OSC as 1/11 5/13 in seven bits.)
The data of a "VWS Terminal Emulation Window Control"
OSC string is interpreted as a command to the
VWS windowing environment to change the status or
appearance of the terminal emulation window.
The data consists of two or more parameters:
1 Specifies the particular window control function to
be effected
2 Interpreted according to window control function
The meanings of first parameter values are as follows:
1--set_terminal_banner
2--shrink_to_icon
3--expand_from_icon
1-24
VMS Workstation Software Version 3.3 Changes and New Features
4--move_terminal_window
5--move_terminal_icon
6--disconnect_keyboard
7--disable_keyboard
8--enable_keyboard
9--push_terminal_window
A--pop_terminal_window
B--disable menu item
C--enable menu item
D--change_multi_scroll_size
AI--enable_window_reports
F--change_font
R--window report (sent by terminal to host only,
ignored by terminal)
All parameters are separated by ";".
new_banner string, 0-64 bytes
icon_text string, 0-64 bytes
position [xx.xxx,yy.yyy]
- Leading "[", trailing "]" and
separator "," are required.
- Numbers are any positive real number.
The decimal point is not required
for whole numbers, nor are leading or
trailing zeros.
- The numbers represent the absolute
position in centimeters from the BOTTOM-
LEFT of the display to the BOTTOM-LEFT
of the window/icon.
1-25
VMS Workstation Software Version 3.3 Changes and New Features
- Window (or icon) positions that would
cause all or part of the window to
be off-screen cause the window to be
displayed as close as possible to the
location, but entirely on-screen.
setterminalbanner--change the text banner of a
terminal
Two parameters:
Parameter 1 "1" (3/1) indicates set_terminal_banner
Parameter 2 new_banner
If blank, use default banner
Text is centered. A null string is ignored. A maximum
of 64 characters can be specified; all additional
characters are ignored.
For example:
<OSC>21;VT220 Terminal<ST>
shrinktoicon--shrink a terminal window to an icon
Three parameters:
Parameter 1 "2" (3/2) indicates shrink_to_icon
Parameter 2 position
If blank, best fit to BOTTOM-LEFT or
previous icon position if icon has been
explicitly located.
Parameter 3 icon_text
If blank, use VMS PROCESS NAME
1-26
VMS Workstation Software Version 3.3 Changes and New Features
If the terminal is already an icon, the icon moves to
the position (if specified).
If terminal mailbox messages are enabled and the
SHRINK was done, this sequence generates a SHRINK
terminal mailbox message.
Examples:
<OSC>22;[1.5,2];VT220 Terminal Icon<ST>
Shrinks the terminal to an icon and places it at ( 1.5
, 2 ). The icon text is "VT220 Terminal Icon." If the
terminal is already an icon, the icon is moved to (
1.5 , 2 ) but the text is not changed.
expandfromicon--expand a terminal from an icon
Three parameters:
Parameter 1 "3" (3/3) indicates expand_from_icon
Parameter 2 position
If blank, restore to previous position.
Parameter 3 new_banner
If blank, do not change banner.
If the terminal is already expanded, the window is
moved to the position (if specified) and the banner
updated. Text is handled as in set_terminal_banner.
This sequence generates an EXPAND terminal mailbox
message if terminal mailbox messages are enabled and
the SHRINK was done.
Examples:
<OSC>23;;VT220 Terminal Banner Text<ST>
1-27
VMS Workstation Software Version 3.3 Changes and New Features
Expands the icon to terminal window and changes the
banner to "VT220 Terminal Banner." Because no new
position is specified, the position used is the last
position. If the terminal is not an icon, this call is
ignored (since no position is specified).
moveterminalwindow--move a terminal window
Three parameters:
Parameter 1 "4" (3/4) indicates move_terminal_window
Parameter 2 Position
Parameter required, otherwise sequence
ignored.
Parameter 3 banner
Optional, if supplied changes the banner
to this string.
If the terminal is in an icon state, the position is
used when next expanded to a terminal window.
This sequence generates a MOVED_WINDOW terminal
mailbox message if terminal mailbox messages are
enabled and the terminal was moved.
In addition to absolute coordinates, you can use
two special values for the position argument. An
unbracketed value of "16" causes the window to be
moved offscreen (made invisible). A value of "0"
causes the window to be moved to its previous location
if currently offscreen.
Example:
<OSC>24;[3.25,6.0]<ST>
This moves the terminal to [3.25,6].
<OSC>24;16<ST>
1-28
VMS Workstation Software Version 3.3 Changes and New Features
This makes the terminal invisible.
moveterminalicon--move a terminal icon
Three parameters:
Parameter 1 "5" (3/5) indicates move_terminal_icon
Parameter 2 position
Parameter required, otherwise sequence
ignored
Parameter 3 icon text
Optional, if supplied changes the icon
title to this string.
If the terminal is not in an icon state, the position
is be used for the next shrink to icon.
Example:
<OSC>25;[5,4]<ST>
disconnectkb--disconnect the keyboard
One parameter:
Parameter 1--"6" (3/6) indicates disconnect_keyboard
The physical keyboard is disconnected from the
terminal window. If the terminal is an icon, this
sequence is ignored. Use the F5 key to reconnect the
keyboard to the terminal by cycling.
This sequence generates a LOST_KB terminal mailbox
message if terminal mailbox messages are enabled and
the terminal is not an icon.
A UIS$DISABLE_KB is executed.
Example:
<OSC>26<ST>
1-29
VMS Workstation Software Version 3.3 Changes and New Features
disablekb--disable the keyboard
One parameter:
Parameter 1--"7" (3/7) indicates disable_keyboard.
The virtual keyboard is disabled. You can reconnect
the keyboard to the terminal only with the enable_
keyboard sequence.
This sequence generates a LOST_KB terminal mailbox
message if terminal mailbox messages are enabled and
the terminal is not an icon.
A UIS$DISABLE_VIEWPORT_KB is executed.
Example:
<OSC>27<ST>
enablekb--enable the keyboard
One parameter:
Parameter 1--"8" (3/8) indicates enable_keyboard.
The keyboard is connected to the terminal window.
This sequence generates a GAIN_KB terminal mailbox
message if terminal mailbox messages are enabled and
the terminal is not an icon.
If the window is an Icon, a UIS$ENABLE_VIEWPORT_KB is
performed. Otherwise, UIS$ENABLE_KB is performed.
Example:
<OSC>28<ST>
pushterminal--push the terminal/icon window
One parameter:
Parameter 1--"9" (3/9) indicates push_terminal_
window.
1-30
VMS Workstation Software Version 3.3 Changes and New Features
The window (terminal or icon) is "pushed" to the
background.
Example:
<OSC>29<ST>
popterminal--pop the terminal/icon window
One parameter:
Parameter 1--"A" (4/1) indicates pop_terminal_
window.
The window (terminal or icon) is "popped" to the
foreground.
Example:
<OSC>2A<ST>
disablemenuitem--disable a Window Options menu item
Two parameters:
Parameter 1 "B" (4/2) indicates disable menu item
Parameter 2 item mask
1 = Disable DELETE item
2 = Disable CHANGE SIZE item
4 = Disable SHRINK TO AN ICON item
8 = Disable ADDITIONAL OPTIONS item
The item mask is any value from 0 to 15 formed by
combining any of the above values. A value of zero
is ignored. The item in the Window Options menu is
disabled.
This sequence is ignored if the logical UIS$VT_
MENU_OPTIONS_LOCKED is defined to be "TRUE" when the
terminal is created.
1-31
VMS Workstation Software Version 3.3 Changes and New Features
Example:
<OSC>2B;10<ST>
This disables CHANGE SIZE and ADDITIONAL OPTIONS.
enablemenuitem--enable a Window Options menu item
Two parameters:
Parameter 1 "C" (4/3) indicates enable menu item
Parameter 2 item mask
1 = Enable DELETE item
2 = Enable CHANGE SIZE item
4 = Enable SHRINK TO AN ICON item
8 = Enable ADDITIONAL OPTIONS item
The item mask is any value from 0 to 15 formed by
combining any of the above values. A value of zero
is ignored. The item in the Window Options menu is
enabled.
This sequence is ignored if the logical UIS$VT_
MENU_OPTIONS_LOCKED is defined to be "TRUE" when the
terminal is created.
Example:
<OSC>2C;5<ST>
Enables DELETE and SHRINK TO ICON
changemultiscrollsize--change the size of the multi-
scroll feature
1-32
VMS Workstation Software Version 3.3 Changes and New Features
Two parameters:
Parameter 1 "D" (4/4) indicates change_multi_scroll_
size
Parameter 2 size
Parameter required, otherwise sequence
ignored
The size parameter is a floating point number that
derives the scrolling region size and produces a
maximum line count for multi-scroll optimization.
This number can be any positive value. There should be
no more than eight digits in the value. Values greater
than one are valid but not recommended.
Example:
<OSC>2D;.25<ST>
Sets the maximum deferred scroll count to 25% of the
scrolling region.
enablewindowreports--enable the window event reports
Variable parameters:
1-33
VMS Workstation Software Version 3.3 Changes and New Features
Parameter 1 "AI" (4/5) indicates enable window
reports
Parameter enable parameters
2-n
0--Disable all reports
1--Enable LOSE KB report
2--Enable GAIN KB report
3--Enable SHRINK to ICON report
4--Enable EXPAND from ICON report
5--Enable RESIZE WINDOW report
6--ENABLE MOVE WINDOW report
21--Disable LOSE KB report
22--Disable GAIN KB report
23--Disable SHRINK to ICON report
24--Disable EXPAND from ICON report
25--Disable RESIZE WINDOW report
26--Disable MOVE WINDOW report
This sequence enables reports for external windowing
events. These reports are also available as VMS
terminal mailbox messages.
See window_event_report (type = R) for the format of
the reports.
1-34
VMS Workstation Software Version 3.3 Changes and New Features
Example:
<OSC>2E;5;6;23;24<ST>
Enables reports for MOVE_WINDOW and RESIZE_WINDOW and
disables SHRINK and EXPAND icon reports.
changeterminalfont--redraw window with new font or
size
Four parameters:
Parameter 1 "F" (4/6) indicates change_terminal_font
Parameter 2 point size
If blank, use current point size. If
zero, use default point size. This is
the height of the font in points.
Parameter 3 spacing
If blank, use current spacing. If zero,
use default spacing. This is the width
of the font in points.
Parameter 4 family name
If blank, uses current font family. Case
is significant. The name is padded with
the character "0" if it is less than
seven characters long.
This sequence always causes the window to be recreated
with the specified font. All graphics in the display
are lost, but text is preserved. The sequence is
applied to the current font set (80 or 132 column
set).
Examples:
<OSC>2f;19;11;DVWSVT0<ST>
1-35
VMS Workstation Software Version 3.3 Changes and New Features
Changes the font to a 19-point, 11-pitch font named
DVWSVT0.
windoweventreport--Event reports
This OSC is sent FROM the terminal TO the host, it is
ignored if transmitted to the terminal.
Format:
<OSC>2R; Pt; D...D <ST>
Where:
"2R" = Window Event OSC
Pt = Event type:
1 = KB lose
2 = KB gain
3 = Shrink to icon
4 = Expand from icon
5 = Move window
6 = Resize window
D...D is the data associated with the report as
follows:
Event type 5 (resize_window),
<OSC>2R;5;x_pos,y_pos,width,height<ST>
X_pos and y_pos are floating point numbers. If
the position of the window is offscreen, a -1.0 is
returned for the coordinate value.
The width and height integer values indicate the size
of the terminal in character cells.
Event type 6 (move_window),
<OSC>2R;6;x_pos,y_pos<ST>
X_pos and y_pos are floating point numbers. If
the position of the window is offscreen, a -1.0 is
returned for the coordinate value.
1-36
VMS Workstation Software Version 3.3 Changes and New Features
All other events return no data.
Example:
<OSC>2R;5;5.2352,1.32,80,24<ST>
- Resize, new position = [ 5.2352 , 1.32 ], size =
80x24
<OSC>2R;6;-1.0,5.222<ST>
- Move, new position = [ -1.0 , 5.222 ] (the x
position is offscreen)
<OSC>2R;3<ST>
- Shrink to icon
__________________________________________________________________
1.11 ANSI Color Text SGRs
SGR - Select Graphic Rendition (Format Effector)
CSI Ps m
9/11 3/? 6/13
SGR is a format effector that specifies one or
more graphic rendition aspects for the characters
following in the data stream. The specified graphic
rendition aspects remain in effect either until the
next occurrence of SGR or until they are explicitly
changed by a following occurrence of SGR. Each graphic
rendition aspect is specified by a parameter value.
1-37
VMS Workstation Software Version 3.3 Changes and New Features
Text color specification is ignored unless the
terminal is created with UIS$VT_PRIVATE_COLOR_MAP TRUE
and at least eight colors are available. The presence
of ANSI Color Text is shown in the Primary Device
Attribute report as a value of 22.
1-38
VMS Workstation Software Version 3.3 Changes and New Features
_______________________________________________________
Ps_____Aspect_Changed__________________________________
0 Default rendition (all attributes OFF, or
at default state). Cancels the effect of any
preceding SGR.
1 Bold or increased intensity
4 Underlined
5 Slowly blinking (.5 hz)
7 Negative image (reverse video)
8 Concealed characters
22 Not bold
24 Not underlined
25 Steady (not blinking)
27 Positive image
28 Revealed characters
30 Black text
31 Red text
32 Green text
33 Yellow text
34 Blue text
35 Magenta text
1-39
VMS Workstation Software Version 3.3 Changes and New Features
_______________________________________________________
Ps_____Aspect_Changed__________________________________
36 Cyan text
37 White text
39 Default text (white)
40 Black text background
41 Red text background
42 Green text background
43 Yellow text background
44 Blue text background
45 Magenta text background
46 Cyan text background
47 White text background
49_____Default_text_background_color_(black)___________
The ANSI color to color map index translation follows.
1-40
VMS Workstation Software Version 3.3 Changes and New Features
Index 0 Black
Index 1 Blue
Index 2 Red
Index 3 Magenta
Index 4 Green
Index 5 Cyan
Index 6 Yellow
Index 7 White
__________________________________________________________________
1.12 VWS VT200 Terminal Emulation Copy and Paste
The following sections specify the copy and paste
functions implemented for VWS V3.3 terminal emulation.
___________________________
1.12.1 Description:
Copy and paste provides a mechanism to transfer
text between terminal windows. It is not a general
UIS facility, and text cannot be moved between non-
terminal windows. It is expected that a future release
of UIS will supply a clipboard facility that the VT200
emulator can take advantage of. A 16k byte global
buffer is used as the terminal "clipboard" and is
interlocked to prevent concurrent updating.
Two modes of operation are possible:
o Transparent mode provides application transparent
(non-cooperating) copy and paste facilities between
terminal windows. An area of text is selected using
1-41
VMS Workstation Software Version 3.3 Changes and New Features
the locator (mouse or tablet). The selected text is
copied to the global buffer and can be transmitted
to the host as keyboard data. Transparent mode is
not available when the terminal is in ANSI locator
report mode (LRP) or when the terminal is in ReGIS
mode.
o Programmed mode provides a set of escape sequences
to load and transmit the Paste Buffer under program
control. Combined with the ANSI locator sequences,
applications can do their own cut, copy, and paste
operations using the system-wide paste buffer.
_____________________
1.12.1.1 Human Interface (Transparent Mode)
The select and paste functions are assigned to the
M2 and M3 locator buttons. By default, Select is
bound to M2 and Paste to M3. You can reverse this
assignment with a logical name assignment evaluated
during terminal reset. M1 always cancels a select
operation in progress.
Transparent mode operations can be selectively enabled
and disabled for each terminal window. The default
can be established by assignment of a logical name
evaluated during a terminal reset. It can also be
changed with an escape sequence under program control.
Copy and Paste functions are independent and can be
individually enabled/disabled.
1-42
VMS Workstation Software Version 3.3 Changes and New Features
_____________________
1.12.1.2 Button Operation
Pressing any button causes the terminal window to
be popped if it is occluded and the keyboard to be
assigned if enabled and not attached.
M1 (Left[1]) Cancel selection
M2 (Center) Select (copy)
M3 (Right[1]) Paste
_______________________________________________________
[1]Right-hand SETUP
_____________________
1.12.1.3 Copy Operations
To begin a copy operation, click the select button.
The beginning of the selection of the text to be
copied is highlighted according to the selection
style:
Rectangular--A complement mode outline is drawn
around the targeted character cell position. This
character cell becomes one corner of the select
area. Moving the locator causes the outline shape
to rubberband; the locator position is the opposite
corner of a rectangular area to be selected. To
cancel the operation, click the M1 button. Click the
select button again to copy all the text within the
rectangular area to the Paste Buffer.
Stream (editor-style)--This is similar to editor text
selection. The targeted character cell position is
highlighted (by default reverse video); moving the
mouse highlights the text between the first selection
point and the current position. You can alter the
highlight attributes to allow for color, reverse
video, bold, and underline as alternate mechanisms
for highlighting the selected text.
1-43
VMS Workstation Software Version 3.3 Changes and New Features
Press the select or paste button to complete the copy.
This copies the text within the selected area into the
paste buffer, including control sequences to select
character sets and graphic rendition. All lines but
the last have a <CR> appended. Unwritten character
positions at the end of each line can be optionally
trimmed.
The selected text is redrawn in its normal rendition
in stream mode, or the rubberband box is erased in
rectangular mode. The cancel button can unhighlight
the selected text and exits the copy operation rather
than copying data into the paste buffer.
The transparent copy operation copies text within
the selected area into the paste buffer, including
control sequences to select character sets and
graphic rendition. All lines but the last have a <CR>
appended. Unwritten character positions at the end of
each line can be trimmed. The text is always prefixed
by sequences that set the correct default settings;
these sequences can be removed from the pasted data
later.
NOTE: The VWS emulator can distinguish between
character cells that are normal rendition spaces
and cells that have not had data written to them.
Unwritten character cells that precede the last
graphic data on the line are converted to spaces even
if unwritten.
1-44
VMS Workstation Software Version 3.3 Changes and New Features
_____________________
1.12.1.4 Paste Operations
Initiate a paste operation by clicking the paste
button while pointing to a terminal window. The data
in the paste buffer is transmitted to the terminal as
keyboard data.
The paste operation transfers the contents of the
paste buffer to the terminal input buffer. During
this operation, the paste buffer is locked and cannot
be accessed by another copy or paste operation. The
buffer can be filtered to allow only the graphic
character data and BELL, BS, HT, LF, FF, and CR
controls. This removes escape, control, device, and
operating sequences.
NOTE: If flow control (HOSTSYNCH) is enabled for the
terminal, you can transmit a paste buffer larger
than the terminal type-ahead buffer. If flow control
is not enabled, data overruns can occur from paste
operations.
___________________________
1.12.2 Programmed Mode
No human interface is imposed on an application that
directly accesses the copy and paste facilities.
Instead, sequences allow terminal applications to
implement their own human interface. Applications can
thus provide a "native" application-specific selection
mechanism. Sequences enable copying to and dumping
from the paste buffer.
The copy to paste buffer, transmit paste buffer, and
begin selection sequences in combination with the
ANSI locator input model enable a flexible programmer
interface to copy and paste.
1-45
VMS Workstation Software Version 3.3 Changes and New Features
_____________________
1.12.2.1 Copy Operations
A device control sequence enables a program to write
arbitrary data into the Paste Buffer. The data is
encoded as hex pairs and allows any value to be
written.
_____________________
1.12.2.2 Paste Operations
A control sequence transmits the paste buffer contents
to the host. An optional parameter causes this data
to be transmitted as encoded hex pairs within a DCS
string.
Table 1-6 lists logical names defined for system setup
operations.
Table 1-6 Logical Names for SETUP
_______________________________________________________
Logical_Name________Default___Function_________________
UIS$VT_ENABLE_COPY FALSE Enables transparent Copy
UIS$VT_ENABLE_ FALSE Enables transparent
PASTE Paste
UIS$VT_PASTE_ CR Format for transparent
FORMAT mode Paste
0 = Graphic characters
plus BELL, BS, HT, LF,
FF, CR
1 = All data
(unfiltered)
UIS$VT_BUTTON_MAP M3:Paste Locator button
assignment
0 = M2:Copy, M3:Paste
1-46
VMS Workstation Software Version 3.3 Changes and New Features
Table 1-6 (Cont.) Logical Names for SETUP
_______________________________________________________
Logical_Name________Default___Function_________________
1 = M3:Copy, M2:Paste
UIS$VT_HIGHLIGHT_ REVERSE Selects the graphic
MASK video rendition for text
Highlighting in stream
type selects.
The format of this mask
is to be TBD.
UIS$VT_STREAM_ TRUE Enables stream style
SELECT text selection
For transparent mode
Copy operations. If this
is FALSE, rectangular
style selection is done.
UIS$VT_SELECT_TRIM TRUE Enables trimming of
trailing unwritten
character positions.
If FALSE, trailing
unwritten cells are
converted to the space
character.
_______________________________________________________
___________________________
1.12.3 Terminal Sequences
Private selectable mode (SM/RM) parameter: DECTPM
Transparent Paste Mode (DECTPM) has been assigned the
following private selectable mode parameter:
?76
1-47
VMS Workstation Software Version 3.3 Changes and New Features
To set DECTPM, the full Set Mode control function is
as follows:
CSI ? 7 6 h
9/11 3/15 3/7 3/6 6/8
To reset DECTPM, the full Reset Mode control function
is as follows:
CSI ? 7 6 l
9/11 3/15 3/7 3/6 6/12
DECTPM determines whether a particular terminal can
accept a paste user-request.
Private selectable mode (SM/RM) parameter: DECTCM
Transparent Copy Mode (DECTCM) is assigned the
following private selectable mode parameter:
?77
To set DECTCM, the full Set Mode control function is
as follows:
CSI ? 7 7 h
9/11 3/15 3/7 3/7 6/8
To reset DECTCM, the full Reset Mode control function
is as follows:
CSI ? 7 7 l
9/11 3/15 3/7 3/7 6/12
DECTCM determines whether a particular terminal can
accept a copy user-request.
The Select Transparent Paste Format (DECSTPF) control
sequence is registered as follows:
CSI Ps ) s
9/11 3/? 2/9 7/3
1-48
VMS Workstation Software Version 3.3 Changes and New Features
where the value of the selective parameter (Ps)
indicates:
0--Graphic data only, plus BELL, BS, HT, LF, FF and
CR
1--Unfiltered
DECSTPF selects the format in which the terminal
receives pasted information from the paste buffer. The
graphic data only format filters the paste buffer data
and allows only graphic characters and selected C0
controls to be transmitted. This removes, for example,
SGR and SCS information from the data stream. The
unfiltered mode transmits the paste buffer unaltered
except for translation of 8-bit to 7-bit controls,
based on the C1 transmission mode setting.
The Transmit Transparent Paste Buffer (DECTTPB)
control sequence is registered as follows:
CSI Ps; Pf ) t
9/11 3/? 3/? 2/9 7/4
where the value of the selective parameter (Ps)
indicates:
0--Graphic data only, plus BELL, BS, HT, LF, FF, and
CR
1--Unfiltered
and the value of the format parameter (Pf) indicates:
0--Transmit ASCII data
1--Transmit as DECCTPB DCS encoded string
DECTTPB transmits the current contents of the paste
buffer to the host. The graphic data only format
filters the paste buffer data and allows only graphic
characters and selected C0 controls to be transmitted.
This removes, for example, SGR and SCS information
from the data stream. The unfiltered mode transmits
the Paste Buffer unaltered except for translation of
1-49
VMS Workstation Software Version 3.3 Changes and New Features
8-bit to 7-bit controls, based on the setting of C1
transmission mode.
If the optional parameter Pf is 0 or omitted, the
data is transmitted to the host as ASCII data with
no indication of the beginning or end of the data. If
Pf is 1, the Paste data is transmitted as hexadecimal
pairs and is included in a DECCTPB DCS/ST envelope:
DCS Pc ! x D...D ST
9/11 2/1 7/8 ?/?...?/? 9/12
The data of the DECCTPB string consists of hexadecimal
pairs representing the contents of the paste buffer.
The parameter Pc indicates the byte count of the
following D...D data.
The Copy Text to Paste Buffer (DECCTPB) device control
string is registered as follows:
DCS ! x D...D ST
9/11 2/1 7/8 ?/?...?/? 9/12
The data of the DECCTPB string consists of hexadecimal
pairs to be inserted into the Paste Buffer. Maximum
past buffer size is implementation-dependent. Data
greater than this is be ignored.
__________________________________________________________________
1.13 Demonstration Software
The VMS Workstation Software V3.3 demo kit includes
some programs that illustrate the use of various
UIS$* routine calls. The kit includes both sources and
images. The demo kit installation procedure enables
you to select demonstration programs in a variety of
languages.
A VWSDEMO.RELEASE_NOTES file included with the kit
contains more detailed information about each demo.
This file explains how the demos are compiled and
linked. VMSINSTAL places the demonstration programs in
directories on SYS$SYSDEVICE:[VWSDEMO].
1-50
VMS Workstation Software Version 3.3 Changes and New Features
The following directory listing contains all demo
files provided for each language.
SYS$DEMO is defined as SYS$SYSDEVICE:[VWSDEMO.]
Directory SYS$DEMO:[000000]
B32.DIR CC.DIR COM.DIR EPAS.DIR
FOR.DIR PAS.DIR PLI.DIR
Total of 7 files.
Directory SYS$DEMO:[B32]
BANNER.EXE BOUNCE.B32 BOUNCE.EXE BOUNCE_ICON.MAR
DATETIME.B32 DATETIME.EXE DEMOMENU.B32 DEMOMENU.EXE
SIMPLE_BANNER.B32 SIMPLE_BANNER.EXE
Total of 10 files.
Directory SYS$DEMO:[CC]
CHROMA_TRIANGLE.C CHROMA_TRIANGLE.EXE CPETAL.C
CPETAL.EXE CREATE_MENU.C DELAUNAY.C DELAUNAY.EXE
DISPLAY_LIST.C DISPLAY_LIST.EXE DOPEXAMPLE.C DOPEXAMPLE.EXE
DOP_FILLED_CIRCLES_C.C DOP_FILLED_CIRCLES_C.EXE
FLAG.EXE FLAGS.C FLAG_COLORS.C FLAG_DEMO.C
JTRACE.C JTRACE.EXE KEYBOARD.C KEYBOARD.EXE
KILLPID.C LOADMENU.C MENU.C MENU.EXE
MENUDEF.H MENUFILE.TXT MENU_C.C MENU_C.EXE
MOUSEAST.C MOUSEAST.EXE MOUSEOVERHEAD.C MOUSEOVERHEAD.EXE
NOBANN_NOBORD.C NOBANN_NOBORD.EXE PATTERN.C PATTERN.EXE
QUAD_DEMO.C QUAD_DEMO.EXE RUBBER.H RUBBERBAND.C
RUBBERBOX.C RUBBERBOX.EXE SCROLLFILE.C SCROLLFILE.EXE
SCROLLINE.C SCROLLINE.EXE SDYN.C SDYN.EXE
SHAPES.C SHAPES.EXE VWS_MENU.C VWS_MENU.EXE
VWS_SCROLL_BAR.EXE VWS_SCROLL_BAR.EXE
Total of 55 files.
Directory SYS$DEMO:[COM]
1-51
VMS Workstation Software Version 3.3 Changes and New Features
BANNER.COM BOUNCE.COM BOXES.COM CLOCK.COM
CPUZZLE.COM CUBE.COM DATETIME.COM DECLANDER.COM
DEFINE_FONTS.COM DEMOLOOP.COM DEMOMENU.COM DEMOMENU.DAT
DEMOMENU2.COM DISPFONT.COM FILLPAT.COM GRAY.COM
JTRACE.COM PATTERN.COM QIX.COM QIXLOOP.COM
ROSE.COM RUN_DOODLE.COM SHOWFONT.COM SIMPLE_BANNER.COM
SPIRO.COM STRIP.COM
Total of 26 files.
Directory SYS$DEMO:[EPAS]
ALPHA.MAR BRUSH.MAR CALC.EPAS CALCI.MAR
CALENDAR.EPAS CALENDARI.MAR CDOODLE.EPAS CDOODLE.EXE
CIRCLE.MAR CLOCKI.MAR CPUZZLE.EPAS CPUZZLE.EXE
DESK.EPAS DESK.EXE DIGITALCLOCK.EPAS DOODLE.EPAS
DOODLE.EXE ELLIPSE.MAR ERASER.MAR EUIS.EPAS
FCIRCLE.MAR FELLIPSE.MAR FPOLY.MAR FRECTANGLE.MAR
MENU.EPAS MOVEC.MAR MOVER.MAR PENCIL.MAR
POLY.MAR RECTANGLE.MAR RLINE.MAR SPRAY.MAR
UISENTRY.EPAS UISUSRDEF.EPAS
Total of 34 files.
Directory SYS$DEMO:[FOR]
ALL_COLORS.EXE ALL_COLORS.FOR AST.EXE AST.FOR
BOUNCE_SUBS.FOR BUTTONAST.EXE BUTTONAST.FOR CUBE.EXE
CUBE.FOR DISTORT.EXE DISTORT.FOR DOILOOP.EXE
DOILOOP.FOR DOILYDC.COM DOILYDC.EXE DOILYDC.FOR
DOP_FILLED_CIRCLES_FOR.EXE DOP_FILLED_CIRCLES_FOR.FOR
FONTS2.EXE FONTS2.FOR MODE.EXE MODE.FOR
OR_MODE.EXE OR_MODE.FOR PAN.EXE PAN.FOR
PSYCHO.EXE PSYCHO.FOR QIX.EXE QIX.FOR
QIXLOOP.EXE QIXLOOP.FOR READCHAR.EXE READCHAR.FOR
ROSE.EXE ROSE.FOR SPIRO.EXE SPIRO.FOR
STRPCHRT.EXE STRPCHRT.FOR WHEEL.EXE WHEEL.FOR
WHEEL_UISDC.EXE WHEEL_UISDC.FOR ZOOM.EXE ZOOM.FOR
Total of 46 files.
Directory SYS$DEMO:[PAS]
1-52
VMS Workstation Software Version 3.3 Changes and New Features
ARCH_DATA.MAR ASTRO_DATA.MAR DECLANDER.EXE DECLANDER.PAS
DLCREATE.INC DLDRAW.INC DLFUNC.INC DLGLOBALS.INC
DLINIT.INC DLMOVE.INC DLUPDATE.INC DOP_FILLED_CIRCLES_PAS.EXE
DOP_FILLED_CIRCLES_PAS.PAS DUST_DATA.MAR FLAG_DATA.MAR
FONTS.EXE FONTS.PAS RAND.MAR SETUP_COLORS.PAS
SHIP_DATA.MAR TEXTPOS.EXE TEXTPOS.PAS YCOOR.MAR
Total of 23 files.
Directory SYS$DEMO:[PLI]
BOXES.EXE BOXES.PLI CLOCK.EXE CLOCK.PLI
DESIGNS.EXE DESIGNS.PLI DIGICLOCK.COM DIGICLOCK.EXE
DIGICLOCK.PLI DISPFONT.EXE DISPFONT.PLI FILLPAT.EXE
FILLPAT.PLI GRAY.EXE GRAY.PLI SHOWFONT.EXE
SHOWFONT.PLI SPEED.EXE SPEED.PLI
Total of 19 files.
__________________________________________________________________
1.14 Hardcopy UIS
The VMS Workstation Version 3.3 software kit contains
media and documentation for Hardcopy UIS (HCUIS).
It enables users and applications to translate UIS
pictures to the formats needed for printing on a
variety of hard-copy devices.
The kit for HCUIS consists of the following:
o The RENDER command, which translates and displays
UIS picture files
o Four translators
UIS to postscript[T]
UIS to SIXEL
UIS to HPGL
UIS to ReGIS
________________
[T] postscript is a registered trademark of Adobe Systems
Incorporated.
1-53
VMS Workstation Software Version 3.3 Changes and New Features
o HCUIS routines
See the VMS Workstation Guide to Printing Graphics for
additional information about HCUIS.
__________________________________________________________________
1.15 Local Area VAXclusters
Version 3.1 of the VMS Workstation Software supports
Local Area VAXclusters.
__________________________________________________________________
1.16 VAXstation 2000
Version 3.1 of the VMS Workstation Software supports
the monochrome VAXstation 2000. Version 3.2 supports
the color, gray-scale, and monochrome (bitonal)
VAXstation 2000.
__________________________________________________________________
1.17 Changes to the VT220 Emulator
___________________________
1.17.1 Version 3.3
In previous versions of VMS Workstation Software,
when you set the keyboard language to SWISS-GERMAN
or SWISS-FRENCH in the workstation set-up menu, the
<CTRL/Y> and the <CTRL/Z> keys did not get remapped
properly and gave incorrect results.
In V3.3, the <CTRL/Y> and <CTRL/Z> are now remapped
properly to give the correct results, as do those keys
in the GERMAN keyboard.
1-54
VMS Workstation Software Version 3.3 Changes and New Features
___________________________
1.17.2 Version 3.2
o A Point Size/Spacing fallback has been added.
o The VT52 mode keyboard errors have been fixed.
o End-of-line wrap and overwrite handles double-wide
lines correctly.
o A number of edit control sequence errors have been
corrected.
o Blinking works on terminals wider than 132 columns.
o Specifying a point size of only one digit is no
longer a problem.
o Resizing an invisible window (WDPL$M_INVISIBLE for
placement) no longer causes visibility.
o The code ignores APL and TCS SCS sequences if the
fonts do not exist.
o If the Display Controls Mode font is not found,
this mode does not change.
o The sequences to report page width and height have
been corrected.
1-55
_______________________________________________________
2 VMS Workstation Software Problems and Restrictions
This chapter describes problems and restrictions
you might encounter when using the VMS Workstation
Software. The chapter describes the problems and
restrictions of the user interface, programming
interface, and device driver interface in separate
sections.
__________________________________________________________________
2.1 Version 3.3
___________________________
2.1.1 ReGIS Restrictions
The implementation of ReGIS for this release of VMS
Workstation Software is based on VT241 ReGIS. It has
the following restrictions:
o No plane mask--the plane mask causes the following
problems:
- Produces odd results when you use certain
products (like DECslide). Try a <CTRL/W> to
clear things up.
- Causes some products not to work at all.
o Line patterns might be wrong (pattern not right)
This happens because there is a bug in the way
patterned lines are drawn in UIS.
o Pattern multiplication is limited to 32 bits
This is a limit in the way UIS creates line
patterns.
o Text is not clipped to display cell size
2-1
VMS Workstation Software Problems and Restrictions
Text is displayed at the full unit cell size and is
not clipped. This is true because there is little
support for this in UIS. (It is unlikely that this
limitation will ever be removed.)
o Unit cell characters that are smaller than the
display cell are not replicated in the display
cell.
Only one copy of the character is inside the
display cell. (It is unlikely that this limitation
will ever be removed.)
___________________________
2.1.2 SET HOST/DTE
Do not use the VMS feature SET HOST/DTE with VMS
Workstation Software. When you use SET HOST/DTE in
conjunction with the Hold Screen key or <CTRL/S>, it
consumes all available process address space. When VMS
Workstation Software then tries to allocate memory,
none is available and a system crash occurs.
___________________________
2.1.3 Tiling
By default, VMS Workstation Software starts up with
only the necessary fonts. If you want larger fonts,
rename the files in SYS$FONT from UIS$LOAD_FONT*.TE to
UIS$LOAD_FONT*.COM.
NOTE: Rename only the files that contain fonts you want
to use.
In addition, the Technical Character Set fonts are
loaded by default. If you do not normally use these
fonts, rename the UIS$LOAD_FONT_TCS*.COM files in
SYS$FONT to UIS$LOAD_FONT_TCS*.TEMPLATE.
2-2
VMS Workstation Software Problems and Restrictions
___________________________
2.1.4 Listing of Fonts
A complete list of fonts included with the VMS
Workstation Software kit is provided in the VMS
Workstation Software Installation Guide, Appendix A.
Check that list to make sure you are not overburdening
your system with unneeded fonts. You can delete any
unnecessary fonts from your system.
___________________________
2.1.5 Print Destination Restriction
There is now a restriction on the use of the Enter new
print destination option of the Printer Setup menu.
See Section 1.6 for a detailed explanation of this
restriction.
__________________________________________________________________
2.2 Version 3.2
The following section describes problems and
restrictions that occur with Version 3.2 of the VMS
Workstation Software.
___________________________
2.2.1 User Interface
The following sections describe problems and
restrictions in the user interface.
_____________________
2.2.1.1 VAXstation II/GPX Boot Problem
If your VAXstation II/GPX system is unresponsive
during a boot or shutdown operation, press the F2
key. The system may have written a message to the
operator console window and may be waiting for you
to read the message before it continues. The operator
console window stays activated only for 30 seconds.
This restriction prevents the possibility of hanging
your workstation.
2-3
VMS Workstation Software Problems and Restrictions
_____________________
2.2.1.2 Restriction with Autologin
If you log in to your first terminal emulator window
while autologin is enabled and then quickly create
another emulator, you may not be automatically logged
in to the second window. This is because the process
information for the first window has not yet been
saved. A solution is to wait until the initial login
procedure has executed before creating additional
terminal emulators.
___________________________
2.2.2 Programming Interface
The following sections describe problems and
restrictions in the programming interface.
_____________________
2.2.2.1 UIS$CTEXTWRITE--16-Bit Text Problem
When you use text with control lists and 16-bit
text (for example, 2-byte Kanji fonts), the control
list item UIS$C_TEXT_WRITE should have a value that
specifies the number of characters it writes. VWS
interprets this value as the number of bytes VWS
writes instead. To avoid this problem when you use 16-
bit text, specify double the number of characters you
want to write as a value for the control list item.
_____________________
2.2.2.2 UIS$CIRCLE and UIS$ELLIPSE--Overflow
Problem
On both VAXstation II and VAXstation II/GPX systems,
UIS$CIRCLE or UIS$ELLIPSE may occasionally draw large
circles or ellipses incorrectly, due to an overflow in
the coordinate conversion.
2-4
VMS Workstation Software Problems and Restrictions
_____________________
2.2.2.3 UIS$DISABLEKB and
UIS$DISABLEVIEWPORTKB--AST Not
Delivered
When a virtual keyboard is disabled by a UIS$DISABLE_
KB or UIS$DISABLE_VIEWPORT_KB, the Lose Keyboard AST
routine is not delivered. If your application depends
on this AST being received after the virtual keyboard
has been detached from the physical keyboard, you must
explicitly call the AST routine after disabling the
keyboard.
_____________________
2.2.2.4 UIS$SETKBATTRIBUTES--Spurious Data
When you use the Up/Down key transitions enabled by
UIS$SET_KB_ATTRIBUTES, you might get spurious data
when the physical keyboard is attached to the window.
A possible solution is to ignore incoming data for a
short time after getting a GAIN_KB_AST. This will be
fixed in a future release.
_____________________
2.2.2.5 UIS$SETPOINTERAST--Late Execution of
Exit AST Routines
When two contiguous regions have been set up with
UIS$SET_POINTER_AST, you might execute an exit AST
intended for the previous region after executing the
first movement AST routine for the new region.
To clarify, when you exit from one region and enter
the other, three actions occur in the following order:
1 The last movement in the first region
2 Exiting from the first region
3 The first movement in the new region
However, the ASTs associated with these actions may be
delivered out of order: last movement, first movement,
exit.
2-5
VMS Workstation Software Problems and Restrictions
The recommended solution is to test for the first
movement on any contiguous region and emulate the
exit AST before taking any other action. According
to the application, you may wish to emulate only some
essential portion of the exit AST routine and let the
actual AST perform the remainder when it is executed.
_____________________
2.2.2.6 Drawing Images That Use Eight
Bits/Pixel
When drawing images that use eight bits/pixel, use the
COPY writing mode (UIS$C_MODE_COPY) to use the pixel
values as direct indexes into the color map. This
writing mode copies each pixel value from the image
into the bit map without any changes to the data.
The default writing mode (UIS$C_MODE_OVER) does not
work as copy mode does.
___________________________
2.2.3 Text Problems
The following sections describe problems and
restrictions to using text with the programming
interface.
_____________________
2.2.3.1 Extracting Transformed Control Lists
The result of extracting transformed control list
text is undefined. That is, the following sequence
of routine calls produces a buffer containing
unpredictable results:
UIS$TEXT(vd_id, atb, text_string, x, y, ctllist, ctllen)
obj_id = UIS$GET_CURRENT_OBJECT(vd_id)
UIS$TRANSFORM_OBJECT(obj_id, matrix, atb)
UIS$EXTRACT_OBJECT(obj_id, buflen, bufaddr, retlen)
Note, however, that the results on the screen and
within UIS internal display list are correct.
2-6
VMS Workstation Software Problems and Restrictions
_____________________
2.2.3.2 Tabs in Control Lists
Text that has a control list containing relative or
absolute tabs may produce unexpected results if the
text falls under any of the following categories:
o Sloped
o Written with a non-default major text path (for
example, UIS$C_TEXT_PATH_LEFT)
o Transformed (using UIS$TRANSFORM_OBJECT or
UIS$COPY_OBJECT) to be sloped
Slanted text that has a control list containing
relative or absolute tabs may erase portions of
characters when written with any writing mode that
writes the background, such as overlay negate.
_____________________
2.2.3.3 Text Placement and Display Lists
After calling UIS$TEXT and UIS$NEW_TEXT_LINE to create
lines of text, you may wish to insert more text at the
end of a line. Since text position is undefined when
you insert text into a display list, you should always
explicitly position your inserted text.
_____________________
2.2.3.4 Text Formatting Problems
The following sections describe problems and
restrictions when formatting text.
Enabling and Disabling Text Formatting
If the original input attribute block for a UIS$TEXT
or UISDC$TEXT call with a control list does not have
text formatting enabled and a subsequent ATB in
the control list does format text, the results are
undefined.
2-7
VMS Workstation Software Problems and Restrictions
Formatted Text with Non-default Attributes
Formatted text gives undefined results if the text or
vertical major text path being written has non-default
attributes of slant, slope, rotation, or character
size. Formatted text that is transformed to have
non-default attributes of slant, slope, rotation,
or character size also gives undefined results.
Full Text Justification of Nonstandard Fonts
For fully justified text to work correctly with fonts
other than those supplied on the distribution kit,
the glyph for the space character must be in the 33rd
position in the font, which is the same position as
the ASCII space character in the supplied fonts.
_____________________
2.2.3.5 Sloped Text
The following sections describe the behavior of sloped
text when it is viewed through a distorted viewport.
Text Slope Angles with Distorted Windows
If you use UIS$TEXT to display sloped text and a
distorted window/viewport mapping (that is, the aspect
ratio of the window differs from the aspect ratio
of the viewport), the results differ, depending on
whether character scaling is enabled. If character
scaling is not enabled, the angle is displayed
relative to the device. For example, at a slope of
45 degrees (with major path right), each character
position moves up and right by the same number of
pixels. If character scaling is enabled, the slope is
measured relative to world coordinates. For example,
at a slope of 45 degrees (with major path right),
each character position moves up and right by the same
world-coordinate amount.
If you use UISDC$TEXT to display sloped text, the
slope angles are measured based on device coordinates,
regardless of whether scaling is enabled.
2-8
VMS Workstation Software Problems and Restrictions
This behavior is permanent and is consistent with
other uses of unscaled text and UISDC routines with
distorted viewport/window mappings.
Text Slope Angles on VR100 Monitors
If sloped text is displayed using UIS$TEXT with
character scaling disabled, the angles appear to be
distorted, even if the viewport and window aspect
ratios are the same. The reason for this behavior is
that the angle is being drawn in device coordinates,
and pixels on a VR100 are not square. To make the
angle appear correct, you must enable character
scaling, using the UIS$SET_CHAR_SIZE routine.
If sloped text is displayed using UISDC$TEXT, angles
appear distorted on a VR100 monitor.
This behavior is permanent and is consistent with
other uses of unscaled text and UISDC routines with
VR100 monitors.
NOTE: The only supported hardware device that uses a
VR100 monitor is a VAXstation I.
_____________________
2.2.3.6 Restrictions on Writing Modes That
Change the Background
Scaled Text on GPX systems
When the VAXstation II/GPX hardware compresses text,
it can write both the background and foreground colors
into the same pixel on the screen. If you are using
a writing mode that changes background pixels (for
example, REPL or REPLN), the foreground pixels can
be overwritten. This can result in what appears to
be missing pixels in scaled characters. Scaling is
done implicitly if text is drawn at slope, rotation,
or slant angles that are not 0 or multiples of 90
degrees.
This restriction is permanent.
2-9
VMS Workstation Software Problems and Restrictions
Text Written at Angles
If text is written in a mode that causes the
background of the cell to be written (for example,
REPL or REPLN), unwritten pixels may exist between
adjacent character cells. This effect only happens
with slope, rotation, or slant angles that are not 0
or multiples of 90.
Digital believes that this is an unavoidable effect
of rasterization but continues to investigate possible
future improvements.
___________________________
2.2.4 Device Driver Interface
MOVE/ROTATE DOP--Specifying Scaling
There is a problem in specifying scaling in the
MOVE/ROTATE Drawing Operation Primitive (DOP).
If the sourcewidth divided by the vec1length or the
sourceheight divided by the vec2length cannot be
represented exactly in 12 bits or fewer, a pixel may
be dropped from the end of the source.
The recommended solution is to decrease the vector
length (usually by a constant 1 or 2 pixels), without
changing the Dx or Dy values, until the full source is
drawn correctly.
___________________________
2.2.5 System Management Interface
If the SYSTEM account is not usable, VMS Workstation
Software does not load correctly when you reboot the
VAXstation hardware. Loading fails when the password
for the SYSTEM account is expired. To update the
password for the SYSTEM account, invoke the VMS
Authorize Utility (AUTHORIZE).
2-10
VMS Workstation Software Problems and Restrictions
___________________________
2.2.6 User Interface
RESIZE WINDOW Time-Out Implemented
The RESIZE WINDOW feature has been modified so that
it stays activated for 30 seconds. This restriction
prevents the possibility of hanging your workstation.
Receiving Operator Messages in a Local Area VAXcluster
When your workstation is a member of a Local Area
VAXcluster, its operator window is disabled by
default. Digital recommends that you do not re-enable
the operator window. Instead, to monitor operator
messages, create a terminal emulator window and enter
the REPLY/ENABLE command at the DCL prompt ($). To
execute the REPLY/ENABLE command, you must have the
OPER privilege.
SET PROCESS/SUSPEND Command Can Cause Your Workstation
to Hang
Entering the SET PROCESS/SUSPEND command to suspend
a workstation process that creates windows can cause
your workstation to hang. That is, no further display
operations are executed.
The locks control the process access to the
workstation display. When you use the SET
PROCESS/SUSPEND command to suspend a process that
currently holds a lock, the process cannot give up its
display lock, thereby preventing other processes from
accessing the display.
To return your workstation to normal operation,
enter the SET PROCESS/RESUME command, specifying the
suspended process.
2-11
VMS Workstation Software Problems and Restrictions
___________________________
2.2.7 Programming Interface
VWSSYSDEF.H Contains Syntax Errors
If you select the C language option in the
installation procedure, the resulting VWSSYSDEF.H
file contains syntax errors. These syntax errors cause
compiler warnings when you include the VWSSYSDEF.H
file in your program.
To avoid these compiler warnings, edit the file to
remove the dimension specification ("[1]") from the
declarations of the following structures:
dop_point_array
dop_line_array
dop_ftext_array
dop_vtext_array
dop_poly_array
dop_move_array
dop_move_r_array
dop_mvr_array
SYS$SUSPEND Calls Can Cause Your Workstation to Hang
Calling the SYS$SUSPEND system service to suspend a
workstation process that creates windows can cause
your workstation to hang. That is, no further display
operations are executed.
The locks control the process access to the
workstation display. When you use the SYS$SUSPEND
system service call to suspend a process that
currently holds a lock, the process cannot give up
its display lock, thereby preventing other processes
from accessing the display.
To return your workstation to normal operation, issue
a SYS$RESUME system service call, specifying the
suspended process.
2-12
VMS Workstation Software Problems and Restrictions
Undesirable Visual Effects Caused by Hardware Replay
to a Previously Occluded Area of the VAXstation II/GPX
Display
On a VAXstation II/GPX, the VMS Workstation Software
uses two methods to restore occluded windows that have
become exposed. First, it can specify that the GPX
hardware "replay" the list of commands that generated
the graphics in the occluded area. When the list of
commands gets too long, the VMS Workstation Software
switches to its second method, which saves the screen
contents in the occluded area and copies them to the
display when the occluded area is exposed.
In some applications, the first replay method causes
undesirable visual effects. To avoid these undesirable
visual effects, execute a scrolling operation within
the viewport. The scrolling operation causes the VMS
Workstation Software to switch from the replay method
to saving the screen contents in the occluded area.
To execute a scrolling operation in the viewport, you
can either make a call to UIS$MOVE_WINDOW or, if you
are using the DOP interface, queue a SCROLL_AREA DOP.
You should specify the same world coordinates in the
move window call that you specified when you created
the window.
The following FORTRAN code segment demonstrates how
to disable hardware replay when restoring an occluded
window:
WD_ID = UIS$CREATE_WINDOW(VD_ID,0.,0.,1.,1.,20.,20.) !Create window
CALL UIS$MOVE_WINDOW(VD_ID,WD_ID,0.,0.,1.,1.) !Disable replay
2-13
VMS Workstation Software Problems and Restrictions
Specifying a Negative Value As Startdeg or Enddeg
Causes Incorrect Drawing of a Circle or Ellipse
If you specify a negative value as the startdeg or
enddeg parameter for a circle or ellipse, it is drawn
incorrectly. To achieve the desired drawing results
when specifying a negative value for either of these
parameters, do the following:
1 Take the negative value modulo 360 and add 360.
2 Specify the resulting value as the startdeg or
enddeg parameter.
The following FORTRAN code segment demonstrates how to
change a negative value into a value that causes the
system to execute the drawing operation correctly:
START_DEG = AMOD(START_DEG,360.)+360.
END_DEG = AMOD(END_DEG,360.)+360.
CALL UIS$CIRCLE(VD_ID,ATB,X,Y,RADIUS,START_DEG,END_DEG)
2-14