com.tivoli.twg.libs
Class SessionHoldCommand

java.lang.Object
  extended bycom.tivoli.twg.libs.Command
      extended bycom.tivoli.twg.libs.ServiceNodeInternalCommand
          extended bycom.tivoli.twg.libs.SessionHoldCommand

public class SessionHoldCommand
extends ServiceNodeInternalCommand

This command allows a "hold" to be placed on the session over which the command is sent, allowing a shared session to be kept open until the service node has released it (or the session inactivity timer expires). The command, if accepted, is processed internally by the target ServiceNode base class (it is not received by ServiceNode subclasses). The target ServiceNode sends a reply with return code 0, causing each IPC transport node in the session path to increment the session hold count. The session hold count is decremented by a SessionReleaseCommand reply. A SessionReleaseCommand reply causes a session to be deleted if the session hold count is not positive. This allows a service node to explicitly free a session to minimize resource useage (e.g., manage a pool of active sessions for mass target operations). Note that held sessions ARE subject to unconditional pruning when their inactivity timer expires.


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
SessionHoldCommand()
          Constructor for session hold commmand
SessionHoldCommand(CommandCompleteListener ccl)
          Constructor for session hold command
 
Methods inherited from class com.tivoli.twg.libs.ServiceNodeInternalCommand
MakeFlatInputBuffer, MakeFlatOutputBuffer
 
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, NumInputParms, NumOutputParms, OutputParm, OutputParm, OutputParmLength, PostponeReply, 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

SessionHoldCommand

public SessionHoldCommand()
Constructor for session hold commmand


SessionHoldCommand

public SessionHoldCommand(CommandCompleteListener ccl)
Constructor for session hold command

Parameters:
ccl - - command complete listener