C Low Level ADAM Message System Commands

The command:

initialises the Adam message system and registers name as the task name and creates the following additional commands:

• adam_path name

  Returns 1 if a path to name exists and 0 if it doesn’t.

• adam_receive

  Receives an Adam message and returns a list who’s elements are:

  command task msg_name path messid msg_status msg_value

  where command is one of:

  actstart paramreq paramrep inform sync syncrep trigger startmsg endmsg getresponse setresponse controlresponse

  If command is paramreq then msg_value is a list who’s elements are:

  parameter_name prompt_string default_value help_text error_message

  Note that if there is no message available adam_receive will wait until a message arrives.

• adam_send task msg_name context msg_value

  Sends a message to a task starting a new transaction. context must be one of:

  get set obey cancel control

  adam_send returns a list who’s elements are the path and messid of the new transaction.

• adam_reply path messid msg_status msg_name msg_value

  Sends a message on the transaction specified by path and messid. Valid values for msg_status are:

  actstart actcomplete paramrep paramreq inform sync syncrep trigger

• adam_getreply timeout path messid

  Waits for an adam message to arrive on the given path and messid and returns a list whose elements are the same as the list returned by adam_receive.