Environment and Internal Variable Arguments

prev next

Arguments of TSSMeasure.internalVarGet()


The following table lists the string-valued internal variables that can be entered as argument sVal of TSSMeasure.internalVarGetString().

Variable Contains
IV_alltext Response text up to the value of Max_nrecv_saved. The same as IV_response.
IV_cmd_id The ID of the most recent emulation command.
IV_column_headers The two-line column header if IV_Column_headers is ON; otherwise, it contains "".
IV_command The text of the most recent emulation command.
IV_error_text The full text of the error from the last emulation command. If IV_error is 0, IV_error_text returns "". For a SQL database or TUXEDO error, the text is provided by the server.
IV_host The host name of the computer on which the script is running.
IV_mcommand The actual (mapped) sequence of characters submitted to the application by the most recent send or msend command. For send commands, IV_mcommand is always equivalent to IV_command.
IV_response Same as IV_alltext.
IV_script The name of the script currently being executed.
IV_source_file The name of the file that was the source for the portion of the script being executed.
IV_user_group The name of the user group (from the suite) of the user running the script.
IV_version The full version string of TestManager (for example, 7.5.0.1045).


The following table lists the integer-valued internal variables that can be entered as argument iVal TSSMeasure.internalVarGetInt().

Variable Contains
IV_cmdcnt A running count of the number of emulation commands the script has executed.
IV_cursor_id The last cursor declared by sqldeclare_cursor or opened by sqlopen_cursor.
IV_error The status of the last emulation command. Most values for IV_error are supplied by the server.
IV_error_type If you are emulating a TUXEDO session and IV_error is nonzero, IV_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 Error 6     Internal Error If you are emulating an IIOP session and IV_error is nonzero, IV_error_type contains one of the following values: 0 (no error) 1 IIOP_EXCEPTION_SYSTEM 2 IIOP_EXCEPTION_USER 3 IIOP_ERROR
IV_fc_ts The "first connect" time stamp for http_request and sock_connect.
IV_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, IV_fr_ts is set to the time the SQL database server responded to the SQL statement.
IV_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.
IV_lc_ts The "last connect" time stamp for http_request and sock_connect.
IV_lineno The line number in IV_source_file of the previously executed emulation command.
IV_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, IV_lr_ts is set to the time the SQL database server responded to the SQL statement.
IV_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.
IV_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.
IV_nusers The total number of virtual testers in the current TestManager session.
IV_ncxmit 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.
IV_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.
IV_statement_id The value assigned as the prepared statement ID, which is returned by sqlprepare and sqlalloc_statement.
IV_total_nrecv The total number of bytes received for all HTTP and socket receive emulation commands issued on a particular connection.
IV_total_rows Set to the number of rows processed by the SQL statements. If the SQL statements do not affect any rows, IV_total_rows is set to 0. If the SQL statements return row results, IV_total_rows is set to 0 by sqlexec, and then incremented by sqlnrecv as the row results are retrieved.
IV_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.
IV_uid The numeric ID of the current virtual tester.


prev next


Rational Test Script Services for Java Rational Software Corporation
Copyright (c) 2003, Rational Software Corporation http://www.rational.com
support@rational.com
info@rational.com