SET, DISPLAY
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help SET, DISPLAY *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
Directs the output of an OpenVMS DECwindows application.
Output can be directed from any processor running a DECwindows
application, including workstations, to any DECwindows
workstation.
Both source and destination nodes must be part of the same
network.
Format
SET DISPLAY [display-device]
| 1 - Parameters |
display-device
Specifies a logical name for the workstation display you are
creating or modifying. If you are directing application output
to multiple workstation displays, you can use different logical
names to point to each display. If you do not specify a display-
device parameter, the logical name DECW$DISPLAY is used. This
means that, by default, application output will be displayed on
the workstation display device referred to by DECW$DISPLAY.
By entering the command SHOW DISPLAY, you can see the default
workstation node where applications will be displayed, as well as
related device, screen, and transport information.
If you specified your own logical name in the SET DISPLAY/CREATE
command, include that logical name in the SHOW DISPLAY command.
| 2 - Qualifiers |
2.1 - /CREATE
Creates the workstation display device (WSAn:) on which a
DECwindows application is displayed. You must specify the /CREATE
qualifier the first time you use the SET DISPLAY command, but
you need not respecify it if you continue to redirect output from
applications to other workstations with subsequent SET DISPLAY
commands.
When you specify the /CREATE qualifier without the /NODE
qualifier, the workstation device defaults to the current node.
Additionally, if you omit the /TRANSPORT qualifier, the transport
defaults to either the value specified by the DECW$SETDISPLAY_
DEFAULT_TRANSPORT logical, if defined, or to DECNET.
2.2 - /DELETE
Cancels the redirected display by deassigning the logical name
DECW$DISPLAY and deleting the created display device. If you
specified a logical name as the display-device parameter with
the SET DISPLAY/CREATE command, entering the SET DISPLAY/DELETE
display-device command cancels the redirected display by
deassigning the logical name you specified and deleting the
created display device.
The DECwindows Session Manager defines DECW$DISPLAY in your job
logical name table when you open a terminal (DECterm) window.
When you redirect application output to another workstation
with the SET DISPLAY/CREATE command, an additional DECW$DISPLAY
logical name is defined in your process logical name table. This
definition supersedes the definition in the job logical name
table. Output from applications run from the process in which
you executed the SET DISPLAY/CREATE command will be displayed on
the workstation referred to by the definition of DECW$DISPLAY in
the process logical name table. Enter the SHOW DISPLAY command
to see where this application will be displayed. To see whether
multiple definitions for DECW$DISPLAY exist, enter the command
SHOW LOGICAL DECW$DISPLAY.
If DECW$DISPLAY is still defined (for example, in the job
logical name table) after you specify the /DELETE qualifier, any
DECwindows applications run from this process will be displayed
on the workstation device to which output is now directed. Enter
the SHOW DISPLAY command if you are unsure of the node to which
DECW$DISPLAY refers.
CAUTION
If you modify or delete the definition of DECW$DISPLAY from
the job logical name table, you will be unable to start
another session. Be careful not to specify the /DELETE
qualifier without having first redirected the display with
the SET DISPLAY/CREATE command.
You cannot specify the /DELETE and /CREATE qualifiers on the same
command line.
2.3 - /EXECUTIVE_MODE
Creates an executive-mode device and assigns the logical name
DECW$DISPLAY to point to it. This qualifier must be used with
the /CREATE qualifier. Devices created with the /EXECUTIVE_MODE
qualifier are deleted only in the following situations:
o They are explicitly deleted with the /DELETE qualifier.
o The system is rebooted.
To modify or delete executive-mode devices, you must have SYSNAM
(system logical name) privilege.
2.4 - /NODE
/NODE=workstation_display
Defines the workstation on which you want to display DECwindows
applications. The node name you provide cannot be a cluster alias
(a name that represents multiple nodes configured in an OpenVMS
Cluster), but must instead identify an actual node.
You must create a workstation display device with the
/CREATE qualifier before you can redirect the output from
applications to other workstations. Do not enter the SET
DISPLAY/NODE=workstation_display command without having
previously specified the /CREATE qualifier.
When you specify the /CREATE qualifier without the /NODE
qualifier, the workstation defaults to the current node.
Make sure that you are authorized to display applications
on the workstation you specify. For more information about
using the DECwindows Session Manager to authorize yourself to
display applications from other nodes, refer to the DECwindows
documentation.
Each node, both source and destination, must be defined in
the other's network node database. For example, to display
applications on node HUBBUB from ZEPHYR, HUBBUB must be entered
in ZEPHYR's network node database, and ZEPHYR must be entered
in HUBBUB's network node database. In addition, users on ZEPHYR
must be authorized in the DECwindows Session Manager to display
applications on HUBBUB. For information about entering nodes in a
network node database, refer to the DECnet for OpenVMS Networking
Manual and the DECnet for OpenVMS Network Management Utilities
manual. These manuals are available on the Documentation CD-ROM.
2.5 - /SCREEN
/SCREEN=screen-number
Defines the screen to be associated with this display device. In
some hardware configurations, the system supports more than one
screen. In such a configuration, you can specify the screen to
which the application is directed.
2.6 - /SERVER
/SERVER=server-number
Defines the server to be associated with the display device
indicated by the display-device parameter to the SET DEVICE
command. Using the transport mechanism, the server passes
data between the user and the application. In some hardware
configurations, the system supports more than one server. In
such a configuration, you can specify the server to which the
application is directed. If you do not specify the display-
device parameter, the SET DISPLAY/SERVER command associates the
server with the display device indicated by the logical name
DECW$DISPLAY.
2.7 - /SUPERVISOR_MODE
/SUPERVISOR_MODE (default)
Creates a supervisor-mode device and assigns the logical name
DECW$DISPLAY to point to it. This qualifier must be used with the
/CREATE qualifier. When the user logs out, the device is deleted.
2.8 - /TRANSPORT
/TRANSPORT=transport-name
Defines the mechanism, for example, DECnet or local, that passes
information between the application and the workstation. The
transport mechanism is used to send input from the user to
the application and output from the application to the display
device. The transport-name can be one of the following values:
o TCPIP or DECNET
Specifies the appropriate network transport for applications
running and displaying on different nodes. You can specify
the default transport value used with the SET DISPLAY/CREATE
command by defining the DECW$SETDISPLAY_DEFAULT_TRANSPORT
logical in either the job, process, or system table. The
value of this logical is then used each time you enter the
SET DISPLAY/CREATE command without the /TRANSPORT qualifier.
If you specify neither the qualifier nor the logical, the
value of DECNET is used as default.
o LOCAL
Optimizes the performance of applications running and
displaying on the same node.
2.9 - /USER_MODE
Creates a user-mode display device and assigns the logical name
DECW$DISPLAY to point to it. This qualifier must be used with
the /CREATE qualifier. The lifetime of a user-mode device is
one DECwindows image: when the next DECwindows image exits, the
device is deleted.
| 3 - Examples |
1.$ SHOW DISPLAY
Device: WSA1: [super]
Node: 0
Transport: LOCAL
Server: 0
Screen: 0
$ SET DISPLAY/CREATE/NODE=ZEPHYR/EXECUTIVE_MODE
$ SHOW DISPLAY
Device: WSA2: [exec]
Node: ZEPHYR
Transport: DECNET
Server: 0
Screen: 0
$ SPAWN/NOWAIT/INPUT=NL: RUN SYS$SYSTEM:DECW$CLOCK
$ SET DISPLAY/DELETE
$ SHOW DISPLAY
Device: WSA1: [super]
Node: 0
Transport: LOCAL
Server: 0
Screen: 0
In this example, you are logged in to your workstation (device
WSA1:), here referred to as node 0. (0 is the standard
shorthand notation for representing your node.) You want to
run the DECwindows Clock on your workstation and display it on
another workstation, ZEPHYR.
Assuming you are authorized to display applications on ZEPHYR,
you redirect the application's output to ZEPHYR with the SET
DISPLAY command. The device created on ZEPHYR is an executive-
mode device. You enter the SHOW DISPLAY command to verify the
location of the redirected display. You then run Clock. When
you finish running Clock, you disable the redirected display
by entering the SET DISPLAY/DELETE command. Finally, you
enter the SHOW DISPLAY command to verify that any applications
subsequently run on your node will also be displayed there.
Note that a new workstation display device, WSA2, is created
when you enter the SET DISPLAY/CREATE command. When you cancel
the redirected display with the SET DISPLAY/DELETE command,
application output is once again displayed on the workstation
display device referred to by WSA1.
2.$ SET DISPLAY/CREATE/NODE=FLOPSY RABBIT
$ SHOW DISPLAY RABBIT
Device: WSA2: [super]
Node: FLOPSY
Transport: DECNET
Server: 0
Screen: 0
$ RUN/DETACHED/OUTPUT=WSA2: SYS$SYSTEM:DECW$CLOCK
$ SET DISPLAY/CREATE/NODE=ZEPHYR ZNODE
$ SHOW DISPLAY ZNODE
Device: WSA3: [super]
Node: ZEPHYR
Transport: DECNET
Server: 0
Screen: 0
$ RUN/DETACHED/OUTPUT=WSA3: SYS$SYSTEM:DECW$CALENDAR
$ RUN SYS$SYSTEM:DECW$BOOKREADER
$ SHOW DISPLAY
Device: WSA1: [super]
Node: 0
Transport: LOCAL
Server: 0
Screen: 0
In this example, you are logged in to your node (device WSA1:),
and want to direct the output from applications to several
workstation displays in the same session. By specifying
different logical names in the SET DISPLAY command, you
can redirect the output without changing the logical name
definition for DECW$DISPLAY. This allows you to display the
output from most applications on your default display but
occasionally display output on another workstation. You can
also continue to run and display applications on your node. In
this example, Clock is displayed on node FLOPSY, Calendar is
displayed on node ZEPHYR, and Bookreader is displayed on your
workstation.
Note that to run your applications with the DCL command
RUN/DETACHED, you must use the device name that equates to the
logical display device name you specified in the SET DISPLAY
command. Use the SHOW DISPLAY command to obtain this device
name.
|
|
