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]>]] [-i <Userid[/Password][@Host[/Port]>] ] [-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]>] ] [-i <Userid_[/Password [@Host[/Port]>] ] [-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

Note

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'"
```

Page tree

4 Comments

Moritz Jung

Rashmi Gokhale

Rashmi Gokhale

Moritz Jung