background image
<< Use Datapools | Display Recorded Rows >>
<< Use Datapools | Display Recorded Rows >>

Command ID Prefix

Setting Script Generation Options
6-15
Command ID Prefix
This option specifies an optional prefix for emulation command IDs.
Emulation commands include commands for emulating database clients as well as
commands for performing communication and timing functions. An emulation
command ID
appears in brackets after the command name. It uniquely identifies the
emulation command in TestManager reports.
Emulation command IDs consist of a prefix and a three-digit numeric suffix.
For example, if you specify
task
as the command ID prefix, you might see the
following emulation command name and ID:
sqlnrecv ["task001"] 1355;
Robot automatically increments the numeric suffix by a value of 1 with each
emulation command.
The maximum length of the command ID prefix is seven characters. If you do not
specify a prefix, Robot uses the script name as the prefix (up to seven characters).
You cannot use this option to define multiple command ID prefixes in a recording
session. If you want your script to contain multiple command ID prefixes, use blocks
to define these prefixes.
With TUXEDO commands, any prefix that you define in
Command ID prefix
Command ID prefix
Command ID prefix
Command ID prefix
is
ignored if you specify a predefined TUXEDO emulation command ID prefix. For
more information, see Assigning a Prefix to TUXEDO Command IDs on page 6-31.
Truncating a Command ID Prefix
Robot uses a tilde (~) to indicate that a command ID prefix that exceeds seven
characters has been truncated.
The command ID prefix format is slightly different for truncated prefixes that appear
in single-script sessions and multi-script sessions. For example, if you define a
command ID prefix of
EmulCmdID
, Robot truncates the prefix as follows:
Truncation format for single-script sessions:
sqlexec ["EmulCmd~024"] "select * from table";
sqlnrecv ["EmulCmd~025"] ALL-ROWS;
Truncation format for multi-script sessions:
sqlexec ["EmulCmd~3.024"] "select * from table";
sqlnrecv ["EmulCmd~3.025"] ALL-ROWS;
The 3 after the tilde shows that the command is in the third script in the session.