Loads the specified page (GET request).

C Language

int spdy_url( const char *StepName, const char *url, <List of Attributes>, [EXTRARES, <List of Resource Attributes>,] LAST );
The label of the step in the Graphical script. Also used as the transaction name for automatic transactions.
The URL (Uniform Resource Locator) of the Web page to load. The format is "URL=<address>". The URL may be any of the following protocols: HTTP, HTTPS, or FTP. For authentication purposes, include both the user name and the password in the URL attribute using the following format: ftp://username:password@server/dir/path.
List of Attributes
See below in this section: List of Attributes
A demarcation parameter indicating that the next parameter will be a list of resource attributes.
List of Resource Attributes
A marker that indicates the end of the argument list.

Return Values

This function returns LR_PASS (0) on success, and LR_FAIL (1) on failure.


The following argument(s) can be parameterized using standard parameterization: List of Attributes

General Information

The spdy_url function is an action function that loads the Web page (GET request) specified by the URL argument. (Each action function in a script causes the browser to display a new Web page or frame. All action functions can be recorded by VuGen.) The spdy_url function does not require a context.

spdy_url is recorded only when VuGen is in either URL–based recording mode, or in HTML–based recording mode with the A script containing explicit URLs only option checked (see VuGen's Recording Options).

You can use spdy_url to simulate the download of a file from an FTP server. The spdy_url function causes the server to perform the same tasks as if a file were actually being downloaded. The download is done in binary mode, unless "FtpAscii=1" is specified.

Examples of non–HTML–generated resources are .gif and .jpg images. The List of Resource Attributes is only inserted when the recording option for these resources is set at Record within the current script step. This is the default setting. See the Virtual User Generator User Guide.

The HTTP header can be modified to pass additional information about the request to the server. Using HTTP headers you can, for example, allow other content types in the response such as compressed files, or you can request a Web page only on certain conditions.

List of Attributes

Mode -The Recording Level: HTML or HTTP. Click Mode (Recording Level) for more information.

RecContentType - The content–type of RESPONSE header during recording, for example, text/html, application/x–javascript. It is read to determine whether the target URL is a recordable resource. Click RecContentType for more information.

RecContentType - The format of the data to be returned. For example, text/html.

Referer - The URL of the referring Web page. The page that referred to the current page. If the location was explicitly expressed, this attribute is omitted.

Resource - A value indicating whether the URL is a resource:
0 – the URL is not a resource
1 – the URL is a resource

ResourceByteLimit - Click ResourceByteLimit for more information.

Snapshot - The file name of the snapshot file (inf extension), used for correlation.

TargetFrame - The name of the frame containing the current link or resource. Click TargetFrame for more information.

UserAgent - Identifies a component other than the browser that will execute the step, for example, an ActiveX component running under the browser. This user agent header is sent for the requests made by the step. No check is made to confirm that the user agent argument matches the browser's User-Agent Run-Time Setting. Non-browser steps do not affect the emulated browser context, nor do they build a new context from the result.