int rm_write(int antenna, char *name, void *buf);

• Write data to reflective memory. No notification is sent to the receiving end.

• antenna specifies the antenna which should receive the data, and may be one of RM_ANT_0, RM_ANT_1, RM_ANT_2, ..., or RM_ANT_10. RM_ANT_0 is used on an antenna computer to indicate that the data will be received on the central computer. antenna may also take the special value RM_ANT_ALL to cause data to be written to all antennas for which reflective memory cards are present (see the description of buf).

• name is the name of the location in reflective memory where data should be written. It must be one of the names listed in the file $COMMON/reflmem/rm_allocation.

• buf is a pointer to a buffer holding the data to be written. If antenna is RM_ANT_ALL, buf should be a pointer to an array of size RM_ARRAY_SIZE containing the data to be written to each antenna. The array is indexed by antenna number. For example, if the central crate contains reflective memory for antennas 3 and 7, data may be written to name on those cards by placing the datum for antenna 3 in buf[RM_ANT_3] and the datum for antenna 7 in buf[RM_ANT_7]. Then a single call to rm_write() with antenna set to RM_ANT_ALL will cause data to be written to both antennas. The available antenna numbers are provided in alist by the rm_open() function.

• Returns RM_SUCCESS if successful. On failure, returns a code describing the error:

  RM_NO_INIT	Reflective memory operations have not been initialized
  	with rm_open()
  RM_ANTENNA_INVALID	There is no reflective memory card for the specified antenna
  RM_NAME_INVALID	name is not a valid name from $COMMON/reflmem/rm_allocation
  RM_ALLOC_VERS	There is a mismatch between the allocation table for the local
  	reflective memory card and the remote reflective memory card
  	(for antenna). Reinstall the drivers. (If antenna is RM_ANT_ALL,
  	this error will not be returned even if the allocation table for
  	one of the cards does not match. The write to that card will
  	fail silently.)