---

int rm_monitor(int antenna, char *name);

• Add an entry to the monitor list for a particular data location on a particular antenna, so that any changes may be detected through rm_read_wait().

• antenna specifies the antenna to monitor, 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 monitor for changes made by the central computer. antenna may also take the special value RM_ANT_ALL to monitor name on all antennas for which reflective memory is present in the crate.

• name specifies the name of the location to be monitored, and should be one of the names defined in the file $COMMON/reflmem/rm_allocation.

• Changes to the monitor list become active only in subsequent calls to rm_read_wait().

• If name is added with antenna RM_ANT_ALL, any entries already in the monitor list for name with individual antennas are removed from the list since they are superseded by the RM_ANT_ALL specifier.

• 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_IN_MONITOR_LIST	The specified name/antenna pair is already in the monitor list