Using CA Service Virtualization › Using the Workstation and Console with CA Service Virtualization › Creating Service Images › Create Service Image by Recording › Transport Protocols › TCP

TCP

This topic contains the detailed instructions for recording a virtual service image using the TCP transport protocol.

For more information about prerequisites and preparatory steps, see Preparing to Virtualize TCP.

Follow these steps:

1. To start recording a new virtual service image, complete one of the following steps:
   • Click VSE Recorder on the main toolbar.
   • Right-click the VirtualServices node on the Project panel and select Create a VS Image, by Recording.

   The Virtual Service Image Recorder opens.

2. Complete the Basics tab as in the following graphic:

   

3. Click Next.
4. Enter the information for both the client and the server, select your delimiters, and add SSL parameters.

   Listen/Record on port

   Defines the port on which the client communicates to DevTest.

   Target host

   Defines the name or IP address of the target host where the server runs.

   Target port

   Defines the port number of the target host where the server runs.

   Treat request as text

   Specifies whether the request is treated as text. For more information, see Preparing to Virtualize TCP.

   Request Encoding

   Lists the available request encodings on the machine where DevTest Workstation is running. The default is UTF8.

   Treat response as text

   Specifies whether the response is treated as text. For more information, see Preparing to Virtualize TCP.

   Response Encoding

   Lists the available response encodings on the machine where DevTest Workstation is running. The default is UTF8.

   Use SSL to server

   Specifies whether DevTest uses HTTPS to send the request to the server.

   • Selected: DevTest sends an HTTPS (secured layer) request to the server.

     If you select Use SSL to server, but you do not select Use SSL to client, DevTest uses an HTTP connection for recording. DevTest then sends those requests to the server using HTTPS.

   Cleared: DevTest sends an HTTP request to the server.

   Use SSL to client

   Specifies whether to use a custom keystore to play back an SSL request from a client. This option is only enabled when Use SSL to server is selected.

   Values:

   • Selected: You can specify a custom client keystore and a passphrase. If these parameters are entered, they are used instead of the hard-coded defaults.

   Cleared: You cannot specify a custom client keystore and a passphrase.

   SSL keystore file

   Specifies the name of the keystore file.

   Keystore password

   Specifies the password associated with the specified keystore file.

5. Click Next to start recording.
6. When your recording is complete, click Next.
7. Select a response data protocol if the response is encrypted, compressed, or otherwise encoded.
8. The recorder attempts to detect message delimiters that tell DevTest when it has read a complete request or response. Confirm, or correct, these delimiters on this screen.

   Note: A Request delimiter is mandatory. A Response delimiter must be selected for Live Invocation to be available.

9. The recorder verifies request and response bodies to ensure that, if they are marked as text, that they are text. If they are not, the type is switched to binary.

   Note: To save the settings on this recording to load into another service image recording, click Save above the Finish button.

   The TCP/IP protocol supports a live invocation step. To enable the live invocation step, select a response protocol. If you do not select a response protocol, no live invocation step is included in the VSM.