This call is called by the Session Manager when the operator presses Ctrl and PrtSc.
VioPrtScToggle
VioHandle (HVIO) - input
VioPrtScToggle toggles the Ctrl and PrtSc state of the foreground session. When the Ctrl and PrtSc state is on, all VioWrtTTY calls from that session are echoed to the print device.
VioPrtScToggle can only be called by the session manager. If an application issues this call, it receives an error code.
Three beeps are generated if a hard error is detected while writing to the printer. When Ctrl and PrtSc is turned off, the operator may have to press the Enter key to cause output spooled while Ctrl and PrtSc was active to be printed. This is because the spool files are closed when the next VioWrtTTY is executed in the session, such as writing the prompt in response to the Enter key.