com.ibm.rational.test.lt.kernel.action

Interface IKLoadTestSchedule

    • Method Detail

      • addUsers

        boolean addUsers(String userGroupName,
                       int numUsers,
                       int startingGroupNum,
                       int startingGlobalNum)
        Add virtual users.

        Creates virtual users within the Load Test container user groups. Users are only constructed. A call to runUsers() must be made to dispatch users for execution.

        Parameters:
        userGroupName - UserGroup to add users.
        numUsers - Number of virtual users to create.
        startingGroupNum - The beginning virtual user number within the user group.
        startingGlobalNum - The beginning virtual user global number.
        Returns:
        trueAll users were added successfully. falseA problem was encountered adding users. Consult the Problem Determination log for details.
      • setUserLevels

        boolean setUserLevels(String userGroupName,
                            int numLoggingUsers,
                            int numHistoryUsers,
                            int numStatsUsers,
                            int numARMUsers)
        Set user levels.

        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.

        Parameters:
        userGroupName - UserGroup name.
        numLoggingUsers - Number of logging users.
        numHistoryUsers - Number of users providing execution history.
        numStatsUsers - Number of users providing statistics data.
        numARMUsers - Number of users providing ARM data.
        Returns:
        true if all levels set successfully. false if there was a problem setting levels. Consult the Problem Determination log for more details.
      • runUsers

        boolean runUsers(int staggerDelay)
        Start virtual user test execution.

        Starts execution of virtual users previously added.

        Parameters:
        staggerDelay - Number of milliseconds to pause in between starting users.
        Returns:
        true if all users running succesfully. false if there was a problem running users. Consult the Problem Determination log for more details.
      • runUsers

        boolean runUsers(String UGName,
                       com.ibm.rational.test.lt.kernel.impl.KStaggerPair[] stagger)
        Run virtual users.

        Starts execution of virtual users added to the engine.

        Parameters:
        UGName - UserGroup name.
        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.
        Returns:
        true if the users are all running.
      • getFriendlyName

        String getFriendlyName()
        Schedule friendly name.

        Returns a name for this schedule that is easy to understand. Removes package name and model GUID from name so the schedule name is succinct.

        Returns:
        String Schedule name.
      • started

        boolean started()
        Report schedule start.

        A convenience to ensure that all UserGroups within a schedule are ready to add users.

        Returns:
        boolean indicating if schedule and all children actions started.
      • getUserGroup

        com.ibm.rational.test.lt.kernel.action.impl.UserGroup getUserGroup(String name)
        Get UserGroup.
        Parameters:
        name - UserGroup name.
        Returns:
        UserGroup
      • getVirtualUsersActive

        int getVirtualUsersActive()
        Get number of virtual users running.
        Returns:
        Number of users running.
      • manualStop

        void manualStop(boolean b)
        Schedule manual stop.

        By default a schedule will exit when all child actions finish. With manual stop, a call to stop() is required to finish the schedule.

        Parameters:
        b - true for manual stop, false means container exits when all children finished
IBM Rational Performance Tester SDK

© Copyright IBM Corp. 2013. All rights reserved.