web_global_verification_pause

Suspends the specified checks set by web_global_verification.

C Language

int web_global_verification_pause( constchar *ID [, constchar *ID1, ..., constchar *IDn], LAST );
Argument
Description
object
An expression evaluating to an object of type WebApi. Usually web for Java. See also Function and Constant Prefixes.
ID [ ID1...IDn]
Each argument is a name-value pair as previously passed to web_global_verification as the ID argument. For example: ("ID=id1","ID=id2", LAST).
ID_List
An array of strings. Each array element is a name-value pair as previously passed to web.global_verification as the ID argument. For example: "ID=id1".
LAST
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.

Parameterization

All string arguments (char type) can be parameterized using standard parameterization.

General Information

The web_global_verification_pause function stops the performance of each of the specified checks previously begun by web_global_verification until the same verification ID is passed to web_global_verification_resume.

Example

In the following example, web_global_verification checks for "text1", "text2", and "text3". web_global_verification_pause and web_global_verification_resume suspend checks selectively for segments of the script.

web_global_verification("Text/IC=text1", "Fail=NotFound",
    "ID=text_1_verify", LAST ); 
web_global_verification("Text/IC=text2", "Fail=NotFound", 
    "ID=text_2_verify", LAST ); 
web_global_verification("Text/IC=text2", "Fail=NotFound", 
    "ID=text_3_verify", LAST ); 
/* For this call, the check will be performed for all the above global verifications. */
web_url("Search for 1_2_3", "URL=...", LAST ); 
....
web_global_verification_pause("ID=text_3_verify", "ID=text_1_verify", LAST);
/* For this call, the check will be performed only for global verification text_2_verify. The others are suspended.*/
web_url("Search for 2 only", "URL=...", LAST ); 
web_global_verification_resume("ID=text_3_verify", LAST);
/* For this call, the check will be performed for global verification text_2_verify and text_3_verify. text_1_verify is still suspended.*/
web_url("Search for 2 and 3", "URL=...", LAST );