View and modify Windows Sockets buffers
The following steps describe how to view, modify, and navigate through Winsock buffer data.
Modify 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.
Note: You cannot modify any data in the Snapshot pane
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
- Ensure that the Snapshot pane is displayed.
- 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.
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.
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.
-
Copy the numerical data to be inserted to the clipboard.
- Right-click a step in the Editor and select Show Arguments.
- In the dialog box that opens, ensure that the Text View tab is displayed.
- 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).
-
Click OK. VuGen inserts the data into the buffer.
Copy and paste blocks of data
You can modify the buffer data as characters, decimal numbers, or hexadecimal numbers. For details, see View and modify Windows Sockets buffers.
Note: You can edit buffer data only when you view the step arguments. You cannot edit buffer data in the Snapshot pane.
-
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.
-
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.
-
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 required location in the buffer and click Advanced > Paste Byte.
-
In short format (2-byte), right-click at the required location in the buffer and click Advanced > Paste Short (2 bytes).
-
In long format (4-byte), right-click at the required location in the buffer and click Advanced > Paste Long (4 bytes).
-
To delete data, select the data in the Text view, right-click inside the selection and select Delete.