message_send

Compose and send a message to software

Format

• -messageNumber -hex -type -toPu -toLevel [-senderLim] [-senderPu] [-senderLevel] [-toLim] [-linkvalue] -nowait
• -messageNumber -hex -type -toPu -toLevel [-senderLim] [-senderPu] [-senderLevel] [-toLim] [-linkvalue] -wait

Function

The command message_send is a signal generator that allows the user to compose an arbitrary message, and send it to any program unit in any LIM. If message_send is invoked without arguments, it will interactively help the user to compose the message. In this case the user is prompted for all information. Before sending the message the corresponding complete command line is printed, to help the user to send the message again non-interactively. Only intended for use by skilled service personnel.

Note: For sending messages to the hardware use the command .

Parameters

• -hex

  A hexadecimal string containing the data to send in the message. The following special codes are allowed:

  • L4 : The current LIM number as an integer (4 bytes)
  • L2 : The current LIM number as a short integer (2 bytes)
  • L1 : The current LIM number as tiny integer/char (1 byte)
  • P4 : The current PU number as an integer (4 bytes)
  • P2 : The current PU number as a short integer (2 bytes)
  • P1 : The current PU number as tiny integer/char (1 byte)

  If the string is enclosed in quotes ("), then space and comma might be inserted anywhere to improve readability.

• -linkvalue

  The link value to use for timegap messages.

• -messageNumber

  The number of the message to be sent.

• -nowait

  Do not wait for a reply message.

• -senderLevel

  The sending thread level in the message header. Possible values are "A", "B", "X", "Y", and "SERVICE". The default value is "Y".

• -senderLim

  The LIM number of the sending LIM in the message header. If the parameter is omitted the default value is the LIM where the command is running.

• -senderPu

  A program unit number or name of the sending PU in the message header. If the parameter is omitted the default value is the virtual PU number of the command.

• -toLevel

  The level to which the message is sent. Possible values are "A", "B", "X", "Y", and "SERVICE".

• -toLim

  The LIM number of the receiver of the message. If the parameter is omitted the default value is the LIM where the command is running.

• -toPu

  The name or number of the program unit that will receive the message.

• -type

  The type of message to send. Possible values are "SW_SW", "HW_SW", "COMBINEDFORWARD_TIMEGAP", "COMBINEDBACKWARD_TIMEGAP", "COMBINEDBACKWARD", and "BROADCAST".

• -wait

  Wait for a reply message, but only as many seconds as specified in the argument. If no argument is given, the timeout is 10 seconds.

Example

• Send a TIMEREQUESTA message to LLSP, and wait for reply.

  message_send -type SW_SW -messageNumber TIMEREQUESTA -toPu LLSP -wait -hex "000000P2L100" -toLevel A