Section 13: LPT library function reference
Model 4200A-SCS Parameter Analyzer Reference Manual
13-100
4200A-901-01 Rev. C / February 2017
pulse_exec_status
This command is used to determine if a test is running or completed.
Usage
int pulse_exec_status(double *
elapsedt
);
elapsedt
Name of the user-defined pointer for elapsed time
Pulsers
4220-PGU
4225-PMU
Pulse mode
Standard and Segment Arb
Details
This command is required to determine when a test is complete or what is occurring during a test.
The return value indicates whether the test is still running (
PMU_TEST_STATUS_RUNNING
or
1
) or
completed (
PMU_TEST_STATUS_IDLE
or
0
). The primary use of this command is to ensure that the
test is completed before fetching PMU data or ending the test.
The elapsed time is the Clarius test time, not the PMU or VPU card test time. For short test times, the
returned elapsed time will be longer than the actual time required on-card.
This command is typically used in a
while
loop to allow the test to finish before retrieving the data
using the
pulse_fetch
command.
It is the responsibility of the user test module (UTM) programmer to ensure that the pulse test is
complete before exiting the UTM. If the UTM program ends before the test is complete, Clarius
responds with two messages. These messages are displayed in the Clarius messages area:
1. Five seconds after the UTM ends prematurely (before the pulse test is finished), the message
"
UTMname
ended before the test was complete. Waiting for test to finish (max wait = 5 minutes)"
is displayed.
2. Clarius continues to wait for the UTM to finish, interrupting further test execution.
3. After the default of five minutes, the UTM is terminated and the following message is displayed,
"
UTMname
did not finish before the maximum wait period. UTM aborted."
4. After this five minute wait, Clarius releases control to the user interface or to the next test in the
project (if using repeat executing or looping).