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
