rsRename

Renames a ResultSet.

If you use a variable to define the new ResultSet name, you will need to loop over the new ResultSet variable manually using rsFirst, rsNext, and #isRowPresent. For example:

<$rsNewName="MySearchResults"$>
<$rsRename("SearchResults", rsNewName)$>
    <$rsFirst(rsNewName)$>
    <$loopwhile getValue(rsNewName, "#isRowPresent")$>
        <!--output code-->
        <$rsNext(rsNewName)$>
    <$endloop$>

Type and Usage

Parameters

Takes two parameters:

  • The first parameter is the name of an existing ResultSet.

  • The second parameter is the new ResultSet name. The call will fail if the resultset already exists.

Output

  • Returns TRUE if the function is successful.

  • Returns FALSE if the function fails.

Example

Renames the SearchResults ResultSet to MySearchResults:

<$rsRename("SearchResults", "MySearchResults")$>