CHAPTER 5: Tutorial: Sample Archive Session In this chapter we will work through a quick sample STARCAT session, from initial login through file retrieval. This example shows how to search for and retrieve public HRS observations of 3C273. In this example, we will actually retrieve data. You can not retrieve data unless you are a registered archive user. 1. Access the STDATU computer: telnet stdatu.stsci.edu Connected to stdatu.stsci.edu. Escape character is `^]`. Username: Type your username Password: Type your password 2. Read the archive news by typing: $ readnews 3. Start STARCAT by typing: $ starcat 4. The banner screen (Figure 5.1) will appear. Press to enter menu mode. Press to bring up the HST Catalog. The top-level menu (Figure 5.2) will appear. If your screen is garbled when you start STARCAT, exit STARCAT and type vt100 before restarting . Figure 5.1: Banner Screen Figure 5.2: Top-Level Menu 5. Press to select a screen and then use the cursor keys to move to GENERAL, and press , this brings up the GENERAL screen (Figure 5.3). Figure 5.3: The GENERAL Screen 6. Now let's define our search criteria. For this example, we will search for publicly-accessible HRS observations of 3C273. Press to begin qualifying: Figure 5.4: Specifying Search Criteria 7. Move to the first field (Target Name) using either the cursor keys or the key. 8. Type the name of the target you want to look for. In this case, "*3c273*." Note the use of wild cards (*) so that the target will be found regardless of any preceding or trailing characters or spaces that might appear in the field. 9. Move to the next field of interest, in this case Instrmnt. Notice that when you move out of a field, the case gets converted to upper case and the equal sign gets added. (You can do this yourself if you wish.) 10. Type the instrument name. In this case "HRS." 11. Move to the next field of interest, in this case release date, since we want to find only public data. 12. Specify that you want to look for data older than today's date. For example, type "<01-Jan-93". 13. Press when you are done specifying criteria. 14. Press to find the first record that matches this set of criteria. In this case, you would see something like Figure 5.5. Figure 5.5: Sample Record Satisfying All Sample Criteria 15. Press to mark the record for retrieval. You can also press to scan for all records matching your search criteria, and then press to mark all of those records. 16. Press to exit and bring up the menu screen. 17. Press to begin retrieving files for the marked record. This will bring up the retrieval screen (Figure 5.6). Figure 5.6: Retrieval Screen 18. These are HRS data sets, so the defaults are acceptable. Press to continue with the retrieval process. This brings up the Dearchiving Screen (Figure 5.7). Figure 5.7: DeArchiving Screen 19. Press to edit the screen. Type your STARCAT Username and Password (the guest account does not allow you to retrieve files). 20. We want to retrieve the files via FTP, so the defaults of Media set to LAN and Format to GEIS are acceptable. This will store the files on disk in a subdirectory of the data directory on STDATU. 21. Press to bring back the menu. 22. Press to continue the retrieval process. This brings up the Request Submission screen (Figure 5.8) from which you can edit the list of files that will be retrieved. Figure 5.8: Request Submission Screen 23. Press to submit the retrieve request. 24. A message will appear on your screen when you get back to the menu telling you that the retrieval was successful; this message gives you a request number. Write down the retrieve request identification string. The list of files in your retrieve request is written to a file in your work- ing directory with the request identification string for a file name and an extension of .req, for example, oort0129.req. You can now either continuing working in STARCAT, or you can exit-you could also exit from the STDATU system altogether and wait for the mail message telling you that the files have been retrieved and are ready for you (the message will go to your home system). 25. Exit STARCAT by pressing several times. 26. Go the directory where your data have been stored, for example: $ data $ cd oort0129 27. Type DIR from the system prompt to see what files are in your direc- tory. For example: $ dir Z0GU0101T.C0H;1 Z0GU0101T.C0D;1 Z0GU0101T.C1H;1 Z0GU0101T.C1D;1 Z0GU0101T.D0H;1 Z0GU0101T.D0D;1 Z0GU0101T.SHH;1 Z0GU0101T.SHD;1 28. Convert the VMS format GEIS files to Unix format GEIS files (this step will not be needed if you are planning to transfer your files to a VMS machine for further analysis). First, make a list of all header files, then create a directory where the converted files will be written, and finally, run the task to convert the files. For example, $ files template: *.*h outfile: myfile.lst $ mkdir converted $ vax2sun input: @myfile.lst output: converted 29. Logout from the STDATU computer. (Type logout). 30. Use FTP to access the STDATU computer: % ftp stdatu.stsci.edu Connected to stdatu.stsci.edu 220 stdatu.stsci.edu FTP server (Version 5.83) ready. Name (stdatu.stsci.edu): Password: . . ftp> cd /stdatu/dmf_stage/oort0129/converted 250 CWD command successful ftp> binary 200 Type set to I. ftp> mget Z0GU0101T* get Z0GU0101T.C0H? y 150 Opening binary mode data connection for Z0GU0101T.C0H 226 Transfer complete . . ftp> bye 221 Goodbye 31. Use STSDAS or other software to analyze the data set. Good luck! 51