Using the Protocol Wizard


The Protocol Wizard guides you through constructing the message sequence for an Advanced Data message flow while ensuring that the proper encoding is used in packet headers and payloads. The following protocols are currently supported by the wizard (see Advanced Data Protocols for brief protocol descriptions and links to RFCs):

Build a message flow following the steps below:


Learn the basics:

Before you use the Protocol Wizard, you should have a basic understanding of:

^Back to Top


To start the wizard:

  1. Add a new DMF... to your test case.

  2. Click the Protocol Wizard button at the bottom of the Data Message Flow window.

  3. Choose the data protocol for the message flow in the Select Protocol window and then click OK. The Protocol-Specific Message Building Wizard window opens and you are ready to build the message sequence.

^Back to Top


To build the message sequence:

The wizard window... is split into two vertical panes. The left pane contains message objects that you can select and re-arrange by clicking and dragging. The right pane displays the selected message's contents and includes parameters that you can use to customize the message header and contents as appropriate to the message type. Mandatory encoding is automatically included in the message to ensure valid packet construction. You can collapse or restore either pane by clicking the arrows at the top of the split pane bar.

  1. Click the Add button to add a new message to the end of the sequence and the Choose Message window opens. The wizard always opens with a default first request or response message depending on the protocol. You can change the message type by clicking the ... button to open the Choose Message window.

    By default, the window displays only the requests or responses that would logically follow the previous message, requests if the previous message was a response, or responses if the previous message was a request. You can use the drop-down list to change the message type filter or select Show All to display all of the protocol's messages supported by the wizard.

    The Help button opens the Advanced Data Protocols topic, which contains definitions of some messages and a link to the protocol RFC.

    Select a message, click OK, and the message is added to the end of the sequence. You can re-position it if necessary by clicking the bar on the left side of the message object, dragging the object to its new position, and releasing the mouse button.

  2. When a message object is selected, its contents are displayed in the right pane. Parameters and fields are provided, as appropriate for the type of message, that allow you to customize the message content.

    The entire message payload that will be sent is displayed in the Raw Message pane. You cannot directly modify the contents in this pane — it simply displays the final composition of the encoding added by the wizard and the information you define.

    In the example to the right, a POP3 email transfer from the server to the client is shown. In the top section of the contents pane, email headers can be selected and added with  the drop-down list, and their values defined in the associated text block. A new line is added to the text block when you select a header field. Short message content can be added now in the Content field. A maximum of 1500 bytes is allowed in the static portion of the finished DMF message. For larger message payloads, you can use filler data to expand the message after you import the message sequence into a DMF.

  3. When you are satisfied with your message sequence, click the Import To DMF button to convert the message sequence into DMF Command controls as you would when importing a message trace.

NOTES:

  • The message direction, Client ==> Server or Client <== Server is selected by default based on the previous message. When you add a message that will be re-positioned, you may need to adjust this setting with the radio buttons.
  • A maximum of 64 Command controls are permitted in a DMF. During the import process, request messages are linked to their associated response messages in Command controls. Your message sequence should not exceed 128 message objects (less if the sequence includes unidirectional messages). You can click the Remove button to delete the selected message object.

 

^Back to Top