GOOSY Id.: gm vaxvms Version: 4.0 Date: September, 16 1987 Revised: August, 01 1995 GO O SY SI nline ine stem OpenVMS Introduction H.G. Essel, M. Richter, W. Schiebel August, 01 1995 GSI, Gesellschaft fur Schwerionenforschung mbH Postfach 11 05 52, Planckstra e 1, D-64220 Darmstadt Tel.
List of Figures 2.1 GSI Computer Network : : : : : 2.2 IBM VT220 Terminal Keyboard : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 7.1 OpenVMS LSE Terminal Keyboard : 7.2 OpenVMS Debug Terminal Keyboard : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : A.1 Alpha AXP or VAX Terminal Keyboard Version 4.
2 Version 4.
Conventions used in this Document Chapter 1 Preface GOOSY Copy Right The GOOSY software package has been developed at GSI for scienti c applications. Any distribution or usage of GOOSY without permission of GSI is not allowed. To get the permission, please contact at GSI Mathias Richter (tel. 2394 or E-Mail "M.Richter@gsi.de") or Hans-Georg Essel (tel. 2491 or E-Mail "H.Essel@gsi.de").
key | The that you must type the letter while capital letters). Here is an example: holding down Ctrl Z means hold down the Ctrl key and type the letter Z. PFn key | The PFn followed by a number means that you must press the PFn key and then type the number. Here is an example: PF1 6 press the PF1 key and then type the number 6 on the main keyboard. PFn or Fn keys | Any PFn or Fn key means that you just press this key. Here is an example: PF2 means press the PF2 key.
Further GOOSY Manuals 1.1 OpenVMS Advisory Service In any case of computer or network problems please contact the Operators in the Computer Center room 1.250, tel. 2515 or the User's Consulting o ce room 2.244, tel. 2555. The authors of this manual and their main elds for OpenVMS advisory services are: Wolfgang Schiebel OpenVMS and network system manager (room 1.252, tel. 2498) Hans-Georg Essel OpenVMS advisor (room 2.262, tel. 2491) Mathias Richter OpenVMS advisor (room 2.262, tel.
GOOSY LMD List Mode Data Generator SBS Single Branch System TCP-Package TRIGGER Bus VME Introduction OpenVMS Introduction 6 Version 4.
Intended Audience 1.3 Intended Audience This is a short introduction for the Alpha AXP or VAX users at GSI. It familiarizes the user with the basic functions of the Alpha AXP or VAX operating system (OpenVMS). This introduction cannot be complete nor can it replace any Alpha AXP, VAX, or OpenVMS manual. It should just help a newcomer to get started. This manual is available for printing on the laser print server in room 2.223 with the OpenVMS DCL command $ PS G POSTD GOO$DOC:GM_VAXVMS.
8 Version 4.
General Remarks on GSI computers Chapter 2 Login and Logout 2.1 The Computer Account As a new user of a GSI computer you have to be accounted for. Through this procedure the system manager (for OpenVMS see names on page 5) sets up a disk directory for you and you will receive a username and a password. You must change your password immediately after the very rst login by the command $ SET PASSWORD Only after you have received an account you can proceed to any terminal for login. 2.
OpenVMS Introduction - Login and Logout VME VAX Mac IBM E t h e r n e t Bridge Server TCP/IP X25/WIN HEPnet ' & Router $ % PC HPUX several FDDI rings connected through GIGAswitches AXP Bridge Server Bridge E t h e r n e t AIX Ethernet VAX AXP AIX DECserver PrintServer LaserPrinter VME Figure 2.1: Schematic view of computers and terminals in the Ethernet/FDDI network 10 Version 4.
User Interfaces to GSI Computers Although the Alpha AXP or VAXstations and the Ethernet are easy to use, users are strictly prohibited from making any changes or re-con gurations on the computer hardware or on the Ethernet cabling by their own. Speci cally: NEVER use 93 IBM 327x cable or 75 video cable as a thin wire Ethernet cable. Use ONLY speci c 50 Ethernet cables available in the GSI stock. Never make a stub from a T-connector to the computer, i.e.
OpenVMS Introduction - Login and Logout graphics terminals are connected to Terminal Servers which for their part are connected to Ethernet. A Terminal Server, e.g. a DECserver, is a device connecting terminals and printers via an Ethernet coaxcable to all Alpha AXP, VAX, ULTRIX, IBM RS/6000 UNIX, HP UNIX, and Digital UNIX (former OSF/1), computers at GSI, to the IBM mainframe computer, and to several VME processor boards (OS/9, LynxOS, and pSOS).
The Alpha AXP or VAX Text Terminal 11. an IBM 327x or IBM 5080 compatible terminal connected directly to the IBM mainframe. 12. remote login via TCP/IP Internet with Telnet on OpenVMS, ULTRIX, AIX, HP-UX, or MVS or any IBM PC or Apple Macintosh running TCP/IP software. 13. remote login via X-25 (DATEX-P, WIN) on OpenVMS or MVS. 14. remote login via HEPnet (DECnet) on OpenVMS. 15. remote telephone modem login on OpenVMS or MVS. 16.
OpenVMS Introduction - Login and Logout The following description shows the OpenVMS login procedure for di erent terminal types. Normally, only the rst phase of the OpenVMS login di ers between the di erent terminal types. 1. A text terminal connected to a Terminal Server. After pressing Return , one of the following is possible: (a) The S200xx Local> prompt is displayed and you can proceed. (b) This is displayed: DECserver 200 Terminal Server V3.1 (BL37) - LAT V5.
The Alpha AXP or VAX Text Terminal ... CLEX1 ... DSAA DSAB ... GOOSY ... IBM ... MVIIC MVIID MVIIE MVIIG ... V6000A ... VME1 VME2 VME3 ... VSAA VSAB VSAC ... VSCG VSCH Available The GSI Online Cluster 1 Available Available ULTRIX 4.4 (RISC) ULTRIX 4.
OpenVMS Introduction - Login and Logout S200xx Local> CONNECT service or just S200xx Local> C service or from a current OpenVMS session such a Terminal Server connection can be simulated by using the command $ CON service or $ SET HOST/LAT service service should be replaced by the available service name. For example: To enter AXP601, the ALPHA AXP node AXP601, you would type: S200xx Local> CONNECT AXP601 or just S200xx Local> C AXP601 2. 3. 4. 5.
The Alpha AXP or VAX Text Terminal $ SET HOST node or just $ HOST node e.g. $ HOST AXP601 and proceed to login. 6. If you login from remote via Telnet (TCP/IP Internet) you need the Internet address or name of the GSI computer you would like to connect to. The GSI naming convention is: node.gsi.de, e.g. axp601.gsi.de, v6000a.gsi.de or mvs.gsi.de for the IBM mainframe. Not all computers at GSI are reachable from remote. You can get the valid Internet addresses using the DCL command $ UCX SHOW HOST name.
OpenVMS Introduction - Login and Logout Now you can login on the Alpha AXP or VAX system by entering your username. AXP601 (Digital 2100 Server Model A500MP, OpenVMS-V6.1) Please login Username: user Type in the username you received from the OpenVMS system manager when you got your account followed by the password belonging to your username Password: password Welcome to OpenVMS AXP (TM) Operating System, Version V6.1 on node AXP601 Last interactive login on Wednesday, 10-AUG-1994 20:38:43.
The DECwindows/Motif Terminal Tektronix TekXpress terminal with a DEC VT220 like keyboard Tektronix TekXpress terminal with an IBM-PC like keyboard In the case of a DEC VXT-20000 you may connect to a host as a TCP/IP Xwindow, a LAT Xwindow, a TCP/IP terminal, or a LAT terminal session. In case of a Xwindow session to a VAX or Alpha AXP the Motif session manager and the Motif windows manager will be started automatically.
OpenVMS Introduction - Login and Logout Type in your username and your password each followed by a Return . The following is a brief description of the handling and the set-up of the window system DECwindows/Motif: When you have more than one window open, you must make the window active you want to work with. To do so, point to a location in the window or window frame by moving the mouse and click the left mouse button (MB1).
First Steps under OpenVMS Screen Background... and Window Colors..., Keyboard.. (with keyclick setup in it), Language... (select English or German e.g. for DECwrite or DECdecision), Pointer..., Security... (to allow other users the opening of windows on your screen). You can select any option with the pointer and a click with MB1. After setting your environment you can save these settings with the option 'Save Session Manager'.
OpenVMS Introduction - Login and Logout The directory displays the following information: The name of les in the above example it is LOGIN The type extension of les above it is COM The version number of les above it is 1. The version number is automatically upgraded each time you save the le with the same name, e.g. when you edit an existing le the new, changed le will get a new, higher version number. LOGIN.COM is, as its name suggests, a command procedure executed whenever you log in.
The IBM Terminal S200xx Local> CONNECT IBM If you want to connect from a running OpenVMS session give the DCL command $ SET HOST/LAT IBM or just $ CON IBM Now your terminal or session is connected to the IBM. After your are connected to the IBM rst type Ctrl G, the Master Reset of an IBM terminal line to cleanup the communication line to the IBM. Now the GSI logo with the IBM terminal device number VDnn will appear on the screen.
OpenVMS Introduction - Login and Logout You will get the IBM Netview Access Services panel for logging in. Please ask the Computer Center operators (room 1.250, tel. 2515) for a speci c Netview Access Services account. Type in your username and password. Remember: the Enter key is the command line delimiter on the IBM and not the Return key which just will move the cursor downwards. After entering your correct username and password you will get to the Application Selection input panel.
Logging Out From the Alpha AXP or VAX PECAD: hold F1 print F2 Shift: PEVAX F5 F6 switch setup screen break F3 F4 PECAD: Ctrl: break F7 F8 F9 F10 PECAD: Shift: PEIBM backspace home dup F11 F13 F12 help F14 F15 F16 insert * F17 eraseEOL erase inp F18 F19 refresh clear F20 PF1 PF2 PF3 PF13 PF14 PF15 PA1 PF4 PF5 PF6 PF16 PF17 PF18 PA2 PF7 PF8 PF9 PF19 PF20 PF21 PA3 PF10 PF11 PF12 PF22 PF23 PF24 + Ctrl G: master reset (e.g.
OpenVMS Introduction - Getting Interactive Help After logging out one is again returned to the Terminal Server "local" mode or the original OpenVMS session depending on the login method. On a Terminal Server session, the prompt S200xx Local> appears. The LOGOUT command at this level logs you out of the Terminal Server and also terminates all remaining sessions. In case of a DECwindows/Motif session you may logout each DECterm window individually or you may exit the whole session.
OpenVMS DCL HELP Chapter 3 Getting Interactive Help 3.1 OpenVMS DCL HELP To obtain on-line documentation for a command, enter the command HELP with the name of the command as a parameter. $ HELP ALLOCATE ALLOCATE Provides your process with exclusive access to a device until you deallocate the device or terminate your process. Optionally associates a logical name with the device. Requires read (R), write (W), or control access. Format ALLOCATE device-name :] ,...
OpenVMS Introduction - Getting Interactive Help If you need help, but do not know what command or system topic to specify, enter the command HELP with the word HINTS as a parameter. Each task name is listed in the HINTS text is associated with a list of related command names and system information topics. 28 Version 4.
OpenVMS DCL HELP $ HELP HINTS HINTS Type the name of one of the categories listed below to obtain a list of related commands and topics. To obtain detailed information on a topic, press the RETURN key until you reach the "Topic?" prompt and then type the name of the topic. Topics that appear in all upper case are DCL commands.
OpenVMS Introduction - Getting Interactive Help GSIHELP: SYSMSGHELP: KERMITSYS: VPW: UTILITY: COMMAND: PROGRAM: MODULE: MESSAGE: RECOVER: DMTYPES: Several general utilities available at GSI, i.e. TEX OpenVMS system error message descriptions KERMIT help library FermiLab software like DTC and CALC GSI and GOOSY command procedures GOOSY commands GOOSY main programs GOOSY program modules GOOSY error message descriptions GOOSY error recovery descriptions GOOSY data element declarations 3.
WorldWideWeb WWW windows. In the manual's Contents window you may select from the View menu the list of the contents (start default), examples, gures, tables, or the index. The contents can be collapsed or expanded. Leave the manual by selecting from the File menu the Close Book option. Exit the Bookreader by selecting from the File menu the Exit option or type Ctrl e (the keyboard Lock to upper case letters should not by active). 3.
OpenVMS Introduction - Using Communication Utilities 3.4 WorldWideWeb WWW The WorldWideWeb (WWW or W3) is the universe of network-accessible information, an embodiment of human knowledge. It is an initiative started at CERN , now with many participants. It has a body of software, and a set of protocols and conventions. W3 uses hypertext and multimedia techniques to make the web easy for anyone to roam, browse, and contribute to. Future evolution of W3 is coordinated by the W3 Organization.
Mail File Directory Chapter 4 Using Communication Utilities 4.1 Using the OpenVMS Mail Utility The interactive Mail utility (MAIL) allows you to send and receive messages, as well as to le, forward, delete, and reply to messages that you have received. To invoke the interactive Mail Utility from a text terminal, specify the DCL command MAIL without parameters. $ MAIL MAIL> You may also call the Mail utility together with DECwindows/Motif selecting from the Session Manager's Applications menu Mail.
OpenVMS Introduction - Using Communication Utilities Mail utility you should create a Mail subdirectory in your default le system. You do this by the command $ MAIL MAIL>SET MAIL_DIRECTORY MAIL>SHOW MAIL_DIRECTORY 4.1.2 Sending Mail You can create and send mail messages interactively with the Mail Utility.
Sending Mail MAIL> SEND To: SMTP%"Anne@mvs.gsi.de" Subj: Meeting of June 9 etc. The pre x SMTP% and the double quotes must be given exactly in this spelling. 3. BitNet or EARN node: In the case of BitNet or EARN specify the addressee as SMTP%"user%node.BITNET@gsi.de", e.g. node IBM mainframe at GSI = DDAGSI3 MAIL> SEND To: SMTP%"PR99%DDAGSI3.BITNET@gsi.de" Subj: Meeting of June 9 etc. The pre x SMTP% and the double quotes must be given exactly in this spelling. 4.
OpenVMS Introduction - Using Communication Utilities where file.type is the text le speci cation and /EDIT starts the text editor rst. The /SELF option will send a copy of the mail to your own account. You may set up a forwarding address permanently within Mail by the Mail command SET e.g. FORWARD, MAIL> SET FORWARD Anne or MAIL> SET FORWARD "AXP601::Anne" In case of Internet or BitNet the special handling of double quotes must be taken into account, e.g. MAIL> SET FORWARD "SMTP%""Anne@mvs.gsi.
Mail Addressing of GSI from Remote username@axp601.gsi.de or username@v6000a.gsi.de or username@alice.gsi.de e.g. anne@v6000a.gsi.de The rst addressing method is the common GSI addressing with "F" is the initial of the rst name and "Name" is the surname of the user, e.g. for Mathias Richter it would be: "M.Richter@gsi.de". The DVEE department keeps a translation list of all users at GSI with their preferred destinations. Therefore e.g. the address "M.Richter@gsi.
OpenVMS Introduction - Using Communication Utilities where "1234567890" is to be replaced by the GSI X-25 number you may get on request from the OpenVMS Advisory Service (see names on page 5). and where "username" is a valid user account on VSCN. 4.1.4 Reading Mail Invoke the Interactive Mail Utility to read a mail message. Messages that you receive are stored in mail les, which have a default le type of .MAI. Your default mail le, MAIL.
Organizing Your Mails To continue reading your new mail messages, press Return in response to the MAIL> prompt. Pressing Return in MAIL is equivalent to specifying the READ command without parameters. To read a speci c Mail use the Mail command MAIL> READ n e.g. MAIL> READ 12 where n is the number of the Mail seen by the Mail command DIRECTORY.
OpenVMS Introduction - Using Communication Utilities or MAIL> SELECT folder-name /SUBJECT="string" subjects of mails containing string MAIL> DIRECTORY or just DIR shows the selected list to read mails from that folder. The DIR command will list all mails from the selected folder. You get all existing folder names by the command MAIL> DIR/FOLDERS If you want to get the contents of a mail into a le use the command MAIL> EXTRACT file-name just after you read the mail.
Using the Phone Utility $ CMAIL TEXT.TXT DFN::DSAA.GSI.DE::MILLER /SUBJECT="Any text" If you would like more information about the usage of it at GSI, enter HELP CMAIL. To get the nodes available in the BitNet (EARN) network use the EARN command followed by any string you know from this node. All nodes will be found, that include that string fully or partially. For example, $ EARN ARGONNE $ EARN ANL The IBM mainframe has the BitNet (EARN) address DDAGSI3. 4.
OpenVMS Introduction - Command Formats 42 Version 4.
DCL Command Format Chapter 5 Command Formats The DIGITAL Command Language (DCL) provides you with a direct connection to the OpenVMS system and the software running on Alpha AXP or VAX. In response to the DCL prompt (which is initially one or two letters de ning the node you are logged in and a dollar sign, e.g. F $ ), you enter a command name followed by any desired parameters and quali ers.
OpenVMS Introduction - Command Formats parameter-quali er. Lowercase and uppercase characters in command and quali er names are equivalent. Lowercase and uppercase characters in parameter and parameter-quali er values are equivalent unless enclosed in quotation marks. The following COPY command line consists of the command name, a command quali er, and two parameters $ COPY/LOG FORMAT.TXT WATER.TXT The command instructs the system to copy the le FORMAT.TXT to another le named WATER.
DCL Quali ers counting the slash before quali ers). Only if you have de ned a DCL symbol which you use as a command synonym the whole command will be checked (see section 5.6 at page 48). The following commands, for example, are equivalent: $ SHOW TIME $ SH TI In interactive mode, you will work faster if you abbreviate. The abbreviations may feel awkward at rst but you will soon get used to them.
OpenVMS Introduction - Command Formats Positional quali ers| A positional quali er has di erent meanings depending on where you place it in the command string. If you place a positional quali er after the command verb but before the rst parameter, the quali er a ects the entire command string. If you place a positional quali er after a parameter, the parameter a ects only that parameter.
DCL Symbols $ LINK INFILE $ LINK INFILE /EXEC=OUTFILE $ LINK INFILE /NOEXEC In the rst example the object le named INFILE with the default le type .OBJ will be linked and an executable image will be produced located in the le INFILE.EXE. In the second example the resulting executable image will be in the output le OUTFILE.EXE. In the third example no executable image will be produced, i.e. this is only a formal check of the link step.
OpenVMS Introduction - Command Formats 5.6 DCL Symbols DCL symbols are very often used as abbreviations for DCL commands and to call DCL procedures or programs. There are global and local symbols. Local symbols are known only at the command procedure level where they are created, whereas global symbols are known to all levels. Global symbols are deleted only by DELETE/SYMBOL/GLOBAL or by logout. You should use mainly local symbols interactively and in DCL procedures.
Interrupting Commands 5.7 Interactive Commands You invoke an interactive command by typing its name and pressing Return . (Some interactive commands accept parameters and quali ers on the command line.) The command responds with a prompt, as shown: $ MAIL Mail> You can now enter subcommands recognized by that interactive command. To enter another DCL command, you must rst exit from the interactive command, usually by typing EXIT (and pressing Return ) or pressing Ctrl Z in response to the command prompt.
OpenVMS Introduction - Command Formats Continue| You can continue execution of the program by entering the command CONTINUE. Any number of built{in commands (but only built{in commands) can be entered after Ctrl Y and before CONTINUE. The following example interrupts the execution of the CLEANUP command procedure, sets veri cation, and then continues execution of the command procedure.
Logical Names $ SHOW PROCESS or $ SPRO Detailed informations about all current processes are available with the command $ SIN or $ SIN132 !for terminals set to 132 character width Detailed informations about a speci c process are available by the command $ PWATCH process-name or $ PWA/pid where 'process-name' is the name of the process to be monitored and 'pid' is the process IDnumber, obtainable by the $ SSYS command.
OpenVMS Introduction - Command Formats A = ALICE, F = FRITZ = V6000A, AXP601, etc. Therefore you should be careful in using abbreviations for lenames, GOOSY Data Base names, or others. If you just use the lename 'A' without a le type declaration, the system will open a network link to the VAX called ALICE, instead of using the le 'A'. This will not happen with e.g. 'A.TXT'. Logical names are de ned in several 'scopes'. The scopes are SYSTEM, GROUP, JOB, PROCESS, and USER.
Logical Names The user access to disk devices is not done directly but via speci c logical names, the so called roots. A root is the logical name for a hardware disk name and a speci c directory. These directories are created by the system manager. The root logical name can be used instead of the physical device name. E.g. on the VAX VSCN the logical name TEX$DEVICE translates to $2$DKB100: and TEX$ROOT translates to TEX$DEVICE:$TEX.].
OpenVMS Introduction - Files 54 Version 4.
File System and Directories Chapter 6 Files 6.1 File System and Directories All kind of data on an Alpha AXP or VAX are kept in les. These les are sorted in directories and subdirectories, up to 7 levels deep. A full le speci cation is: node::device: directory]filename.
OpenVMS Introduction - Files $ SET DEFAULT newdir] $ SET DEFAULT .newdir] $ SET DEFAULT -] In the rst case, newdir is set 'absolute', in the second relative to your current directory. The third command gets you back one level. You nd where you are by $ SHOW DEFAULT or shorter: $ SDEF A list of all les in a directory is output to terminal by $ DIR filespec Filespec may be omitted, or speci ed partially using wildcards. Wildcards are * and % for any number of letters or one letter, respectively.
File Backup 6.2 File Structure at GSI There is a sub-structure in the main VAX VMScluster to increase the availability and performance. The VAX V6000A (FRITZ) is connected via a so called Computer Interconnect CI (a 70 Mbit/s serial bus) to a central disk controller HSC-70. The disks on this controller are named like $1$DUAn: where n is a number, e.g. $1$DUA21:. The VAX V6000A is also connected via Ethernet/FDDI to all VAXstations (more than 60) of the whole cluster.
OpenVMS Introduction - Files backed up approximately every fortnight by the OpenVMS Advisory Service (see names on page 5). Between two full backups each night all les not saved in the full backup will be backed up partially on disk. This partial backup will be overwritten each night, i.e. this is no incremental backup! If you lost a le please contact the OpenVMS Advisory Service immediately for restore (see names on page 5).
File Handling $ COPY file1.type1 file2.type2 !copy file1 to file2 $ COPY file1.type1 directory]file1.type1 !copy into another directory $ COPY file1.type1 xx$ROOT: directory]file1.type1 !copy on to another root $ COPY file1.type1 node::root: directory]file1.type1 !copy on to another node $ COPY node1::root1: directory1]file1.type1 vers1 _$ node2::root2: directory2]file2.type2 vers2 To copy several les into separate new les use wildcard characters, e.g. $ COPY file1.type1,file2.type2,file3.
OpenVMS Introduction - Files $ FTP within FTP use the following sequence of commands FTP> CONNECT "host_name" or FTP> OPEN "host_name" ! use double quotes preserving lower case characters now login on the remote computer FTP> APPEND local_file "remote_file" ! append to a remote file rename le | To rename one or more les inclusively types and versions use the DCL command RENAME, e.g. $ RENAME file1.type1 version1 file2.type2 version2 !rename all files with type1 into files with type2 $ RENAME *.
File Handling $ POP -Pnnxxx file1.type1 version1,file2.type2 version2 !print all files of type1 from the default directory on the laser printer P08 ! with 80 characters per line on white paper: $ POP -P08WAS *.type1 * dump le | To dump the contents of a le in hexadecimal, decimal or octal use the DCL command DUMP, e.g. $ $ $ $ $ DUMP file1.type1 DUMP/OUT=ofile file1.type1 DUMP/OCT file1.type1 DUMP/DEC file1.
OpenVMS Introduction - Files !search "string" in file1 and file2 and list lines found on your terminal $ SEARCH file1.type1,file2.type2 "string" !search "string" in all files of type1 and write lines found into file ofile.LIS $ SEARCH/OUT=ofile *.type1 "string" !search "string" in all files of type1 and list +- 5 lines found on your terminal $ SEARCH *.type1 "string" /WINDOW=(5,5) !search "string" in all files of type1 and list only filenames on your terminal $ SEARCH *.
Magtape Handling Currently only EXAbyte cassettes must be initialized speci cally, if you want to copy les on a new EXAbyte cassette. You must rst write an arbitrary (short) Backup saveset on it $ MOUNT /FOREIGN tape: $ BACKUP file.type tape:file.bck /SAVE $ DISMOUNT /NOUNLOAD tape: e.g. $ MOUNT /FOR LM1: $ BACKUP ADAM.TXT LM1:ADAM.BCK /SAVE $ DISMOUNT /NOUNL LM1: Now you can use the cassette for the normal DCL COPY. 5.
OpenVMS Introduction - Program Development 64 Version 4.
Editing Chapter 7 Program Development 7.1 Editing We recommend to use the language sensitive editor LSEDIT invoked from a text terminal by $ LSEDIT filename.type or just $ LSE filename.type !If you edit the same file again just type $ LSE !The editor remembers the last filename edited. You may also start LSEDIT from a DECwindows/Motif DECterm with $ LSEDIT/INTERFACE=DECWINDOWS filename.type or just $ LSE/INT=DECW filename.type or select from the DECwindows/Motif Session Manager Application Menu LSEDIT.
OpenVMS Introduction - Program Development Upper and lower case characters are always displayed as they are. You switch between insert and overstrike mode by Ctrl A. A new line is entered by the Return key instead of the Enter key. To proceed the cursor to a new line use 0 or + for going down or * for going up with the cursor within your text. The screen splitting is entered or left by PF1 =. To switch between the two windows, use F20 or GOLD * . To delete the character left from the cursor, use Delete .
Editing Move the cursor to the top of the text bu er by PF1 5 . Rewrite (refresh) the whole screen by Ctrl W. To open a new text le and with it a new bu er use F9 . It prompts you for the le name. The bu er name will become equal to the le name. To switch the current bu er to another bu er, use F10 . The bu er name will be prompted. To show all available bu ers use GOLD Select . Select one of them by moving the cursor to the bu er line and use Select .
OpenVMS Introduction - Program Development HELP ! to get help A shorthand for READ is PF1 F9 (the lename is prompted). A shorthand for WRITE/SELECT is PF1 F10 (the lename is prompted). To get a keypad layout, enter PF2 . To get all keypad de nitions, enter PF1 F7 . Enter the OpenVMS help by F7 .
Editing Test compile: This is a very useful feature of the LSEDIT. Press F17 and the current le will be compiled. The error messages are displayed in the top window. You may now correct your source following the messages. NOTE that the current bu er is written to its le! Ctrl N will skip to the next error, Ctrl P will skip to the previous error. Include PL/I calling sequence for a module: With the the F8 key you can include a calling statement for a module. The module name is prompted.
OpenVMS Introduction - Program Development The upper key values are the simple key hits, the lower are entered with a preceding GOLD(=PF1)-key hit. hold F1 print F2 setup F3 switch screen F4 PECAD: Ctrl: break break F5 PECAD: Shift: PEIBM text ( text ) del.word cut bu und word F11 F12 F14 F13 PECAD: Shift: PEVAX Ctrl Y VMS help incl.call new le sel.bu show key incl.
Compiling 7.2 Compiling You may call the following compilers directly as DCL commands: $ $ $ $ $ $ $ $ $ BASIC CC CXX FORTRAN MACRO MODULA OPS5 PASCAL PLI ! for the C compiler ! for the C++ compiler on AXP only ! for the assembler ! on the VAXes only But the recommended command to call a compiler is $ COMPILE filename.type The compilers are invoked by $ COMPILE filename.type, depending on the le type. Standard le types are: .C = C sources .FOR = Fortran sources .MAR = VAX Assembler sources .
OpenVMS Introduction - Program Development $ COMPILE X/OLB=OPRIV ! insert object of X in library OPRIV $ COMPILE X/LIB=TPRIV ! Search TPRIV for includes $ COMPILE X /QUALIFIER=(LIST,SHOW=ALL) ! write a file X.LIS containing line numbers ! PL/I switches as shown by HELP PLI must ! be passed to COMPILE by this way You may also compile programs during a LSEDIT session pressing the F17 key.
Debugging This should again be done in the LOGIN.COM le. Then the program is executed by command. The LIB$GET FOREIGN routine called in the program returns any characters typed behind command. This is the method to pass parameters to a program together with the execution. A program can be canceled by All utility programs should be rather termi- Ctrl Y. Ctrl Z. nated on terminal input request by 7.5 Debugging The OpenVMS debugger is a very powerful tool to nd errors.
OpenVMS Introduction - Program Development $ CREATE/TERMINAL/NOPROCESS /WINDOW_ATTR=(TITLE="Debugger",ICON_NAME="Debugger",ROWS=40) /DEFINE_LOGICAL=(TABLE=LNM$JOB,DBG$INPUT,DBG$OUTPUT) $ ALLOCATE DBG$OUTPUT In the following only the text terminal command mode will be described. For the DECwindows/Motif mode refer to on-line Help or the Debugger manual. When you enter the DEBUG menu you may get detailed information with the DEBUG command HELP.
Debugging PECAD: PECAD: Ctrl: break switch setup screen break print hold F1 Shift: PEVAX F3 F2 F4 Ctrl Y F5 F6 F7 F8 F9 Ctrl Z F10 PECAD: Shift: PEIBM beg.line del.word overstr F11 F12 F13 help F15 F14 F16 F17 F18 F19 F20 Ctrl A: switch insert and overstrike mode set exam loc scroll text Ctrl B: recall previous command GOLD help BLUE screen 1 line * Keypad contin.
OpenVMS Introduction - Program Development 7.6 OpenVMS Libraries The OpenVMS libraries are similar to IBM PDS's. But IBM members are called here modules (that's live). OpenVMS libraries are supported only by speci c commands and utilities. Only libraries of speci c types are supported: TEXT, HELP, OBJECT and MACRO libraries. Libraries are created by $ $ $ $ LIBRARY/CREATE/TEXT LIBRARY/CREATE/HELP LIBRARY/CREATE/OBJECT LIBRARY/CREATE/MACRO filename.tlb filename.hlb filename.olb filename.
Libraries TEXT Libraries Used for PL/I includes and GOOSY data type declarations compilers and GOOSY. $ LIB/REPLACE library file.TXT ! replace file as module 'file' $ LIB/REPLACE/MODULE=name library file.TXT ! replace file as module 'name' $ LIB/EXTRACT=module/OUT=file.TXT library ! copy module to file The text in the le / module may have any format. File type .TEX is defaulted.
OpenVMS Introduction - Program Development LIBEXTR sourcelib module extracts modules from library. Wildcards for module are supported. Module names may be in a text le which must be speci ed as @ le. LIBDEL sourcelib module deletes a module from library. Wildcards for module are supported. Module names may be in a text le which must be speci ed as @ le. 7.7 Source Code Analysis SCA Together with the Language Sensible Editor LSEDIT a Source Code Analyzer SCA is available.
DEC Performance and Coverage Analyzer PCA PCA has two operational components: 1. the collector: It gathers performance or test coverage data on a running program and writes that data to a performance data le. You may select either the main image or one of the shareable images in the program's address space. It measures the dynamic behavior of the image you have selected.
OpenVMS Introduction - Program Development These commands will write the collected data to the le TEST.PCA, will set PC sampling mode and starts the program. To invoke the analyzer use the DCL command PCA $ PCA /COMMAND="command1 command2 ..." data-file e.g.
OpenVMS Routines store les (called elements) in a library fetch elements, modify them, and test them in your own directory control concurrent modi cations to the same element Merge concurrent modi cations to an element create successive versions (called generations) of elements compare two generations of an element within a library organize related library elements into groups de ne a set of generations of elements as a class to make up a base level or release version of a project track which users are wor
OpenVMS Introduction - DCL Procedures 7.10.2 Run Time Library Routines OpenVMS provides a large number of runtime library (RTL) routines for various purposes. General library routines (LIB$...). Screen handling routines (SMG$...). Mathematical routines (MTH$...). String handling routines (STR$...). You get a full list and short description by HELP RTL. Again, the call of these routines may be inserted by the LSEDIT 7.10.3 Utility Routines OpenVMS provides program interfaces to several utilities.
Command Procedure Format Chapter 8 DCL Procedures DCL procedures are les containing DCL commands. A DCL procedure can be executed in batch job, or in the current process, or at a remote node. $ @file $ @file /OUTPUT=outfile $ SUBMIT/NOPRINT file ! Execute interactively. ! Execute interactively and write all output ! into the file named 'outfile' ! Submit for batch execution and write all output ! into the log-file named 'file.LOG' under SYS$LOGIN 8.
OpenVMS Introduction - DCL Procedures $ $ $ $ $ $ $ $ $ $ $ $ GOTO CALL label label: SUBROUTINE IF - THEN ELSE - ENDIF INQUIRE ON - THEN ON ERROR THEN ON CONTROL_Y THEN SET NO]ON SET VERIFY SET NOVERIFY SYNCHRONIZE ! Go to label ! Subroutine call ! Subroutine ! ! ! ! ! ! ! ! ! Conditional execution Prompt for a string Control conditions Control error conditions Control Ctrl Y conditions Enable (default) or disable error conditions Output commands lines during execution Do not output commands lines (def
Control Statements with symbols having a numeric value and others having a string value, but the result will be unpredictable. String values are enclosed in quotation marks (""). If a symbol is enclosed in apostrophes, it is replaced by its value before the line is processed further. This is important because one can use symbols for very tricky operations. In expressions, or as arguments in lexical functions (see below) the apostrophes are not allowed. There are global and local symbols.
OpenVMS Introduction - DCL Procedures 8.3 Control Statements Besides the error control statements (see below) there are only four other control statements: $ IF expression THEN command ! execute command only if expression true $ $ $ $ IF THEN ELSE ENDIF ! Conditional execution $ GOTO label $ label: ! Proceed at label ! label $ GOSUB ROUT $ ROUT: $ RETURN ! Proceed at label ROUT, but return ! label ! return to statement behind GOSUB $ CALL label $ label: SUBROUTINE ! Subroutine call ! Subroutine 8.
Command Procedure Parameters The string de ned with the INQUIRE statement will be typed on the terminal rst (prompt string) followed by a colon ":". If you want to suppress the colon use INQUIRE/NOPUNCTATION. DCL reads commands from SYS$COMMAND and writes output to SYS$OUTPUT or SYS$ERROR. Any prompts from programs are read from SYS$INPUT which is the DCL procedure le. You must provide the input as data lines behind the line calling the program.
OpenVMS Introduction - DCL Procedures $! $! $! $! $! $! This routine may be called as @file ? ! @file X ! @file X Y/SWI ! @file X /VAL=1 @file X "" Z /VAL=1/SWI /DEF="A B"! Enter menu 1 positional parameter 2 pos. par. and a qualifier second pos.
Lexical Functions F$USER() F$VERIFY ! user identification code (UIC) ! verification status Examples: $ old_default = F$DIRECTORY() $ SET DEFAULT X.Y] $ SET DEFAULT 'old_default' ! save directory ! set directory ! restore directory $ IF F$MODE() .EQS. "BATCH" THEN SET VERIFY ! set verification ON in batch only $ IF F$MODE() .EQS.
OpenVMS Introduction - DCL Procedures $ $ $ $ $ x y y x y = = = = = " a " F$EDIT(x,"TRIM") F$EDIT(y,"UPCASE") "a a a " F$EDIT(x,"COMPRESS") $ x = "This is !AS" $ y = F$FAO(x,"A") ! ! ! ! y is a y is A several spaces y is a a a (one space) ! The !AS is a dummy for a string ! y is This is A The following functions convert data types: F$CVSI F$CVTIME F$CVUI F$IDENTIFIER F$INTEGER F$STRING ! ! ! ! ! ! ! extract bit fields and convert to integer convert time to yyyy-mmm-dd hh:mm:ss.
LSEDIT Support for Command Procedures 8.8 Command Procedure Error Handling You should provide generally one or more labels where errors are handled and one where breaks ( Ctrl Y) are handled. You may close les, delete temporary les, give error explanations etc...
OpenVMS Introduction - GSI Utilities IF_END LOOP TMP ! IF END construct ! Loop setup ! unique temporary file name Remember, that you have to replace 'placeholders' and 'tokens' marked by $] or fg, respectively. To do that, just type. Go to the next one by Ctrl N and replace it and so on. 92 Version 4.
Miscellanea Chapter 9 GSI Utilities 9.1 Miscellanea There are some useful utilities written at GSI. Use the HELP command to get complete descriptions. CBATCH executes a DCL command line as a batch job. CREPEAT repeats a DCL command line till Ctrl Y. CREPLACE replace one string by another in several les. CDIFFER Compares sets of les and outputs which les are di erent. ECLINE repeat a DCL command line using a set of values for a placeholder. Note that the command line must be enclosed in quotation marks.
OpenVMS Introduction - GSI Utilities It is recommended to use always rst the /LIST quali er to check if the ECLINE command works correctly. The command is very powerful and may therefore produce a lot of junk, if an error was in the command line. MLOCKS shows all de ned resource locks. The program will prompt you with: SUC: MLOCKS> To enter the command menu type in SUC: MLOCKS> $ MENU NWDCL executes a DCL command line at a remote node. SSEC shows Global Sections of your node.
TeX and LaTeX 9.3 GOOSY Program Library Many general purpose routines have been written for GOOSY. They may be of interest for other programmers as well. All these routines begin with U$.... Get on overview by HELP @MODULE DIRECTORY or in the GOOSY manual 'Overview'. A detailed description can be obtained by HELP @MODULE routine. In an LSEDIT session you can include the complete routine call by pressing the F8 key and entering the routine name.
OpenVMS Introduction - GSI Utilities You have now created your document and now you have to "check" the spelling. Hit the and give the LSE command SPELL. Do key For the SPELL utility all LATEX control string are unknown, so ignore them once with the I key. Do not use the A key because it would enter wrong spelling into the general directory of SPELL. After your text was check and corrected leave LSEDIT with Do Exit command or hit just GOLD Remove . Then call LATEX by typing $ LATEX FIRSTTRY.
Expanding on LaTeX % % % % THIS IS A COMMENT SMALL.TEX -- Released 5 July 1985 USE THIS FILE AS A MODEL FOR MAKING YOUR OWN LaTeX INPUT FILE. EVERYTHING TO THE RIGHT OF A % IS A REMARK TO YOU AND IS IGNORED BY LaTeX. % THE FILE /usr/local/lib/tex82/local.gid TELLS HOW TO RUN LaTeX.
OpenVMS Introduction - Appendix LATEX User's Guide & Reference Manual by L. Lamport or call Volker Schaa, tel. 340, room 1.158 You can print a document example by entering the command lines: $ LATEX TEX$INPUTS:SAMPLE $ DVIPRI SAMPLE 9.4.3 DECwrite (Please do not use DECpresent any longer. It is retired and replaced by DECwrite). DECwrite is only running under DECwindows/Motif.
Using a Terminal and Editing Command Lines Appendix A Using a Terminal and Editing Command Lines On the Alpha AXP or VAX terminal all input can be typed ahead, even if the CPU does not echo. The type ahead bu er allows 80 characters to be typed ahead. The following keys allow you to edit the current DCL command line (and the command lines of most utilities). For some keys to work, the SET TERMINAL/LINE_EDITING command must be in e ect, which is the start default for all terminals at GSI.
OpenVMS Introduction - Appendix | Show the last 20 commands. n | Gets the th command. xyz | Gets the last command starting with the characters xyz. RECALL/ALL RECALL RECALL n | Recalls the DCL command entered after the current command. Ctrl O | Stops and starts the screen output. The execution of a program or command pro+ cedure will not be stop. Any error output or the DCL prompt will automatically switch on the output again. F1 or HOLD | Stops and starts the screen output.
Using a Terminal and Editing Command Lines two sessions if you use the multisession option together with a VT330, VT340, or VT420 terminal. You can move through your established sessions by pressing Ctrl \, or by breaking out to the Terminal Server local mode with key F5 (or Ctrl F5 and Return on a PECAD) and then using the following Local> commands: FORWARD or BACKWARD.
OpenVMS Introduction - Appendix PECAD: Ctrl: break hold F1 print F2 switch setup screen break F3 F4 F5 PECAD: Shift: PEVAX Ctrl Y F6 F7 F8 F9 Ctrl Z F10 PECAD: Shift: PEIBM beg.line del.
Login Command Procedure Appendix B Login Command Procedure A user's login command procedure will be executed at the login time of the user. The user might de ne logical names or DCL symbols in this login procedure. The le must have the name LOGIN.COM and it must be located in the so called login directory of the user where the default is set to after the login. Normally this directory has the same name as the username.
OpenVMS Introduction - Appendix $!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! $! The following lines are for all Utilities writen at GSI !!!!! $! $ TOOLLOGIN $! $!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! $! The following lines are for Public Software, like GNU and WWW !!!!! $! $ PUBLICLOGIN $! $!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! $! The following lines are for Software written by CERN, e.g.
Standard File Types $ SETMES GOOSY /NOHEAD/NOPREF $!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! $! $! Add here user specific statements: $! $ IF F$MODE() .NES. "INTERACTIVE" THEN GOTO G_BATCH $! $! Add here statements to execute interactively only: $! $ GOTO G_FINISH $! $ G_BATCH: $ IF F$MODE() .NES. "BATCH" THEN EXIT $ WRITE SYS$OUTPUT "*********** Starting user batch procedure *****************" $! $! Add here statements to execute in batch only: $! $ SET VERIFY $ G_FINISH: $ EXIT Version 4.
OpenVMS Introduction - Appendix 106 Version 4.
Standard File Types Appendix C Standard File Types Standard le types used at GSI are: ANA SCA analysis le ASM M68020 assembler source C C language source CP C language source for M68020 CXX C++ language source COM DCL command procedures DAT Data le DIR Directory (NEVER use this type) DOC DECwrite document le EX20 M68020 exe les EXE Executable image le (program) FOR FORTRAN program source le HLP Text le of a member of a help library HLB Help library IMG Image (scanned) document le LIS Listing crea
OpenVMS Introduction - Appendix OBJ Object code le, output from compilers (input for linker). OLB Object library PCA PCA analysis le PLI PL/I program source le (without preprocessor) PPL PL/I program source le (for preprocessor) PS PostScript le TXT Text le written by user (input for text library) TLB Text library TMP Temporary le. Should be deleted each day.
Printers at GSI Appendix D Printers and Scanners D.1 Printers at GSI To print a le on a laser printer there is only one command for OpenVMS and UNIX the POP command. The POP command has the following structure: POP - -o ] Print the file on the printer and with the style selected with . are platform specific parameters passed through the print server.
OpenVMS Introduction - Appendix Display a syntax help of the print command. Examples: $ POP -P01GPS file.PS prints file.PS on Printer P01 in PostScript format $ POP -Q -p08 shows all entries in the default print queue of the printer p08 The print queue names (selector) de ne the printer device as well as the printing style and format. If the style or the printer selector are omitted default values are used.
Printers at GSI LN03_TEXT_80F (stock=DEFAULT) PCL (stock=DEFAULT) LPS$$FORM (stock=DEFAULT) PS_PLAIN (stock=PLAIN_PAPER) If you need additional fonts use the option /SETUP=(font,font,...
OpenVMS Introduction - Appendix WNS WNQ WPS WPD WRS WXS = = = = = = white white white white white white paper, paper, paper, paper, paper, paper, PostScript only, single sided PostScript only, double sided and two-on-one page ASCII/PostScript, single sided ASCII/PostScript, double sided REGIS, single sided Tektronix, single sided Example: POP -P08WND -O /NOFLAG/COP=3 FILE.PS prints the PostScript file: files.ps on printer p08 on white paper without a flag page in 3 copies.
Printers at GSI P09 PrintServer 17 PSAB:: GAS,GNS,WNS,GRS,GXS,GAD,GND,GAQ,GNQ,WAS 1.222a P10 PrintServer 17 PSAC:: GAS,GNS,WNS,GRS,GXS,GAD,GND,GAQ,GNQ,WAS Geschaeftsfuehrung P11 PrintServer 17/600 PSAD:: GAS,GNS,WNS,GRS,GXS,GAD,GND,GAQ,GNQ,WAS Atomphysik vis-a-vis 2.294 P12 PrintServer 17/600 PSAE:: GAS,GNS,WNS,GRS,GXS,GAD,GND,GAQ,GNQ,WAS KPIII 4.174 P13 PrintServer 17/600 PSAF:: GAS,GNS,WNS,GRS,GXS,GAD,GND,GAQ,GNQ,WAS KPII vis-a-vis 4.
OpenVMS Introduction - Appendix P23 LN03R ScriptPrinter LTA1748:S300FD GAS,GNS,GRS,GXS,GDS,GAQ,GNQ Cont.01 2046 P24 LN03R ScriptPrinter LTA1911:S700FN GAS,GNS,GRS,GXS,GDS,GAQ,GNQ Labor 2.103 P25 LN03R ScriptPrinter LTA1492:S200EI GAS,GNS,GRS,GXS,GDS,GAQ,GNQ Labor 3.001 P26 LN03 / PLUS GAS LTA428:S200AF DV/EE Lab 2.252 P27 LN03 / PLUS GAS LTA408:S200AD Mess-Station 1.124 P28 LN03 / PLUS GAS LTA528:S200AP KPII vis-a-vis 4.141 P29 LN03 / PLUS GAS LTA438:S200AG SHIP Villa Exp.
Printers at GSI P37 LN03 / PLUS GAS LTA457:S200AI Prog.entw.Raum 2.117 P38 LN03 / PLUS GAS LTA1458:S200EE VAX-Rechnerraum 1.222a P39 InkJet LJ250 GAS LTA488:S200AL DV/EE Lab 2.252 P40 Designjet 650C A0 LNS LTA361:S200BD P41 Magicolor WCS,FCS P42 LinePrinter GAS LTA668:S200BD Room 1.107L P43 LN03 / PLUS GAS TTA3: directly connected to VSAA Cave B P44 LN03 / PLUS GAS TTA3: directly connected to VSBQ P45 LaserJet 4Si GPS,WPS,GPD,WPD RZ I/O Room RZ 2.
OpenVMS Introduction - Appendix You get help with $ HELP obtained by command PRINTER and with $ HELP POP. The printer queue status can be $ SPRI Each department is responsible for lling toner and new paper on their local LN03+ and LN03R printers. Toner and paper are available at the GSI stock. In case of problems call the the operators console tel. 2515 or the OpenVMS Advisory Service (see names on page 5). D.2 Image Scanners at GSI Pictures stored pixel-wise are called image data.
Installed Software on OpenVMS Appendix E Batch Queues At the Alpha AXP and the VAX VMSclusters (Nodes AXP601, AXP602 or V6000A, VSCN or all satellites AXP6xx or VSxx) there are among other queues several batch queues (this list is obtained by command SHOW QUEUE /BATCH): Batch queue SYS$BATCH_node, on node:: e.g.
OpenVMS Introduction - Appendix 118 Version 4.
Software installed on OpenVMS VAX Appendix F Installed Software on OpenVMS F.1 Software installed on OpenVMS VAX The following software products are currently installed on the main OpenVMS VAX Cluster at GSI and is available on most VAXstations connected to this Cluster. A (*) marks all software not available on other VAXs. The DCL command to start the application is given in ]. To all products documents and on-line Help are available. To most products a Bookreader documentation is available, too.
OpenVMS Introduction - Appendix selected by the DECwindows/Motif Session Manager Language option. (Runs only under DECwindows/Motif. Bookreader documentation available) DECpresent (*) $ DECPRESENT]: DECpresent is replaced by DECwrite. DECimage Scan (*) $ IMAGE INTER]: Scans images in black/white or color with 300 dpi on one of the scanners installed at GSI, e.g. SCAN01 located in the Elektronik/Experimente laboratory room 2.249. For scanner locations see appendix D on page 109.
Software installed on OpenVMS VAX SCA $ SCA]: By the DEC Source Code Analyzer (SCA) together with the LSEDIT programs can be analyzed for cross-references and call consistencies. It produces detailed analysis libraries from program sources.
OpenVMS Introduction - Appendix { GTS-GRAL GKS (Graphics Kernel System) (Bookreader documentation available) DEC Notes $ NOTES]: DEC Notes is an interactive notes and conference tool for many users joining common notes conferences. Users can read or write notes depending on the conference type. (Bookreader documentation available) Relational Data Base, RDB (*) $ RDO or $ SQL]: The run-time version of the relational data base RDB is available on all Alpha AXP and VAX systems.
Software installed on OpenVMS VAX DECdecision, DECchart, DECcalc (*) $ INFORM]: DECdecision is an integrated information management and decision support environment composed of spreadsheet, database, and charting components, and a cross-application tape recorder. Use DECdecision to store data, access and query data, analyze complex data, and create graphs based on that data.
OpenVMS Introduction - Appendix DEC SoftPC (*) $ SOFTPC]: The SOFTPC command allows an OpenVMS system to emulate an IBM PC AT 286. It can operate either in DECwindows mode or character cell mode. (Bookreader documentation available) PCDISK (*) $ PCDISK]: PCDISK is a DOS le maintenance utility which is used to maintain DOS devices, e.g. 3 1/2 " oppies, accessible to OpenVMS. The interface is DOS like, having many emulated DOS commands. OpenVMS style prompting, line editing and HELP are available.
Software installed on OpenVMS Alpha AXP { Distributed Name Service, DNS: DNS manages network-wide logical names, e.g. for peripherals or computer node names. It will be converted to the OSI X-500 standard in the future. { Remote System Manager, RMS: Allows system management operations like software installations and backups on all VAX nodes on the Ethernet, even on other clusters.
OpenVMS Introduction - Appendix DECwrite is a WYSIWYG (What You See Is What You Get) editor under DECwindows/Motif to compose complex documentations including text, graphics, and images previously scanned with DECimage Scan software. (Runs only under DECwindows/Motif.
Software installed on OpenVMS Alpha AXP The statistic results are available as histograms or tables.
OpenVMS Introduction - Appendix DEC TCP/IP Services for OpenVMS (UCX) (*) $ TELNET and $ FTP]: The DEC TCP/IP Services for OpenVMS promote sharing between Alpha AXP and VAX servers and UNIX clients. It supports networking, le access, and application development between Alpha AXP and VAX servers and UNIX clients. The DEC TCP/IP Services for OpenVMS software is comprised of several components, e.g.
Software installed on OpenVMS Alpha AXP { Volume Shadowing: It allows the shadowing (simultaneous on-line use) of to identical disk drives as one logical device. If the hardware of one drive should crash the second drive runs uninterrupted. Version 4.
OpenVMS Introduction - Appendix 130 Version 4.
System Error Messages Appendix G HELP File Format The format of a help le must be (Note that there are in the rst column only level numbers any text must begin with a ): 1 key text text ... 2 subkey text ... 3 subsubkey text ... 2 subkey text ... 3 subsubkey text ... 1 key text ... 2 subkey text ... line line line line line line line line The module name(s) is (are) determined from the main keys in the le.
OpenVMS Introduction - Appendix 132 Version 4.
System Error Messages Appendix H System Error Messages System error messages are displayed in the format: %FACILITY-L-IDENT, text FACILITY = L = (F IDENT = text = the mnemonic for the program issuing the message the first letter of the severity code = fatal error, E = error, W = warning, I = information, S = success) an abbreviation of the text an explanation of the error Example: $ DELETE ADAM.
OpenVMS Introduction - Appendix 134 Version 4.
OpenVMS Glossary OpenVMS Glossary The glossary follows the following format: The glossary words are printed in bold. Words that can be cross-referenced are emphasized. Words that can be entered at the terminal are in typewriter style. account: Enables access to the system software (command interpreters, compilers, utilities, and so on) including the ability to perform work of general nature (program development, text editing, and so on).
OpenVMS Glossary batch: Mode of non-interactive processing in which all commands to be executed by the operating system and, optionally, data to be used as input to the commands are placed in a command procedure le and submitted to the computer system for execution in a so called batch queue (corresponding OpenVMS DCL command $ SUBMIT file /QUEUE=queuename). batch job: A non-interactive process. batch queue: Execution queue for batch jobs submitted to the computer system.
OpenVMS Glossary Computer Interconnect CI: A high-speed, fault-tolerant, dual-path serial bus, which has a bandwidth of 70 MBits per second. With the CI, any combination of VAX processor nodes and intelligent I/O subsystem (Hierarchical Storage Controller, HSC) nodes -up to 16 in number - can be loosely coupled in a computer room environment running the VMScluster software. concatenate: To link together in a series. CPU: Central Processing Unit.
OpenVMS Glossary DECwindows/Motif: The standard graphical user interface available on Alpha AXP, VAXs- tations, and DECstations is DECwindows/Motif. It is compatible to OSF Motif and the Xwindow standards. DECwrite: DECwrite is a WYSIWYG (what you see is what you get) editor under DECwindows/Motif to compose complex documentations including text, graphics, and image data. It runs under OpenVMS on Alpha AXP and VAXstation and under MicroSoft Windows on IBM compatible PCs.
OpenVMS Glossary directory: A le that brie y catalogs a set of les stored on disk or tape. The directory includes the name, type, version number, creation date, modi cation date, and other information of each le in the set. editor: see LSEDIT EARN: The European Academic & Research Network which is the European version of the U.S. BitNet. The IBM mainframe has the EARN address DDAGSI3. This computer is the only one accessible at GSI via EARN (not available on VAX nor on Alpha AXP).
OpenVMS Glossary le version number: Numeric component of a le speci cation. When a le is edited, its version number is increased by one. FTP File Transfer Protocol: FTP is the user interface to the Internet TCP/IP standard le transfer protocol. FTP allows users to log into remote systems, transfer les to and from remote hosts, obtain listings of directories on remote hosts, and other common le operations. Most FTP commands require one or more le speci cations.
OpenVMS Glossary HEPnet: GSI is connected to an international DECnet for the High Energy Physics community, called HEPnet. Hierarchical Storage Controller, HSC: A self-contained, intelligent, mass-storage (magnetic disk and tape drives) controller that communicates with VAX processors in a VMScluster environment via a Computer Interconnect, CI bus. IBM mainframe: The GSI computer center is equipped with an IBM mainframe type 9121-621 running MVS/ESA/TSO under VM/ESA.
OpenVMS Glossary K: A unit for measuring the size of memory or similar resources. K is short for kilo and is used to mean 1000, although in computer slang K is equal to 1024. keypad: The small set of keys to the far right of the main keyboard on a terminal. The key functions depend on the program using them, e.g. LSEDIT, DEBUG, DCL, or IBM mainframe.
OpenVMS Glossary are other text editors available, namely EDT and EVE. For more information on these text editors see the LSEDIT or DECset manuals or the Bookreader documentation. LynxOS: LynxOS is a real-time operating system designed for use with Motorola based GSI CAMAC controller CVC, VME processor boards (like Eltec E6, E7), and Intel 80x86 based PCs. It provides fully UNIX compatible real-time options and POSIX standards.
OpenVMS Glossary the object code. Several of these object code les are linked together producing an image le which nally can be executed on the computer. OpenVMS: VMS = Virtual Memory System. The name of the Alpha AXP and VAX operating system. operating system: The system software that controls the operations of the computer. Alpha AXP and VAX computers are running the OpenVMS operating system. The DECstations are running the ULTRIX operating system.
OpenVMS Glossary prompting: A symbol used by the system as a cue to signal that the system is ready to accept input from you. preamble: Term from LATEX . The commands before \begin document. process: The environment in which you use the Alpha AXP or VAX OpenVMS system. PURGE: The action of deleting older versions of les, but keeping the newest one (the one with the highest version number). quali er: Command modi er that describes the operation of a command.
OpenVMS Glossary system manager: Person who makes resources available to users and sets up restrictions governing the use of such resources (see names on page 5). TCP/IP: The Transmission Control Protocol/Internet Protocol, TCP/IP, was originally devel- oped by the U.S. Department of Defense. Based on TCP/IP, the Internet network is a Computer network used worldwide by research and industry. Several protocol are based on TCP/IP, e.g.
OpenVMS Glossary VAX: Virtual Address Extension. The name of a computer system manufactured by DIGITAL Equipment Corporation. The operating system for VAX computers is OpenVMS. VMScluster: A highly integrated organization of OpenVMS systems that communicate over a high-speed communications path. VMScluster con gurations have all the function of single node systems, plus the ability to share CPU resources, queues, and disk storage.
OpenVMS Glossary Wissenschafts-Netz WI: The computer telecommunication network service o ered by the Ger- man PTT, Telekom to all German Universities and research labs. It uses the X-25 packetswitched communication protocol on telephone lines with modems. The corresponding VAX software running at GSI on the VAXstation VSCN only is called PSI, the Packetnet System Interface of DEC. WWW: The WorldWideWeb (WWW or W3) is the universe of network-accessible information, an embodiment of human knowledge.
Index Index A abbreviation command 44 DCL symbol 48 account 9, 18, 135 addressing mail from remote 36 Advisory Service 5 aid for computers and network 5 ALLOCATE command 62, 101 Alpha AXP 57, 135 Alpha AXP or VAX node names 16, 52 APPEND command 59 Apple Macintosh 12, 13, 16, 19 application software for OpenVMS Alpha AXP 125 for OpenVMS VAX 119 applications in DECwindows/Motif 21 ARPA network 40 article in LaTeX 95 ASCII 135 assembler 135 ASSIGN command 51 attention key of IBM terminal 23 AU Australian Un
OpenVMS Introduction - Index command 43, 136 DCL CNEWS 31 format 136 interactive 49 interrupting 49 procedure 83, 136 comment 83 control 86 debug 90 error handling 91 execution 83 global symbol 85 label 83 lexical function 88 local symbol 85 LOGIN.
Index LaTeX 96 LIBCOPY 77 LIBDEL 78 LIBEXTR 78 LIBLIS 77 LIBRARY 76 LIBRARY/CREATE 77 LIBRARY/DELETE 76 LIBRARY/EXTRACT 76 LIBRARY/INSERT 76 LIBRARY/OUT 76 LIBRARY/REPLACE 76, 94 LIBSEARCH 77 LIBTYPE 77 LINK 72 LINK/DEBUG 73 LO 24 LOGOFF 24 LSEDIT 65, 78, 120, 126 LSEDIT/RECOVER 68 MACRO 71 MAIL 33 MATHEMATICA 123, 127 MCPU 51 MDCLANAL 90 MDCLLIST 87 MLOCKS 94 MODULA 71, 121 MONITOR 51 MOUNT 63 NOTES 122 NWDCL 94 ON CONTROL Y THEN 83, 91 ON ERROR THEN 83, 91 ON-THEN 83, 91 OPEN 83, 91 OPS5 71, 121, 127 PASC
OpenVMS Introduction - Index SQL 122, 127 SSEC 94 SSERVICE 15 SSYM 48 SSYS 50 STOP 50 STUDENT 32 SUBMIT 83 SUBROUTINE 83, 86 SYNCHRONIZE 83 TDIR 56 TDOCUMENT 94 TDRAW 120 TYPE 60 VEST 127 WRITE 83, 86, 91 XDVI 94, 96 XWWW 32, 148 DEBUG DEPOSITE 74 EDIT 74 EXAMINE 74 EXIT 74 GO 74 refresh screen 74 scrolling 74 SEARCH 74 SET BREAK 74 SET LANGUAGE 74 SET SYMBOL 74 SPAWN 74 STEP 74 TYPE 74 LSEDIT COMPILE 69 EXIT 67, 69 HELP 67 QUIT 67, 69 READ 67 SHOW 67 SPAWN 69 SPELL 67, 95 152 WRITE 67 MAIL DELETE 39 DIRE
Index CONNECT server command 15, 22 connect to Alpha AXP or VAX 15 connect to IBM 22 CONTINUE command 50 control in DCL 86 control key 4, 49 COPY command 44, 45, 58 CPU 137 CPU time 49 create a document 95 create a library 76 CREATE command 60 CREATE/DIRECTORY command 55 CREPEAT command 93 CREPLACE command 93 cross reference source code analysis 78 Ctrl A 66 C 49 keys 4 DCL command line 99 T 49 W 67, 74 Y 49, 73 Z 47, 49, 50, 73 cursor 137 CVC 143 D data 137 data base development tool RALLY 122 management
OpenVMS Introduction - Index parameter 45 prompt 18 prompting for parameters 47 quali er 45 symbol 48, 84 abbreviate 48 create 48 de ne 48 delete 48 global 48 list 48 local 48 show 48 terminal I/O 86 DEALLOCATE command 63, 101 DEASSIGN command 51 DEBUG 73 keypad layout 75 debugging command procedure 90 program 73 DEBWIN command 73 DEC Digital Equipment Corporation 137 DEC GKS 121, 127 DEC Notes 122 DEC TCP/IP Services for OpenVMS 17, 123, 128 DEC VXT-2000 Xwindow terminal 18, 26 DECdecision spreadsheet tool
Index LSEDIT command 66 mail 39 word left DCL command line 99 LSEDIT command 66 word right LSEDIT command 66 DELETE command 60 DELETE/SYMBOL command 48 delimiter 44, 138 Deutsch DECwindows/Motif 21 device 138 name 55, 138 separation 138 Alpha AXP or VAX 101 IBM 24 DFN network 40 DIFFERENCES command 61 Digital Equipment Corporation DEC 137 Digital UNIX (former OSF/1) 138, 146 DIR command 21, 56, 58 directory 21, 55, 139 extension of les 22 name of les 22 of mails 39 show tree=TDIR 56 version number of les
OpenVMS Introduction - Index F fatal error 133 FDDI 9, 57, 136, 137, 139, 140 GIGAswitch 9, 57, 136, 137, 139, 140 le 139 backup 57 extension 55, 107 handling 58 name 55, 139 wildcard 56 speci cation 55, 139 standard types 107 structure at GSI 57 system 55 type 55, 107, 139 version number 55, 140 File Transfer Protocol FTP 58, 59, 140 nd a string in LSEDIT 66 rst steps under OpenVMS 21 Fn keys 4 FORTRAN compiler 121, 127 FORWARD server command 26, 101 forwarding MAIL 36 FTP File Transfer Protocol 58, 5
Index keypad layout 24 last screen 23 logging o 24 master reset 23 PECAD graphics 23 PERICOM graphics 23 terminal 327x 13 terminal 5080 13 IBM Netview Access Services 24 iconize a window 20 IF-THEN-ELSE-ENDIF commands 83, 86 image executable 72, 141 picture data 98, 116, 141, 145 IMAGE INTERACTIVE command 98, 116, 120 image scanner 98, 116, 141, 145 include in LSEDIT calling sequence 69 module from text library 69 information message 133 InfoServer 30, 119, 125, 136, 141 INITIALIZE command 62 INQUIRE comma
OpenVMS Introduction - Index LaTeXD for German text 95, 120, 126 LAVC 142 leave LSEDIT 69 lexical function in DCL 88 LIBCOPY command 77 LIBDEL command 78 LIBEXTR command 78 LIBLIS command 77 library 76 help 76 object 76 text 77 usage 77 LIBRARY command 76 LIBRARY/REPLACE command 94 LIBSEARCH command 77 LIBTYPE command 77 line editing 99 keypad 101 line number LSEDIT 65 line wrapping 44 LINK /DEBUG 72, 73 command 72 library 72 linker 142 linking 142 LO command 24 local area transport LAT 12, 142 local DCL sy
Index SELECT folder 39 SEND 34 SET FORWARD 36 SET MAIL DIRECTORY 33 maintenance personnel for computers and network 5 manual documentation DECwindows/Motif Bookreader 30, 119, 125, 136, 141 master reset of IBM terminal 23 mathematical system Mathematica 123, 127 MB1 mouse button 20 MCPU command 51 MDCLANAL command 90 MDCLLIST command 87 menu bar of DECwindows/Motif 20 menus of DECwindows/Motif 20 Messtation 143 MLOCKS command 94 MMS module management system 80, 121, 126 modem (telephone) 13 login 17 MODULA
OpenVMS Introduction - Index OPEN command 83, 91 OpenVMS 144, 147 Advisory Service 5 Alpha AXP application software 125 installed software 125 routines 81 VAX application software 119 installed software 119 operating system 144 operator help 5 OPS5 compiler 121, 127 OSF 144 OSF/1 see Digital UNIX 144 overstrike terminal characters 66 DCL command line 99 P P1 to P8 DCL symbols 87 parameter 43, 144 quali er 43, 46 parameter passing in DCL 87 PASCAL compiler 121, 127 password 9, 18, 20, 21, 144 paste edit bl
Index positional 46 positive-negative ones 46 value ones 46 queue 145 R RALLY data base development tool 122 RDB relational data base 122, 127 RDO relational data base operator utility 122, 127 READ command 83, 91 read from terminal in DCL 86 reading mail 38 recall DCL command line 99, 100 RECALL command 99 recover interrupted LSEDIT 68 refresh terminal screen in DEBUG 100 in LSEDIT 67 relational data base RDB 122, 127 remote addressing mail 36 remote mail 40 remote telephone modem 13 login 17 RENAME comm
OpenVMS Introduction - Index NOVERIFY 83 ON 83, 91 PASSWORD 9, 21, 144 PROMPT 18 VERIFY 83 setup a window 20 shift text left/right in LSEDIT 66 SHOW command DEFAULT 56 LOGICAL 52 PROCESS 50 SYMBOL 48 SYSTEM 50 SHOW server command PORT 101 SERVICE 14 SESSIONS 24 shrink a window to an icon 20 SIN command 51 SIN132 command 51 size limit of DCL command 44 size of a window 20 SLOG command 52 SoftPC emulator 124 software Advisory Service 5 SoftWindows emulator 128 SORT command 61 source code 145 analysis SCA 78,
Index telephone modem 13 Telnet (TCP/IP Internet) 12, 13, 17, 23, 123, 128, 146 terminal 12, 13, 18, 146 I/O in DCL 86 multisession 14, 26, 101 server 12, 14, 146 session 26, 100 terminate program 73 TeX previewer for DECwindows/Motif XDVI command 94 text library 77 text terminal 12, 13 THEN command 83, 86 TK50 cassette handling 62 TN3270 23 token in LSEDIT 68 top CPU users 51 Topdraw 120 training courses 32 translate logical name 52 TYPE command 60 type of lename 55 typeahead bu er DCL command line 99 TZ8
OpenVMS Introduction - Index icon 20 manage sessions 20 menu 20 move 20 move to front of screen 20 resize 20 restore from an icon 20 session manager 20 setup 20 shrink to icon 20 size 20 window layout of DECwindows/Motif 20 Wissenschafts-Netz WIN 13, 17, 37, 40, 148 workstation environment 20 WorldWideWeb 32, 148 WRITE command 83, 86, 91 write to terminal in DCL 86 WWW 32, 148 X X-25 PTT network 13, 17, 37, 40, 137, 148 MAIL 35 X-terminal 12, 19, 148 XDVI command 94, 96 Xwindow 32, 138, 148 terminal 12, 1
Contents Contents 1 Preface 1.1 OpenVMS Advisory Service 1.2 Further GOOSY Manuals : 1.3 Intended Audience : : : : : 3 : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 2 Login and Logout 2.1 2.2 2.3 2.
OpenVMS Introduction 4.1.5 Organizing Your Mails 4.1.6 CMAIL Utility : : : : 4.2 Using the Phone Utility : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 5 Command Formats 5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9 5.
8.4 8.5 8.6 8.7 8.8 8.9 8.