![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF){kind=logo}
![[HR]](../../IMAGES/REDBAR.GIF)
Check that all terminals are set to the correct baud rate and are assigned appropriate characteristics. (See the user's guide for your terminal.)
Spooled devices and devices allocated to queues fail the initialization phase of UETP and are not tested.
Make sure that no other processes are sharing the Ethernet adapter device when you run UETP.
Note
UETP will not test your Ethernet adapter if DECnet for OpenVMS or some other application has the device allocated.
Because either DECnet for OpenVMS or the LAT terminal server can try to use the Ethernet adapter (a shareable device), you must shut down DECnet and the LAT terminal server before you run the device test phase, if you want to test the Ethernet adapter.
The DR11--W data interface uses an internal logical loopback mode that tests all features except that of module connectors, cables, and transceivers.
Caution
Only Multivendor Customer Services personnel can set up the DR11--W data interface for UETP testing.
Because random external patterns are generated during this operation, the user device or other processor might need to be isolated from the DR11--W data interface being tested until the testing is completed.
To test the DR11--W data interface properly, the E105 switchpack must be set as follows:
| Switch 1 | Switch 2 | Switch 3 | Switch 4 | Switch 5 |
| Off | On | Off | Off | On |
When UETP testing is completed, restore the DR11--W data interface to the proper operating configuration.
The DRV11--WA data interface is a general-purpose, 16-bit, parallel, direct memory access (DMA) data interface.
Caution
Only Multivendor Customer Services personnel can set up the DRV11--WA data interface for UETP testing.
To prepare the DRV11--WA driver on a MicroVAX computer for UETP testing, be sure the following conditions exist:
When UETP testing is completed, restore the DRV11--WA to the proper operating configuration.
The DR32 (DR750 or DR780) device is an interface adapter that connects the internal memory bus of a VAX processor to a user-accessible bus called the DR32 device interconnect (DDI).
Caution
Only Multivendor Customer Services personnel can set up the DR750 or DR780 for UETP testing.
To prepare the DR750 or the DR780 for UETP testing, use the following procedure:
When UETP testing is completed, restore the DR750 or the DR780 to the proper operating configuration.
If you have two LPA11--K devices, be sure that each is given a systemwide logical name in the SYS$MANAGER:LPA11STRT.COM file. The logical name for the first LPA11--K device should be LPA11$0, and the logical name for the second LPA11--K device should be LPA11$1.
UETP does not test the following devices; their status has no effect on UETP execution:
UETP does not have specific tests for UDA, HSC, or CI devices; they are tested implicitly by the disk, magnetic tape, and DECnet for OpenVMS tests.
UETP also does not test the console terminal or console drives. If you boot the system, log in, and start UETP, you have shown that these devices can be used.
Before you run UETP in an OpenVMS Cluster environment, check the SYSTEST_CLIG account. The SYSTEST_CLIG account parallels SYSTEST except that it is dedicated to running the cluster-integration test. The requirements for the SYSTEST_CLIG account are as follows:
Note
The SYSTEST_CLIG account could have been disabled during the OpenVMS upgrade procedure. If it was disabled, you must reenable the SYSTEST_CLIG account and give it a null password before you run UETP.
$ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> MODIFY /FLAGS=NODISUSER /NOPASSWORD SYSTEST_CLIG UAF> EXIT
Note
Digital recommends that you disable the SYSTEST_CLIG account after testing has completed.
$ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> MODIFY /FLAGS=DISUSER SYSTEST_CLIG UAF> EXIT
UETP requires little additional preparation for the cluster-integration test phase beyond the requirements for other UETP test phases. The additional requirements for cluster integration testing are as follows:
$ SET TERM/BROADCAST/PERM OPA0:Nodes on which the operator's terminal (OPA0) is set to the NO BROADCAST terminal characteristic will generate the following error message during the cluster test:
**********************
* UETCLIG00master *
* Error count = 1 *
**********************
-UETP-E-TEXT, 0 operator consoles timed out on the cluster test warning
and 1 operator console rejected it.
-UETP-E-TEXT, Status returned was,
"%SYSTEM-F-DEVOFFLINE, device is not in configuration or not
available"
$ DEFINE/GROUP UETP$CTMODE ALL
After you install the OpenVMS operating system on a small system disk (for example, an RZ23L), you might not have the 1200 blocks of free disk space required to run UETP successfully. If you do not have 1200 free blocks on your system disk, use VMSTAILOR to remove some files from the system disk before you run UETP. For instructions on using VMSTAILOR, refer to the OpenVMS upgrade and installation manual for your system.
The DECnet for OpenVMS phase of UETP uses more system resources than other tests. You can, however, minimize disruptions to other users by running the test on the least busy node.
By default, the file UETDNET00.COM specifies the node from which the DECnet test will be run. To run the DECnet test on a different node, enter the following command before you invoke UETP:
$ DEFINE/GROUP UETP$NODE_ADDRESS node_address
This command equates the group logical name UETP$NODE_ADDRESS to the node address of the node in your area on which you want to run the DECnet phase of UETP.
For example:
$ DEFINE/GROUP UETP$NODE_ADDRESS 9.999
You can also run the DECnet for OpenVMS test on a different node by entering the following command before you invoke UETP:
$ DEFINE/GROUP UETP$NODE_NAME "node""username password""
Note
When you use the logical name UETP$NODE_ADDRESS, UETP tests only the first active circuit found by NCP (Network Control Program). Otherwise, UETP tests all active testable circuits.
When you run UETP, a router node attempts to establish a connection between your node and the node defined by UETP$NODE_ADDRESS or UETP$NODE_NAME. Occasionally, the connection between your node and the router node can be busy or nonexistent. When this happens, the system displays the following error messages:
%NCP-F-CONNEC, Unable to connect to listener -SYSTEM-F-REMRSRC, resources at the remote node were insufficient %NCP-F-CONNEC, Unable to connect to listener -SYSTEM-F-NOSUCHNODE, remote node is unknown
UETP automatically loads all installed and enabled vector processors during the load phase, and automatically tests all installed and enabled vector processors during the device test phase.
If vector processors are available on the system, check for the VP number by entering the following commands:
$ x = F$GETSYI ("VP_NUMBER")
$ SHOW SYMBOL x
Multiply the value of x by 3. If the result is greater than
the account PRCLM value, then you must increase the SYSTEST account
PRCLM quota to match the returned result. For more information see
Chapter 26.
However, UETP cannot load the VAX Vector Instruction Emulation facility (VVIEF) during the load phase, and will not automatically test VVIEF. To test VVIEF, you must do the following before running UETP:
Y Y UETVECTOR.EXE "DEVICE_TEST"
$ X = F$GETSYI("VECTOR_EMULATOR")
$ SHOW SYMBOL X
The VVIEF test can be executed as an individual test using the RUN command, as described in Section 17.8.2.
When you have logged in and prepared the system and devices, you are ready to begin the test.
To start UETP, enter the following command and press Return:
$ @UETP
UETP displays the following prompt:
Run "ALL" UETP phases or a "SUBSET" [ALL]?
Throughout the startup dialog, brackets indicate the default value, which you can choose by pressing Return.
When running UETP for the first time, it is recommended that you choose the default value (ALL) and run all the phases. If you choose ALL, UETP displays three more questions, which are described in Section 17.4.2 through Section 17.4.4. If you want to run all the test phases, skip the next section.
You can run a single phase by entering SUBSET or S in response to the following prompt:
Run "ALL" UETP phases or a "SUBSET" [ALL]?
If you enter S or SUBSET, UETP prompts you for the phase you want to run as follows:
You can choose one or more of the following phases:
DEVICE, LOAD, DECNET, CLUSTER
Phases(s):
There is no default; enter one or more phase names from the list. Separate two or more phases with spaces or commas.
If your choice includes the LOAD phase, UETP displays three prompts:
How many passes of UETP do you wish to run [1]? How many simulated user loads do you want [n]? Do you want Long or Short report format [Long]?
If you exclude the LOAD phase from your list of choices, UETP responds with only two prompts: the first and the third.
The next three sections discuss how you can respond to these questions. After you have answered the questions, the phase you have selected runs to completion.
If you specified the default ALL or a subset of phases at the last prompt, UETP displays the following message:
How many passes of UETP do you wish to run [1]?
You can repeat the test run as many times as you want. If you enter 1 in response to the prompt (or press Return for the default), UETP stops after completing a single run. If you specify a number greater than 1, UETP restarts itself until it completes the specified number of passes.
You can run UETP once to check that the system is working, or many times to evaluate the system's response to continuous use. For example, a service technician who is interested only in verifying that a newly installed system works might run UETP once or twice. A manufacturing technician might let the system run for several hours as part of the system integration and test.
When you specify multiple UETP runs, you can request a short console log. (See Section 17.4.4.) Ensure that all line printers and hardcopy terminals have enough paper because each run requires two pages.
After you specify the number of passes, UETP prompts you as follows:
How many simulated user loads do you want [n]?
Note
UETP displays this prompt only if you choose to run the LOAD phase, either implicitly (by running all phases) or explicitly (by running a subset and specifying the LOAD phase).
The load test simulates a situation in which a number of users (detached processes) are competing for system resources. In response to this prompt, enter the number of users you want to simulate for this test. The number in brackets is the default value that UETP computed for your system. The default value depends on the amount of memory and the paging and swapping space that your system has allocated.
Although the given default value is the best choice, you can increase or decrease the user load by entering your own response to the prompt. However, be aware that an increase can cause the test to fail because of insufficient resources.
If you want to see UETP display the user-load equation as it runs, see Section 17.6.2.
The following prompt allows you to choose between long or short report formats:
Do you want Long or Short report format [Long]?
If you choose the long report format (the default), UETP sends the following information to the console terminal:
In many cases, it might not be convenient to have UETP write the bulk of its output to the terminal. For example, if you run UETP from a hardcopy terminal, the output printing can slow the progress of the tests. This delay might not be a problem if you have requested only one run; however, you might prefer to use the short format if you intend to run multiple passes of UETP from a hardcopy terminal.
If you request the short format, UETP displays status information at the console, such as error messages and notifications of the beginning and end of each phase. This information enables you to determine whether UETP is proceeding normally. If the short console log indicates a problem, you can look at the file UETP.LOG for further information. UETP.LOG contains all the output generated by the various phases, as well as the status information displayed at the console.
After you choose the report format, UETP initiates its sequence of tests and runs to completion. If UETP does not complete successfully, refer to Section 17.6 for troubleshooting information.
At the end of a UETP pass, the master command procedure UETP.COM displays the time at which the pass ended. In addition, UETP.COM determines whether UETP needs to be restarted. You can request multiple passes when you start up the test package. (See Section 17.4.2.)
At the end of an entire UETP run, UETP.COM deletes temporary files and does other cleanup activities.
Pressing Ctrl/Y or Ctrl/C lets you terminate a UETP run before it completes normally. Normal completion of a UETP run, however, includes the deletion of miscellaneous files that have been created by UETP for the purpose of testing. Using Ctrl/Y or Ctrl/C can interrupt or prevent these cleanup procedures.
The effect of these control characters depends on what part of UETP you are executing. For an explanation of the organization of UETP and its components, refer to Section 17.8.
Press Ctrl/Y to abort a UETP run. Note, however, that cleanup of files and network processes in the [SYSTEST] directory might not be complete.
If you are running an individual test image, pressing Ctrl/Y interrupts the current UETP test and temporarily returns control to the command interpreter. While the test is interrupted, you can enter a subset of DCL commands that are executed within the command interpreter and do not cause the current image to exit.
The OpenVMS User's Manual contains a table of commands that you can use within the command interpreter. In addition, you can enter any of the following commands:
Note
Using the STOP command can prevent cleanup procedures from executing normally. You should use the EXIT command if you want the image to do cleanup procedures before terminating.
If you enter any DCL command other than those that execute within the command interpreter, the test does cleanup procedures and terminates, and the DCL command executes.
Press Ctrl/C to interrupt a UETP run. You cannot continue the same test phase after you press Ctrl/C. UETP automatically goes to the next phase in the master command procedure.
Some UETP phases react to Ctrl/C by cleaning up all activity and terminating immediately. These tests display the following message when they are started:
%UETP-I-ABORTC, 'testname' to abort this test, type ^C
The phases that do not display the previous message terminate all processes they have started. These processes might not have a chance to complete normal cleanup procedures.
If you are running an individual test image, however, you can use Ctrl/C to terminate the execution of the image and complete cleanup procedures.
Note that Ctrl/C does not complete cleanup procedures for the cluster test.
This section explains the role of UETP in interpreting operational errors in an OpenVMS operating system. See Section 17.7 for a discussion of common errors that can appear in a UETP run and describes how to correct them.
When UETP encounters an error, it reacts like a user program. It either returns an error message and continues, or it reports a fatal error and terminates the image or phase. In either case, UETP assumes the hardware is operating properly and it does not attempt to diagnose the error.
If the cause of an error is not readily apparent, use the following methods to diagnose the error:
You can monitor the progress of UETP tests at the terminal from which they were started. This terminal always displays status information, such as messages that announce the beginning and end of each phase and messages that signal an error.
The tests send other types of output to various log files, depending on how you started the tests. (See Section 17.6.7.) The log files contain output generated by the test procedures. Even if UETP completes successfully, with no errors displayed at the terminal, it is good practice to check these log files for errors. Furthermore, when errors are displayed at the terminal, check the log files for more information about their origin and nature.
Each test returns a final completion status to the test controller image, UETPHAS00, using a termination mailbox. This completion status is an unsigned longword integer denoting a condition value. As a troubleshooting aid, UETPHAS00 displays the test's final completion status using the $FAO and $GETMSG system services.
Sometimes, however, the $FAO service needs additional information that cannot be provided using the termination mailbox. When this happens, UETP displays an error message similar to the following:
UETP-E-ABORT, !AS aborted at !%D
When UETP displays these types of error messages, check the log files for more information. You can also run the individual test to attempt to diagnose the problem.
The error messages that appear at the terminal and within the log files have two basic sources:
If you need help interpreting the messages, use the OpenVMS Help Message utility (Help Message) or refer either to the OpenVMS System Messages and Recovery Procedures Reference Manual or to the manual that describes the individual system component.
Several parts of UETP, such as some device tests, UETINIT00.EXE, UETCLIG00.EXE, and UETDNET00.COM, let you obtain additional information concerning the progress of the test run or the problems the test encounters. Because this information is usually insignificant, it is not displayed on the screen.
To view the information, enter the following command to define the logical name MODE and run the program:
$ DEFINE MODE DUMP
The following example shows the output for UETINIT00.EXE on a MicroVAX 3600 system:
$ RUN UETINIT00
Welcome to VAX/VMS UETP Version 7.1
%UETP-I-ABORTC, UETINIT00 to abort this test, type ^C
You are running on a MicroVAX 3600 Series CPU with 65536 pages of memory.
The system was booted from _DUA0:[SYS0.].
Run "ALL" UETP phases or a "SUBSET" [ALL]?
How many passes of UETP do you wish to run [1]?
The default number of loads is the minimum result of
1) CPU_SCALE * ((MEM_FREE + MEM_MODIFY) / (WS_SIZE * PER_WS_INUSE))
2.50 * (( 28126 + 312) / ( 1024 * 0.20)) = 347
2) Free process slots = 197
3) Free page file pages / Typical use of page file pages per process
96920 / 1000 = 96
How many simulated user loads do you want [96]?
Do you want Long or Short report format [Long]?
UETP starting at 22-JUN-1996 09:08:26.71 with parameters:
DEVICE LOAD DECNET CLUSTER phases, 1 pass, 96 loads, long report.
$
This program does not initiate any phase; it displays the equation used by UETP to determine user load and the specific factors that are employed in the current run.
Respond to the questions by pressing Return. After you respond to the first prompt, the program displays the expressions that determine the default number of simultaneous processes. The following definitions apply:
UETINIT00 also displays the specific values represented by the expressions. In this example, UETP selects 96 as the default for simulated user loads, because 96 is the minimum result of the three expressions.
You should deassign the logical name MODE before running UETP, unless you prefer to see the previous breakdown every time you run UETP.
The following example shows the output for UETINIT00.EXE on an Alpha system:
$ RUN UETINIT00.EXE
Welcome to OpenVMS Alpha UETP Version 7.1
%UETP-I-ABORTC, UETINIT00 to abort this test, type ^C
You are running on a DEC 4000 Model 610 CPU.
The system was booted from _COB3$DKA0:[SYS0.].
Run "ALL" UETP phases or a "SUBSET" [ALL]?
How many passes of UETP do you wish to run [1]?
The default number of loads is the minimum result of
1) (MEM_FREE + MEM_MODIFY) / ( WS_SIZE )
( 215696 + 11136) / ( 4000) = 56
2) Free process slots = 281
3) Free page file pages / Typical use of blocks per process
199936 / 1000 = 199
How many simulated user loads do you want [56]?
Do you want Long or Short report format [Long]?
UETP starting at 22-APR-1996 12:20:01.32 with parameters:
DEVICE LOAD DECNET CLUSTER phases, 1 pass, 56 loads, long report.
$
This program does not initiate any phase; it displays the equation used by UETP to determine user load and the specific factors that are employed in the current run.
6017P054.HTM OSSG Documentation 22-NOV-1996 14:22:35.91
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.