Saturday, 24 September 2011




Test Script Language (TSL) for QTP or Winrunner

0) add_cust_record_class:-This function associates a function with a custom class.
 arg1 is the custom class with which the function is associated.
 arg2 is the full path of the DLL containing the function.
 arg3 is the name of the custom record function defined in the
     DLL. This custom record function returns the statement
     recorded in the test script.(optional)
 arg4 is the name of the logical name function defined in
 the DLL. (optional)

1) add_record_attr :- registers a custom property.
arg1 The name of the custom property to register.
     This cannot be a standard WinRunner property name.
 arg2 The full path of the DLL in which the query and verify
     functions are defined.
 arg3  The name of the query function included in the DLL.


2)add_record_message:-  his function adds a message to the list of Windows messages.
 arg1 is The number or identifier of the Windows message.

3)ascii:- This function returns the numeric ASCII code of the first character in a string.
 arg1 is the specified string.

4)atan2:-This function returns the arctangent, in radians.
 arg1 / arg2 is the ratio.

5)button_check_info:-This function checks the value of a button property.
 arg1 is the button name.
 arg2 is the property to check.
 arg3 is the property expected value.

6)button_check_state:- This function checks the value of a button property.
 arg1 is the button name.
 arg2 is the expected state: 0(OFF), 1(ON) or 2(DIMMED).

7)button_get_info:-This function returns the value of a button property
 arg1 is the button name
 arg2 is the requested property
 arg3 is the returned value.

8)button_get_state:-This function returns the current state of a check or radio button
 arg1 is the button name
 arg2 is the returned state.

9)button_press:-This function activates the specified push button
 arg1 is the button name.

10)button_set:-This function sets the specified radio or check button to the requested value
 arg1 is the button name
 arg2 is the value.

11)button_wait_info:-This function waits for a specified value of a button property
 arg1 is the button name
 arg2 is the requested property
 arg3 is the expected value
 arg4 is the timeout (in seconds)

12)calendar_activate_date:-This function double-clicks the specified date in a calendar
(not valid for objects of type Date Time or Month Calendar).
 arg1 is the calendar name.
 arg2 is the date to select.

13)calendar_get_selected:-This function retrieves and counts the selected dates
in a calendar. If the object is a Date Time or Month Calendar
control, the function also retrieves the selected time.
 arg1 is the calendar control name.
 arg2 is the selected dates separated by the listview separator
(usually a comma).
 arg3 is the number of dates that are selected.
 arg4 is the selected time (valid only for the Date Time control, in use
mainly in its time format display).

14)calendar_get_status:-This function retrieves the selection status. It is valid for Date Time
controls only.
 arg1 is the calendar name.
 arg2 is selection status.

15)calendar_get_valid_range:-This function retrieves the range of allowed values for a calendar control.
It is valid for Month Calendar or Date Time controls only.
 arg1 is the calendar name.
 arg2 is the type of requested range: date or time values.
 arg3 is the minimum allowed value.
 arg4 is the maximum allowed value.

16)calendar_select_date:-This function selects the specified date in a calendar.
 arg1 is the calendar control name.
 arg2 is the date to select. (for Date Time or Month Calendar controls,
the format is DD-MMM-YYYY)

17)calendar_select_range:-This function selects all dates in a calendar between two specified dates.
It is valid for calendars of type Month Calendar only.
 arg1 is the calendar name.
 arg2 is the first date of the range .
 arg3 is the last date of the range.

18)calendar_select_time:-This function selects the specified time. It is valid for Date Time controls only.
 arg1 is the Date Time control name.
 arg2 is the time to select (HH:MM:SS format).

19)calendar_set_status:-This function sets the selection status. It is valid for Date Time
controls only.
 arg1 is the calendar name.
 arg2 is the requested status.

20)call_chain_get_attr:-This function returns information about a test or function in the
call chain.
 arg1 property name
 arg2 test or function in the call chain. 0 indicates
 the current test/function; 1 indicates the test/function
 that called the current item
 2 indicates two levels above the current item, etc.
 arg3 value of property

21)call_chain_get_depth:-returns the number of items in the call chain.

22)call_ex:-This function calls a QuickTest test.
Arg1 is the full path of the test.
Arg2(optional) indicates whether to run QuickTest minimized.
Arg3(optional) indicates whether to close QuickTest after running the test

23)click:-This function depicts a mouse button click.
 arg1 is the mouse button.
 arg2 is the time.

24)click_on_text:-This function moves the mouse pointer to the location of the specified string and enters mouse button clicks.
 arg1 is the string.
 args 2,3 are x,y of the rectangle's upper-left corner
 args 4,5 are x,y of the rectangle's lower-right corner
 arg6 is the click sequence.

25)compare_text:-This function compares two strings.
The first two args are the compared strings.
The last two args are sets of characters to be treated as identical.

26)cos:-This function returns the cosine of an angel.
 arg1 is the angel expressed in radians.

27)create_browse_file_dialog:-Creates a browse dialog box.
 arg1 is a filter for the files to display in the browse form

28)create_custom_dialog:-Creates a custom dialog box.
 arg1 is the name of the function that will be invoked
 arg2 is the title of the window
 arg3 is the label of the button that invokes the function
 arg4 contains the label(s) of the edit field(s)
 arg5 contains the label(s) of the check box(es)

29)create_input_dialog:-Creates a dialog box with an input edit field.
 arg1 is a message for the user

30)create_list_dialog:-Creates a dialog box with a list of items.
 arg1 is the title of the window
 arg2 is a message for the user
 arg3 is a list of items

31)create_password_dialog:-Creates a password dialog box.
 arg1 is the label of the login field
 arg2 is the label of the password field
 arg3 is the returned contents of the login field
 arg4 is the returned contents of the password field
 arg5 (optional) indicates whether arg4 is encrypted (TRUE) or not(FALSE).

32)db_check:-This function captures and compares data from a database.
Note that the checklist file (arg1) can be created only
during record.
 arg1 - checklist file.
 arg2 - name of file storing the captured data.
 arg3 (optional) - max num of rows to retrieve (default - no limit).
 arg4 (optional) - array of parameters for the SQL statement.
 Notice: The order of the parameters (as in the Watch List) is important!

33)db_connect:-This function creates a new connection session with a database.
 arg1 - the session name (string)
 arg2 - a connection string
 for example "DSN=SQLServer_Source;UID=SA;PWD=abc123"
 arg3 (optional) - The number of seconds to allow before a query or login attempt times out.

34)db_disconnect:-This function disconnects from the database and deletes the session.
 arg1 - the session name (string)

35)db_dj_convert:-This function executes a Data Junction conversion export file (djs).
 arg1 - the export file name (*.djs)
 arg2 - an optional parameter to override the output file name
 arg3 - a boolean optional parameter whether to
 include the headers (the default is TRUE)
 arg4 - an optional parameter to
 limit the records number (-1 is no limit and is the default)

36)db_execute_query:-This function executes an SQL statement.
Note that a db_connect for (arg1) should be called before this function
 arg1 - the session name (string)
 arg2 - an SQL statement
 arg3 - an out parameter to return the records number.

37)db_get_field_value:-This function returns the value of a single item of an executed query.
Note that a db_execute_query for (arg1) should be called before this function
 arg1 - the session name (string)
 arg2 - the row index number (zero based)
 arg3 - the column index number (zero based) or the column name.

38)db_get_headers:-This function returns the fields headers and fields number of an executed query.
Note that a db_execute_query for (arg1) should be called before this function
 arg1 - the session name (string)
 arg2 - an out parameter to return the fields number
 arg3 - an out parameter to return the concatenation
 of the fields headers delimited by TAB.

39)db_get_last_error:-This function returns the last error message of the last ODBC operation.
 arg1 - the session name (string)
 arg2 - an out parameter to return the last error.

40)db_get_row:-This function returns a whole row of an executed query.
Note that a db_execute_query for (arg1) should be called before this function
 arg1 - the session name (string)
 arg2 - the row number (zero based)
 arg3 - an out parameter to return the concatenation
 of the fields values delimited by TAB.

41)db_record_check:-This function checks that the specified record exists in the
 database.Note that the checklist file (arg1) can be created
 only using the Database Record  Verification Wizard.
 arg1 - checklist file.
 arg2 - success criteria.
 arg3 - number of records found.
 arg4 (optional) - The number of seconds to allow before a query or login attempt times out.

42)db_write_records:-This function writes the records of an executed query into a file.
Note that a db_execute_query for (arg1) should be called before this function
 arg1 - the session name (string)
 arg2 - the output file name
 arg3 - a boolean optional parameter whether to
 include the headers (the default is TRUE)
 arg4 - an optional parameter to
 limit the records number (-1 is no limit and is the default).

43)dbl_click:-This function depicts a mouse button double-click.
 arg1 is the mouse button.
 arg2 is the time.

44)ddt_close:-This function closes a data table.
arg1 is the table name.

45)ddt_close_all_tables:-This function closes all open tables in all open tests.

46)ddt_export:-This function saves the table as a new file.
arg1 is the name of the existing table
arg2 is the name of the new file.

47)ddt_get_current_row:-This function retrieves the active row number.
arg1 is the table name.
arg2 is the active row.

48)ddt_get_parameters:-This function returns a list of all parameter in the table.
 Table file - name of data table.
 Params list (out) - list of parameters separated by TAB.
 Params num (out) - number of parameters in list.

49)ddt_get_row_count:-This function retrieves the number of rows in the table.
arg1 is the table name.
arg2 is the number of rows.

50)ddt_is_parameter:-This function checks if a specific parameter exists in the table.
If the parameter exists, it returns E_OK. Otherwise, it returns
E_NOT_PARAMETER.
arg1 is the table name.
arg2 is the parameter name.

51)ddt_next_row:-This function increases the active row number.
arg1 is the table name.

52)ddt_open:-This function opens a data table.
 arg1 is the  table name.
 arg2 is the  mode.

53)ddt_report_row:-This function reports the active row to the test results.
arg1 is the table name.

54)ddt_save:-This function saves the changes made in the table while
running the test.
arg1 is the table name.

55)ddt_set_row:-This function sets the active row number.
arg1 is the table name.
arg2 is the active row.

56)ddt_set_val:-This function inserts a value into a cell in the active row
 and the column entered.
arg1 is the table name.
arg2 is the field.
arg3 is the value to be entered.

57)ddt_set_val_by_row:-This function sets a value for the cell  indicated by its row
and column.
arg1 is the table name.
arg2 is the row number.
arg3 is the field.
arg4 is the value to be entered

58)ddt_show:-This function displays the specified data table.
arg1 is the table name.
arg2 indicates whether the table is displayed or hidden.

59)ddt_sort:-This function sorts the specified data table cells according to up to 3 keys.
arg1 is the data table file name.
arg2 is the row number of the top, left cell.
arg3 is the column number of the top, left cell.
arg4 is is the row number of the bottom, right cell.
arg5 is the column number of the bottom, right cell.
arg6 is the sort method: by row or by column.
arg7 is the primary key setting  (ascending/descending) and number
arg8 (optional) is the second key setting  (ascending/descending) and number.
arg9 (optional) is the third key setting (ascending/descending) and number.

60)ddt_update_from_db:-This function updates the table with data from database.
 arg1 - table name.
 arg2 - query or conversion file (*.sql ,*.djs).
 arg3 (out) - num of rows actually retrieved.
 arg4 (optional) - max num of rows to retrieve (default - no limit).
 arg5 (optional) - The number of seconds to allow before a query or login attempt times out.

61)ddt_val:-This function returns the value of the parameter of the active row.
The function returns empty string in case of error.
arg1 is the table name.
arg2 is the parameter name.

62)ddt_val_by_row:-This function returns the value of the parameter of a specific row.
The function returns empty string in case of error.
arg1 is the table name.
arg2 is the row number.
arg3 is the parameter name.

63)declare_rendezvous:-This function declares a rendezvous.
 arg1 The name of the rendezvous. This must be a string
     constant and not a variable or an expression.
 refer to LoadRunner help.

64)declare_transaction:-This function declares a transaction.
 arg1 The name of the  transaction. This must be a string
     constant and not a variable or an expression.
 refer to LoadRunner help.

65)define_object_exception:-This function defines an exception for an object.
 arg1 is a name for the exception
 arg2 is the handler function name
 arg3 is the window name
 arg4 is the object name
 arg5 is the property name
 arg6 (optional) is the value of the property.

66)define_popup_exception:-This function defines an exception for a window popping up.
 arg1 is a name for the exception
 arg2 is the handler function name
 arg3 is the window name

67)define_tsl_exception:-This function defines an exception for a TSL error.
 arg1 is a name for the exception
 arg2 is the handler function name
 arg3 is the return code of the function

68)delete_record_attr:-This function removes a custom property that was registered
 using add_record_attr.
 arg1 The name of the custom property to remove.
 arg2 The full path of the DLL in which the query and verify
      functions are defined. (optional)
 arg3 The name of the user-defined query function that was
     called by the add_record_attr statement which registered
     the custom property.(optional)
 arg4 The name of the verify function that was called by the
     add_record_attr statement which registered the custom
      property (optional).

69)desktop_capture_bitmap:-Captures the selected area of the screen.
This can be either the entire desktop,
or a specified area on the desktop.
Arg1 - The file name for the captured image.
Arg2 - X coordinate (optional).
Arg3 - Y coordinate (optional).
Arg4 - Rectangle width (optional).
Arg5 - Rectangle height (optional).

70)dos_system:-This function executes a dos system command
  arg1 is the dos system command.

71)edit_check_info:-This function checks the value of an edit property.
 arg1 is the edit name.
 arg2 is the property to check.
 arg3 is the property expected value.

72edit_check_selection:-This function checks that the specified string is selected.
 arg1 is the edit name.
 arg2 is the expected selection.

73)edit_check_text:-This function checks that the content of an edit field.
 arg1 is the edit name.
 arg2 is the expected content.
 arg3 is indicate whether the comparison is case sensitive(TRUE).

74)edit_delete:-This function deletes the specified string from an edit object
 arg1 is the name of the edit object
 arg2 is the starting column
 arg3 is the end column

75)edit_delete_block:-This function deletes a specified text block from an edit object
 arg1 is the name of the edit object
 arg2 is the first row of the block to be deleted
 arg3 is the first column of the block
 arg4 is the end row
 arg5 is the end column

76)edit_get_block:-This function returns a text block in an edit object
 arg1 is the name of the edit object
 arg2 is the start row
 arg3 is the start column
 arg4 is the end row
 arg5 is the end column
 arg6 is the returned text.

77)edit_get_info:-This function returns the value of an edit object property
 arg1 is the edit name
 arg2 is the requested property
 arg3 is the returned value.

78)edit_get_row_length:-This function returns the length of a row in an edit object
 arg1 is the name of the edit object
 arg2 is the row number
 arg3 is the returned length

79)edit_get_rows_count:-This function returns the number of rows in an edit object
 arg1 is the name of the edit object
 arg2 is the returned rows number

80)edit_get_selection:-This function returns the selected (highlighted) string in an edit object
 arg1 is the name of the edit object
 arg2 is the returned string (256 char. max.).

81)edit_get_selection_pos:-This function returns the selected text block's starting and ending row and column
 arg1 is the name of the edit object
 arg2 is the starting row of the selected block
 arg3 is the starting column
 arg4 is the end row
 arg5 is the end column

82)edit_get_text:-This function returns the entire contents of an edit object
 arg1 is the name of the edit object
 arg2 is the returned text.

83)edit_insert:-This function inserts a string in the first row of an edit object
 arg1 is the name of the edit object
 arg2 is the string
 arg3 is the column in which the insertion starts.

84)edit_insert_block:-This function inserts a string in a multi-line edit object
 arg1 is the name of the edit object
 arg2 is the new string
 arg3 is the insertion row
 arg4 is the insertion column

85)edit_replace:-This function replaces a given string in the first row of an edit object
 arg1 is the name of the edit object
 arg2 is the new string
 arg3 is the starting column
 arg4 is the ending column.

86)edit_replace_block:-This function replaces a block of text in an edit object
 arg1 is the name of the edit object
 arg2 is the new text
 arg3 is the starting row
 arg4 is the starting column
 arg5 is the end row
 arg6 is the end column

87)edit_set:-This function replaces the entire contents of an edit object with the specified string
 arg1 is the name of the edit object
 arg2 is the new contents.

88)edit_set_insert_pos:-This function places the cursor at the specified insertion point
 arg1 is the name of the edit object
 arg2 is the insertion row
 arg3 is the insertion column.


89)edit_set_selection:-This function selects text in an edit object
 arg1 is the name of the edit object
 arg2 is the starting row
 arg3 is the starting column
 arg4 is the end row
 arg5 is the end column.

90)edit_wait_info:-This function waits for a specified value of an edit object
 property.
 arg1 is the edit name
 arg2 is the requested property

91)email_send_msg:-This function sends an email to one or more recipients.
Arg1 is the recipients list.
Arg2 is the email subject.
Arg3 is the email message.
Arg4 is the text format the mail uses (optional).

92)end_transaction:-This function marks the end of a transaction for
 performance analysis.
 arg1 is the transaction name
 arg2 is the transaction status

93)error_message:-This function sends an error message to the controller.
 arg1 the message (any string).
 refer to LoadRunner help.

94)eval:-This function evaluates the enclosed TSL statement(s).
 arg1 is the statement(s) string.

95)exception_off:-This function deactivates an exception.
 arg1 is the exception name

96)exception_off_all:-This function deactivates all exceptions.

97)exception_on:-This function activates an exception.
 arg1 is the exception name.

98)exp:-This function calculates the exponential value.
 arg1 is the the natural logarithm base.

99)file_close:-This function closes the specified file opened using the file_open statement.
 arg1 is the name of the file to be closed.

100)file_compare:-This function compares the contents of two files.
 arg1 is the first file name
 arg2 is the second file name
 arg3 saves the files for future viewing (optional).
 arg4 ignores " ","\r","\n", and "\t" characters when comparing files (optional).

101)file_getline:-This function reads the next line from an open file and assigns it to a variable.
 arg1 is the name of an open file.
 arg2 is the name of the variable that stores the line being read.

102)file_open:-This function opens the specified file.
 arg1 is the name of the file to be opened
 arg2 is the open mode:
   FO_MODE_READ   is read only;
   FO_MODE_WRITE  is write only;
   FO_MODE_APPEND is write only to the end of the file.

103)file_printf:-This function prints formatted output to an open file.
 arg1 is the name of an open file.
 arg2 is the format string.
 arg3...arg32 are the expressions, separated by commas, to be formatted and printed.

104)generator_add_category:-This function defines a new function category
  arg1 is the category name

105)generator_add_function:-This function defines a new function in the function table
 arg1 is the function name
 arg2 is the function description
 arg3 is the number of arguments
 args 4,5,6 define the first argument
  Note: Additional arguments must be added manually.

106)generator_add_function_to_category:-This function adds a function to a category
 arg1 is the category name
 arg2 is the function name.

107)generator_add_subcategory:-This function adds a sub-category to a category
 arg1 is the category name
 arg2 is the sub-category name.

108)generator_set_default_function:-This function sets a function as the default for a category
 arg1 is the category name
 arg2 is the default function name.

109)get_class_map:-This function returns the standard class associated with a custom class.
 arg1 is the custom class.
 arg2 is the returned standard class.

110)get_host_name:-This function returns the host machine executing the test.

111)get_master_host_name:-This function returns the host machine running the
 LoadRunner.

112)get_record_attr:-This function returns the properties recorded for a class.
 arg1 is the class.
 arg2 is the returned obligatory property.
 arg3 is the returned optional property.
 arg4 is the returned selector.

113)get_record_method:-This function returns the recording method for a class.
 arg1 is the class.
 arg2 returns the recording method.

114)get_time:-This function returns the current system time
 (seconds elapsed since January 1st, 1970).

115)get_x:-is function returns the x coordinate of the mouse pointer.

116)get_y:-This function returns the y coordinate of the mouse pointer.

117)getenv:-This function returns the value of an environment variable
  arg1 is the variable.

118)getvar:-This function returns the value of a system variable
  arg1 is the variable.

119)GUI_add:-This function adds an object to a buffer
 arg1 is the buffer in which the object will be entered
 arg2 is the name of the window containing the object
 arg3 is the name of the object
 arg4 is the description of the object

120)GUI_buf_get_desc:-This function returns the description of an object
 arg1 is the buffer in which the object exists
 arg2 is the name of the window containing the object
 arg3 is the name of the object
 arg4 is the returned description

121)GUI_buf_get_desc_attr:-This function returns the value of an object property
 arg1 is the buffer in which the object exists
 arg2 is the name of the window
 arg3 is the name of the object
 arg4 is the property
 arg5 is the returned value

122)GUI_buf_get_logical_name:-This function returns the logical name of an object
 arg1 is the buffer in which the object exists
 arg2 is the description of the object
 arg3 is the name of the window containing the object
 arg4 is the returned name

123)GUI_buf_new:-This function creates a new GUI buffer
 arg1 is the buffer name

124)GUI_buf_set_desc_attr:-This function sets the value of an object property
 arg1 is the buffer in which the object exists
 arg2 is the name of the window
 arg3 is the name of the object
 arg4 is the property
 arg5 is the value

125)GUI_close:-This function closes a GUI buffer
 arg1 is the file name.

126)GUI_close_all:-This function closes all the open GUI buffers.

127)GUI_delete:-This function deletes an object from a buffer
 arg1 is the buffer in which the object exists
 arg2 is the name of the window containing the object
 arg3 is the name of the object (if empty, the window will be deleted)

128)GUI_desc_compare:-This function compares two physical descriptions (returns 0 if the same)
 arg1 is the first description
 arg2 is the second description

129)GUI_desc_get_attr:-This function gets the value of a requested property
 arg1 is the description of an object
 arg2 is the property name
 arg3 is the returned value

130)GUI_desc_set_attr:-This function sets the value of an property
 arg1 is the description of an object
 arg2 is the property name
 arg3 is the value

131)GUI_get_name:-This function returns the current GUI being tested
 arg1 is the output name
 arg2 is the output version

132)GUI_get_window:-This function returns the currently active window in the GUI map

133)GUI_list_buf_windows:-This function lists all windows within a buffer
 arg1 is the buffer name
 arg2 is the output array of windows
 arg3 is the output number of windows

134)GUI_list_buffers:-This function lists all open buffers
 arg1 is the output buffers array
 arg2 is the output number of buffers

135)GUI_list_desc_attrs:-This function returns a list of all property values for an object
 arg1 is the object description
 arg2 is the output array of values

136)GUI_list_map_buffers:-This function lists all buffers loaded in the GUI map
 arg1 is the output buffers array
 arg2 is the output number of buffers

137)GUI_list_win_objects:-This function lists all objects within a requested window
 arg1 is the buffer name
 arg2 is the window name
 arg3 is the output array of objects
 arg4 is the output number of objects

138)GUI_load:-This function loads a GUI file
 arg1 is the file name

139)GUI_map_get_desc:-This function returns the description of an object in the GUI map
 arg1 is name of the window containing the object
 arg2 is the name of the object
 arg3 is the returned description
 arg4 is the output buffer containing the description

140)GUI_map_get_logical_name:-This function returns the logical name of an object in the GUI map
 arg1 is the object description
 arg2 is name of the window containing the object
 arg3 is the output object name
 arg4 is the output buffer containing the description

141)GUI_open:-This function opens a GUI file
 arg1 is the file name.

142)GUI_save:-This function saves a GUI buffer
 arg1 is the file name.

143)GUI_save_as:-This function saves a GUI buffer with the given file name
 arg1 is the buffer name
 arg2 is the file name.

144)GUI_set_window:-This function sets the scope for object identification within the GUI map
 arg1 is the window name

145)GUI_unload:-This function unloads a GUI buffer
 arg1 is the file name.

146)GUI_unload_all:-This function unloads all the loaded GUI buffers.


147)gui_ver_add_check:-This function defines a new GUI verification check
 arg1 is the check name
 arg2 is the capture function name
 arg3 is the compare function name
 arg4 (optional) is the display function name
 arg5 (optional) is the check type (1=window/0=object=default)

148)gui_ver_add_check_to_class:-This function adds a GUI verification check to an object class
 arg1 is the class name
 arg2 is the check name

149)gui_ver_add_class:-This function defines a new GUI verification class
 arg1 is the class name
 arg2 (optional) is the user checklist UI function
 arg3 (optional) is the user default checks function

150)gui_ver_set_default_checks:-This function sets the default checks for an object class
 arg1 is the class name
 arg2 is the list of check names

151)index:-This function determines the position of one string within another.
 srg1 is the main string.
 arg2 is the sub-string.


152)int:-This function determines the integer portion of a positive, real number.
 arg1 is the number.

153)invoke_application:-This function invokes an application from within a test script.
 arg1 is the full path of the application.
 arg2 is the command line options.
 arg3 is the working folder.
 arg4 specifies how the application is shown.

154)length:-This function returns the number of characters in a given string.
 arg1 is the string.

155)list_activate_item:-This function activates an item in a specified list object
 arg1 is the list object
 arg2 is the item to be activated.
 arg3 (optional) is the horizontal offset (in pixels) of the click location
relative to the left margin of the item's text.

156)list_check_info:-This function checks the value of a list property.
 arg1 is the list name.
 arg2 is the property to check.
 arg3 is the property expected value.

157)list_check_item:-This function checks the content of an item in a list.
 arg1 is the list name.
 arg2 is the item number.
 arg3 is the expected content of the item.

158)list_check_selected:-This function checks that the specific items are selected.
 arg1 is the list name.
 arg2 is the expected selected items.

159)list_collapse_item:-This function collapses the items in the tree view object
 arg1 is the tree view name
 arg2 is the item to be collapsed
 arg3 is mouse button (optional).

160)list_deselect_item:-This function deselects an item in a specified list object
 arg1 is the list object
 arg2 is the item to be deselected
 arg3 (optional) is a mouse button. In the case of a regular list
(instead of a listview or treeview) or a combo object,
only the LEFT mouse button is allowed.
 arg4 (optional) is the horizontal offset (in pixels) of the click location
relative to the left margin of the item's text. This argument
can be used only if the optional arg3 is defined.

161)list_deselect_range:-This function deselects all items in a list between two specified items
 arg1 is the list name
 arg2 is the first item of the range
 arg3 is the last item of the range.
 arg4 (optional) is a mouse button. In the case of a regular list
(instead of a listview or treeview) or a combo object,
only the LEFT mouse button is allowed.
 arg5 (optional) is the horizontal offset (in pixels) of the click location
relative to the left margin of the item's text. This argument
can be used only if the optional arg4 is defined.

162)list_drag_item:-This function starts a drag&drop operation from a list.
IMPORTANT: this function must be followed in the script by a drop function.
 arg1 is the object
 arg2 is the item name
 arg3 is the mouse button

163)list_drop_on_item:-This function ends a drag&drop operation on a list.
IMPORTANT: this function must be preceded in the script by a drag function.
 arg1 is the object
 arg2 is the item name
 arg3 (optional) horizontal offset from left side
 arg4 (optional) vertical offset from top

164)list_expand_item:-This function expands the items in the tree view object
 arg1 is the tree view name
 arg2 is the item to be expanded
 arg3 is mouse button (optional).

165)list_extend_item:-This function adds an item to those already selected from a list
 arg1 is the list name
 arg2 is the item to be added
 arg3 (optional) is a mouse button. In the case of a regular list
(instead of a listview or treeview) or a combo object,
only the LEFT mouse button is allowed.
 arg4 (optional) is the horizontal offset (in pixels) of the click location
relative to the left margin of the item's text. This argument
can be used only if the optional arg3 is defined.

166)list_extend_multi_items:-This functions selects all items specified in the list of items and adds them to those already selected
 arg1 is the list view name
 arg2 is the list of items to be added
 arg3 (optional) is a mouse button. In the case of a regular list
(instead of a listview or treeview) or a combo object,
only the LEFT mouse button is allowed.
 arg4 (optional) is the horizontal offset (in pixels) of the click location
relative to the left margin of the item's text. This argument
can be used only if the optional arg3 is defined.

167)list_extend_range:-This function selects all items between two specified items and adds them to those already selected
 arg1 is the list name
 arg2 is the first item of the range
 arg3 is the last item of the range.
 arg4 (optional) is a mouse button. In the case of a regular list
(instead of a listview or treeview) or a combo object,
only the LEFT mouse button is allowed.
 arg5 (optional) is the horizontal offset (in pixels) of the click location
relative to the left margin of the item's text. This argument
can be used only if the optional arg4 is defined.

168)list_get_checked_items:-This function returns the value of the items marked as checked
 arg1 is the list view or tree view name
 arg2 is the returned value of the items marked as checked
 arg3 is the number of items marked as checked.

169)list_get_checked_items:-This function returns the value of the items marked as checked
 arg1 is the list view or tree view name
 arg2 is the returned value of the items marked as checked
 arg3 is the number of items marked as checked.

170)list_get_column_header:-This function returns the value of a listview column header
 arg1 is the list name
 arg2 is the column index
 arg3 is the returned column header.

171)list_get_info:-This function returns the value of a list property
 arg1 is the list name
 arg2 is the requested property
 arg3 is the returned value.

172)list_get_item:-This function returns an item according to its numeric position in a list
 arg1 is the list name
 arg2 is a number indicating the item's position
 arg3 is the returned item string.

173)list_get_item_info:-This function gets the state of the specified item
 arg1 is the list name
 arg2 is the item name
 arg3 is the state property to be retrieved.
    Note: The property: CHECKED applies to list view and tree view objects only.
 arg4 is the returned value.

174)list_get_item_num:-This function returns the numeric position in a list of an item
 arg1 is the list name
 arg2 is the item string
 arg3 is the returned item number.

175)list_get_selected:-This function returns the value of the selected item
 arg1 is the list name
 arg2 is the returned selected item
 arg3 is the selected item number.

176)list_get_subitem:-This function returns the value of a listview subitem
 arg1 is the list name
 arg2 is the item
 arg3 is the index of the requested subitem.
 arg4 is the returned subitem value.

177)list_rename_item:-This function activates the edit mode on the list view or tree view object's label
 arg1 is the list view or tree view object's name
 arg2 is the item label to rename.

178)list_select_item:-This function selects an item in a specified list object
 arg1 is the list object
 arg2 is the item to be selected
 arg3 (optional) is a mouse button. In the case of a regular list
(instead of a listview or treeview) or a combo object,
only the LEFT mouse button is allowed.
 arg4 (optional) is the horizontal offset (in pixels) of the click location
relative to the left margin of the item's text. This argument
can be used only if the optional arg3 is defined.

179)list_select_multi_items:-This function selects the specified items in a list view object
 arg1 is the list view name
 arg2 is the list of icons' labels separated by commas (can be configured by the user)
 arg3 (optional) is a mouse button. In the case of a regular list
(instead of a listview or treeview) or a combo object,
only the LEFT mouse button is allowed.
 arg4 (optional) is the horizontal offset (in pixels) of the click location
relative to the left margin of the item's text. This argument
can be used only if the optional arg3 is defined.

180)list_select_range:-This function selects all items in a list between two specified items
 arg1 is the list name
 arg2 is the first item of the range
 arg3 is the last item of the range.
 arg4 (optional) is a mouse button. In the case of a regular list
(instead of a listview or treeview) or a combo object,
only the LEFT mouse button is allowed.
 arg5 (optional) is the horizontal offset (in pixels) of the click location
relative to the left margin of the item's text. This argument
can be used only if the optional arg4 is defined.

181)list_set_item_state:-This function sets the state icon of the specified list view or tree view item to the requested value
 arg1 is the list view name
 arg2 is the item name
 arg3 is the state icon (check-box) value
 arg4 is the mouse button (optional).

182)list_wait_info:-This function waits for a specified value of a list property
 arg1 is the list name
 arg2 is the requested property
 arg3 is the expected value
 arg4 is the timeout (in seconds).

183)load:-This function loads a compiled module into memory.
 arg1 is the module name.
 arg2 indicates a system module(1) or a user module(0).
 arg3 indicates whether the module remains open in the WinRunner window(0) or not(1).

184)load_dll:-This function loads an external dll.
 arg1 is the path name.

185)log:-This function returns the natural base (base @) logarithm.
 arg1 is a positive, non-zero number.

186)lr_whoami:-This function returns information about the user currently
 executing the test.
 arg1 is the output vuser id
 arg2 (optional) is the output sgroup
 arg3 (optional) is the output scenario id

187)match:-This function finds the occurrence of a regular expression in a string.
 arg1 is the string.
 arg2 is the regular expression.

188)menu_get_desc:-This function returns the menu's physical description
 arg1 is the menu name
 arg2 is the obligatory property list
 arg3 is the optional property list
 arg4 is the selector
 arg5 is the returned description.

189)menu_get_info:-This function returns the value of a menu property
 arg1 is the menu name
 arg2 is the requested property
 arg3 is the returned value.

190)menu_get_item:-This function returns the string value of the item at the specified numeric position
 arg1 is the menu name
 arg2 is the numeric position of the item
 arg3 is the returned value.

191)menu_get_item_num:-This function returns the numeric position of an item in a menu
 arg1 is the menu name
 arg2 is the string value of the item
 arg3 is the returned numeric value.

192)menu_select_item:-This function selects an item from a menu
 arg1 is the menu item name which consists of the logical
    menu name and the item, separated by a ';'.

193)menu_wait_info:-This function waits for a specified value of a menu property
 arg1 is the menu name
 arg2 is the requested property
 arg3 is the expected value
 arg4 is the timeout (in seconds).

194)move_locator_abs:-This function moves the screen pointer to new absolute coordinates.
 arg1 is the x coordinate.
 arg2 is the y coordinate.
 arg3 is the time.

195)move_locator_rel:-This function moves the screen pointer to new coordinates relative to the current positions.
 arg1 is the x coordinate.
 arg2 is the y coordinate.
 arg3 is the time.

196)move_locator_text:-This function moves the screen pointer to the specified string.
 arg1 is the string.
 args 2,3 are x,y of the rectangle's upper-left corner.
 args 4,5 are x,y of the rectangle's lower-right corner.
 args 6,7 are the x,y shift coordinates.

197)mtype:-This function depicts mouse button input.
 arg1 is the button input string.

198)nargs:-his function returns the number of arguments actually passed to the function.

199)obj_check_bitmap:-This function captures and compares an object bitmap.
 arg1 is the logical name of the object.
 arg2 is a string that identifies the captured bitmap.
 arg3 indicates the time.

200)obj_check_gui:-This function captures and compares GUI data for an object.
 arg1 is the logical name of the object.
 arg2 is the name of the checklist for the captured GUI data.
 arg3 is the name of the file storing the GUI data.
 arg4 indicates the time.

201)obj_check_info:-This function checks the value of an object property.
 arg1 is the object name.
 arg2 is the property to check.
 arg3 is the property expected value
 arg4 is the timeout (in seconds).

202)obj_check_text:-This function checks the text within an object-relative rectangle.
 arg1 is the object name
 arg2 is the expected text.
 args 3,4 are x,y of the rectangle's upper-left corner (optional)
 args 5,6 are x,y of the rectangle's lower-right corner (optional).

203)obj_click_on_text:-This function moves the mouse pointer to the location of text in
 the specified object and enters mouse button clicks.
 arg1 is the object name
 arg2 is the requested string expression
 args 3,4 are object-relative x,y of the rectangle's upper-left
 corner (optional)
 args 5,6 are object-relative x,y of the rectangle's lower-right
 corner (optional)
 arg7 TRUE - search for any string, FALSE - search only for a
 complete word.(optional)
 arg8 is mouse button (optional)

204)obj_drag:-This function starts a drag&drop operation from an object.
IMPORTANT: this function must be followed in the script by a drop function.
 arg1 is the object
 arg2,arg3 are the screen coordinates
 arg4 is the mouse button

205)obj_drop:-This function ends a drag&drop operation on an object.
IMPORTANT: this function must be preceded in the script by a drag function.
 arg1 is the object
 arg2,arg3 are the screen coordinates

206)obj_exists:-This function returns E_OK if the object currently exists
 arg1 is the object name.

207)obj_find_text:-This function searches for text in an object-relative rectangle
 arg1 is the object name
 arg2 is the requested string expression
 arg3 is the returned array that stores the string location
 args 4,5 are x,y of the rectangle's upper-left corner (optional)
 args 6,7 are x,y of the rectangle's lower-right corner (optional)
 arg8 TRUE - search for any string, FALSE - search only for
 a complete word (optional).

208)obj_get_desc:-This function returns an object's physical description
 arg1 is the object name
 arg2 is the obligatory property list
 arg3 is the optional property list
 arg4 is the selector
 arg5 is the returned description.

209)obj_get_info:-This function returns the value of an object property
 arg1 is the object name
 arg2 is the requested property
 arg3 is the returned value.

210)obj_get_text:-This function reads the text within an object-relative rectangle
 arg1 is the object name
 arg2 is the returned text
 args 3,4 are x,y of the rectangle's upper-left corner (optional)
 args 5,6 are x,y of the rectangle's lower-right corner (optional).

211)obj_highlight:-This function highlights an object
 arg1 is the object name
 arg2 is the number of flashes.

212)obj_mouse_click:-This function performs a mouse click within the specified object
 arg1 is the object name
 arg2 is the x position
 arg3 is the y position
 arg4 is mouse button (optional)

213)obj_mouse_dbl_click:-This function performs a double-click within an object
 arg1 is the object name
 arg2 is the x position
 arg3 is the y position
 arg4 is mouse button (optional)

214)obj_mouse_drag:-This function performs a mouse drag within an object
 arg1 is the object name
 args 2,3 are the starting x,y position
 args 4,5 are the ending x,y position
 arg6 is mouse button (optional).

215)obj_mouse_move:-This function moves the mouse pointer to the designated position within an object
 arg1 is the object name
 arg2 is the x position
 arg3 is the y position

216)obj_move_locator_text:-This function moves the screen pointer to the location of text in
 the specified object.
 arg1 is the object name
 arg2 is the requested string expression
 args 3,4 are object-relative x,y of the rectangle's upper-left
 corner (optional)
 args 5,6 are object-relative x,y of the rectangle's lower-right
 corner(optional)
 arg7 TRUE - search for any string, FALSE - search only for a
 complete word.(optional)

217)obj_type:-This function sends keyboard input to a specific object.
 arg1 is the object name.
 arg2 is the input string.

218)obj_wait_bitmap:-This function waits for a GUI object bitmap to be drawn.
 arg1 is the logical name of the object.
 arg2 is a string that identifies the captured bitmap.
 arg3 indicates the time.

219)obj_wait_info:-This function waits for a specified value of an object property
 arg1 is the object name
 arg2 is the requested property
 arg3 is the expected value
 arg4 is the timeout (in seconds)

220)ora_compare_report:-This function compares the contents of two files.
 arg1 is the first file name
 arg2 is the second file name
 arg3 saves the files for future viewing (optional).
 arg4 ignores " ","\r","\n", and "\t" characters when comparing files (optional).

221)ora_save_report:-This function compares the contents of two files.
 arg1 is the first file name
 arg2 is the second file name
 arg3 saves the files for future viewing (optional).

222)output_message:-This function sends a message to the controller.
 arg1 the message (any string).
 refer to LoadRunner help.

223)password_edit_set:-This function replaces the entire contents of a password-style
 edit object with a string extracted from the specified encrypted string.
 arg1 is the name of the edit object
 arg2 is an encrypted string. WinRunner decodes it and puts

224)password_encrypt:-This function returns an encryption of an input string.
 The returned string can be used as an input parameter
 for the password_edit_set function.

225)pause:-This function pauses test execution and displays the requested variable value or string.
 arg1 is the variable or string.

226)qcdb_add_defect:-This function adds a new defect to the Quality Center defect
database.
 arg1 - Defect summary.
 arg2 - Defect description.
 arg3 - Defect fields. Example "Field1=Value1;Field2=Value2".

227)qcdb_get_step_value:-This function returns the value of a field in the Step table in a
Quality Center database.
arg1 is the field name.
arg2 is the index of the step.
arg3 is the subject path (optional - the default is the current
test).
Note: This function can only be used when WinRunner is connected to a
Quality Center database.

228)qcdb_get_test_value:-This function returns the value of a field in the Test table in a
Quality Center database.
arg1 is the field name.
arg2 is the subject path (optional - the default is the current test).
Note: This function can only be used when WinRunner is connected to a
Quality Center database.

229)qcdb_get_testset_value:-This function returns the value of a field in the Test Set table in a
Quality Center database.
arg1 is the field name.
arg2 is the subject path (optional - the default is the current
test).
arg3 is the name of the test set (optional - the default is the
current test set).
Note: This function can only be used when WinRunner is connected to a
Quality Center database.

230)qcdb_load_attachment:-This function loads a test's file attachment and returns the
file system path of the location where it was loaded.
Arg1 - the attachment's file name.
Arg2 - the test path.

231)rand:-This function generates a pseudo-random floating point number.

232)reload:-This function removes a compiled module from the memory,
and loads it again.
 arg1 is the module name.
 arg2 indicates a system module(1) or a user module(0).
 arg3 indicates whether the module remains open in the WinRunner window(0) or not(1).

233)rendezvous:-This function sets a rendezvous point in the test.
 arg1 is the rendezvous name

234)report_msg:-This function inserts a message in the test results
 arg1 is the message.

235)scroll_check_info:-This function checks the value of a scroll property.
 arg1 is the scroll name.
 arg2 is the property to check.
 arg3 is the property expected value.

236)scroll_check_pos:-This function checks the value of a scroll property.
 arg1 is the scroll name.
 arg2 is the expected position of the scroll.

237)scroll_drag:-This function drags a scroll bar or slider object to the specified position.
 arg1 is the scroll or slider name.
 arg2 is the scroll or slider orientation.
 arg3 is the position.

238)scroll_drag_from_min:-This function drags a scroll bar or slider object a specified distance from the minimum position.
 arg1 is the scrollbar.
 arg2 is the scroll or slider orientation.
 arg3 is the distance from the minimum position

239)scroll_get_info:-This function returns the value of a scroll or slider property.
 arg1 is the scroll or slider name.
 arg2 is the requested property.
 arg3 is the returned value.

240)scroll_get_max:-This function returns the maximum scrollbar or slider position.
 arg1 is the scroll or slider name.
 arg2 is the scroll orientation.
 arg3 is the returned maximum position.

241)scroll_get_min:-This function returns the minimum scrollbar or slider position.
 arg1 is the scroll or slider name.
 arg2 is the scroll or slider orientation.
 arg3 is the returned minimum position.

242)scroll_get_pos:-This function returns the current absolute scrollbar or slider position.
 arg1 is the scroll or slider name.
 arg2 is the scroll or slider orientation.
 arg3 is the returned position value.

243)scroll_get_selected:-This function returns the start and end positions of the slider selection range.
 arg1 is the slider name.
 arg2 is the returned start position of the selected range.
 arg3 is returned end position of the selected range

244)scroll_line:-This function scrolls the specified number of lines in the scroll or slider object.
 arg1 is the scroll or slider name.
 arg2 is the scroll or slider orientation.
 arg3 is the number of lines.

245)scroll_max:-This function sets the scroll bar or slider to the maximum position.
 arg1 is the scroll or slider name.
 arg2 is the scroll or slider orientation.

246)scroll_min:-This function sets the scroll bar or slider to the minimum position.
 arg1 is the scroll or slider name.
 arg2 is the scroll or slider orientation.

247)scroll_page:-This function scrolls the specified number of pages in the scroll or slider object.
 arg1 is the scroll or slider name.
 arg2 is the scroll or slider orientation.
 arg3 is the number of pages.

248)scroll_wait_info:-This function waits for a specified value of a scroll or slider property.
 arg1 is the scroll or slider name.
 arg2 is the requested property .
 arg3 is the expected value.
 arg4 is the timeout (in seconds).

249)set_class_map:-This function associates a custom class with a standard class.
 arg1 is the custom class.
 arg2 is the standard class.

250)set_record_attr:-This function sets the properties  to be recorded for a class.
 arg1 is the class.
 arg2 is the obligatory properties .
 arg3 is the optional properties .
 arg4 is the selector.

251)set_record_method:-This function sets the recording method for a class.
 arg1 is the class.
 arg2 is recording method.

252)set_window:-This function specifies the window that will receive subsequent input
 arg1 is the window name

253)setvar:-This function modifies the value of a system variable
 arg1 is the variable
 arg2 is the new value.

254)sin:-This function returns the sine of an angle.
 arg1 is the angel expressed in radians.

255)spin_get_info:-This function returns the value of a spin property
 arg1 is the spin name
 arg2 is the requested property
 arg3 is the returned value.

256)spin_get_pos:-This function returns the current position in the spin object
 arg1 is the spin name
 arg2 is the returned position.

257)spin_get_range:-This function returns the minimum and maximum positions in the spin object
 arg1 is the spin name
 arg2 is the minimum position
 arg3 is the maximum position.

258)spin_max:-This function sets the spin object to its maximum position
 arg1 is the spin name.

259)spin_min:-This function sets the spin object to its minimum position
 arg1 is the spin name.

260)spin_next:-This function sets the spin object to the next position
 arg1 is the spin name.

267)spin_prev:-This function sets the spin object to the previous position
 arg1 is the spin name.

268)spin_set:-This function sets the position of a spin object to the provided value
 arg1 is the spin name
 arg2 is the new position.

269)spin_wait_info:-This function waits for a specified value of a spin property
 arg1 is the spin name
 arg2 is the requested property
 arg3 is the expected value
 arg4 is the timeout (in seconds).

270)split:-This function divides an input string into fields and stores them in an array.
 arg1 is the string.
 arg2 is the array.
 arg3 is a string of field separators.

271)sqrt:-This function returns the square root.
 arg1 is a positive number.

278)srand:-This function defines the seed parameter for the rand function.
 arg1 is the seed parameter.

279)start_transaction:-This function marks the beginning of a transaction for
 performance analysis.
 arg1 is the transaction name

280)static_check_info:-This function checks the value of a static property.
 arg1 is the static name.
 arg2 is the property to check.
 arg3 is the property expected value.

281)static_check_text:-This function checks the content of a static field.
 arg1 is the static name.
 arg2 is the expected content.

282)static_get_info:-This function returns the value of a static property
 arg1 is the static name
 arg2 is the requested property
 arg3 is the returned value.

283)static_get_text:-This function returns the entire contents of a static text object
 arg1 is the name of the static text object
 arg2 is the returned text.

284)static_wait_info:-This function waits for a specified value of a static text property
 arg1 is the static name
 arg2 is the requested property
 arg3 is the expected value
 arg4 is the timeout (in seconds).

285)statusbar_get_field_num:-This function returns the numeric position of a field in a statusbar.
 arg1 is the statusbar name.
 arg2 is the field text - possibly a regular expression.
 arg3 is the returned field number.

286)statusbar_get_info:-This function returns the value of a statusbar property.
 arg1 is the statusbar name.
 arg2 is the requested property.
 arg3 is the returned value.

287)statusbar_get_text:-This function returns the content of a field according to its numeric position in a statusbar.
 arg1 is the statusbar name.
 arg2 is a number indicating the field's position.
 arg3 is the returned field content string.

288)statusbar_wait_info:-This function waits for a specified value of a statusbar property.
 arg1 is the statusbar name.
 arg2 is the requested property .
 arg3 is the expected value.
 arg4 is the timeout (in seconds).

289)str_map_logical_to_visual:-This function converts a logical string to a visual string
or vice-versa.
When using Windows with Hebrew support,get_text
sometimes returns a logical string.
Use str_map_logical_to_visual to convert the string
to visual format.
    arg1 is the logical string
    arg2 is the returned visual string.

290)substr:-This function retrieves a substring from a given string.
 arg1 is the string.
 arg2 is the position.
 arg3 is the length.

291)system:-This function executes an operating system command
  arg1 is the system command.

292)tab_get_info:-This function returns the value of a tab property
 arg1 is the tab name
 arg2 is the requested property
 arg3 is the returned value.

293)tab_get_item:-This function returns an item according to its numeric position in a tab
 arg1 is the tab name
 arg2 is a number indicating the item's position
 arg3 is the returned item string.

294)tab_get_selected:-This function returns the value of the selected item
 arg1 is the tab name
 arg2 is the returned selected item
 arg3 is the selected item number.

295)This function returns the value of the selected item
 arg1 is the tab name
 arg2 is the returned selected item
 arg3 is the selected item number.

296)tab_select_item:-This function selects an item in a specified tab object
 arg1 is the tab object
 arg2 is the item to be selected.

297)tab_wait_info:-This function waits for a specified value of a tab property
 arg1 is the tab name
 arg2 is the requested property
 arg3 is the expected value
 arg4 is the timeout (in seconds).

298)tbl_activate_cell:-This function double clicks the mouse on the given cell (row/column)..
 arg1 is the table name
 arg2 is the location of the row within the table specified by a string preceded by the # char or (for WinRunner with PowerBuilder support) the contents of one or more cells in the row
 arg3 is the location of the column within the table, specified by a string preceded by the # char or string with the column name.

299)tbl_get_cell_data:-This function gets the contents of the given cell (row/column)..
 arg1 is the table name
 arg2 is the location of the row within the table specified by a string preceded by the # char or (only for WinRunner with PowerBuilder, Java or WebTest support) the contents of one or more cells in the row
 arg3 is the column name or location of the column within the table specified by a string preceded by the # char
 arg4 is the output variable that stores the string found in the specified cell.

300)tbl_get_cols_count:-This function gets the number of columns in the table
 arg1 is the table name
 arg2 is the output variable that stores the total number of columns in the table.

301)tbl_get_column_name:-This function retrieves the column header name of the specified column in a table
 arg1 is the table name
 arg2 is the numeric index of the column within the table specified by an integer
 arg3 is the parameter into which the retrieved name is stored.

302)tbl_get_rows_count:-This function gets the number of rows in the table
 arg1 is the table name
 arg2 is the output variable that stores the total number of rows in the table.

303)tbl_get_selected_row:-This function gets the current selected row
 arg1 is the table name
 arg2 is the currently selected row.

304)tbl_select_col_header:-This function selects the specified column header of a table.
 arg1 is the table name
 arg2 is the column name or the location of the column within the table specified by a string preceded by the # char.

305)tbl_set_cell_data:-this function sets the given value to the given cell (row/column)..
 arg1 is the table name
 arg2 is the location of the row within the table specified by a string preceded by the # char or (for WinRunner with PowerBuilder, Java or WebTest support) the contents of one or more cells in the row
 arg3 is the location of the column within the table, specified by a string preceded by the # char
 arg4 is a string denoting the contents to be entered into the specified cell.

306)tbl_set_selected_cell:-This function sets the focus to the given cell (row/column)..
 arg1 is the table name
 arg2 is the location of the row within the table, specified by a string preceded by the # char or (for WinRunner with PowerBuilder and Java support) the contents of one or more cells in the row
 arg3 is the column name or the location of the column within the table specified by a string preceded by the # char.

307)tbl_set_selected_row:-This function selects the specified row in a table
 arg1 is the table name
 arg2 is the location of the row within the table or (for WinRunner with PowerBuilder support) the contents of one or more cells in a row.

308)time_str:-This function converts an integer to a time string.
 arg1 is the integer number.

309)tl_step:-This function divides test scripts into sections and inserts
a status message in the test results.
When WinRunner is connected to a Quality Center project,
the message is inserted to the Quality Center steps table
as well.
 arg1 is the name of the test step.
 arg2 sets whether the step passed(PASS) or failed(FAIL).
 arg3 is a short explanation of the step.

310)tl_step_once:-This function divides test scripts into sections and inserts
a status message in the test results.
When WinRunner is connected to a Quality Center project,
the message is inserted to the Quality Center steps table
once per step name.
 arg1 is the name of the test step.
 arg2 sets whether the step passed(PASS) or failed(FAIL).
 arg3 is a short explanation of the step.

311)tolower:-This function converts all uppercase characters in the string to lowercase.
 arg1 is the string.

312)toolbar_button_press:-This function presses a specified button in a toolbar
 arg1 is the toolbar object
 arg2 is the button to be pressed.
 arg3 (optional) is the mouse button pressed.

314)toolbar_get_button:-This function returns a button according to its numeric position in a toolbar
 arg1 is the toolbar name
 arg2 is a number indicating the button's position
 arg3 is the returned button string.

315)toolbar_get_button_info:-This function checks the state of a specified button in a toolbar
 arg1 is the toolbar name
 arg2 is the name of the button
 arg3 is the button state to be checked
 arg4 is the return value of the checked button.

316)toolbar_get_button_num:-This function returns the numeric position of a button in a toolbar
 arg1 is the toolbar name
 arg2 is the button string
 arg3 is the returned button number.

317)toolbar_get_buttons_count:-This function returns the number of buttons in a toolbar
 arg1 is the toolbar name
 arg2 is the returned number.

318)toolbar_select_item:-This function selects an item from a toolbar that looks like a menu
(as in Microsoft IE4 or the Start menu in Windows98).
 arg1 is the toolbar name.
 arg2 is the path of toolbar items separated by semi-colons.
 arg3 (optional) is the mouse button pressed when selecting the last item in arg2.

319)toupper:-This function converts all lowercase characters in the string to uppercase.
 arg1 is the string.

320)type:-This function sends keyboard input to the AUT
 arg1 is the input string.

321)unload:-This function removes a compiled module or selected function from memory.
 arg1 is the module/test name.
 arg2 is the function name.

322)unload_dll:-This function unloads an external dll.
arg1 is the path name.

323)unset_class_map:-This function unbinds a custom class associated with a standard class.
 arg1 is the custom class.

324)user_data_point:-This function allows you to record your own data for
performance analysis.
 arg1 is a string indicating the name of the sample type
 arg2 is the value to be recorded.

325)vb_get_label_names:-This function retrieves the names of all label controls in the given form window
 arg1 is the logical name of the Visual Basic form
 arg2 is the out parameter containing the name of the storage array
 arg3 is the out parameter containing the number of elements in the array.

326)wait:-This function causes the interpreter to pause for a specified amount of time.
 arg1 is the time.

327)win_activate:-This function activates a window
 arg1 is the window

328)win_capture_bitmap:-Captures the selected area of the screen.
This can be either the window in focus, a specific window
or a specific area in a window.
Arg1 - The file name for the captured image.
Arg2 - The name of the window to capture (optional).
Arg3 - X coordinate (optional).
Arg4 - Y coordinate (optional).
Arg5 - Rectangle width (optional).
Arg6 - Rectangle height (optional).

329)win_check_bitmap:-This function captures and compares a window bitmap.
 arg1 is the logical name of the window.
 arg2 is a string that identifies the captured bitmap.
 arg3 indicates the time.
 args 4,5 are the coordinates or the upper left corner.
 arg6 is the width of the bitmap.
 arg7 is the height of the bitmap.

330)win_check_gui:-This function captures and compares GUI data for an object.
 arg1 is the logical name of the window.
 arg2 is the name of the checklist for the captured GUI data.
 arg3 is the name of the file storing the GUI data.
 arg4 indicates the time.

331)win_check_info:-This function checks the value of a window property.
 arg1 is the window name.
 arg2 is the property to check.
 arg3 is the property expected value
 arg4 is the timeout (in seconds).

332)win_check_text:-This function checks the text within a window-relative rectangle.
 arg1 is the window name
 arg2 is the expected text.
 args 3,4 are x,y of the rectangle's upper-left corner (optional)
 args 5,6 are x,y of the rectangle's lower-right corner (optional).

333)win_click_help:-This function clicks on the help button in a window title bar.
 arg1 is the window

334)win_click_on_text:-This function moves the mouse pointer to the location of text in
 the specified window and enters mouse button clicks.
 arg1 is the window name
 arg2 is the requested string expression
 args 3,4 are window-relative x,y of the rectangle's upper-left
 corner (optional)
 args 5,6 are window-relative x,y of the rectangle's lower-right
 corner (optional)
 arg7 TRUE - search for any string, FALSE - search only for a
 complete word.(optional)
 arg8 is mouse button (optional)

335)win_close:-This function closes a window
 arg1 is the window

336)win_drag:-This function starts a drag&drop operation from a window.
IMPORTANT: this function must be followed in the script by a drop function.
 arg1 is the object
 arg2,arg3 are the screen coordinates
 arg4 is the mouse button

337)win_drop:-This function ends a drag&drop operation on a window.
IMPORTANT: this function must be preceded in the script by a drag function.
 arg1 is the object
 arg2,arg3 are the screen coordinates

338)win_exists:-This function returns E_OK if the window currently exists
 arg1 is the window name.

339)win_find_text:-This function searches for text in a window-relative rectangle
 arg1 is the window name
 arg2 is the requested string expression
 arg3 is the returned array that stores the string location
 args 4,5 are x,y of the rectangle's upper-left corner (optional)
 args 6,7 are x,y of the rectangle's lower-right corner (optional)
 arg8 TRUE - search for any string, FALSE - search only for
 a complete word (optional).

340)win_get_desc:-This function returns the window description
 arg1 is the window name
 arg2 is the obligatory property list
 arg3 is the optional property list
 arg4 is the selector
 arg5 is the returned description.

341)win_get_info:-This function returns the requested window property
 arg1 is the window name
 arg2 is the requested property
 arg3 is the returned value.

342)win_get_text:-This function reads the text within a window-relative rectangle
 arg1 is the window name
 arg2 is the returned text
 args 3,4 are x,y of the rectangle's upper-left corner (optional)
 args 5,6 are x,y of the rectangle's lower-right corner (optional).

343)win_highlight:-This function highlights a window
 arg1 is the window name
 arg2 is the number of flashes.

344)win_max:-This function maximizes a window to fill the entire screen
 arg1 is the window

345)win_min:-This function minimizes a window to an icon
 arg1 is the window

346)win_mouse_click:-This function performs a mouse click within the specified window
 arg1 is the window
 arg2 is the x position
 arg3 is the y position
 arg4 is mouse button (optional)

347)win_mouse_dbl_click:-This function performs a double-click within a window
 arg1 is the window name
 arg2 is the x position
 arg3 is the y position
 arg4 is mouse button (optional)

348)win_mouse_drag:-This function performs a mouse drag within a window
 arg1 is the window name
 args 2,3 are the starting x,y position
 args 4,5 are the ending x,y position
 arg6 is mouse button (optional).

349)win_mouse_move:-This function moves the mouse pointer to the designated position within a window
 arg1 is the window name
 arg2 is the x position
 arg3 is the y position

350)win_move:-This function moves a window to a new absolute location
 arg1 is the window name
 args 2,3 are the x,y coordinates of the new location

351)win_move_locator_text:-This function moves the screen pointer to the location of text in
 the specified window.
 arg1 is the window name
 arg2 is the requested string expression
 args 3,4 are window-relative x,y of the rectangle's upper-left
 corner (optional)
 args 5,6 are window-relative x,y of the rectangle's lower-right
 corner (optional)
 arg7 TRUE - search for any string, FALSE - search only for a
 complete word.(optional)

352)win_open:-This function opens a window (should be used after recording with "Script Wizard").
 arg1 is the logical name.

353)win_resize:-This function resizes a window
 arg1 is the window
 arg2 is the new width of the window
 arg3 is the new height of the window

354)win_restore:-This function restores a window from an minimized or maximized state to its previous size
 arg1 is the window

355)win_type:-This function sends keyboard input to a specific window.
 arg1 is the window name.
 arg2 is the input string.

356)win_wait_bitmap:-This function waits for a window bitmap.
 arg1 is the logical name of the window.
 arg2 is a string that identifies the captured bitmap.
 arg3 indicates the time.
 args 4,5 are the coordinates or the upper left corner.
 arg6 is the width of the bitmap.
 arg7 is the height of the bitmap.

357)win_wait_info:-This function waits for a specified value of a window property
 arg1 is the window name
 arg2 is the requested property
 arg3 is the expected value
 arg4 is the timeout (in seconds).

358)ActiveBar_combo_select_item:-This function selects an item in a ComboBox tool.
 arg1 is a string containing the band identifier and tool identifier, separated by semicolon ( ; )
 arg2 is the name or index of the item

359)ActiveBar_dump:-This function stores information about ActiveBar bands and tools.
 arg1 is the file pathname in which the ActiveBar information will be dumped

360)ActiveBar_select_menu:-This function selects a menu item in a toolbar.
 arg1 is a string containing the band identifier and tool identifier, separated by semicolon ( ; )
 arg2 is optional, TRUE for running using events only

361)ActiveBar_select_tool:-This function selects a tool in the toolbar.
 arg1 is a string containing the band identifier and tool identifier, separated by semicolon ( ; )
 arg2 is optional, TRUE for running using events only

362)Activate a method of an ActiveX control.
Usage: 1.Name - the logical name of the object.
2.MethodName - the method name.
3.ReturnValue - the return value of the method.
Optional: 4 - 8. InOut Parameters.

363)ActiveX_get_info:-This function retrieves the value of an ActiveX control
property
Usage : 1.Name - the logical name of the object
2.PropertyName - object property
3.PropertyValue - return the value of object property

364)ActiveX_set_info:-This function sets the value of a property for an ActiveX
control.
Usage : 1.Name - the logical name of the object
2.PropertyName - object property
3.PropertyValue - value of property to assign

0 comments:

Post a Comment

Bookmark Us

Delicious Digg Facebook Favorites More Stumbleupon Twitter