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. |