3.5 Saving and restoring inputs

All input and output parameters (“adverbs”) are global throughout AIPS. When an adverb value is specified for, or set by, a task or verb, it remains at that value for any other task or verb that uses an adverb of the same name (until you change it). This global nature of the AIPS adverbs is useful in most cases. It can, however, be inconvenient — especially if you are taken by surprise because you have not reviewed the adverb values before running a task. Before running any task or verb, check your current input adverbs carefully with:

> INP  name  C R

where name is the program name, or

> INPUTS  name  C R

to write the input values to the message file.

> QINP  C R

to resume the previous INP or INPUTS with the page last displayed.

Some tasks have multiple pages of input parameters. QINP allows you to change a parameter on a page, review that page and then go on to the next page without having to view the first pages over again. Some verbs and a few tasks have output adverbs. Unless they are also used on input, they will not appear when you do INP or INPUTS. After running such verbs and tasks, do

> OUTPUTS  name  C R

to view the output values and write them to the message file.

To reset all adverbs for a particular task or verb to their initial values, without changing any other adverbs or procedures, enter

> DEFAULT  name  C R

to reset the values for name.

> DEFAULT  C R

to reset the values for the verb or task named in the TASK adverb.

You can save all adverbs you have specified for AIPS to disk at any time by typing:

> SAVE aaaaa  C R

where aaaaa is any string of up to 12 characters.

> GET aaaaa  C R

will restore these inputs later.

These commands save or restore your entire AIPS “environment”. For this reason, GET must be the only command on the input line; SAVE may appear with other commands, but will be executed before any of the other commands on the line. Thus, the sequence INNAME  ’3C123’  C R INNAME  ’BLLAC’ ; SAVE  BLLAC  C R will save a 3C123 environment, not a BLLAC one. AIPS automatically saves your environment in a disk area called LASTEXIT whenever you use the EXIT, KLEENEX, or RESTART commands. The command GET LASTEXIT is automatically executed whenever you start up the AIPS program again on the same machine. Thus, you retain your own AIPS environment from one use of AIPS to the next. To obtain a null version of the adverb values and of the rest of the AIPS environment, type:

> RESTORE  0  C R

There is also one temporary area for saving your AIPS environment. To save your inputs temporarily, type:

> STORE  1  C R

to save your inputs in area 1, and

> RESTORE  1  C R

to recover the inputs you previously stored in area 1.

When new verbs and adverbs are created at your site, your old SAVE files will not know about them. Beginning with the 15JAN96 release, you may update the old files with the sequence:

> GET aaaaa  C R

to recover the old SAVE area.

> COMPRESS  C R

to get the new basic vocabularies without losing your adverb values and procedures.

> SAVE aaaaa  C R

to save the updated area for later; use the full name of the SAVE area here.

The list of SAVE areas may be reviewed with the verb SGINDEX. A SAVE area may be written as a RUN file (§3.10.2) if you first GET the area and then use SG2RUN.

The input adverb values associated with a task or a verb can be stored by the command:

> TPUT name  C R

where name is the verb, task, or procedure name.

and retrieved by the command:

> TGET name  C R

TPUT and TGET allow you to avoid, to some extent, the global nature of the adverb values in AIPS. This is sometimes advantageous. Whenever a task (or a verb, for that matter) is executed by the verb GO, TPUT runs automatically. TGET will therefore recover the last set of input adverbs used to execute the task, unless you deliberately overwrite them with a TPUT of your own. Note that AIPS will complain if you try to TGET input adverbs for a task for which no TPUT has previously been run (either manually or automatically). You must “put” before you can “get.” TGINDEX will show you what tasks have been TPUT and when. VPUT, VGET, and VGINDEX allow you to save, recover, and list task-specific adverbs from up to 35 completely user-controlled storage areas. All TGET and VGET files have a new format which includes adverb names. Then, when the adverbs to a task or verb change, TGET and VGET will still work. In 31DEC23, the command TUGET will do a TGET but from a different user number. This may be convenient when the user uses multiple user numbers on his/her computer.

PLGET lets you recover the adverbs used to construct a user-selected plot file. As of 31DEC23, these are known by name. Older plot files depend on the list of adverbs having not changed. Check the INPUTS carefully after a PLGET.

You can change between versions of AIPS software once you are inside AIPS by typing

> VERSION version  C R

where version is one of OLD, NEW or TST

Alternatively, you may use this command to access a private version of a program in some other area — see §12.2.2. Note that toggling between different versions of AIPS is possible only when the data formats are the same. Unfortunately, recent versions are not fully compatible with previous versions of AIPS. (The antenna file format changed in 2009, the internal UV format changed in 2015.) Note also, that you are toggling between different versions of tasks, not the verbs within the AIPS program. That version is selected when you start the program (§2.2.3) and can be changed only by exiting and start anew.