GetResultRef

Returns a pointer to the search result buffer.

$result_ref = $obj->[GetResultRef]();

foreach $serial_num (keys %{ $result_ref }) {

  foreach $object_param (keys %{ $result_ref->{$serial_num} }) {

    $param_value = $result_ref->{$serial_num}->{$object_param};

  }

}

This method provides a reference to the internal search buffer for objects that were found in the result of an earlier List<object> method (see CreateX, ListX, UpdateX, DeleteX, SuspendX, ResumeX, ExportX, MoveX). Each List<object> method stores results in the same internal buffer, so you should store or process the results of one search before executing a new search.

Search results are stored in double-hashed arrays, where the key for the first hash is the serial number of each object that was found, and the next hash has the parameter name as the key. One entry in the result buffer from a ListDGE method may have the following format:

$result_ref->{<serial_number>}\->{dgename} = "dge01.eng"

\->{locationname} = "Default Location"

\->{host} = "my_server"

\->{testcount} = 15

\->{softlimit} = 15000

\->{hardlimit} = 20000

\->{serialnumber} = nnn

All parameter names (key for second hash) will be in lower case.