mposter and msend syntax

The following figure shows the syntax for the mposter command. 

mposter syntax

mposter [-h|-?] [-z] [-q] [-v] [-c <ConfigFile>] {-p <Var=Value>} [-l <HomeLocation>] [-n <CellName> | -n <@Host[/Port[#Key]>]] [-v] [-x] [-w MSecAnswerWait][-d] [-e] [-k] [-j <BufDir>] [ - | { <SourceFile> } | -a <Class> [-m <Message>] [-r <Severity>] [-b <SlotSetValue>] | -u <ObjectID> [-b <SlotSetValue>]]

The following figure shows the syntax for the msend command. The syntax for msend is very similar to mposter except that mposter supports the -d option.

msend syntax

msend [-h|-?] [-z] [-q] [-v] [-c <ConfigFile>] {-p <Var Value>}[-l <HomeLocation>] [-n <CellName> | -n  <Host[/Port[#Key]>] ] [-v] [-x] [-w MSecAnswerWait][-d] [-e] [-k] [-j <BufDir>] [ - | { <SourceFile> } | -a <Class> [-m <Message>] [-r <Severity>] [-b <SlotSetValue>] | -u <ObjectID> [-b <SlotSetValue>]]

The following table lists the command-specific options for mposter and msend. For a list of common command options that apply to all CLI commands, see Event management common command options.

mposter and msend options

Option

Description

-

Input from standard input stream

-a Class

Sends an object of class Class

-b SlotSetValue

Adds SlotSetValue settings (format: "slot=value;...")
For example,-b "msg='this is a test';mc_tool=computer;"

-d

(Used with mposter only) Sends as data instead of as event

-e

Specifies to use EIF instead of MCELL format

-j BufDir

Sets the directory to be used for persisting events that are buffered until they are sent

-k

Kills the mposter or msend server instance

-m Message

Sets event message to the specified Message text

-n CellName

Connects to cell CellName, as defined in directory or on specified host and port, with specified key

Note

Allows only one cell

-p Var=Value

Can be used to specify the directory path to the source file by using the following syntax:
-p ServerDirectoryName=Server
The default value is installationDirectory\pw\server\etc\mcell.dir.

-r Severity

Sets the event severity value to the Severity specified
For example:-r WARNING or -r CRITICAL

-u objectID

Specifies to update or modify data or event object specified by objectID rather than creating a new object.
Possible values for objectID are:

  • The event_handle slot value for event objects
  • The data_handle slot value for data objects
  • The mc_ueid slot value for event objects preceded by the @ character
  • The mc_udid slot value for data objects preceded by the @ character

-w MSecAnswerWait

Sets the length of time in milliseconds to wait for message answer; default is 30,000.

-x

Examines timings

To send a special character as part of a text field by using msend or mposter, enclose the character within a set of single quotation marks (' ') framed by a set of double quotation marks(" "). The following code blocks show some examples for the same:

  • To send an escape sequence such as backslash as part of a text field, use the following command:

    msend -n CellName -m "'a\b'"
  • To send a semicolon as part of a text field, use the following command:

    msend -n CellName -m "'a;b'"



Was this page helpful? Yes No Submitting... Thank you

Comments