Task Reference
PureLoad 3.5 November 2007	http://www.minq.se support@minq.se

• Introduction
• System Tasks
  • Basic Tasks
  • Web (HTTP) Tasks
  • Extract Tasks
  • Database (JDBC) Tasks
  • Mail Tasks
  • News (NNTP) Tasks
  • File Transfer Program (FTP) Tasks
  • Network Utility Tasks
  • Directory Server (LDAP) Tasks
    • LDIF
    • Modify Format
  • Telnet Tasks
  • SSH Tasks
• Custom Tasks

Introduction

The system tasks supplied with the applications enables out of the box testing of the major Internet protocols. The  node System Tasks in the Task Types tab of the scenario editor lists all tasks that are supplied. Using the Task Types tab you can see overall (short information) about tasks using the bottom Task Information tab as well as information about the parameters using the Task Parameters tab:

The set of system tasks in PureLoad depends on the license being used. If Enterprise Edition is used the following task groups are included:

and if Web Edition is used:

The following will give an overview of the task groups provided. For details on parameters, use the spot help provided in the scenario editor (move you mouse to the parameter you want information on and hold it for a second).

System Tasks

The system tasks supplied with the applications enables out of the box testing of the major Internet protocols as well as various utility tasks.

The following will give an overview of the tasks groups provided. For details on parameters, use the spot help provided in the scenario editor (move you mouse to the parameter you want information on and hold it for a second)

Basic Tasks

This task group includes various useful utility tasks:

• DescriptionTask
  Used for documentation purposes to place description/documentation text as a task in a Scenario.
• SleepTask
  Sleeps for specified time and can be used to add a delay. Typically used to simulate "think times".
• RandomSleepTask
  Similar to SleepTask, but sleeps for a random amount of time.
• SetVariableTask
  Sets/initializes a list of scenario variables.
• CheckValueTask
  Performs a check to assert that two values are equal.
• ScriptTask
  Write custom tasks on the fly using Java (Beanshell).
  
• RuntimeSettingsTask
  Sets/updates runtime settings.
  
• CommandTask
  Executes an OS command.
  
• NullTask
  Does not do anything. Normally used for test purposes.
  
• ErrorTask
  Generates an error and does nothing else. Normally used for test purposes.
  

Web (HTTP) Tasks

• HttpInitTask
  Initializes common HTTP parameters used by  subsequent HTTP tasks.
• HttpGetTask
  Sends an HTTP GET request.
• HttpPostTask
  Sends an HTTP POST request.
• HttpPostFileTask
  Sends HTTP POST request with multipart/form-data
• HttpPostContentTask
  Sends HTTP POST with specified MIME type content, for example XML.
• HttpPostBinaryContentTask
  Sends HTTP POST with binary coded text.
• HttpHeaderTask
  Sets HTTP header values used by subsequent tasks.
• HttpVerifyResponseTask
  Verifies previous HTTP response.
• HttpExtractTask
  Extracts values from previous HTTP response.
• HttpCookieTask
  Sets an HTTP cookie.
• GetHTMLPageTask
  Sends an HTTP GET requests for all resources on previous HTML page.
• HttpGetAndWaitTask
  Sends an HTTP GET request repeatedly until the desired result is found.
• HttpPostSOAPTask
  Sends an HTTP POST request with SOAP message.
• HttpPutTask
  Sends an HTTP PUT request.
• HttpPutFileTask
  Sends an HTTP PUT request where content is read from a file.
• HttpDeleteTask
  Sends an HTTP DELETE request.
• HttpSSLClientCertificateTask
  Defines an SSL Client Certificate used by subsequent tasks.
• HttpSetLocalAddress
  Sets the local IP address/host to use for subsequent HTTP tasks.

Extract Tasks

Extract tasks operate on textual results from previous tasks. The extracted value is stored in a variable which can be used in subsequent tasks. Most of the HTTP tasks (and many of the other tasks as well) store text data so that it can be extracted from. A good approach is to execute the text producing task in the debugger and analyze the result there.

• ExtractTask
  Extracts from any text using start and end patterns.
• XmlXPathExtractTask
  Extracts from XML using XPATH expressions.
• PropertyExtractTask
  Extracts a property from text interpreted as Java properties.
• HTMLExtractLinkTask
  Extracts HREF link from HTML by the name of the link.
  

Database (JDBC) Tasks

The JDBC (Java Database Connectivity) tasks are used to access a relational database. These tasks require a JDBC driver for the database. Sun hosts a list of JDBC drivers at http://industry.java.sun.com/products/jdbc/drivers. The JDBC driver must be placed in the INSTALL_HOME/extensions directory.

• JDBCConnectTask
  Connects to a database and stores connection for subsequent tasks.
• JDBCSelectTask
  Executes an SQL SELECT query.
• JDBCExecuteTask
  Executes an SQL INSERT or UPDATE.
• JDBCDisconnectTask
  Disconnects from database and removes connection scenario attribute.

Mail Tasks

• MailConnectTask
  Connects to a mail server and stores connection for subsequent tasks.
• MailSendTask
  Sends a mail message using SMTP.
• MailReadTask
  Reads a mail message using IMAP or POP3 protocol.
• MailDeleteTask
  Deletes a mail message.
• MailListTask
  Lists mails in a mail box/folder.
• SMTPCheckTask
  Connects to an SMTP server and checks that it is functional.
  

News (NNTP) Tasks

• NntpConnectTask
  Connects to a news server and stores connection for subsequent tasks.
• NntpListGroupsTask
  Lists new groups since specified date.
• NntpListArticlesTask
  Lists articles since specified date.
• NntpDisconnectTask
  Disconnects from NNTP server and removes connection scenario attribute.
  

File Transfer Program (FTP) Tasks

• FtpConnectTask
  Connects to an FTP server and store connection for subsequent tasks.
• FtpChangeDirTask
  Changes FTP remote directory.
• FtpListTask
  Lists content of current FTP remote directory.
• FtpGetFileTask
  Gets a file from a remote system to local file system.
• FtpPutFileTask
  Puts a file from local file system to remote system.
• FtpDisconnectTask
  Disconnects from FTP server and removes connection scenario attribute.
  

Network Utility Tasks

• EchoTask
  Sends and receives an echo request using Echo protocol (RFC 862) to the specified host. Can use either TCP (default) or UDP protocol.
• TimeTask
  Sends and receives a time request using the Time protocol (RFC 868) to the specified host. Can use either TCP (default) or UDP protocol.
• PingTask
  Uses an OS command to send ICMP ECHO_REQUEST datagram packages (pings) to a server. Reported execution time is average time per ping.
• CheckTcpServiceTask
  Checks that a connection can be made to a TCP port and then closes the connection. Optionally, it can also check for an expected string of text to be returned.
• DNSLookupTask
  Performs a DNS lookup on the specified name.

Directory Server (LDAP) Tasks

• LDAPConnectTask
  Connects to a directory server using LDAP and stores the connection for subsequent tasks.
• LDAPAddTask
  Adds an entry specified in LDIF format.
• LDAPReadTask
  Performs a directory read operation.
  
• LDAPSearchTask
  Performs a directory search operation.
• LDAPModifyTask
  Modifies an entry according to LDIF format.
• LDAPRenameTask
  Renames an entry in a directory.
• LDAPDeleteTask
  Deletes an entry in a directory.
• LDAPDisconnectTask
• Disconnects from directory server and removes connection scenario attribute.

LDIF

LDAP tasks (LDAPAddTask and LDAPModifyTask) use the LDAP Data Interchange Format (LDIF) to represent LDAP entries in text form. The version of LDIF used is a slighly simplified version of LDIF, described below.

The basic form of an LDIF entry is:

The value may be specified as UTF-8 text.

Multiple attribute values are specified on separate lines, e.g.,

Here is an example of an LDIF entry:

Modify Format

To specify data to be modified by the LDAPModifyTask the LDIF data consists of one or more records, each one corresponding to a change, addition, or deletion from the LDAP database. The records are separated by a blank line. Each record has the following format.

The record begins with the type of change being made:

Then, the change information itself is given, the format of which depends on what kind of change was specified above. For a changetype of modify, the format is one or more of the following:

Or, for a replace modification:

Or, for a delete modification:

If no attributetype lines are given, the entire attribute is to be deleted.

For a changetype of add, the format is:

For a changetype of delete, no additional information is needed in the record.

Example:

Telnet Tasks

• TelnetConnectTask
  Connects to a remote hosts on a specified port and stores the connection for subsequenet tasks.
• TelnetLoginTask
  Performs a login on the remote host.
• TelnetOperationTask
  Sends/receives strings to/from a remote host.
• TelnetDisconnectTask
  Disconnects from remote host and removes connection scenario attribute.
  

SSH Tasks

• SSHConnectTask
  Connects to a remote host on a specified port and stores the connection for subsequent tasks.
• SSHShellTask
  Sends/receives strings to/from a remote host over SSH.
• SSHDisconnectTask
  Disconnects from remote host and removes connection scenario attribute.
  

Custom Tasks