hw_message_send

Compose and send a message to hardware

Format

• -messageNumber -hex [-senderLim] [-senderPu] [-senderLevel] [-toLim] -equ
• -messageNumber -hex [-senderLim] [-senderPu] [-senderLevel] [-toLim] -multno

Function

hw_message_send is used to compose and send a message to hardware. Only intended for use by skilled service personnel.

Note: You can send a message to the hardware, but you cannot receive a reply, as the reply message goes to the program unit that is the registered owner of the hardware.

If the command is entered without arguments, you will be prompted for the information (and the constructed command line will be echoed before it is executed).

Parameters

• -equ

  Equipment position. The parameter has the format LLLG-Y-Z-I where LLL=LIM number [range: 1-124], G=gateway [range: A to O. If the gateway letter is omitted the default value is used. Default value: A], Y=magazine, Z=position, and I=individual.

  Example:

  • 1A-0-10-3 (single value)
  • 1C-0-10-3...1C-0-10-7 (series)
  • 1A-0-10-9,1B-0-30-6 (multiple values)
  • 1K-0-10-3...1K-0-10-7,1M-0-50-6 (combination)
• -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.

• -messageNumber

  The number of the message to be sent

• -multno

  Multiple number that will receive the SW_HW 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.

• -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.

Example

• Send a BORDID message to 1-0-0-1.

  hw_message_send -toLim 1 -messageNumber BORDID -multno 1 -hex "16"