next up previous contents
Next: A ALPHABETICAL INDEX OF Up: 12 AUXILARY CATALOGS Previous: 12.1 The IUE Reference

12.2 Observing Program Database

There is a database of the observing programs approved for IUE since launch. Each program was assigned a five character code. With few exceptions, there are separate program IDs for each episode; users have not usually had multi-year observing programs. Roughly, the episode can be considered the year since launch. In the database, each program ID is associated with an episode, the name of the Principle Investigator, the PI's affiliation, and the title of the observing program. The information associated with particular programs, episodes, and/or names can be displayed or written to a file with the routine IUEPROG:

IUEPROG,PID,ep,lname,fname,affil,title,srch=srch,file=file, /silent 

PID Program ID(s) to search for. Up to five characters long. If PID is a variable, it will be set equal to the list of matching program IDs. If it is a null string, it will not be used to constrain the search.
ep Episode(s) to search for. This is an integer. If it is a variable, it will be set equal to the list of matching episodes. If it is equal to a null string, or not given at all, it will not be used to restrict the search.
lname Last name of Principle Investigator. This is not case sensitive. If it is a null string, or not given, it will not be used to restrict the search. If it is a variable, it will be set equal to the list of matching names.
fname First names of Principle Investigators. Strictly an output parameter.
affil Affiliations of Principle Investigators. Strictly an output parameter.
title Titles of proposals. Strictly an output parameter.
srch The database routines expect a ``search string'' to be entered. Normally, IUEPROG creates one using the values of PID, EP, and LNAME. These are the indexed items in this database. Those familiar with the lower-level database routines may enter a search string via the SRCH keyword. If this keyword is used, the values of PID, EP, and LNAME will be ignored as input parameters and will be strictly output parameters. Note that in this way a user can search on non-indexed items (e.g., AFFIL). As noted in the discussion about the Merged Log, searches on non-indexed items are slower. Use DOC_LIBRARY to see more details about using the SRCH keyword with IUEPROG.
file If the user wishes to write the results to a file instead of to the screen, a filename may be entered via the FILE keyword.
silent If the FILE keyword is not set, the output are normally printed on the screen. The user can suppress output to the screen via this keyword.


next up previous contents
Next: A ALPHABETICAL INDEX OF Up: 12 AUXILARY CATALOGS Previous: 12.1 The IUE Reference

2/9/1998