Filter
Top Products
165
Dialogic
®
DSI SS7MD Programmer’s Manual Issue 3
8.2 s7_play
Description
The s7_play utility is a console application that reads commands from as ASCII text file then executes the
commands. Each command can specify either:
• a message to be sent to a destination process
• a delay to apply before the next command is executed
Syntax
s7_play –m<module_id> -f<filename>
Command Line Options
The s7_play utility supports the following command line options:
• -m<module_id>
Specifies the unique module ID that is assigned to s7_play for the inter process communication (IPC)
environment. Any message that is sent to this module ID is displayed by the s7_log utility as text on the
host console. The module ID may be entered in decimal or hexadecimal (prefixed by ‘0x’) format. If the
module ID is not specified, the s7_play utility uses a module ID of 0xef. The module ID assigned to the
s7_play utility must have a corresponding LOCAL entry in the host’s system.txt file and must not be in use
by any other process on the host.
• -f<filename>
Specifies the text file that contains the commands to be executed by the s7_play utility.
Example
To run s7_play with module ID 0x3d and accept commands from a file called cmd.txt, the command is:
s7_play –m0x3d –fcmd.txt
Text File Format
Each line in the text file must begin with one of the command specifiers in the following table:
The Delay function (D) takes a single parameter specifying the delay in either milliseconds (-m) or seconds
(-s). Some examples:
D-s0001 * Delay for 1 second
D-m0001 * Delay for 1 millisecond
Note: The delay value may be in the range 0000 to FFFF.
The Send Message function (M) allows the fields of the message to be specified in the following format:
M-I<inst>-t<type>-i<id>-f<src>-d<dst>-r<rsp_req>-e<err_info>-s<status>-p<param>
The meaning of the various options is shown in the following table:
Character Function
M Send a message
D Delay
W Send a message and wait for a response
P Pause and wait for a specified message type to be received
* Ignore (comment line)
Field Identifier Length (in characters) Message Field
I 2 Instance
t 4 type
i 4 id
f 2 src