BAIT: putsym command

NAME

putsym - installs symbols into request or FITS files

SYNOPSIS

putsym file=name [stanza=n] xx=yy [zz=qq ... ]

DESCRIPTION

This program inserts the symbols specified in the command line into the desired file which may be either a keyword/value file or a FITS file. If the symbol already exists in the file, it is overwritten. To insert COMMENT lines, use a form like

putsym file=foo.rqs comment='this is a comment'

OPTIONS

stanza=n - inserts the symbol into the n'th stanza of a pseudo-FITS file, which must already exist. Stanzas are numbered starting from 1. This option has no effect on a true FITS file.

BUGS

It can difficult to get exactly the right form of a string value into the header. The following sequence properly reads the value of the OBJECT symbol from file `a.rqs' and inserts it into file `b.rqs':

set a=`picksym file=a.rqs object nostrip`

putsym file=b.rqs object="$a"

If the file does not have an END statement, you get the message `can't open file foo stanza 1'.


SEE ALSO

picksym,