SUNY_Help !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! To add items to this file, place a "2" in column 1 followed by a ! space and the 11-21 character item name (shorter names mess up ! the formatting of the first page). On successive lines, add the ! help text, followed by a line with "!" in col. 1 for clarity. ! ! Higher (deeper) entries use higher numbers followed by names of any ! length. Please restrict tree to depth of "5", and note that higher ! level entries must use fewer columns for text (<60 for level "4"). ! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! To see what commands and names have been locally defined, type "SHOW LOGICAL /ALL" or "SHOW SYMBOL /GLOBAL /ALL". ALLTYPE_file Types specified file(s) (wildcards allowed), inserting a form feed between the files. This is useful for hardcopy terminals. Usage: $ ALLTYPE file_name(s) EBCDIC_Conversion If you need to read an EBCDIC tape, use READTAPE to copy the files to disk, and then convert the IBM (EBCDIC) format to ASCII by running the program UTILS:IBMIMPORT. This program reads the EBCDIC file named IBM.IN and writes out an ASCII file named IBM.OUT. Alternatively, the command procedure @UTILS:IBMIMPORT will prompt you for file names (with or without wild fields) and will run IBMIMPORT on the specified file names for you. Note: It renames the input files one at a time to IBM.IN, converts it, and then renames the IBM.OUT file back to the original name. Don't have any IBM.IN or IBM.OUT files in your directory or the command procedure will fail. You will have to remove trailing blanks (using UTILS:TRAIL) after the file(s) hev been converted to ASCII. EDITOR_options Various command procedures have been written to use the EDT editor. EDT Command to get you into the EDT editor in keypad mode USAGE: $ EDT in_file_name [out_file_name] [editor options] PF1 H while in EDT lists locally defined gold keys If the out_file_name is not specified, a new version of the in_file_name is created. However, you must specify the out_file_name to specify editor options. EDTREC Command to recover an interrupted EDT session Usage: $ EDTR*EC in_file_name [out_file_name] FDT Editor/compiler for FORTRAN program. Usage: $ FDT in_file_name [out_file_name] [editor options] PF1 H while in FDT lists locally defined gold keys If the out_file_name is not specified, a new version of the in_file_name is created. However, you must specify the out_file_name to use the editor options. It is not necessary to supply the .FOR suffix of the file. If the suffix is different from .FOR, you have the option of renaming the file, regular EDT, or exit. FDTREC Command to recover an interrupted FDT session $ FDTR*EC file_name HDT Command to get you into the EDT editor in keypad mode for help files $ HDT in_file_name [out_file_name] [editor options] WDT Command to get you into the EDT editor in keypad mode with 132 columns per line $ WDT in_file_name [out_file_name] [editor options] ERASE_files Creates a blank version of a file. Usage: $ ER*ASE filename A new version of the file is created, with nothing in it. The old version can be eliminated by purging. FX80_printing Various commands are available to print on the Epson FX-80 printer attached to the printer port of a VT102 terminal. These commands take the form: FX80 /OPTION FILES, where option is one of the following: /OPEN Open an FX-80 printing session (no files argument) /CLOSE Closes an FX-80 printing session initiated by FX80 OPEN /WIDE Use 132 column mode /BOLD Print in bold type (double strike; reduces print speed) /ELITE Print in elite type (12 characters per inch, def = 10) /ESC Special mode to leave print controller on FX80 may be abbreviated by FX, and all options may be abbreviated to one or two letters (enough to make it unique). If multiple files are given, form feeds are inserted between each (see TYPEALL). Example: FX /B/W TEST.LIS,DATA.TXT G_and_H_floating Not all VAX processors support the instructions that use G_floating and H_floating data types in hardware (ours does not). However by establishing a special software emulator to "catch" floating point faults and emulate the offending instruction in software, one may write a program that will run correctly on any VAX processor without modification, whether the processor supports G-floating and H_floating instructions or not. Software emulation of the hardware instructions is guaranteed to be very slow so it is NOT advisable for computationally intensive programs. But it gets the job done if you need extended range for the exponent or higher precision mantissas. There are several ways to include the emulator in your program, as documented below. The LINK method is the easiest to use, and works for most programs. LINK_way Explicitly link to the the special procedure LIB$ESTEMU with the LINK command for your program. LINK program,SYS$LIBRARY:STARLET/INCLUDE=LIB$ESTEMU LIB$ESTEMU uses the LIB$INITIALIZE function to establish LIB$EMULATE as the program fault condition handler. PROGRAM_way Establish LIB$EMULATE as the exception handler for your FORTRAN program by including the following code fragment in your code: EXTERNAL LIB$EMULATE CALL LIB$ESTABLISH (LIB$EMULATE) All languages except PL/1 use an equivalent code fragment. See the reference for more information on using LIB$EMULATE in PL/1. SPECIAL_way If you are already using a special condition handler, call LIB$EMULATE from your handler as shown in the example below. LIB$EMULATE returns control to your condition handler only if it does not emulate the instruction. INTEGER*4 FUNCTION MY_HANDLER (SIGARGS, MECHARGS) INTEGER*4 SIGARGS(*), MECHARGS(*) CALL LIB$EMULATE (SIGARGS, MECHARGS) C C... The rest of your condition handler goes here. C RETURN END References Additional information on this subject and condition handling procedures in general may be found in "VAX/VMS Run-Time Library Users Guide", Chapter 6 - Condition Handling. See HELP FORTRAN or the "VAX/VMS FORTRAN Reference Manual" for more information on converting REAL*8 variables to D_Floating or using REAL*16 (H_Floating) variables. HARDWARE_list Our current HARDWARE configuration consists of: 1 11/780 Processor with FP780 Floating Point Accelerator. 8 Megabytes of main memory. 2 RA81 disks (900 Mb total). 1 TU78 tape transport (125ips @ 1600/6250 bpi). 2 Kennedy 9300 tape transports (125ips @ 800/1600 bpi). 48 Terminal ports. 16 VT102 Terminals, 8 with Retro-Graphics upgrade. 3 Auto-answer modems with dial-out capablilty. 1 QMS Lasergrafix 1200 printer/plotter. 5 EPSON FX-80 dot-matrix printers. TAPE_Drives MFA0: refers to the TU78 MTA0: refers to the lower of the two Kennedy drives MTA1: refers to the upper of the two Kennedy drives These drives are available 8-5, M-F. If you need help, ask John Hasstedt. The drives may be used at other times only by those authorized to enter the Nuclear Structure Laboratory. NOTE: Blank tapes will need to be initialized by a systems person before you can mount them. This is a VMS security feature. Blank tapes to leave the facility should be purchased by your group. IMSL_library The following symbols are defined to make it easier to link to the IMSL library: IMSL_SNGL_LIB Single precision library IMSL_DBLE_LIB Double precision library IMSL_LIB Single precision library For example, to use the single precision library in a LINK command: $ LINK your_program,IMSL_LIB/LIB The source code is available in SYS$SOURCE:[IMSL]. It is for private modifications only, and may not be disseminated. KILL_a_process The KILL command is used to stop another process in your group. The format of the command is $ KILL process_id where process_id is the process ID for the process you want to stop (shown when you enter SHOW USERS). If the process ID is omitted, the command will prompt for it. If you enter RETURN to the prompt, it will stop the current process (log you off). KILL can stop either an interactive process or a batch job. LASER_printer To send files to the laser printer, use the LASER command. In addition to the options available to the PRINT command, LASER supports several additional options (three letter abbreviations permitted). Files queued to the printer via LASER are prefixed by a special printer configuration file to insure that the printer begins printing with the correct font and page set-up options. If you wish to redefine the LASER command, you must place LASER in quotes: $ MYPRI :== 'LASER'/TRAY=1 Defaults If no switches are specified, you will get: /PORTRAIT /NORMAL /TRAY=0 /TOP_MARGIN=500 /LEFT_MARGIN=1000 /BOTTOM_MARGIN=10750 /CHARACTERS=0 /LINES=08 /FONT=10 This will give 80 lines of about 80 characters using font 10 in portrait mode. Word processing commands are disabled, pre-punched paper is used with a top margin of 1/2", a left margin of 1", and a bottom margin of 3/4". Letterheads_and_Logos Special forms and stationery overlays have been designed for printing directly on the LASER printer. There are commands to support two types of special stationary called LOGO's and LETTERHEAD's. A LOGO is printed on each page of a file while a LETTERHEAD is printed on the first page only. In each case the specified form will be merged with your document and sent to the printer. The command to print a letter head on a file called LASER.LIS is LETTER. The format for the command is LETTER letter_head_name where letter_head_name is the name of the letter head (listed in the file named below). For the current list of available stationary: $ TYPE TEX$LOGOS:LOGO.DIC Send requests for new letter heads to SOFTSUP. Synonyms_and_Abbreviations All switches may be abbreviated to three letters (not including the slash). In addition the following synonyms are also valid: /TM=nnnnn Synonym for /TOP_MARGIN /LM=nnnnn Synonym for /LEFT_MARGIN /BM=nnnnn Synonym for /BOTTOM_MARGIN /LPI=nn Synonym for /LINES_PER_INCH /CPI=nnnn Synonym for /CHARACTERS_PER_INCH /M11 Synonym for /LPI=06 /TM=00000 /LM=00000 /TRAY=1 /DIABLO /PLOT10 Synonym for /TM=00350 /LM=00500 /BM=08500 /LANDSCAPE /BOTTOM_MARGIN /BOTTOM_MARGIN=nnnnn Bottom Margin in units of 0.001" from the top of the page. For example, in portrait mode, /BOTTOM_MARGIN=10500 will set the margin to 10.5 inches from the top or 0.5 inches from the bottom of the page. /CHARACTERS_PER_INCH /CHARACTERS_PER_INCH=nnnn Characters per inch (1.00-99.99) /CPI=nnnn The argument of CHARACTERS_PER_INCH is a four digit number with an implied decimal point in the 100's position. Thus /CHARACTERS_PER_INCH=1250 specifies 12.5 characters per inch. Specifing a character per inch value on a proportionally spaced font converts that font to fixed spacing. Note: /CPI or /CHARACTERS_PER_INCH change only the character spacing, NOT the character height and width. /FONT /FONT=nnnnn Print text using font nnnnn. The available fonts will change from time to time, but for now try the following: 10 EDP font, default font, pitch 12 30 Roman, pitch 10, nice for word processing All fonts are proportionally spaced except 10, but you can override this by specifing a character spacing. To get a LASER Printer listing of the currently available fonts, print one of the files: LANDSCAPE.QMS, PORTRAIT.QMS, or MASS11.QMS from the directory TEX$QMS: (e.g. $ LASER TEX$QMS:PORTRAIT.QMS). /LANDSCAPE_MODE /LANDSCAPE_MODE prints lines parallel to the long side of the paper. This is the default. See also /PORTRAIT_MODE. /LEFT_MARGIN /LEFT_MARGIN=nnnnn Left Margin in units of 0.001" For the upper tray (pre-punched paper), the default is 1". For the lower tray (normal paper), the default is 0". /LINES_PER_INCH /LINES_PER_INCH=nn Lines per inch (1-20) /LPI=nn Specify the number of lines of text per vertical inch as /LINES=nn, where nn = 1 to 20. The default is set at 8 lines per inch. Note: /LPI changes only line spacing, NOT character height / width. ! 3 /LOGO /LOGO=logo_name Print with 'logo_name' stationery. Each page of the file will be printed using 'logo_name' stationery. Several files or multiple copies of one file may be printed at the same time using the same stationery. You can not switch or "turn off" stationery in the middle of a file or group of files; use separate LASER commands. Note: MASS-11 LASER.LIS files will not print correctly with /LOGO, use /LETTERHEAD instead. For example: $ LASER /LOGO=PHYSICS letter.lis,seminar.lis/COPIES=3 Prints the file 'letter.lis' and 3 copies of the file 'seminar.lis' using SUNY Dept. of Physics stationery. ! 3 /LETTERHEAD /LETTERHEAD=logo_name Print with 'logo_name' stationery (on the first page only). The first page of the first file will be printed using 'logo_name' stationery. Several copies of one file using using the same stationery may be printed at the same time. Note that only one file may be printed at a time using the /LETTERHEAD switch. For example: $ LASER /LETTERHEAD=PHYSICS longmemo.lis/COPIES=2 Prints 2 copies of the file 'longmemo.lis' using SUNY Dept. of Physics stationery. Only the first page of the multi-page file will be written using stationery. /M11 /M11 is used to print LASER.LIS files produced by MASS-11 with the following default settings: /TRAY=1 /LPI=06 /TM=00000 /LM=00000 /DIABLO If you fail to include the /M11 option when printing LASER.LIS files you will have the usual print defaults. You may, of course, set your own parameters. /PORTRAIT_MODE /PORTRAIT_MODE prints lines parallel to the short side of the paper. See also /LANDSCAPE_MODE. /TOP_MARGIN /TOP_MARGIN=nnnnn Top Margin in units of 0.001" For the upper tray (pre-punched paper), the default is 0.5". For the lower tray (normal paper), the default is 0". If you specify landscape mode, the default for tray 0 is 0.75" to allow for the punched holes. /TRAY=n Specify the upper tray as /TRAY=UPPER, /TRAY=U or /TRAY=0. Specify the lower tray as /TRAY=LOWER, /TRAY=L or /TRAY=1. The upper tray (default) contains pre-punched paper; the lower tray contains normal (un-punched) paper. Note that the defaults for /TOP and /LEFT margin are tray dependent. Word Processing Modes /DIABLO Diablo 630 Emulation /QUME QUME 11/45 Printer Emulation /NORMAL_MODE(D) No Special Printer Emulation Use /DIABLO to print files produced by the Diablo version of RNO or MASS11, since such files will contain instructions for a Diablo style terminal. See also /M11 under HELP SUNY LASER SYN. MAIL_account A special MAIL username has been formed for users without accounts, who wish to leave messages for users with accounts (typically by dialling into one of our modems, see HELP SUNY HARDWARE MODEMS). A user logging into this account (no password) is captured into the VAX/VMS MAIL procedure; EXIT results in LOGOFF. Interactive HELP is available inside the MAIL procedure. MASS11_word_processor MASS11 is a word processing package containing a spelling checker and some data base management tools. To execute simply type M11. Before using MASS11 for the first time, you must copy several files into the directory which you will use for word processing by typing: @SYS$SUNY:[MASS11]PREMASS11 MASS11 will be constantly updated as new versions become available (on the average once a month or two). The current version of MASS11 is 4-B, and the manual is now on the system. You may print your own copy of MASS11:REFMANUAL.LIS (use the LASER command). There is also a pocket version MASS11:POCKET.LIS, which should suffice for most needs. PRINT THIS SHORTER VERSION (POCKET.LIS) FIRST (<10% of the full version). The following contains information not available in the manuals: DEMO You can obtain a copy of the DEMO directory by typing: $ COPY SYS$SUNY:[MASS11]DEMO.* * GREEK_Math Some of the VT100 and VT102 terminals have now been equiped with an optional Greek/Math character set, called MATHONE. If your terminal has the optional character set installed the following lines will alternate between the normal ASCII character set and MATHONE: Normal: (B !"#$%&'()*+,-./0123456789:;<=>? MATHONE: (1 !"#$%&'()*+,-./0123456789:;<=>? (B Normal: (B @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_ MATHONE: (1 @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_ (B Normal: (B `abcdefghijklmnopqrstuvwxyz{|}~ MATHONE: (1 `abcdefghijklmnopqrstuvwxyz{|}~ (B If your terminal does not have the optional character set installed the second line will probably contain gibberish. See John Hasstedt to get your terminal Greek/Math upgrade. VT200 series terminals use downloaded alternate character sets. To download the Greek/Math characters to a VT200 series terminal, enter the command DOWNLOAD VT200 DOWNLOADING_to_FX-80 MATHONE is the default alternate font on the laser printer. In order to obtain it on the FX-80 you need to download the additional character set every time you power up the printer, or reset it (@). See HELP SUNY UTILS FX-80 DOWNLOAD. Italic_Underlining To obtain italics instead of underlining, e.g. in references, use printer #5, LASER ITAL. This generates a LASER.LIS file which you print in the normal way. See HELP SUNY MASS11 Printing_output. Landscape_Fonts ** Special Procedures For LANDSCAPE Printing Mass-11 Files ** Normally, landscape mode word processing fonts are not loaded in the laser printer since there is insufficient RAM space in the printer to load all of the fonts that are commonly used by both TeX and MASS11. Some time in the future we expect to remedy this situation by having a program (the Font Daemon) automatically download fonts as needed. However, as an interim solution, one may manually replace the 10 Pitch portrait mode Roman and Roman Slanted fonts (accessed via PITCH(10) and FONT(3) from MASS11) with 12 Pitch landscape mode Roman and Math-One fonts (the default Roman and Greek/Math fonts) by entering the following command: $ @TEX$QMS:LANDSCAPE.M11 To recover the original fonts, download them using the PRINTQ account. Printing_output To print a LASER.LIS file produced by MASS-11, type LASER /M11 LASER.LIS See HELP SUNY LASER for more information on printing. SPELLING_checker The spelling checker can not be accessed from the main word processing menu contrary to indication. Instead, while editing, use the command PF1 * S USER_dictionary It is currently necessary to copy the user dictionary into each directory in which you plan to do MASS11 word processing. The initial PREMASS11 command will copy the default user dictionary into your home directory. It is up to you to make and update your additional copies. NCAR_graphics A graphics package including 2-d and 3-d contour diagrams, written at the National Center for Atmospheric Research (NCAR), Boulder, Colorado. Plots are written into metafiles, which are device independent. The metafiles are then translated into device-dependent output. Graphs may be obtained interactively, or viewed later, and hard copies may be made at any time. INTERACTIVE_plotting Several subroutines have been added at Stony Brook to enable the plots to be viewed as they are made, in addition to having the option of keeping a record of them in a plot file, and/or making a hardcopy on the laser printer. Note that the default name of the plot file is 79, but this may be changed by a call to IPLFIL. IEXIT Purpose: Terminate the interactive plotting session. Usage: CALL IEXIT Must be the last call in the plotting session IFRAME Purpose: Replaces FRAME as the terminator of a given plot Usage: CALL IFRAME The user is asked whether to keep a record of the file, and/or make a hardcopy on the laser printer. NOTE: If an NCAR routine calls FRAME, your call to IFRAME is useless. Avoid those routines, or make your own copy and replace the call to FRAME with a call to IFRAME. IMODE Purpose: Change the number of pixels in each direction Usage: CALL IMODE( MODE ) MODE can take only one of three values: 1 Standard mode: 1024x781 (default NCAR) 2 Large square: 1024x1024 (default PLOT10) IT IS THE USERS REPONSIBILITY NOT TO EXCEED THE LIMIT SET BY THE SCREEN OR PAPER IN THE Y-DIRECTION (781 PIXELS) 3 Small square: 781x781 IPLOT Purpose: Initiate a new plot in interactive mode Usage: CALL IPLOT Must be called before any NCAR plotting routine for that plot. IPLFIL Purpose: Set the name of the plot file in which the plot records are kept Usage: CALL IPFIL( 'plot_file_name' ) This routine may be called before any call to IPLOT. If it is not called, the plot record is appended to the previously defined plot file. The default plot_file_name is 79; it may be changed to any file or logical name, not exceeding 40 characters. Note that if plot_file_name has no suffix, it is given the suffix .DAT. LINKING The entire library may be called using the symbol 'NCARLIBS $ LINK your_main,[...],'NCARLIBS Do not forget the apostrophe in 'NCARLIBS. Another way is to set up NCAR libraries as LNK$LIBRARY's for the entire process by the command $ SETNCAR MANUALS Manuals are available in C-115 and with the groups. MODE Each device now recognizes three modes: 1 Standard mode: 1024x781 (default NCAR) 2 Large square: 1024x1024 (default PLOT10) IT IS THE USERS REPONSIBILITY NOT TO EXCEED THE LIMIT SET BY THE SCREEN OR PAPER IN THE Y-DIRECTION (781 PIXELS) 3 Small square: 781x781 You can initiate any of these modes in NPLOT by the instructions: DEVICE TT VTR# or DEVICE TT VTS# where # is the mode number, and VTR is for Retrographics and VTS for Selanar. The PRINT command following this call is automatically adjusted to the mode, but you can also set it directly by DEVICE LASER (or LPA0) QMS# NPLOT_Translator An interactive translator program, with on-line help, is enabled by: $ NPLOT This program can be used to review plots, rescale them, combine different plots, and make hardcopies on the laser printer. Retro_Graphics This help item came from [SUNY.UTILITY]DQ650.HLP - Please edit that file and re-insert it into the master help file. DQ650 is a program designed to allow users to use some of the special features of VT100 terminals equipped with one of Digital Engineering's graphics cards (Retrographics Model DQ650M or DQ650S). Options Presently the program's only function is to copy the entire graphics image from the terminal back into the computer and store it as a hex file capable of being printed on the QMS Lasergrafix 1200. Since this is the only option, the program has no command syntax and is called up simply by saying $ DQ650. You can call it from within a SPEAKEASY session by saying :_ DOVMS("DQ650"). As the program acquires additional features it will be provided with a command structure complete with input/output parameters and qualifiers. Tell us what additional features you would like to see. Screen_Copy The program copies the entire graphics bitmap stored in the terminal back into the computer and into a file named QMS.PLT in your current directory. This file may then be printed on the QMS Lasergrafix 1200. This feature is useful for obtaining quality hardcopy (though only at the basic resolution of the graphics terminal) of graphs produced by programs (like SPEAKEASY) that do not support graphics output directly to the laser printer. To get a Screen_Copy from within SPEAKEASY say: DOVMS("DQ650"). See "Initialization" for information on putting the terminal into the proper graphics mode before attempting a Screen_Copy. Initialization The terminal can be in any mode (VT100, TEK4010 or TEK4027) when the program starts but must previously have had TEK4027 mode enabled with the largest graphics workspace. This special initialization is necessary because the only way to read the screen back is by using TEK4027 mode. The easiest way to initialize the terminal is to enter TEK4027 mode manually (using CTRL-B) and then typing the following 4027 commands: !WOR 33!GRA 1,33 <--- Establish Workspace. !SHR Y <--- Use 4010 Scaling. or !TEST <--- Which has the same side effects as above. Then return to the graphics mode you normally use. You need do this only once before you start plotting! At present, the program does not save and restore the previous mode of the terminal; it will always leave the terminal in TEK4010 mode with TEK4010 coordinate scaling. This is the most convenient mode for SPEAKEASY users. TRAILing_blanks Interactive FORTRAN program to remove trailing blanks of file(s) (between the last nontrivial character and the carriage return). Usage: $ R UTILS:TRAIL There is also a batch version of this program with the same I/O. Usage: $ R UTILS:BTRAIL USER_help_library You can create your personal help items in a help file ['USERDIR']'USERDIR'.HLP where 'USERDIR' is the name of your home directory (your name, possibly truncated). See this file (SYS$SUNYDISK:[HELP]SUNY.HLP) for an example of a help file. In order to include your help items in the HELP library you must create your personal help library (one time creation) by: $ CRHLB Then you must update it by: $ HLB every time you put a change in the help file.