© 2008 by the Rector and Visitors of the University of Virginia.

The information contained on the University of Virginia’s Department of Information Technology and Communication (ITC) website is provided as a public service with the understanding that ITC makes no representations or warranties, either expressed or implied, concerning the accuracy, completeness, reliability or suitability of the information, including warrantees of title, non-infringement of copyright or patent rights of others. These pages are expected to represent the University of Virginia community and the State of Virginia in a professional manner in accordance with the University of Virginia’s Computing Policies.

U001A: UVA's Unix Umenu System (UMENU)

U-001A UVA's Unix Menu System (Umenu)

CONTENTS


INTRODUCTION

The Unix Menu System (Umenu) is a menu-driven interface for the users of Information Technology and Communication's (ITC's) RS/6000 computers. It is based on the Virginia PEN menu system and designed with a similar goal in mind - to let the Unix novice use some of Unix's basic programs and utilities with a minimum of effort.

If you have received an account on an RS/6000 computer since August 23, 1993, Umenu will automatically start up after you have logged in. If you received your account before this date, and want to try Umenu, type umenu at the Unix prompt. If you want to have Umenu begin every time you log in, type umenuInstall at the Unix prompt or contact the Help Desk during business hours at 924-3731 or send electronic mail to unix-consult@virginia.edu.

If you do not want to have the Unix Menu System when you log in, from the main menu select 6:

6) System Customization

and then select the option:

9) How to disable Umenu at login

After you select this option, the next time you log in you will get the standard Unix prompt rather than Umenu. (If you wish to re-enable Umenu at login simply invoke Umenu by typing "umenu" at the Unix prompt, select 6 from the main menu, then select option 10, How to enable Umenu at login.)


NAVIGATING UMENU


 General Umenu Keys
 Key              Function
 Up Arrow         move pointer up one selection
 Down Arrow       move pointer down one selection
 Return or Enter  select item
 +                next page
 -                previous page
 p                previous menu
 m                main menu
 x                exit Umenu

The first menu is shown below (after the user moved the selection arrow to 6) System Customization).

              UVa's Unix  Menu System (Umenu)

    1)  Electronic Mail
    2)  Electronic News         (e.g., USENET news)
    3)  UVa Computing News      (ITC News)
    4)  File Management         (view, edit, delete, print, up/download files)
    5)  User Information        (whois)
->  6)  System Customization    (disable Umenu, mail reg, home page)
    7)  Umenu Reference Manual
    8)  Internet Services       (library services, telnet, etc.)
    9)  Go to UNIX              (type exit to return to Umenu)
   10)  On line Information     (hints, short courses, documents, other help)
   11)  Run Ovid                (Medline & Current Contents)
   12)  Cluster Commands        (gather, fmail, file restore)
    x)  Exit Umenu/logout


*********  REMEMBER: Exit Umenu with 'x' before turning your machine off **** 

(h) help          (x) exit
Your choice:

Pressing the Enter or Return key will select the "System Customization" menu, shown below.

                Customization Menu

->  1)  Change your password

    2)  Printer preference
    3)  Editor preference  
    4)  File transfer preferences

    5)  Register for mail
    6)  Mail preferences
    
    7)  Select a newsreader
    
    8)  How to disable Umenu at login
    9)  How to enable Umenu at login
      
   10)  Create your own home page
   11)  Edit your home page
   12)  Use lynx to preview your home page
                                                                     
(h) help          (m) main menu     (p) prev menu     
Your choice:

Press the Return key to choose "Change your password" or type a number and press the Return key to make another selection. Move back to the main menu by typing m. You can get help from any menu by typing h.

Once you enter another program like mail or news, you may find a slightly different-looking screen and an extended set of commands. Umenu attempts to present you with a uniform set of commands within each program, but there will be some differences. A summary of the basic commands will appear later in this document.


ELECTRONIC MAIL

Select option 1 from the main Umenu menu to read your mail. Beginning in August 1996 you can select one of the following mail readers: Pine, Elm or Mush mail. The default mail reader for Umenu is Pine. (For more information regarding mail reader selection, see the System Customization section of this document.)

This document discusses the Pine mail reader. For additional information on the Mush and Elm mail readers see our on-line FAQ's (see the section "How to Get Help").

The Pine Mailer

If Pine is your Umenu mailer, you will see a screen similar to the one below after selecting the Electronic Mail option from Umenu's main menu:
 
 

PINE 3.93   MAIN MENU              Folder: INBOX    5 Messages
 
    ?  HELP                -  Get help using Pine
    C  COMPOSE MESSAGE     -  Compose and send/post a message
    I  FOLDER INDEX        -  View messages in current folder
    L  FOLDER LIST         -  Select a folder OR news group to view
    A  ADDRESS BOOK        -  Update address book
    S  SETUP               -  Configure or update Pine
    Q  QUIT                -  Exit the Pine program

Copyright 1989-1996. PINE is a trademark of the University of Washington. 
? Help                     P PrevCmd                  R RelNotes                
O OTHER CMDS L [ListFldrs] N NextCmd                  K KBLock       

Make your selection by using the arrow keys to move the highlighted area to your selection and pressing the Return key or by typing the character corresponding to your selection. Select help (?) for information on the Pine mailer, select the compose message option (C) to create and send a mail message, select folder index (I) to view the messages in the current folder, select folder list (L) for a list of folders, select address book (A) to list the contents of your address book, select setup (S) to modify your Pine configuration, or select quit (Q) to exit Pine. Also note that there are other commands available from this screen - those commands, and the corresponding character to run the command, are listed at the bottom of the screen.

Select the folder index option (I) to view the messages in your mailbox. A sample Pine mail screen is shown below:

    A 1 Aug  1 Sam Student         (1,083) Course Offering Directory
      2 Aug  1 Tom Terrified       (2,639) Calculus Homework !!!
      3 Aug  2 Harry Howdy         (2,754) Hello !
    D 4 Aug  3 Gary Greek            (810) Homecoming Party
    N 4 Aug  3 Larry Latin         (1,001) Verb Conjugation
    
? Help       M Main Menu P PrevMsg   - PrevPage D Delete    R Reply     
O OTHER CMDS V [ViewMsg] N NextMsg Spc NextPage U Undelete  F Forward 
The "A" to the left of message number 1 indicates that that mailing has been answered. A "N" to the left of a message number indicates that the message is unread ("new"), a "D" indicates that the message has been marked for deletion. To select a message for viewing use the arrow keys to position the highlighted area on the desired message and press the Return key. Other commands available from this screen are listed across the bottom of the Pine screen.

Composing a Mail Message in Pine

You can compose a mail message by choosing option C (Compose Message) from Pine's main menu (type M to return to the main menu). Fill in the To: and Subject: fields and then move the cursor to the Message Text portion of the screen. Type in your mail message (Pine uses the Pico editor - see the Editor section of this document for more information on the Pico editor). When you are ready to send your message type Ctrl-X. You will be asked if you wish to send the message - press y (for yes).

Creating and Changing Folders in Pine

Save a mail message to your Unix account by typing the character "s" at the screen that lists the mail messages or after choosing a mail message for viewing. You will be prompted for the name of the mail folder in which you wish to store the message:

SAVE to folder [saved-messages] :

You can either 1) provide a name for the mail folder, or 2) press the Return key whereby the message is stored in the folder saved-messages. A mail folder is simply a file in the Mail subdirectory of your account. You can change to another mail folder when you are reading mail; the new folder will be treated just like your regular mailbox except that the messages you see will be the ones you have previously saved. You can list your mail folders by selecting L at the main Pine screen or by typing L while in your mailbox.

As an example, suppose you have been saving mail to a folder called urgent over the past few days, and now you would like to look at it again. From the main menu (you return to the main Pine menu by typing M) select the folder list option. You will see a screen similar to:

PINE 3.93   FOLDER LIST        Folder: INBOX  5 Messages   

INBOX     urgent      97-August
To view the mailings in the urgent folder use the arrow keys to position the highlighted area over "urgent" and press the Return key. To return to the Pine main menu type M; type L to return to the screen listing your mail folders.

Printing Mail Messages in Pine

Before you can print a mail message from Pine, you must specify a printer. You can specify a UVa networked printer or an attached or Novell printer.

To specify a UVa networked printer, see the section "Printer Preference" under System Customization in this document.

If you have a printer attached to the microcomputer you are using, or you have access to a Novell networked printer, you can print from Pine to this printer by going to the main Pine menu and choose Setup. Then select Printer as the setup task. Select attached-to-ansi to send mail printed from Pine to a local or Novell printer.

Once your printer is defined either by Umenu or in Pine, to print a selected mail message, type Y (for prYnt) either from the list of headers or when you are reading a message. Type Y (for yes) again to confirm.

Using Pine's Attachment Feature

Pine's attachment feature provides for the transfer of non-text files through e-mail. Examples of non-text files are Word Perfect and Word documents. To attach a non-text file to a Pine mailing you must first transfer the file from your microcomputer to your Unix account. (Use a secure FTP utility - such as SecureFX or Fugu - to transfer a non-text file from your microcomputer to your Unix home directory.)

To attach a non-text file to a Pine mailing, provide the name of the file at the Attchmnt: field. Pine MIME encodes the attachment when the mailing is sent. In order for your attached file to be useful to your recipients, they must have the ability to MIME decode the attachment (PINE and Simeon provide this decoding automatically).

You can use Pine to save a mail attachment to a file in your Unix account. Use Pine to open the mail message - then type V (to view attachment). You are then placed in the Attachment Index. Move the highlighted area to the field indicating the attachment and press S (Save). The mailer suggests a name for the saved file - press Return/Enter to accept the default or type in your selection. Then press E to exit the attachment index and return to the mail message.


ELECTRONIC NEWS

Electronic news or USENET is a system where publicly available messages, news articles and discussions can be "posted" and read. For more on what electronic news is and how it works, see Information Technology and Communication's (ITC) document U-011 entitled "USENET News."

Select option 2 from the main Umenu menu to access electronic news. You can select one of three news readers (Pine, trn or tin) as your Umenu news reader. The default news reader for Umenu is Pine. (For more information regarding news reader selection see the System Customization section of this document.)

This document discusses the Pine news reader. For additional information on the trn and tin news readers, see our on-line FAQ's (see the section "How to Get Help").

Pine

Beginning in August 1997, Pine is the default news reader for Umenu. Pine is both a mailer and a newsreader, so it tends to treat news articles like mail messages. For example, Pine does not automatically delete read news articles (as most news readers do). Additionally, Pine does not "thread" news articles (use the command sequence $ s to sort your articles by subject).

If Pine is your Umenu newsreader, you will see a screen similar to the one below after selecting the Electronic News option from Umenu's main menu:


 
--------------------------------------------------------------------------------
Folder-collection   ** Default for Saves **                     (Local)
--------------------------------------------------------------------------------

INBOX               97-July

--------------------------------------------------------------------------------
News-collection                              (Remote)
--------------------------------------------------------------------------------

news.announce.newusers   uva.announce.downtime    uva.general
uva.rideboard            uva.want-ads


Your subscribed newsgroups will appear in the News Collection portion of the Pine screen. Select a newsgroup for browsing by moving the highlighted area to the newsgroup listing at the bottom of the screen and then press Return.

Once you select a newsgroup to read you will see a screen similar to the one below (NOTE the listing of available commands at the bottom of the Pine screen):


PINE 3.93  FOLDER INDEX  chv.general Msg 1 of 10 NEW   

    1 Oct  1 Rich Perrson         Rolls For Sale              
    2 Oct  1 Kat Lover            Reward for Lost Kitten                  
    3 Oct  9 S. M. Art Shopper    Looking for Cheap Used Furniture 
    4 Oct 10 Phil Tank            Cheap Gas in town ?                      


? Help        M Main Menu   P PrevMsg     - PrevPage   D Delete    R Reply
O OTHER CMDS  V [ViewMsg]   N NextMsg   Spc NextPage   U Undelete  F Forward

At the top of the screen is the name of the group you are reading. Below that is the list of articles available for reading (USENET news articles have a limited lifespan). Select an article for reading by moving the highlighted area to the desired article and pressing the Return key. After you have read the article, it's a good idea to press the "d" key to remove the article (Pine doesn't automatically delete read news articles). Pine then deletes the article and opens the next article for reading. Type "i" to return to the listing of news articles; type "l" ("elle") to return to the listing of subscribed newsgroups.

To compose a new article type c. When asked if you wish to post to the current newsgroup enter y (type n if you have changed your mind and no longer wish to post an article). You are then placed in the Pine composition mode. Fill in the subject of the article then use the arrow keys to move to Message Text portion of the screen. Enter the text of the article. To then post the article type Ctrl-x. You will be asked if you really wish to post; indicate yes (y) or no (n).

To post a follow up to an article type r (either at the listing of news articles or after opening an article for reading). You will be asked if you wish to include the original article in your reply - indicate your choice (y for "yes" or n for "no"). You are then asked if you want your follow-up to appear as a news article only (type f), or be sent to the author as e-mail (type r), or as both (type b). A follow-up will have the same subject as the original article (and should therefore be a response to that article).


EDITORS

Electronic mail, news articles and text files are created using a text editor. The default Umenu editor is Pico. You can select your Umenu editor through the System Customization submenu. A "good" editor should provide all the editing features needed to enter a short message or article, and be easy to learn and use.

Text is entered in the Pico in the normal way that text would be entered in any word processor. Text wraps to the next line after 65 characters are entered; therefore, it is only necessary to press the Return key to begin a new paragraph.

 

Pico

Moving around the Screen in Pico

Most keyboards have arrow keys; you can use these keys to move the cursor in Pico. If your arrow keys do not respond correctly, control characters can be used instead.

           Command                   Effect  
 Up Arrow or Ctrl-p     previous line
 Down Arrow or Ctrl-n   next line
 Left Arrow or Ctrl-b   back a character
 Right Arrow or Ctrl-b  forward a character
 Ctrl-y                 previous page
 Ctrl-v                 next page

Other Pico Commands

The key sequences for additional Pico commands can be found at the bottom of the Pico screen. Here is a listing of some of the more useful commands:

     Command                   Effect  
 Backspace Key  delete character to left of cursor
 Ctrl-w         search
 Ctrl-g         assistance
 Ctrl-k         delete the current line
 Ctrl-x         exit the editor
 Ctrl-L         redraw the screen
 Ctrl-j         justify
 Ctrl-o         save to a file
 Ctrl-r         yank in another file
 Ctrl-t         check spelling
 Ctrl-c         cancel


FILE MANAGEMENT

When you enter the File Management Menu, you will see the following screen.

                File Management Menu

->  1)  File Viewer
    2)  File Editor
    3)  File Remove
    4)  File Copy
    5)  File Zip (compress with gzip)
    6)  File Unzip (uncompress gzipped file)
    7)  File Printer
    8)  Print Queue Viewer/Job Remover
    9)  Upload a file
   10)  Download a file
   11)  Quota Information
   12)  Subdirectory Creation/Deletion

      For Eudora Users on a Macintosh:
   13)  Terminate Popper Process


(h) help          (m) main menu     (p) prev menu     

The first six options allow you to look at, change, remove, copy and zip/unzip (compress/uncompress) the files on your account. For instance, if you choose the "File Viewer" you will see a screen similar to the following:

File Viewer -- please press return to view file or change to a new directory

The current directory is /home/abc3b/

         Type           Size       Date            Name
------------------------------------------------------------------------------
->  1)  GO UP A DIRECTORY
    3)  <file>          941     Apr 4 19:13     Oldmail
    2)  <directory>     512     Jul 23 09:40    Data
    4)  <file>          49      Aug 18 08:23    assignments
    5)  <file>          5816    Jul 21 09:06    dead.letter 
    6)  <file>          0       Aug 18 05:00    examples   
    7)  <file>          155     Jan 27 1992     ftest.f
    8)  <file>          156     Jul 19 12:03    mydoc.doc 

(h) help          (m) main menu     (p) prev menu     (+,-) scroll page

Your choice:

In the middle of the screen is the first part of the listing of the files and directories on your account. The information displayed includes the type (directory or file), the size in bytes (characters), the date the file was last changed, and the name of the file. If you select a directory and press the Return key, you will get a list of the files and subdirectories of that directory. If you select a file, the contents of that file will be displayed. (Note that the File Viewer tool does NOT dislay files names that begin with a ".".)

The "File Editor" option allows to you to create a new file or edit an exiting file. After selecting the File Editor option you are presented with the edit menu:

                Edit Menu

->  1)  Create a new file 
    2)  Edit an existing file

(h) help          (m) main menu     (p) prev menu

If you select option 1 you will be prompted for verification; type y to continue (type quit to go back to the menu). Next you are prompted for the name of the new file. After typing in your name selection you will be placed in the text editor. If you select option 2 from the Edit menu you will see a screen similar to that seen with the "File Viewer" option; select the file you wish to edit.

The "File Remove," "File Copy," "File Zip," "File Unzip," and "File Printer" options act similarly to the "File Viewer" option. However when you select the "File Remove" and "File Zip/Unzip" options you will be prompted for verification before action is taken on the file. The "File Zip" option compresses files with no loss of information. A "zipped" file is no longer a text file and must be "unzipped" before it can be viewed with an editor. Selecting "File Copy" will require you to type the name of the new copy before copying the selected file. When you select a file from the "File Printer" menu, the file will be sent to your default printer (if you have specified one).

The "File Printer" option allows you to select a file for printing. After selecting this option you will be prompted to select printing to a UVa Network printer or your local printer (printer attached to your microcomputer). In order to print to a networked printer, you must have defined a default network printer (see System Customization). After you select a file for printing you will be asked several questions regarding the print output. The first question asks how many panels you would like per page (the default is ttwo); make your selection or simply press Return for the default. Then you are asked if you would like a header, date and border printed on each page; indicate your choice (the default is yes). Finally, you are asked to select either landscape or portrait orientation (with landscape as the default).

The "Print Queue Viewer/Job Remover" option shows the files that have been sent to your default printer. If you own the job, you can choose to remove the job from the print queue.

Options 7 and 8 "Upload a File" and "Download a File" are used to transfer files between your Unix account and your microcomputer. These two options are covered in the sections on "File Transfer."

Use the "Quota Information" option to determine your disk quota and your current disk usage.

Use the "Subdirectory Creation/Deletion" option to create and delete subdirectories.

The last selection allows Eudora users to terminate a hung popper process. This can happen when they have been disconnected without exiting from the mail session.


USER INFORMATION (WHOIS)

When you select "User Information" you will see the following screen.

                     USER INFORMATION

The User Information menu allows you to obtain information about students,
staff, and faculty at UVa.

Type in your search in one of the following forms:

     blimey           All users with last name of 'Blimey'
     blimey, bill     All users named 'Bill Blimey'
     bl, b            Last names starting with 'bl' and first names
                      starting with 'b'
     924-3731         All users with specified phone number
     !blb5k           Official UVa login of 'blb5k'
     %bl              All official UVa logins starting with 'bl'
     help             Get complete information about the UVa user database

-->

At the --> prompt you can type in the name or string you are searching for. For example, if you type in "blue" as your search string, you will get a screen similar to the following:  
 
 
 
 

                               Whois Menu
Once you are pointing to the entry you want to view, press 
or <space>.

->1) Blue, Yellow A. (yab3c) Undergrad  College of Arts and Sciences 
  2) Blue, Orange P. (opb2u) Staff      Information Technology and Communication
  3) Blue, Red G.    (rgb4u) Faculty    College of Architecture

(h) help          (m) main menu     (p) prev menu     
Your choice:

If you want to see the information on Orange P. Blue, move the arrow to that selection and press return. You will then get the screen:

        Name:                    Orange P. Blue
        Mailid/Handle:           opb2u
        Unix Uid:                none
        Classification:          Staff
        Department:              Information Technology and Communication
        Office Phone:            unknown
        Registered E-Mail Addr:  unknown

(h) help          (m) main menu     (p) prev menu     
Your choice:

which may give useful information like phone, messenger mail, and e-mail address.


SYSTEM CUSTOMIZATION

When you select "System Customization" you will see the following screen:


                Customization Menu

->  1)  Change your password

    2)  Printer preference
    3)  Editor preference
    4)  File transfer preferences

    5)  Register for mail
    6)  Mail preferences

    7)  Select a newsreader       

    8)  How to disable Umenu at login
    9)  How to enable Umenu at login

   10)  Create your own home page 
   11)  Edit your home page
   12)  Use lynx to preview your home page

(h) help          (m) main menu     (p) prev menu     
Your choice:

 

Change your Password

The first option on the "Customization Menu" is to change the password of your account. You will be forced to do this when you log on to your account for the first time, but you may change your password with this option whenever you wish.

Printer Preference

This option brings up a menu with a list of some the printers that are publicly available on the network. If you do not want one of the listed printers, you can specify a printer that is either publicly available, or one that you have permission to print to. To determine the names of other publicly available printers, choose option one from the Printer Preference menu. The list of available printers appears near the end of the displayed document. To exit the document type q. Select a printer from the list available on the printer preference menu or type in your choice.

NOTE: This option allows you to select a UVa networked printer; you cannot select a printer directly hooked up to your computer or your specified standard Novell networked printer. If you wish to print to a local printer or a Novell printer you can do so by selecting "File Printer" from the File Management option of Umenu. Alternately, you could transfer the file you want to print to your microcomputer, and then print from the microcomputer. See the section on "File Transfer" for more information.

Editor Preference

This option allows you to change your default editor, which is Pico for Umenu. If you are familiar with another Unix editor, you may want to change your default editor here.

File Transfer Preferences

This option allows you to select a default file transfer protocol when you are using Umenu. You will need to be sure that the protocol on the microcomputer you are using matches this selection. These preferences are only important for those sending files back and forth (called uploading or downloading) between their RS/6000 account and a microcomputer.

Register for Mail

The register for mail option is a very important system customization option. You will want to select this option in order to "register" your e-mail address on your account so that mail sent to your-ID@virginia.edu will be received on your RS/6000 account and your e-mail address will be recorded in the "whois" database so others can find your address.

Mail Preferences

This option brings up a menu to allow you to change a number of options in the Umenu mailer. Selecting it brings up the following menu:

              Mail Customization Menu

      1)  Change the default Mailer

      2)  Automatically Record All Outgoing Message
      3)  Store read messages in folder Oldmail
      4)  Install a clean mail configuration file

      5)  Forward All Mail to Another Address 

      6)  Edit your signature file
      7)  Change your name as it appears on your mail message

      8)  Enable the vacation program
      9)  Disable the vacation program

      10)  Change from Central Mail Service (Simeon) to local Unix mail box

(h) help          (m) main menu     (p) prev menu     
Your choice:

  1. This option allows you to change your default Umenu mailer. The default Umenu mailer is Pine.) The Umenu mailers are: Pine, Elm and Mush (mail).

  2. This option allows you to store copies of all the mail you send in your Mail directory on your account (the mail is saved in folders named using a YY-Month format). The default setting for this option is OFF (copies are not saved).

  3. This option allows you to store your read mail in the mail folder Oldmail when you exit the mail menu. The default setting for this option is OFF (read mail is NOT moved to the folder Oldmail.)

  4. This option installs the default configuration file corresponding to your Umenu mailer.

  5. This option allows you to forward all e-mail going to your RS/6000 account to another electronic mailbox (such as PCMail or the Central Mail Service for Simeon).

  6. This option allows you to create or change the text that appears at the end of all your mail messages and news postings (your signature). By default, this is blank.

  7. This option allows you to change your name as it appears on your mail (and news) messages.

  8. This option enables the vacation program. The vacation program automatically sends your message to the sender of a mail message to notify the sender that you are on vacation (vacation sends one message per sender per week).

  9. This option disables (turns off) the vacation program.

  10. This option changes your Umenu mail configuration so that your Umenu mailer "points" to the mail on your Unix server rather than your mail on the Central Mail Service. It also 1) registers you to receive mail at your Unix server and 2) removes the .forward file from your Unix account.

Select a newsreader

This option allows you to change your default Umenu newsreader. The default Umenu newsreader is Pine.) The three Umenu newsreaders are: Pine, tin and trn.

Disable and Enable Umenu at login

These two options allow you to enable or disable the startup of Umenu when you log in. In either case, you will not notice the change until you log out of and back into your account. If you received your account in August 1993 or later, and you have not excessively changed the startup files on your account, these two options should work with no problem. If your account was created prior to August 1993 and you want to enable Umenu, exit to the Unix prompt and type the command umenuInstall. You will need to log out and back in to verify that Umenu has been installed.

Create your own home page

This selection creates a "bare-bones" home page. It places the home page in the public_html directory of your account (the public_html directory is created if it doesn't exist). A subdirectory named gifs is created within the public_html directory. The permissions for the public_html, gifs and your home directories, as well as your home page, are set to allow World Wide Web access.

Edit your home page

This selection allows you to use your Umenu editor to edit your home page.

Use lynx to preview your home page

The selection runs the lynx browser (text only) to preview your home page.  
 
 
 
 


FILE TRANSFER

Uploading to Your Account from a Microcomputer

Note: This section of the document is related to transfers using older technologies and programs for downloading and uploading files. These options do not work with most software users currently use to connect to Unix machines from the internet. We recommend you look at Fugu, SecureFX and the Home Directory Service instead of these services.

You can transfer a document from your microcomputer to the RS/6000 from the File Management Menu of the Umenu system. You may have already created a document on your microcomputer that you want to mail to someone. If you transfer the file to the RS/6000, you can avoid retyping it. In other cases you may want to compose the message or article using your favorite word processor rather than use an editor on the RS/6000.

If you intend to compose a document with a word processor and later send it as part of an electronic mail message, save it as a text file (sometimes called an "ASCII" file). Most word processed files have hidden commands which tell the microcomputer how to center titles, control spacing, etc. Saving a word processed document as a text file removes these hidden formatting commands. Almost all word processors have an option which allows a file to be saved as a text file.

To transfer files from the File Management Menu, select the option:

5) Upload a file

and then type in the name you want the file to have when it is uploaded to your account.

If you have previously specified a file transfer method in the Customization Menu, the following dialog will appear. (See the section on "File Transfer Preferences" above if you have not previously selected this setting.) A text file is any file which only contains symbols like letters and numbers which are printable characters. Files which contain graphics or other non-text information are called non-text or binary files (NOTE: Non-text files are uuencoded during transfer; they must be uudecoded upon receipt. A simpler alternative for the transfer of non-text is a secure FTP client such as SecureFX or Fugu.). Documents created by most word processors contain hidden formatting commands (and should be considered non-text files) unless they are specifically saved using a "text file" option.

  File Type to Upload
    1)  text
    2)  non-text
   (h) help   (q) quit

  Your Choice:  1

After you specify whether the file to be transferred from your microcomputer disk is a text or non-text file, you will be asked to verify that the transfer method specified in the Customization Menu is correct. If it is correct, press the Return key to select the default choice of "Yes" and continue. For example, if you are dialing in and are using kermit as the transfer protocal:

   Performing text file upload via kermit.  
   Continue (y/n)?  y

The RS/6000 will then indicate that it is ready to begin receiving, and ask you to begin sending.

  Kermit is now receiving.  Please begin sending ...
  0 Sz* @-#Y1~"  z>             

The next step will depend on the microcomputer telecommunications software you are using. If you are using a Macintosh, the "Send File" option may be on the menu bar at the top of the screen. If you are using a telecommunications program for an IBM PC computer, such as "ProComm Plus," a function key on the keyboard (F1, F2, etc) or the PgUp and PgDn keys may be used to initiate the file transfer process at the microcomputer end. You will need to consult the manual for your microcomputer telecommunications program to determine the method employed by your program.

After you have initiated the "Send File" command on your microcomputer (by whatever means is specified for your microcomputer telecommunications software), the file transfer process will begin. Most microcomputer telecommunications programs will provide an on-screen indicator which shows the percentage of the file which has been transferred as the process continues. Once the file has been successfully transferred from your microcomputer to the RS/6000, the following message will appear:

Press the <Return Key> to return to mail or news ..."

Downloading a File from the RS/6000 to a Microcomputer

Once you have specified a file transfer method in the Customization Menu (you only need to do this once), you are ready to save a document to your microcomputer disk. You can save an electronic mail message (using Pine) or a news article to your microcomputer disk by invoking the command S (upper-case S).

Once you have entered the S command at the prompt and pressed the Return key, you will be asked whether you want to save a text or non-text file to disk. If the text of the message can be read on your computer screen, you should specify "text file." (In some cases graphics or formatted word processing files will not be readable on the network, but can be viewed with the appropriate microcomputer software after they are downloaded.) In this example, we will assume that a text file is being downloaded. (NOTE: Non-text files are uuencoded during transfer; they must be uudecoded upon receipt. A simpler alternative for the transfer of non-text is a secure FTP client such as Fugu or SecureFX.).

      File Type to Download
       1)  text
       2)  non-text
      (h) help   (q) quit
      Your Choice:  1

After you specify whether the file to be saved to your microcomputer disk is a text or non-text file, you will be asked to verify that the transfer method specified in the Customization Menu is correct. If it is correct, press the Return key to select the default choice of "Yes" and continue.

    Performing text file download via kermit.  
    Continue (y/n)?  y

You will then be asked to specify a name for the downloaded file when it is transferred to your microcomputer. You can select any name you want, but it should not contain any spaces.

Name to be used on your computer for the downloaded file:trial.txt

After you enter a file name, the network will begin sending the file.

   Kermit is now sending.  Please begin receiving ...
   0 Sz* @-#Y1~"  z>             

The next step will depend on the microcomputer telecommunications software you are using. If you are using a Macintosh, the "Receive File" option may be on the menu bar at the top of the screen. If you are using a telecommunications program for an IBM PC computer, such as "ProComm Plus," a function key on the keyboard (F1, F2, etc) or the PgUp and PgDn keys may be used to initiate the file transfer process at the microcomputer end. You will need to consult the manual for your microcomputer telecommunications program to determine the method employed by your program.

After you have initiated the "Receive File" command on your microcomputer (by whatever means is specified for your microcomputer telecommunications software), the file transfer process will begin. The amount of time required to transfer the file will depend upon the size of the file and the speed of your modem.

Most microcomputer telecommunications programs will provide an on-screen indicator which shows the percentage of the file which has been transferred as the process continues. Once the file has been successfully transferred from the RS6000 to your microcomputer, the following message will appear.

Press the <Return Key> to return to mail or news ...

You can also transfer files down to your microcomputer from your account using the

    6)  Download a file

option from the File Management Menu. After selecting this option, find the file you wish to download and press Return or Enter. You will then get the download selection described above.

Click one of the following links for additional information regarding SecureFX, Fugu, SecureCRT and Secure Telnet.  


INTERNET SERVICES (library services, telnet, etc)

This menu connects you to a variety of local as well as international resources. The commands in this program are slightly different from the ones in Umenu. The standard set of commands are listed at the bottom of the screen.

                      Internet Services

->  1)  Changes to this menu
    2)  Library Card Catalogues
    3)  Connect to another system (slogin)
    4)  Text-only World Wide Web browser (lynx)

(h) help          (m) main menu     (p) prev menu
Your choice:

"Library Card Catalogues" connects you to some of UVa's local electronic library databases along with a number of international ones. "Connect to another system" allows you to "slogin" (make a secure connection) to another computer on the Internet where you have an account. The "Text-only" World Wide Web browser option runs the program "lynx." Lynx allows you to navigate the World Wide Web using a text interface.


GO TO UNIX

Selecting this option sends you directly to a Unix prompt. Your prompt will be:

Type 'exit' to return to menu 
machine:/home/userId $

and you will be able to issue any Unix command or use software, such as SAS, SPSS, Maple, or Mathematica, that is available on our RS/6000s. Type exit to return to Umenu.


HOW TO GET HELP

By selecting 10 on the main menu, "On Line Information?" you will get the following menu describing sources of computing information and assistance.

                  Additional Information

  (For help with Unix software, select item 1;
  then select supported.software to locate a package, then
  software from the Unix menu.)

->  1)  On-line Help and Documents ("hints" command)
    2)  Important Announcements for Users
    3)  ITC Computing Courses
    4)  How To Get Computing Help
    5)  Unix consolidation info (clas and seas)

By selecting "How To Get Computing Help" you will get the following message describing how to contact ITC User Support for computing help.


			   Computer related problems?

ITC (Information Technology, and Communication) offers help with problems
you may be having with your Unix account.  We can be reached by e-mail, 
phone, or in person.

E-mail  -- mail to consult@virginia.edu
           mail comments & suggestions to umenu@virginia.edu

Phone   -- call 924-3731 between 8:00am - 5:00pm on weekdays

Walk In -- come to room 235 in Wilson Hall (next to Rouss Hall 
           and New Cabell Hall) from 8:00am to 5:00pm on weekdays.

Press return to go back to main menu or type "mail"
to mail to consult@virginia.edu.
By typing mail at the prompt you can send a message to consult@virginia.edu. An answer to your question will be mailed back to you by an ITC consultant.  
 


RUN OVID

Selection of this option runs the ovid program. This is provided to supplement the much better access available via the web from the library. (This interface to Ovid was changed in early July, 2000 to reflect changes in the way our access to Ovid is licensed.)

After selecting this option you will see a screen similar to:

The University interface to Ovid has changed.
For assistance contact the Health Sciences Library Reference Desk
at 924-5591 or email hslref@virginia.edu

You will be connected to ovid.com with telnet
You will get prompted as follows:

Please use lower case letters to log in.

ENTER BRS PASSWORD 
MMMMMMMMMXX


ENTER SECURITY PASSWORD 
_:  MMMMMMMMMOO
Loading program....

Select the Ovid application you wish to run:

  1) Ovid            [ Ovid Technologies\' full screen interface ]
  2) Ovid Colleague   [ BRS menu-based interface ]
  3) Ovid Online      [ BRS native interface - "dotdot" mode ]

Choice: 

just press the Enter key for the ENTER BSR PASSWORD and 
ENTER SECURITY PASSWORD prompts
Option 1 most closely resembles the old Ovid access

Hit the Enter key to continue the login

 

Press the enter key as required to reach the menu of choices for ovid version. Option 3 is most like the old Ovid interface.

The Ovid utility allows you to search the Medline, Current Contents, Aidsline, CancerLit, Bioethics, HealthSTAR, Nursing and Allied Health and PsycLIT databases.


CLUSTER COMMANDS

Three options are available for people using Umenu who have accounts on blue.unix (also known as the Unix Cluster) and/or have their home directories on the NetApp server.

NOTE: Some of these options will not work except under those conditions.

Choosing option 12, Cluster Commands, from the top menu shows the following options:


                 Cluster Commands

->  1)  Gather          (lastlogin, tempfiles, friends)
    2)  Fmail           (unsubscribe from mailing lists)
    3)  Snapshot        (retrieve recently deleted files)

Gather

The gather command has several options, each of which retrieves Cluster specific information:


                 Gather

        (Note!  These commands work only on blue.unix!)

->  1)  Lastlogin       (last time you logged in)
    2)  Editsessions    (locates active or abandoned edit sessions)
    3)  Uptime          (runs "uptime" for each node)
    4)  Tempfiles       (locates files in /tmp)
    5)  Friends         (runs "who" on each node)
    6)  Processes       (runs "ps" for all nodes)

Most of these options are variations on standard Unix commands which return information from every node on the Cluster, not just the one you are logged into when you run gather. For example, typing the lastlogin command on faraday.clas gives:


faraday: /home/mst3k $ lastlogin
   mst3k: Last login: Tue Dec 16 15:46:41 1997 on pts/99 from poe.acc.Virginia.EDU

When you choose the "Lastlogin" option from the "Cluster Commands" menu, you will see the following prompt:


Enter the login id(s) you wish to check
or press  to see your last login:

Pressing the Return or Enter key will check for your last logins on each node of the Cluster. You will also be prompted for whether you want to check for your last unsuccessful logins as well, with No being the default:


Include last unsuccessful logins? (y/N):

Output from gather will be similar to:


node1:    mst3k: Last login: Wed Dec 10 19:53:39 1997 on pts/0 from poe.acc.Virginia.EDU
node2:    mst3k: Last login: Thu Dec 11 20:47:34 1997 on pts/0 from poe.acc.Virginia.EDU
node3:    mst3k: Last login: Mon Dec 15 16:17:26 1997 on pts/1 from poe.acc.Virginia.EDU
node4:    mst3k: Last login: Tue Dec  9 14:43:10 1997 on pts/1 from poe.acc.Virginia.EDU
node5:    mst3k: Last login: Tue Dec 16 08:13:17 1997 on pts/1 from poe.acc.Virginia.EDU

For more information about gather, see the Cluster Specific Tools document.

Fmail

Some mailing list systems such as the listserv system require that a user send mail from the account from which he or she originally subscribed. The fmail command allows you to unsubscribe from those type of mailing lists. This utility makes messages appear to originate from the same machine name from which you subscribed.

For example, before the consolidation of faraday.clas, fermi.clas, and darwin.clas into one machine, you may have had an account on fermi. If you subscribed to a mailing list while on fermi, the machine which hosts that list needs an "unsubscribe" email to come from fermi.clas.virginia.edu to honor the request. Since the separate machine fermi.clas does not exist anymore, fmail provides people with a simple way to unsubscribe from those mailing lists.

When you choose the Fmail menu option, you will see the following prompt:

Enter full name of machine where
this message is supposed to be from
(must end with ".virginia.edu"):
Enter the full name of the machine on which you had an account when you subscribed to the mailing list (for example, fermi.clas.virginia.edu). The next To: prompt asks for the e-mail address of the mailing list, and the Subject: prompt asks for a title for your message.

Fmail will next prompt you for how you want to compose the body of the message.

Message body:

    t) Type in message
    e) Edit message with editor
    f) Read message from file

Your Choice:
Selecting "t" will place you in a line editor where you can type your message. Typically the message will be "unsubscribe". When finished, press the Ctrl (Control) key and the d key simultaneously. Fmail then asks if you wish to send the message you just composed. For example, to unsubscribe from the list test-list@virginia.edu, you would send a message to majordomo@virginia.edu with the message:
unsubscribe test-list
end

Selecting "e" from the menu above will place you in the editor you normally use while in Umenu, such as vi, jove, or pico. Simply write your message using this editor, and then exit the editor. Fmail will ask if you wish to send the message you just composed.

Use the "f" option above if you already have a message composed which you can insert into the mail message. At the prompt:

Enter filename:
type in the name of the text file you wish to include as the body of the message. If fmail finds and can read in the file, you will be asked if you wish to send the message.

If using fmail does not successfully unsubscribe you from the desired mailing lists, you can write to unix-consult@virginia.edu for help.

Snapshot

One of the advantages of having your home directory on the NetApp server is the ability to retrieve recently deleted files without having to go to a backup tape. For more information about how the NetApp creates and maintains these "snapshots", see the document Retrieving Deleted Files.

Choosing the "Snapshot" option from the Cluster Commands menu will give the following prompt:


Enter the name of the file you wish to retrieve (or Ctrl-c to quit):

Although you don't need to know the exact name and location of the file you want to retrieve, it will help to reduce the number of returned file names if you can recall as much of the name as possible. You do not need to enter path information. For example, if the file you deleted was:

	/home/mst3k/perl/program.pl

you would only need to enter "program.pl" at the prompt. If you couldn't remember the exact name of the file, but you do remember that it ended with .pl, you could enter ".pl" at the prompt. However, this would retrieve the name of every file in the snapshot directories which contains .pl. That could be a longer list than you want to sort through, so try to be as specific with the file name as you can.

Once you enter a file name, it may take a while to search through the snapshot directories to find any matches. The more files and subdirectories you have in your account, the longer the search takes. Matching file names are returned in a menu format similar to this (assume "procmail-log" was entered at the previous prompt):


    Size (kb)   Date            Name
    ---------   ------------    ----
 1)  75885      Dec 17 13:58    procmail-log
 2)  74985      Dec 17 11:54    procmail-log
 3)  72674      Dec 17 09:46    procmail-log
 4)  72152      Dec 17 05:51    procmail-log
 5)  72152      Dec 17 05:51    procmail-log
 6)  71998      Dec 16 22:59    procmail-log
 7)  71998      Dec 16 22:59    procmail-log
 8)  71752      Dec 16 18:16    procmail-log
 9)  71998      Dec 16 22:59    procmail-log
10)  64012      Dec 15 23:58    procmail-log
11)  50216      Dec 14 17:00    procmail-log
12)  49659      Dec 13 18:26    procmail-log
13)  48568      Dec 12 17:40    procmail-log
14)  43085      Dec 11 22:51    procmail-log
15)  35249      Dec 10 22:19    procmail-log

Enter # of file to retrieve,
<RETURN> for more files, or 'x' to cancel:

If more than 15 matching filenames are returned, then pressing the RETURN or Enter key will present the next set of filenames. When you reach the end of the list, you will cycle back around to the first fifteen. At any point, you can type in the number corresponding to the snapshot of the file you wish to retrieve. The date column tells you the day and time at which the snapshot for that file was taken.

When you decide to retrieve a snapshot of a file, the copied file will have the same base name as the original file plus the current date. For example, if the first snapshot file above was chosen for retrieval:


Enter # of file to retrieve,
<RETURN> for more files, or 'x' to cancel: 1

/home/mst3k/.snapshot/hourly.0/mail/procmail-log
copied to /home/mst3k/mail/procmail-log.11.17

the snapshot file is copied to the same directory as the original and has the current date appended.


EXITING THE UMENU SYSTEM

If Umenu is started automatically when you logged in to your account, selecting the `x' option will exit you from Umenu and log you out of the system. If you have disabled Umenu at login (refer to "System Customization" ), selecting this option will exit you from Umenu and return you to your Unix prompt. Please note you must exit Umenu before turning your machine off.


WE REALLY WANT TO KNOW...
Have you found this publication useful? Are there ways we might improve or supplement it or other ITC publications? Did you find this document in Web or in hard copy? We really want your opinion. Send e-mail to:  newsdesk@virginia.edu