This subroutine writes a header item.

The [x] part of the name is optional. If used [x] indicates the data type (one of R, D, I, L or C, the default is C) of the item. So for instance if you want an item with type REAL, the subroutine that you should call is HDR_OUTR.

CALL HDR_OUT[x]( PARAM, XNAME, ITEM, COMMEN, VALUE, STATUS )

PARAM = CHARACTER $\ast$ ( $\ast$ ) (Given)

XNAME = CHARACTER $\ast$ ( $\ast$ ) (Given)

ITEM = CHARACTER $\ast$ ( $\ast$ ) (Given)

COMMEN = CHARACTER $\ast$ ( $\ast$ ) (Given)

VALUE = ? (Given)

STATUS = INTEGER (Given and Returned)

• This subroutine will directly access an image if an association has not already been made. If an association has already been made then the image must be opened for write or modification access (by ??x]]IMG_MOD[n][x] or ??IMG_OUT[x], if you also want to process the image data and HDR_MOD otherwise).

• Item names from any source may be hierarchical (i.e. ING.DETHEAD writes the FITS header "ING DETHEAD"; BOUNDS.MAXX the value of the MAXX component of BOUNDS in a non-FITS source). Writing hierarchical records in FITS records is strongly discouraged (as it violates the standard).

• This subroutine may be used to write the value of items in the same source of more than one image dataset at a time by using multiple parameter names. Multiple parameter names are provided as a comma separated list (i.e. ’IN1,IN2,IN3’). Note that the argument VALUE must be declared as a dimension of size at least the number of parameters in the list, if this option is used.