com.tivoli.twg.engine
Class FindObjectByAttribCmd

java.lang.Object
  extended bycom.tivoli.twg.libs.Command
      extended bycom.tivoli.twg.engine.FindObjectByAttribCmd

public class FindObjectByAttribCmd
extends Command

Command class for issuing find object by attribute request to Director Workgroup Server.

As of V2.11, searching supports using a single instance style attribute (STRING_TYPE, INTEGER_TYPE, etc) to match with an array style attribute of the same basic type (STRING_ARRAY_TYPE, INTEGER_ARRAY_TYPE, etc). An object will match if the single value provided matches any of the values in the corresponding array of values from the object. On versions before V2.11, doing this would result in no matching objects.


Field Summary
 
Fields inherited from class com.tivoli.twg.libs.Command
CMD_SENDER_FLAG, CMDRET_CREATE_CMDPKT_FAILED, CMDRET_ENCRYPT_FAIL, CMDRET_ENQUEUE_LOCAL_FAILED, CMDRET_INVALID_DEST_ADDRESS, CMDRET_NO_LOCAL_SVCNODE_IMPL, CMDRET_SECURE_FAIL, CMDRET_SEND_BUFFER_FAILED, CMDRET_SEND_FAILED, CMDRET_SEND_TIMEOUT, CMDRET_SERVICEFAILED, CMDRET_SESS_DISABLED_LCL, CMDRET_SESS_DISABLED_RMT, CMDRET_SESS_UNAVAIL_LCL, CMDRET_SESS_UNAVAIL_RMT, CMDRET_SESS_WAIT_DONE, CMDRET_SESS_WAIT_EXPIRED, CMDRET_SESS_WAITING, COMMAND_TYPE_INPUT, COMMAND_TYPE_OUTPUT, DEFAULT_CMD_TIMEOUT, ENQUEUE_FAILED_COPYDATA, ENQUEUE_FAILED_NO_DESTPATH, ENQUEUE_FAILED_NO_PROCESS_HANDLE, ENQUEUE_FAILED_NO_SVC_NODE_HANDLE, ENQUEUE_FAILED_SECURITY, ENQUEUE_GENERAL_FAILURE, JNI_BUFFER_NULL, JNI_ENTRY_POINT_NOT_LOADED, JNI_HANDLE_NULL, JNI_INITIALIZE_FAILED, RMI_LOOKUP_ERROR, SESSION_NONE, SESSION_PREFERRED, SESSION_REQUIRED
 
Constructor Summary
FindObjectByAttribCmd(java.lang.String cls, java.lang.String[] attriblist, DataValue[] vallist)
          Constructor for find object by attrib command.
FindObjectByAttribCmd(java.lang.String cls, java.lang.String[] attriblist, DataValue[] vallist, java.util.Locale loc)
          Constructor for find object by attrib command.
 
Method Summary
 LongValueSet getMatchingIDs()
          Get set of object IDs returned as matching
 
Methods inherited from class com.tivoli.twg.libs.Command
AddInputParm, AddInputParm, AddObjectAsInputParm, AddObjectAsOutputParm, AddOutputParm, AddOutputParm, addToDebugStrings, AllocateBuffer, AttachInputParm, AttachOutputParm, CmdId, CommandCode, commandCodeDebugString, CommandComplete, CompressObject, debugPrint, DecompressObject, DestinationAddress, DetachInputParm, DetachOutputParm, FreeBuffer, FreeInputsAfterSend, getCmdType, GetObjectFromInputParm, GetObjectFromOutputParm, getSenderServiceNode, hexDump, InputParm, InputParm, InputParmLength, IsFlatInputBuffer, IsFlatOutputBuffer, IsPostponedReply, MakeFlatInputBuffer, MakeFlatOutputBuffer, NumInputParms, NumOutputParms, OutputParm, OutputParm, OutputParmLength, Postpo neReply, ResetIndex, ResetInput, ResetOutput, ReturnAddress, ReturnCode, ReturnCodeToString, RootDestinationAddress, RootReturnAddress, SessionHold, SessionMode, SessionRelease, SessionWaitTime, setCmdType, setCmdTypeInput, setCmdTypeOutput, SetCommandCode, setCommandCodeDebugString, setCommandCompleteListener, SetDestinationAddress, SetNewID, SetReturnAddress, SetReturnCode, setSenderServiceNode, SetSessionHold, SetSessionMode, SetSessionRelease, SetSessionWaitTime, SetTimeOut, TimeOut, toString, UseFlatInputBuffer, UseFlatOutputBuffer
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

FindObjectByAttribCmd

public FindObjectByAttribCmd(java.lang.String cls,
                             java.lang.String[] attriblist,
                             DataValue[] vallist)
Constructor for find object by attrib command.

Parameters:
cls - - class (or superclass) name of objects to find
attriblist - - list of attribute ID strings
vallist - - list of attribute values which must match

FindObjectByAttribCmd

public FindObjectByAttribCmd(java.lang.String cls,
                             java.lang.String[] attriblist,
                             DataValue[] vallist,
                             java.util.Locale loc)
Constructor for find object by attrib command.

Parameters:
cls - - class (or superclass) name of objects to find
attriblist - - list of attribute ID strings
vallist - - list of attribute values which must match
loc - - locale for request
Method Detail

getMatchingIDs

public LongValueSet getMatchingIDs()
Get set of object IDs returned as matching

Returns:
LongValueSet of object IDs, or null if command error