Environment and Internal Variable Arguments

prev next

Arguments of InternalVarGet


The following table lists the internal variables that can be entered with the internVar argument.

Variable Contains
alltext Response text up to the value of Max_nrecv_saved. The same as response.
cmd_id The ID of the most recent emulation command.
cmdcnt A running count of the number of emulation commands the script has executed.
col The current column position (1-based) of the cursor (ASCII screen emulation variable).
column_headers The two-line column header if Column_headers is ON; otherwise, empty.
command The text of the most recent emulation command.
cursor_id The last cursor declared by sqldeclare_cursor or opened by sqlopen_cursor.
error The status of the last emulation command. Most values for error are supplied by the server.
error_text The full text of the error from the last emulation command. If error is 0, error_text returns nothing. For a SQL database or TUXEDO error, the text is provided by the server.
error_type If you are emulating a TUXEDO session and error is nonzero, error_type contains one of the following values: 0 (no error) 1 VU/TUX Usage Error 2 TUXEDO System/T Error 3 TUXEDO FML Error 4 TUXEDO FML32 Error 5 Application under test Error 6     Internal Error If you are emulating an IIOP session and error is nonzero, error_type contains one of the following values: 0 (no error) 1 IIOP_EXCEPTION_SYSTEM 2 IIOP_EXCEPTION_USER 3 IIOP_ERROR
fc_ts The "first connect" time stamp for http_request and sock_connect.
fr_ts The time stamp of the first received data of sqlnrecv, http_nrecv, http_recv, http_header_recv, sock_nrecv, or sock_recv. For sqlexec and sqlprepare, fr_ts is set to the time the SQL database server responded to the SQL statement.
fs_ts The time the SQL statement was submitted to the server by sqlexec or sqlprepare, or the time when the first data was submitted to the server by http_request or sock_send.
host The host name of the computer on which the script is running.
lc_ts The "last connect" time stamp for http_request and sock_connect.
lineno The line number in source_file of the previously executed emulation command.
lr_ts The time stamp of the last received data for sqlnrecv, http_nrecv, http_recv, http_header_recv, sock_nrecv, or sock_recv. For sqlexec and sqlprepare, lr_ts is set to the time the SQL database server responded to the SQL statement.
ls_ts The time the SQL statement was submitted to the server by sqlexec or sqlprepare, or the time the last data was submitted to the server by http_request or sock_send.
mcommand The actual (mapped) sequence of characters submitted to the application under test by the most recent send or msend command. For send commands, mcommand is always equivalent to command.
ncnull The number of null characters in an application response examined by the previous receive command in attempting to match this response.
ncols The number of columns in the current screen (ASCII screen emulation variable).
ncrecv The total number of nonnull characters from an application response examined by the previous receive command in attempting to match this response.
ncxmit The total number of characters transmitted to the application by the previous send or msend command.
nkxmit The total number of "keystrokes" transmitted to the application by the previous send or msend command. For send commands, nkxmit is always equivalent to ncxmit.
nrecv The number of rows processed by the last sqlnrecv, or the number of bytes received by the last http_nrecv, http_recv, sock_nrecv, or sock_recv.
nrows The number of rows in the current screen (ASCII screen emulation variable).
nusers The number of total virtual testers in the current TestManager session.
nxmit The total number of characters contained in the SQL statements transmitted to the server in the last sqlexec or sqlprepare command, or the number of bytes transmitted by the last http_request or sock_send.
response Same as row.
row The current row position (1-based) of the cursor (ASCII screen emulation variable).
script The name of the script currently being executed.
source_file The name of the file that was the source for the portion of the script being executed.
statement_id The value assigned as the prepared statement ID, which is returned by sqlprepare and sqlalloc_statement.
total_nrecv The total number of bytes received for all HTTP and socket receive emulation commands issued on a particular connection.
total_rows Set to the number of rows processed by the SQL statements. If the SQL statements do not affect any rows, total_rows is set to 0. If the SQL statements return row results, total_rows is set to 0 by sqlexec, and then incremented by sqlnrecv as the row results are retrieved.
tux_tpurcode TUXEDO user return code, which mirrors the TUXEDO API global variable tpurcode. It can be set only by the tux_tpcall, tux_tpgetrply, tux_tprecv, and tux_tpsend emulation commands.
uid The numeric ID of the current virtual tester.
user_group The name of the user group (from the suite) of the virtual tester running the script.
version The full version string of TestManager (for example, 7.5.0.1045).



prev next


The Command Line Interface to Rational Test Script Services Rational Software Corporation
Copyright (c) 2003, Rational Software Corporation http://www.rational.com
support@rational.com
info@rational.com