|
IBM Rational Performance Tester SDK | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IKUserGroup
Define functionality a load test user group should implement.
A load test user group is a Container
that
defines workload and manages the virtual users that execute
the workload.
Field Summary |
---|
Fields inherited from interface com.ibm.rational.test.lt.kernel.action.IKAction |
---|
ABANDONED, DP_ENCRYPTED_VALUES_KEY, EXECUTING, FINISHED, HANDLETIMER, SEMWAIT, SLEEPING, Status, UNSTARTED |
Fields inherited from interface com.ibm.rational.test.lt.kernel.logging.IKLog |
---|
HISTORY_ALL, HISTORY_NONE, HISTORY_PAGES, HISTORY_REQUESTS, HISTORY_SCHEDULE, LOG_ALL, LOG_CONFIG, LOG_FINE, LOG_FINER, LOG_FINEST, LOG_INFO, LOG_NONE, LOG_SEVERE, LOG_WARNING, STATISTIC_ALL, STATISTIC_NONE, STATISTIC_PAGES |
Fields inherited from interface com.ibm.rational.test.lt.kernel.services.ITestExecutionServices |
---|
STORAGE_LOCAL, STORAGE_USER |
Method Summary | |
---|---|
boolean |
addUser(int startingGroupNum,
int startingGlobalNum)
Add virtual user. |
IContainer |
createTesterWorkload(IContainer parent)
Define workload. |
int |
getLongRunLimit()
Get the long run mode test limit |
boolean |
getLongRunMode()
Get the long run mode value |
int |
getVirtualUsersActive()
Get virtual users active. |
void |
runUsers()
Start virtual user test execution. |
boolean |
runUsers(com.ibm.rational.test.lt.kernel.impl.KStaggerPair[] stagger)
Run virtual users. |
void |
setLongRunLimit(int limit)
Set (enable/disable) the long run mode test limit |
void |
setLongRunMode(boolean mode)
Set (enable/disable) the long run mode |
void |
setStaggerDelay(int s)
Specify stagger value to be used when launching users. |
boolean |
setUserLevels(int lumberjacks,
int historians,
int statisticians,
int armers)
Set user levels. |
Methods inherited from interface com.ibm.rational.test.lt.kernel.action.IContainer |
---|
add, addCatch, addFinally, addInitially, current, finish, get, getActions, getActionsArray, getChildCount, getParentHistoryId, getStartEvent, getStartHistoryId, getStopEvent, getUserGroup, getVirtualUser, isAllowChildrenToPageTestLog, next, nextHistoryId, previous, recordChildExecutionTime, registerChildVerdict, registerChildVerdict, registerChildVerdict, registerChildVerdict, remove, rollUpVerdicts, setAllowChildrenToPageTestLog, setStartHistoryId, stopChildren, verifyParentRelationships |
Methods inherited from interface com.ibm.rational.test.lt.kernel.action.IKAction |
---|
abandon, addEventBehavior, blocked, execute, executeAction, executionTime, findDataArea, finish, getBlockedTimeout, getHistory, getHistoryType, getId, getName, getParent, getResultInteger, getResultObject, getResultString, getRtbEnabled, getStatTree, getStopRequested, getSubsystem, getTimeoutDuration, getTimeoutScheme, getVirtualUserName, getWorkerThread, hasFinished, hasStarted, isRunning, reset, setBlockedTimeout, setDispatchingAction, setHistory, setHistoryType, setId, setResultInteger, setResultObject, setResultString, setResultString, setRtbEnabled, setStatTree, start, status, stop, stop, stopAction |
Methods inherited from interface com.ibm.rational.test.lt.kernel.ICountable |
---|
addCounter, getCounter, getCounters, resetCounters |
Methods inherited from interface com.ibm.rational.test.lt.kernel.logging.IKLog |
---|
getHistoryLevel, getHistoryLevel, getLogLevel, getStatisticsLevel, getVirtualUserGUID, log, log, log, log, reportEvent, reportEvent, reportEvent, reportMessage, reportMessage, reportMessage, reportVerdict, reportVerdict, reportVerdict, reportVerdict, reportVerificationPoint, reportVerificationPoint, reportVerificationPoint, reportVerificationPoint, reportVerificationPoint, reportVerificationPoint, wouldARM, wouldLog, wouldReportHistory, wouldReportHistory, wouldReportStatistics |
Methods inherited from interface com.ibm.rational.test.lt.kernel.action.IKSemaphore |
---|
acquire, availablePermits, getQueue, getQueueLength, reducePermits, release, release, toString, tryAcquire, tryAcquire |
Methods inherited from interface com.ibm.rational.test.lt.kernel.services.ITestExecutionServices |
---|
getARM, getLoopControl, getPDLogManager, getStatisticsManager, getTestLogManager, getTime, getTransaction, getValue, setValue |
Methods inherited from interface java.lang.Runnable |
---|
run |
Method Detail |
---|
boolean addUser(int startingGroupNum, int startingGlobalNum)
Creates a virtual user within the UserGroup container. A call to runUsers() must be made to dispatch users added for execution.
startingGroupNum
- This user's identifying number with this UserGroup.startingGlobalNum
- This users' unique identifying number within this schedule run.
true
User added successfully.
false
A problem was encountered adding this user. Consult
the Problem Determination log for details.boolean setUserLevels(int lumberjacks, int historians, int statisticians, int armers)
Sets the number of virtual users that will be report execution history, providing execution statistics, writing problem determination log data, and providing ARM (Application Response Measurement) data.
lumberjacks
- Number of logging users.historians
- Number of users providing execution history.statisticians
- Number of users providing statistics data.armers
- Number of users providing ARM data.
true
if all levels set successfully.
false
if there was a problem setting levels. Consult
the Problem Determination log for more details.void runUsers()
Starts execution of virtual users previously added.
boolean runUsers(com.ibm.rational.test.lt.kernel.impl.KStaggerPair[] stagger)
Starts execution of virtual users added to the engine.
stagger
- Array of startup sequences made up of two integers. First
integer is the number of users to start. Second integer
is a delay value in milliseconds to wait before starting each user.
true
if the users are all running.IContainer createTesterWorkload(IContainer parent)
Produces the container of actions which make up the workload for a given virtual user in this user group.
parent
- The virtual user which owns this workload.
void setStaggerDelay(int s)
The stagger delay is the amount of time in milliseconds that should be paused in between starting execution of virtual users.
s
- Number of milliseconds to pause between starting users.int getVirtualUsersActive()
void setLongRunMode(boolean mode)
value
- the new valueboolean getLongRunMode()
void setLongRunLimit(int limit)
value
- the new valueint getLongRunLimit()
|
IBM Rational Performance Tester SDK | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |