Stopping PV-WAVE
The most direct way to stop PV‑WAVE is to type EXIT or QUIT at the WAVE> prompt. Other more complicated methods of stopping include aborting, suspending, and interrupting.
Exiting PV-WAVE
When you exit PV‑WAVE, you are returned to the operating system prompt. Variable assignments are lost unless you saved them yourself by saving the session; however, data that is buffered for open output files is flushed to these files before exiting is complete.
Exiting on a UNIX System
If you type EXIT or QUIT at the WAVE> prompt, you will exit back to the operating system. Entering a <Control>-D as the first character on the command line performs the same function. If the <Control>-D is not the first character on the command line, it simply ends the input line as if a <Return> had been entered.
Suspending PV-WAVE
When you suspend PV‑WAVE, you are returned to the operating system prompt; however, PV‑WAVE is still running as a background process. All variables and their values are saved.
Suspending PV‑WAVE on a UNIX System
<Control>-Z is the UNIX suspend character. It stops a process and places it in the background. Typing the suspend character suspends PV‑WAVE and returns you to the shell process where you can enter commands. Type fg to return PV‑WAVE to the foreground.
note | <Control>-C will not halt PV-WAVE while executing I/O or graphics routines. |
Interrupting a PV‑WAVE Command
<Control>-C is the interrupt character. Typing the interrupt character generates a keyboard interrupt. Under UNIX, the interrupt character can be changed by you outside of PV‑WAVE. This is rarely done, so for the purposes of this manual, we assume the default convention.
When you type <Control>-C at the WAVE> prompt, the following message is displayed:
% Interrupt encountered.
When the interpreter regains control, you are returned to the WAVE> prompt. You can continue after interrupting PV‑WAVE with the .CON executive command. For more details about using executive commands such as .CON to control programs, see the PV‑WAVE Reference.
Aborting PV-WAVE
When you abort PV‑WAVE, a message appears, such as quit (core dumped) and you are returned to the operating system prompt. Remove the core file before re-entering PV‑WAVE.
Aborting on a UNIX System
As with any UNIX process, PV‑WAVE may be aborted by typing <Control>-\.
note | This is a very abrupt exit—all variables are lost, and the state of open files will be uncertain. Thus, although it can be used to get out of PV‑WAVE in an emergency, its use should be avoided. |
After aborting PV‑WAVE in a UNIX environment, you may find that your terminal is set up improperly. You can restore the proper settings for your terminal by issuing the UNIX command:
% reset
or
% stty echo -cbreak
Version 2017.0
Copyright © 2017, Rogue Wave Software, Inc. All Rights Reserved.