LISTEN_CREATE
(edit this)
  • System usage: #define LISTEN_CREATE 762
  • Application usage: #define APP_LISTEN_CREATE -1762
  • Introduced in: 8.6.0
  • Processed by: XCVR

Description: Create a programmable listener. This is a general-purpose chat channel listener maintained by the XCVR script. This functionality is provided to simplify the creation of hibernating libraries. Whenever a message is received on the indicated channel, a linked message will be generated with the message number specified in the original LISTEN_CREATE call. See 770 RECV_DOMAIN for an example. See also 763 LISTEN_DESTROY, 764 LISTEN_PROBE.

Parameter format: String: the channel number, followed by a space, followed by the link message number to send. For example, "0 2" would cause messages on channel 0 to generate start_task() calls with the number 2. No action is taken if the combination of chat channel and link message number already exists in the transceiver's list of listeners.

Key: none. XCVR listeners cannot filter incoming messages and report everything received on the indicated channel. (Keep in mind that prims cannot hear themselves, and that attachments hear everything directed at the wearer.)