Creating User Data Tables (UTBLs)

A User Data Table (UTBL) is defined in WSim as a list of string constants (for example, a list of account numbers or user IDs and passwords). The WSim Test Manager organizes each UTBL into fields, so that each line in a UTBL has one or more fields (for example, a user ID and a password).

WSim Test Manager can automatically generate WSim user data tables and the STL source code to use them. This function can be invoked by editing the STL source in the WSim Test Manager. To edit the STL source, type the command UTBL, place the cursor on the line that contains the string to be replaced and press ENTER.

Notes:
  • The first single or double quotation marks (' or ") encountered on the line where the cursor is placed will be considered the starting position of the string to be replaced.
  • There is a possibility of a line overflow if the string to be replaced is on a line that contains a large amount of text.
When the WSim user table function is invoked, a pop-up panel is displayed: 
 
   File  Edit  Confirm  Menu  Utilities  Compilers  Test  Help
------------ Create WSim User Table (UTBL) -----------------------------------
|                                                                            |
|   Select an option.  Then press Enter.                                     |
|                                                                            |
|   _  1.  Create a new UTBL.                                                |
|      2.  Create a new field in an existing UTBL.                           |
|      3.  Use an existing field or UTBL.                                    |
|                                                                            |
|                                                                            |
| F1=Help     F2=Split      F3=End       F4=Return    F5=         F6=        |
| F7=Up       F8=Down       F9=Swap     F10=Left     F11=Right               |
'----------------------------------------------------------------------------'
000066  charset 'field'
000067  type 'mypass'
000068  transmit using enter
000069
000070  /*------------------------------------------------- 09050396 00004 */
000071  WTM_panel_ID = 'PNL00003'
000072  log 'WTM_panel_ID' WTM_panel_ID
000073  screen_data = substr(screen,rowcol(1,1),8)
000074  expected_data = '08'x||'ICH7000'
 F1=Help     F2=Split      F3=Exit      F5=Rfind     F6=Rchange   F7=Up
 F8=Down     F9=Swap      F10=Left     F11=right    F12=Cancel
In this pop-up panel, choose one of the following options:
  • If a field exists, choose option 3. No new UTBL is created.
  • If the UTBL exists, but a new field is to be added, choose option 2.
  • If a new UTBL is required, choose option 1 and the following panel is displayed: 
     
   File  Edit  Confirm  Menu  Utilities  Compilers  Test  Help
 - -------------------- Create WSim User Table (UTBL) --------------------
 E |                                                                     | 0072
 C | Type the values for the following fields.  Then press Enter.        |
 0 |                                                                     |
 0 | User Table Name        : _______                                    | HALF
 0 | Table Description      : ________________________________________   |
 0 |                                                                     |
 0 | Field Name             : ________                                   |
 0 | Field Description      : ________________________________________   |
 0 | Field Delimiter        : ¢                                          | 2 */
 0 |                                                                     |
 0 | Access Type (1,2 or 3) : 2  1.  Random                              |
 0 |                             2.  Single Sequential                   |
 0 |                             3.  Single Sequential (repeated)        |
 0 |                                                                     | ndgen
 0 | F1=Help     F2=Split     F3=End      F4=Return    F5=      F6=      | 3 */
 0 | F7=Up       F8=Down      F9=Swap    F10=Left     F11=Right          |
 0 '---------------------------------------------------------------------'
000050  charset 'field'
000051  type 'mypass'
F1=Help      F2=Split     F3=Exit      F5=Rfind    F6=Rchange   F7=Up
F8=Down      F9=Swap     F10=Left     F11=Right   F12=Cancel

A user table name and field name must be entered. The table and field descriptions are optional.

There are three access types:
  1. Random sets up STL code to randomly access the UTBL. This is useful for using a random spread of the whole UTBL.
  2. Single Sequential sets up STL code to access the UTBL in strict sequential order. When the end of the UTBL is reached, no further accesses are allowed. This is useful for user IDs and passwords, where there is a limited number of entries in the UTBL.
  3. Single Sequential Repeated sets up STL code to access the UTBL in sequential order and resets the UTBL pointer to the top of the UTBL when the bottom of the UTBL is reached. This is useful when accessing a limited number of UTBL rows but reusing the UTBL is wanted.
Parent topic: Testcases