C H A P T E R  5

Using the SunVTS TTY User Interface

This chapter describes how to run a test session using the SunVTS TTY UI. The procedures are written in a step-by-step form so you can use them to become familiar with SunVTS using the SunVTS TTY UI. This chapter is divided into the following sections:



Note - This chapter assumes that you have already performed the following procedures:
bullet Installed SunVTS as described in Installing and Removing SunVTS
bullet Started SunVTS as described in Starting SunVTS
bullet Prepared your system for testing as described in Preparing Devices for Testing



See Appendix A for descriptions of each SunVTS window and dialog box.


5.1 Getting Started with the SunVTS TTY UI

This section describes how to use the fundamental features of the SunVTS TTY UI to perform diagnostic testing on a system. For information about using more advanced features, see Using Additional Features with the SunVTS TTY UI .

5.1.1 The SunVTS TTY UI Main Window and Keyboard Commands

The SunVTS TTY UI is an ASCII based, screen-oriented interface that does not require a graphical window environment. Most of the control and monitoring options that are available in the SunVTS graphical interfaces are also available in the TTY interface.

You can use the TTY interface to run SunVTS from a serial terminal, or through a graphical window tool such as a shell tool, command tool, or CDE terminal window.

The procedures in this chapter explain how to use the TTY main window:

FIGURE 5-1 SunVTS TTY Main Window

TABLE 5-1 SunVTS TTY Main Window

Window Item

Description

Control panel

Provides access to SunVTS controls.

Test_Groups panel

shows the testable devices (categorized in groups) and provides access to their test options.

Status panel

Displays SunVTS test status information.

Message console panel

The area where test messages are displayed. No user input is accepted in this panel. You can use up and down arrow keys to scroll through the messages in this panel.



5.2 Navigating the SunVTS TTY UI

Use keyboard commands instead of mouse and pointer action to control SunVTS in the TTY UI. The following table lists the keyboard commands and explains how to use them.

TABLE 5-2 TTY Keyboard Commands

Key

Description of Action

Tab

Moves you from one panel to another.

For example, if you are working in the Control panel and press the Tab key, the focus (or highlight) shifts to the Status panel. Highlighted panels are bordered by asterisks (*).

Arrow keys

Moves between selections within a panel

Return

  • Displays a menu

  • Selects and applies a choice or a command in a menu

Spacebar

Selects or deselects a checkbox:

  • [*] = selected

  • [ ] = deselected

Backspace key

Deletes text in a text field

Escape

Discards a pop-up menu or window

Control-F

S crolls forward in a scrollable window

Control-B

Scrolls backward in a scrollable window

Control-X

Quits the TTY user interface but leaves the SunVTS kernel running

Control-L

Refreshes the TTY window



procedure icon  To Configure SunVTS for a Test Session

1. Identify the current state of SunVTS in the Status panel.

FIGURE 5-2 Status panel (TTY)

2. Select a test mode (Functional or Connection).

About Test modes :

How to do it :

    a. Use the tab key to move to the Control panel ((if needed).

    b. Use the arrow keys to highlight test_mode and press return.

    The test_mode menu is displayed.

    FIGURE 5-3 test_mode Menu (TTY)

    c. Use the arrow keys to highlight functional or connectivity and press return.

    d. Use the arrow key to highlight OK in the confirmation dialog box and press return.


    Note Note - You can exit any menu, at any time with the <Esc> key.



3. Specify the display mode (logical or physical).

About display modes :

How to do it :

    a. Use the arrow keys to highlight grouping and press return.

    The grouping menu is displayed.

    FIGURE 5-4 grouping Menu (TTY)

    b. Use the arrow keys to highlight logical or physical and press return.

4. Enable Intervention mode (if needed).

About Intervention mode :

Any device that requires your intervention before the test can run (such as loading media for tape, CD-ROM, and diskette tests) also requires that you notify SunVTS that you have performed this action by enabling Intervention mode. You can not select any intervention mode devices until you enable this mode.

How to do it :

    a. Prepare the device for testing (see Preparing Devices for Testing ).

    b. Use the tab key to move to the Control panel.

    c. Use the arrow keys to highlight intervention and press return.

    d. Use the arrow keys to highlight Enable and press return.

5. Select the device groups that you want to test.

About device group s:

An asterisk next to a device group in the Test_Groups panel indicates that the devices in that group are selected . Depending on the devices on your system, and the test mode that you select, SunVTS selects certain devices by default. You can change the selected devices.

How to do it :

    a. Use the tab key to move to the Control panel.

    b. Use the arrow keys to highlight test_select and press return.

    c. Use the arrow keys to highlight one of the following:

6. Select specific devices to test.

About specific devices :

In the previous step, you selected sets of devices for testing by choosing device groups. You can further refine your device selection by selecting or deselecting specific devices.

How to do it :

    a. Use the tab key to move to the Test_Groups panel.

    b. Use the arrow keys to highlight the device group for which you plan to select or deselect individual devices, and press return.

    The individual devices within that group are displayed in a list.

    FIGURE 5-5 Devices within a Group (TTY)

    c. Use the arrow keys to highlight the [ ] (brackets) next to the device that you want to select or deselect.

    d. Press the space-bar to toggle the asterisk.

    e. Press return to close the group.

    Notice that the Status panel displays (or removes) the devices as you select (or deselect) them.

7. Modify the system-level test options (if desired).

About test options :

SunVTS is ready to test each device once you select it. You can, however, modify test options that alter the way tests run to suit your testing needs. There are three levels where you control test options:

The order that you apply the system-level, group-level, and device-level options is important. Start by assigning the system-level options, then assign the group-level options, and finish with the device-level options. Otherwise, if you make lower-level options, then higher-level options, the higher-level options will propagate down and undo your lower-level options. An alternative to this approach is to use locks and overrides to protect lower-level options. See Preserving Test Options with Locks and Overrides .

How to do it :

    a. Tab to the Control panel.

    b. Use the arrow keys to highlight set_options and press return.

    The set_options menu is displayed.

    FIGURE 5-6 set_options Menu (TTY)

    c. Use the arrow keys to select one of the following menus, and press return:



    Note Note - For descriptions of these menus see SunVTS Dialog Boxes.



    d. Use the arrow keys and numeric keys to set the options values.

    e. Use the arrow keys to highlight Apply and press return.

8. Modify group-level and device-level options (if desired).

About group-level and device-level options :

Group-level and device-level options are similar to the system-level testing attributes, but instead pertain to a specific device (or device group) only. You modify these options by changing values in the following dialog boxes:

How to do it :

    a. Tab to the Test_Groups panel.

    b. Use the arrow keys to highlight the device group and press return.

    At this point you can choose to access the group-level option menu instead by highlighting Option (instead of the device-level) and press return. Then go to Step d. Otherwise, the following steps will direct you to modify device-level options.

    c. Use the arrow keys to select a device from the device list and press return.

    The Test_Options menu is displayed.

    FIGURE 5-7 Test_Options Menu

    d. Select one of the option dialog boxes ( Test_Parameters , Test_Execution , or Advanced ) and press return.


    Note Note - For descriptions of these menus, see SunVTS Dialog Boxes.



    e. Use the arrow and numeric keys to modify the options in the dialog box.

    f. Use the arrow keys to highlight apply and press return.

    If you selected the Test_Parameters dialog box, you will be prompted to apply your changes to one of the following:

    FIGURE 5-8 Apply Menu Choices

The test session configuration is complete. Continue to the next procedure to run the test session.


procedure icon  To Run, Monitor, and Stop a Test Session

1. Start the test session.

H ow to do it :

    a. Use the tab key to move to the Control panel.

    b. Use the arrow keys to highlight start and press return.

    The start menu is displayed.

    c. With start highlighted (the default) press return.

    The test session begins.

Depending on how you configured the options in the Test_Execution menus, testing will continue until:

2. Monitor the overall test session status by watching the Status panel.

The Status panel indicates that a test session is running by displaying testing for the System_status . The System_passes , Total_errors , and elapsed_time will increment.

3. Monitor specific tests by watching the Status panel.

Watch for:

4. Check for test messages by watching the Message console panel.

The Message console panel displays test messages under the following circumstances:

Use the up and down arrow keys to scroll through messages in this panel.

5. Stop the test session (if desired).

How to do it :

    a. Use the tab key to move to the Control panel.

    b. If stop is not highlighted, use the arrow keys to highlight it, and press return.

    The test session displays a confirmation menu.

    c. Press <Esc> to dismiss the confirmation menu.

    The test session stops.


procedure icon  To Review and Reset Test Session Results

1. Review the logs.

About logs :

SunVTS provides access to four log files:

How to do it :

    a. Use the tab keys to move to the Control panel.

    b. Use the arrow keys to highlight log_files .

    The log_files menu is displayed.

    c. Use the arrow keys to select one of the three log files and press return.

    d. Use the arrow keys to select one of the following:

    e. Press <Esc> to close the log_file menu.

2. Interpret SunVTS messages

There are many messages for each of the many tests that run under SunVTS. For this reason, it is difficult to document the implication of each message that you might see. Most messages contain all the explanatory text that is possible for each event that is encountered. Some messages are information messages ( INFO , VERBOSE , WARNING ) which do not represent an error, while some messages are error messages ( ERROR and FATAL ), indicating that the test detected a failure. This section explains generic test message information.

SunVTS information message example:

04/24/00 17:19:47 systemA SunVTS5.0: VTSID 34 disktest.VERBOSE c0t0d0: "number of blocks 3629760"

SunVTS error message example:

05/02/00 10:49:43 systemA SunVTS5.0: VTSID 8040 disktest.  FATAL diskette: "Failed get_volmgr_name()"   Probable_Cause(s):     (1)No floppy disk in drive  Recommended_Action(s):     (1)Check the floppy drive

Whenever possible, the error message supplies a message type (described in the following table), followed by the message text, one or more probable causes, and one or more recommended corrective actions.

The following table describes the types of messages you might encounter. All messages are displayed in the Message panel, and most are logged in one of the SunVTS logs ( Info or Error ).

TABLE 5-3 Message Types

Message Type

Log file

Description

INFO

Info log

Displayed when a non-error test event occurs.

ERROR

Error and Info logs

Displayed when a test detects an error, often an indication of a problem with a specific function or feature of the device under test.

FATAL

Error and Info logs

Displayed when a test detects a severe error that might cause the test to exit, such as a failure to open a device. These errors are indicative of hardware failures.

VERBOSE

Not logged

Test progression messages that are displayed when the verbose feature is enabled.

WARNING

Info log

Displayed when something affects the test that is not an error, such as a device that is busy.


You can write scripts that watch for certain SunVTS events as they are logged in the log files, and which trigger an action when a particular message string occurs. If you plan to do this, read the information about the message format. See .



Note Note - As of SunVTS 5.0, the VTS_OLD_MSG variable is no longer supported. It was used to display test messages in a pre-SunVTS 4.0 format, usually because a script relies on the older format. Now your scripts must accept the current SunVTS message formtat.



3. Reset the test session results (if desired).

How to do it :

    a. Use the tab key to move to the Control panel.

    b. Use the arrow keys to highlight reset and press return.

    The information in the Status panel is reset. This does not reset your test options.


5.3 Using Additional Features with the SunVTS TTY UI

This section describes additional SunVTS features using the SunVTS TTY user interface:

5.3.1 Connecting to Another Host

You can connect the SunVTS user interface on your local system to a SunVTS kernel that is running on another system in your network. Once you are connected to the remote system, all of the controls in the TTY UI control the testing of the remote system.


procedure icon  To Connect to Another Host

1. Make sure that the SunVTS kernel is running on the remote system.

You can do this in several ways. You can remote login (using rlogin or telnet ) to the remote system and run the vtsk command (see To Start the SunVTS Kernel (vtsk) ) to start the kernel.



Note Note - On the remote system, you must login (or switch user) as a user that has SunVTS privileges (superuser by default) before you can start the SunVTS kernel (vtsk).



2. Open the Connect_to_Host menu:

    a. In the Control panel, highlight connect_to and press return.

    b. Enter the remote system hostname in the connect_to_host field.

    c. Highlight Apply and press return.

    d. Press <Esc> when you receive the connect_to confirmation box.

The SunVTS UI now controls SunVTS on the remote system. The remote system hostname is displayed at the top of the TTY main menu.

5.3.2 Using the Email Notification Feature

You can have SunVTS send test status messages to you using email.


procedure icon  To Enable Email Notification

1. In the Control panel, highlight set_options and press return.

The set_options menu is displayed.

2. Select Notify and press return.

3. Complete the notify menu items.

4. Highlight Apply and press return.

5.3.3 Controlling the Size of the Log Files

The log file sizes of the SunVTS test error log ( /var/opt/SUNWvts/logs/sunvts.err ), the SunVTS kernel error log ( /var/opt/SUNWvts/logs/vtsk.err ) and the information log ( /var/opt/SUNWvts/logs/sunvts.info ) are each limited to a maximum size of 1 Mbyte by default. When the log file reaches the maximum size, the content is moved to a file called logfilename . backup . Additional events are added to the main log files. If the log file reaches the maximum size again, the content is moved to the backup file, overwriting the earlier backup file content. Only one backup file is maintained for each log file.

You can modify the log file maximum size specification.


procedure icon  To Modify the Log File Size Limits

1. In the Control panel, highlight set_options and press return.

The set_options menu is displayed.

2. Highlight Thresholds in the set_options menu and press return.

3. Enter a value ( 1-5 ) in the Max System Log Size field.

4. With Apply highlighted, press return.

5.3.4 Preserving Test Options with Locks and Overrides

With locks and overrides you can preserve or override the options you set at the system level, group level, and device level.

5.3.4.1 Locks

Normally, when you change an option setting at the system level or group level, the new option setting propagates down to all lower levels. Enabling the lock prevents an option setting made at a higher level from affecting the lower-level option setting.



Note Note - Overrides nullify lower-level locks.




procedure icon  To Set (or Unset) a Lock

1. Open the Test Advanced Options dialog box from the group level or device level you want to lock as follows:

    a. Move to the Test_Groups panel.

    b. Highlight the group that has the device for which you plan to set (or unset) a lock, and press return.

    The group devices are displayed.

    c. Highlight the device and press return.

    The Test_Options menu is displayed.

    d. Highlight Advanced and press return.

    The Advanced options menu is displayed.

    e. Highlight the setting for the Test Lock and press return.

    f. Highlight enabled (or disabled ) and press return.

    g. Highlight Apply in the Advanced menu.

    The lock is set (or unset).

5.3.4.2 Overrides

You can use overrides to void the lock protection. Setting the system-level override nullifies all locks, and setting a group-level override nullifies all the locks below that group.


procedure icon  To Set (or Unset) an Override

1. Open the Advanced Option dialog box at one of the following levels:

2. Highlight the Override setting (enable/disable), and press return.

The enable disable menu is displayed.

3. Select enable (or disable ), and press return.

4. Highlight Apply , and press return.

5.3.5 Scaling Your Test Session

You can use a combination of options to scale testing intensity to meet your diagnostic needs. For example, you can modify test options so that each test instance runs simultaneously, thus increasing the stress level for a single or multiprocessor system. The following procedures can be used individually or in combination to scale the test session.


procedure icon  To Modify the Number of Test Instances

You can scale your test session by running multiple copies of the same test on your devices. Each copy is called a t est instance . Each test instance is a separate process of the same test. The number of test instances can be set at the system level, group level, and the device level as follows:

1. Open the Test_Execution Option menu at one of the following levels:

2. Highlight the Num of Instances setting, and enter the value you want.

3. Highlight Apply , and press return.


procedure icon  To Modify Test Concurrency Options

The test concurrency option sets the number of tests that run at a given time during a test session. You can set this value to one to run one test at a time, or increase the test concurrency value thus increasing the stress level of your test session.

There are two options you can modify in the Schedule Option dialog boxes (at the system level and group level) to scale your test session:

1. Open the Schedule Option menu at one of the following levels:

2. Highlight the concurrency setting, and enter the value you want.

3. Highlight Apply , and press return.


procedure icon  To Bind a Test to a Processor with the Processor Affinity Option (for Multiprocessor Systems)

By default, the Solaris kernel assigns each test instance to whichever processor is available at the time. On multiprocessor systems, you can bind (assign) a test instance to a particular processor as follows:

1. Open the Test_Execution Option menu at one of the following levels:



Note Note - The Processor Affinity field is only displayed on multiprocessor systems.





Note Note - The Processor Affinity option is not available for processor tests such as cputest and fputest. These tests are associated with each individual processor on your system and you cannot bind these tests to a different processor.



2. Highlight the Processor Affinity setting, and enter the value you want.

3. Highlight Apply , and press return.

5.3.6 Using the Debugging Features

You can enable certain options that cause the SunVTS test session to output more test data than when you run the session with the default option values. The following procedures describe how to enable these features.


procedure icon  To Enable (or Disable) Debugging Options

1. Open the Test_Execution Option menu at one of the following levels:

2. Enable (or disable) one or more of the following options:

3. Highlight Apply , and press return.

5.3.7 Saving a Test Session Configuration for Repeated Use (Option Files)

You can use the Option Files feature to save the current set of selected devices and test options for reuse. This is a convenient feature when you plan to use the same test session configuration over and over again.

The configuration information is saved in a filename of your choice in the
/var/opt/SUNWvts/options directory.



Note Note - Do not manually edit any option file. Unnecessary or spurious characters in the option file can cause unexpected behavior when you use them.




procedure icon  To Create an Option File

1. Configure SunVTS for the test session that you want to save.

See To Configure SunVTS for a Test Session .

2. Highlight option_files in the Control panel, and press return.

The Option Files menu box is displayed.

3. Specify an option file name in the Option File field.

4. Highlight Store , and press return.


procedure icon  To Load an Option File



Note Note - Loading an option file that was created on another system is permitted, but you must make sure that the configuration is valid for the system you plan to test.





Note Note - Do not load an option file that was created in a
64-bit environment into a 32-bit environment.



1. Highlight option_files in the Control panel, and press return.

The Option Files menu box is displayed.

2. Highlight List and press return.

The list of available option files is displayed.

3. Highlight an option file from the list, and press return.

4. Highlight Load , and press return.

The test session configuration is loaded into SunVTS. You can use this configuration, or modify it before you start the test session.


procedure icon  To Remove an Option File

1. Highlight option_files in the Control panel, and press return.

The Option Files menu box is displayed.

2. Highlight List and press return.

The list of available option files are displayed.

3. Highlight the option file from the list that you want to delete, and press return.

4. Highlight Remove , and press return.

5.3.8 Using the Auto-Start Feature

You can use the auto-start feature, along with saved option files, to simplify the process of configuring a test session and running it.When the auto-start feature is turned on in an option file, SunVTS automatically starts the test session when the option file is invoked, eliminating the need to select the start button.


procedure icon  To Configure SunVTS to use the Auto-Start Feature

1. Highlight set_options from the Control panel, and press return.

The set_options menu is displayed.

2. Highlight Schedule and press return.

The Schedule menu is displayed.

3. Enable the Auto Start setting in the Schedule menu.

4. Highlight Apply and press return.

5. Create an option file as described in To Create an Option File .

The option file that you create is configured to use the auto-start feature.


procedure icon  To Use the Auto-Start Feature

1. Highlight quit UI and Kernel from the quit menu in the Control panel.

You must quit SunVTS and restart it for the auto-start feature to work.

2. Use the following command to restart SunVTS from the command-line, specifying the Option File that you created:

# /opt/SUNWvts/bin/sunvts -to option_file

SunVTS displays the TTY main window and automatically starts the test session.

5.3.9 Suspending and Resuming a Test Session

You can suspend a test session. For example, you might want to look at messages on the Console panel that have scrolled out of view, or you may want to view and print a log file.


procedure icon  To Suspend and Resume a Test Session

1. While the test session is running, highlight suspend in the Control panel, and press return.

"Suspended" is displayed in the Status panel, and the test session pauses until you resume it.

2. While the test session is suspended, highlight resume in the Control panel, and press return.

"Testing" is displayed in the Status panel, and the SunVTS kernel resumes the suspended test session.

5.3.10 Recording and Replaying a Test Session

You can use the Record and Replay feature to record a SunVTS test session. Only one test session recording is saved at a time.

The events are recorded in a file called /var/opt/SUNWvts/vts_replay_file .

Once a test session is recorded, you can use the recorded events to drive the SunVTS kernel so it reproduces the recorded sequence of events at a later time.



Note Note - The Record and Replay feature closely reproduces the sequence of events, but it cannot reproduce the time periods of these events because the execution times vary from one run to another.




procedure icon  To Record and Replay a Test Session

1. Configure SunVTS for the test session that you want to run.

See To Configure SunVTS for a Test Session .

2. Highlight start in the Control panel and press return.

The start menu is displayed.

3. Highlight Start with Record and press return.

The test session runs, and the events are recorded. When testing stops, the recorded session is available to replay.

4. Highlight start in the Control panel and press return.

The start menu is displayed.

5. Highlight Replay and press return.

The kernel reruns the same tests, with the same configuration that you specified.



Note Note - During the replay, the kernel is actually rerunning the tests, not just re-displaying the recorded session.




5.4 Scheduling Test Sequences With the Deterministic Scheduler

SunVTS TTY UI provides a Deterministic Scheduler that allows you to determine what tests run, and in what order. If you do not use this feature, selected tests run in an order that is dynamically determined by the SunVTS kernel.

5.4.1 Deterministic Scheduler Overview

The Deterministic Scheduler is available as dsched Menu in the Control Panel in the SunVTS TTY UI.



Note Note - To select an item in the menu, highlight the item using the arrow keys, then press return. Use the <Esc> key to exit a menu, or



The following list provides an overview of the steps you perform to start, run, and quit the Deterministic Scheduler feature. Detailed instructions follow.

  1. Start SunVTS with the SunVTS TTY user interface as described in Chapter 3 .

  2. Start the Deterministic Scheduler.

  3. Create one or more tasks , using the Task Manager menu. A task is a SunVTS test session configuration (one or more selected SunVTS tests, test options, and specific test mode).

  4. Create the sequence , using the Sequence Manager menu. A sequence is a group of tasks specified to run in a certain order.

  5. Define the number of times ( loops ) that sequence runs, using the Sequence Runner menu.

  6. Start the sequence.

  7. When the sequence is done, reset the Deterministic Scheduler if desired.

  8. Quit the Deterministic Scheduler from the main Dsched Menu .

5.4.2 Getting Started With the Deterministic Scheduler


procedure icon  To Start the Deterministic Scheduler

1. Use arrow keys to highlight dsched (Deterministic Scheduler) in the control panel and press return.

The Deterministic Scheduler menu is displayed.

FIGURE 5-9 DSched Menu

2. Start the Deterministic Scheduler by highlighting Start DS and pressing return.

The DSched Control menu is displayed and the Deterministic Scheduler feature is invoked.

FIGURE 5-10 DSched Control Menu

3. Press <Esc> to return to the main SunVTS TTY window.

You are returned to the SunVTS main window in preparation to configure tasks.


procedure icon  To Create a Task

1. In the Test Groups panel, configure a test session (select one or more devices, test options, and your desired test mode).

If you assign more than one test to a task, the order of the tests within this task cannot be predicted. If you want to control the order of every test, assign only one test for each task.



Note Note - When the Deterministic Scheduler is started, it changes the default values of Max System Passes from 0 (run indefinitely) to 1 (run one pass). This is necessary so that each task only runs selected tests once and proceeds to run subsequent tasks in the sequence.



For details about configuring a test session, refer to To Configure SunVTS for a Test Session .

2. Use arrow keys to highlight dsched (Deterministic Scheduler) in the control panel and press return.

3. Highlight Show DS and press return.

The DSched Control menu is displayed ( FIGURE 5-10 ).

4. Display the Task Manager menu by selecting Task Manager , and press return.

The Task Manager menu is displayed.

FIGURE 5-11 Task Manager Menu

5. In the Task Manager menu, enter a task name in the Task File text field.

6. Select Store and press return to save the task.

Your task is created with the test configuration you specified in Step 1 .

7. Repeat this procedure as needed to create the all the tasks you plan to use in a sequence.


procedure icon  To View Existing Tasks

1. Select List... from the Task Manager menu ( FIGURE 5-11 ) and press return.

The Tasks Available menu is displayed with the list of Available Tasks. If this is the first time that the Deterministic Scheduler is used, you must create a minimum of one task before any tasks are available to view.

2. To see the test session configuration for a particular task, select the task, and press return.

3. Select Load and press return.

The SunVTS Status panel shows the SunVTS test configuration associated with the selected task.


procedure icon  To Modify a Task

1. Select List... from the Task Manager menu ( FIGURE 5-11 ) and press return.

2. Select the task you plan to modify, and press return.

3. Select Load and press return.

The SunVTS Status panel shows the SunVTS test configuration associated with the selected task.

4. Change the test configuration in the main window.

5. In the DSched Task Manager menu, select Store .

Your changes are saved.


procedure icon  To Delete a Task

1. Select List... from the Task Manager menu ( FIGURE 5-11 ) and press return.

2. Select the task you plan to delete, and press return.

3. Select Remove in the Task Manager menu, and press return.

4. Select OK in the confirmation menu, and press return.

The task is deleted.


procedure icon  To Create a Sequence

1. Invoke the Sequence Manager menu by selecting the Sequence Manager ( FIGURE 5-12 ) in the DSched Control menu ( FIGURE 5-10 ).

FIGURE 5-12 Sequence Manager Menu

2. Enter the name of the sequence file you want to create in the Sequence Name text field.

By default, the Deterministic Scheduler displays the text field with a .sequence suffix. This filename suffix is not mandatory.

3. Select Task Insert/Delete -> Insert Tasks in the Sequence Manager menu.

4. Select Insert Tasks and press return.

The Tasks Available menu is displayed.

FIGURE 5-13 Tasks Available Menu

5. Select a task from the list and press return.

This displays a menu with Insert Task as the only choice.

6. Press return.

The task you selected is inserted into the sequence.

The order in which you add tasks is the order they will be run in the sequence, with the first added task running first, and the last task running last. However, you can insert tasks into specific places in your list of tasks as described later in this section.

7. Repeat Step 5 and Step 6 to add additional tasks into the sequence.


Note Note - Use the <Esc> key to move back to previous menus.



8. Select Store in the Sequence Manager menu ( FIGURE 5-13 ) and press return.

Your sequence is saved for future use. To run the sequence see To Run the Sequence .



Note Note - Select Close in the Sequence Manager menu to move back to the DSched Control menu.




procedure icon  To View Tasks in a Sequence

1. Display the Sequence Manager menu (accessed from dsched Show DS Sequence Manager menu).

2. Select List... in the Sequence Manager menu and press return.

3. Highlight the sequence you want to see, and press return.

If the list is long, use control-F (forward) and control-B (backwards) to scroll through the sequences.

FIGURE 5-14 List of Sequences

4. You can view the list of tasks available in this sequence by selecting Tasks In Sequence in the Sequence Manager menu.


procedure icon  To Remove Tasks from a Sequence

1. Display the Sequence Manager menu (accessed from dsched Show DS Sequence Manager menu).

2. Select list... in the Sequence Manager menu and press return.

The list of sequences is displayed.

3. Select the sequence you plan to modify and press return.

4. Select Task Insert / Delete and press return.

The Tasks In Sequence menu is displayed with a list of tasks in the sequence.

5. Select Delete Task/Set Task Insert Mark and press return.

The list of tasks for this sequence is displayed.

6. Select the task you want to delete and press return.

A menu with two choices is displayed.

7. Select Delete Task and press return.

The selected task is deleted from the sequence.

8. Repeat the above steps to remove additional tasks as desired.

9. Use the <Esc> key to move back to the Sequence Manager menu.

10. Save your changes by selecting Store and press return.

11. Select ok and press return.

12. Select Close to exit the Sequence Manager menu.


procedure icon  To Insert Tasks in a Sequence

1. Display the Sequence Manager menu (accessed from dsched Show DS Sequence Manager menu).

2. Select list... in the Sequence Manager menu and press return.

The list of sequences is displayed.

3. Select the sequence you plan to modify and press return.

4. Select Task Insert/Delete Task and press return.

5. Delete Set Task Insert Mark and press return.

The list of tasks for this sequence is displayed.

6. Use the arrow keys to select the task that is directly above the place where you want the new task inserted, and press return.

7. Select Set Insert Mark , and press return.

This marks your insertion point. Any task you add after this step, in this sequence, will be inserted below this insertion mark.

8. Use the <Esc> key to move back to the Insert Task menu.

9. Select Insert Task and press return.

The list of available tasks is displayed.

10. Select the task you want to add and press return.

11. With I nsert Task highlighted, press return.

The task is inserted below the insert mark.

12. Repeat Step 10 and Step 11 for all the tasks you want to add.

13. Use the <Esc> key to move back to the Sequence Manager menu.

14. Save your changes by selecting Store and pressing return.

15. Select ok and press return.

16. Select Close to exit the Sequence Manager menu.


procedure icon  To Delete a Sequence

1. Display the Sequence Manager menu (accessed from dsched Show DS Sequence Manager menu).

2. Select list... in the Sequence Manager menu and press return.

The list of sequences is displayed.

3. Highlight the sequence you want to delete, and press return.

4. Select Remove in the Sequence Manager menu and press return.

5. Select ok and press return.

The selected sequence is deleted from the Deterministic Scheduler.



Note Note - The tasks associated with the deleted sequence are not deleted.



6. Select Close to exit the Sequence Manager menu.


procedure icon  To Run the Sequence

1. Invoke the Sequence Runner menu by selecting Seq Runner in the Start DS menu.

FIGURE 5-15 Sequence Runner Menu

2. Select the sequence that you want to run by selecting List... , highlighting the sequence, and press return.

3. Change the Total Loop value to the number of times you want to repeat the sequence of tests.


Note Note - The default and minimum number of Total Loops value is 1. You can change the Total Loop value to the desired value, up to a maximum of 10 loops.



4. Select the Start button at the bottom of the Sequence Runner menu start the sequence.

While testing is underway, you can do any of the following:


procedure icon  To Reset the Status Panel and Deterministic Scheduler

1. Use the Reset in the main window to reset the Status panel and Deterministic Scheduler.

The TTY Status panel test statistics and the Deterministic Scheduler current loop count are reset.


procedure icon  To Quit the Deterministic Scheduler

1. To quit the Deterministic Scheduler when you are done, select dsched right arrow Quit DS Options right arrow Quit DS .