View and Modify Windows Sockets Buffers

The following steps describe how to view, modify, and navigate through WinSock buffer data.

Modifying buffer data

You can modify buffer data in the Show Arguments dialog box for specific lrs steps in a Vuser script. You can use the Show Arguments dialog box to modify buffer data for the following steps:

  • lrs_length_receive
  • lrs_length_send
  • lrs_receive
  • lrs_receive_ex
  • lrs_send

For further details on these steps, see the Function Reference.

To display the Show Arguments dialog box for any of the above steps, right-click a step in the Editor and select Show Arguments. A dialog box opens and displays the buffer data in the Buffer Content section of the dialog box.

For further details about editing buffer data in Windows Sockets steps, see Buffer Data Editing.

Note: You cannot modify any data in the Snapshot pane

Back to top

View and modify the data in the data.ws file

In the Solution Explorer, double-click the data.ws file. The contents of the data.ws file appear in the VuGen Editor. Modify the data directly in the Editor. For details, see Windows Sockets Data.

Note: Although it is possible to modify data.ws files, it is recommended that you do not modify these files. 

View the data in the Snapshot pane

  1. Ensure that the Snapshot pane is displayed.
  2. Open the Vuser script in the Editor and select a step, or double-click an entry in the Step Navigator. The associated snapshot is displayed in the Snapshot pane. You cannot edit the snapshot data.

Back to top

Navigate within the snapshot data

To navigate within the buffer data, display in the Snapshot pane, and then click Go to. The Go to Offset dialog box opens.

  • To go to a specific offset within the buffer (absolute), select Go to offset and specify an offset value. Click Apply.

  • To jump to a location relative to the cursor, click Advance by and specify the number of bytes to advance. To advance ahead, enter a positive value. To move backwards within the buffer, use a negative value. Click Apply.

  • To select a range of data within the buffer, click Select range from and specify the beginning and end offsets. Click Apply.

Back to top

Insert data into a buffer

You can insert a numerical value into a data buffer. You can insert the data as a single, double-byte, or 4-byte value. The following steps describe how to insert a number into a data buffer.

  1. Copy the numerical data to be inserted to the clipboard.

  2. Right-click a step in the Editor and select Show Arguments.
  3. In the dialog box that opens, ensure that the Text View tab is displayed.
  4. Under Buffer Content, right-click at the location in the buffer where you want to insert the data, and then select Advanced > Paste Byte or Advanced > Paste Short (2 bytes) or Advanced > Paste Long (4 bytes).
  5. Click OK. VuGen inserts the data into the buffer.

Back to top

Copy and paste blocks of data

You can modify the buffer data as characters, decimal numbers, or hexadecimal numbers. For details, see Buffer Data Editing.

Note: You can edit buffer data only when you view the step arguments. You cannot edit buffer data in the Snapshot pane.

  1. Right-click a step in the Editor and select Show Arguments. A dialog box opens and displays the buffer data in the Buffer Content section of the dialog box.

  2. To copy buffer data:

    • As characters, select one or more bytes and press Ctrl+c.

    • As a decimal number, select one or more bytes, right-click in the selection and select Advanced > Copy As Decimal Number.

    • As a hexadecimal number, select one or more bytes, right-click in the selection and select Advanced > Copy As Hexadecimal Number.

  3. To paste the data:

    • As characters, press Ctrl+V.

    • As a single byte (assuming the size of the data on the clipboard is a single byte), right-click at the desired location in the buffer and click Advanced > Paste Byte.
    • In short format (2-byte), right-click at the desired location in the buffer and click Advanced > Paste Short (2 bytes).

    • In long format (4-byte), right-click at the desired location in the buffer and click Advanced > Paste Long (4 bytes).

  4. To delete data, select the data in the Text view, right-click inside the selection and select Delete.

Back to top