In this section we discuss some DECwindows/VMS and Motif/VMS (X window system) utilities for use with IRAF running on VMS workstations. Further information can be found in the file 0readme in the [IRAF.VMS.X11] directory. Note that VMS/IRAF can also be used with an X user interface running on a remote UNIX workstation, with only VMS/IRAF running on the VMS host. This section is relevant only if you need to run the X clients directly on a VMS host. We discuss only xterm and saoimage here since these were the only X clients available for graphics and image display at the time this was written, but newer facilties may be available before this document is again revised. Check with the IRAF group for more current information on support for graphics and imaging under the X window system.
Xterm is a public-domain version of the standard MIT X window system terminal emulator, modified to work on VMS. It is a two-window tool capable of emulating a VT102 terminal and a Tektronix 4014 terminal. Appropriate escape sequences will cause xterm to switch between these two modes, but some programs require the user to make the change (using the CTRL-middle mouse button menu). It is especially valuable for IRAF use since it allows a plotted graph to be kept in the Tektronix emulation window while commands are given in the VT102 emulation window.
A common mistake is to run the CL from a DECterm window, which does not support IRAF graphics. To use IRAF interactive graphics tasks one must run IRAF from an xterm window (or any similar terminal emulator supported by IRAF, e.g., gterm, xgterm, etc.). To use xterm with IRAF we recommend that the "xtermr" graphcap entry be used. This is set as follows:
cl> stty xtermr nl=54
By default, this entry has 65 lines in the text window. If your setup is different (perhaps 54 lines instead of 65) you can make changes as shown on the stty command line. The "xterm" stty setting is an alias for the "xtermr" stty setting; they can be used interchangeably.
The xtermr graphcap entry writes the status line in the TEK window, not in the text window. This is the preferred setup, since DEC hasn't yet made available the customize feature for "focus follows cursor", meaning there is no way around needing to click-to-focus. Use of xtermr requires the least amount of clicking.
You should not click inside the TEK window to focus on it, but on its header or border. Otherwise, the mouse click returns a character which terminates cursor mode. Clicking on the border provides focus without reporting any events, since the cursor is not inside the "active" region.
Saoimage is an X-windows based image display server originally developed by the Smithsonian Astrophysical Observatory. It provides a large selection of options for zooming, panning, scaling, coloring, pixel readback, display blinking, and region specifications. User interactions are usually performed with the mouse. You must have saoimage running, although it can be iconified, before attempting to write to it. More information may be found in the 0readme file in the [IRAF.VMS.X11] directory.