rtecall("transtop") function

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

A RAD function that measures the amount of data transferred, elapsed time, and CPU usage of any transaction. The function is commonly invoked from the RAD debugger and used in conjunction with the rtecall("transtart") function.

The CPU time is retrieved from the server machine.

You can have multiple transaction timings active at the same time.

Function

rtecall("transtop")

Format

$L.success.flag= rtecall($L.fnc.name, $L.return.code, $L.transaction, $results)

Parameters

The following parameters are valid for the rtecall("transtop") function:

Parameter	Data type	Description
$L.success.flg	Logical	Indicates whether or not the function was successful.
$L.fnc.name	String	Name of the sub-function to call, in this case "transtop".
$L.return.code	Number	Provides a more detailed return code.
$L.transaction	String	Any name selected by the user for the transaction to measure.
$L.$results	Array	The results gathered, in the form of an array: `{elapsed seconds, cpu seconds, 0, 0, 0}`. Service Manager no longer keeps track of the third, fourth, and fifth value in the array and it always reports as zero.

Parameter

Data type

Description

$L.success.flg

Logical

Indicates whether or not the function was successful.

$L.fnc.name

String

Name of the sub-function to call, in this case "transtop".

$L.return.code

Number

Provides a more detailed return code.

$L.transaction

String

Any name selected by the user for the transaction to measure.

$L.$results

Array

The results gathered, in the form of an array: {elapsed seconds, cpu seconds, 0, 0, 0}. Service Manager no longer keeps track of the third, fourth, and fifth value in the array and it always reports as zero.

Factors

If the $L.success.flg is false, the function failed. If it is true, the function succeeded.

Example

$L.success.flg=rtecall("transtop", $L.return.code, "problemopen", $results) $results={58.164, 0.961, 0, 26712, 2477}

This example shows that the problemopen transaction took 58.164 seconds of real time and 0.961 CPU seconds.