Virtual Hometerm Subsystem (VHS) Manual (H06.03+)

Using VHS
Virtual Hometerm Subsystem (VHS) Manual—429311-001
3-11
Debug Prompt Processing
•
VHS extracts the name and the PID of the application from the result of the
SET P P,L command.
•
VHS extracts the language of the application trapped into Inspect from the ENV
Inspect command.
•
When Inspect prompts VHS back, VHS tries to find a match between the
application information and one of the sections from the VHS Inspect file. The VHS
Inspect file format is described later in this section.
•
If a section matched the application information, VHS sends the commands of this
particular section to Inspect. If, after executing the Inspect commands, Inspect
prompts VHS again, VHS creates a saveabend file and stops the application.
•
If none of the VHS Inspect file sections matched the application information
trapped into Inspect, VHS creates a saveabend file and stops the application.
•
Every Inspect command executed is logged in the primary log file and an EMS
event is generated only if the parameter GENERATE-INSPECT-EVENT is set
to ON.
Debug Prompt Processing
When VHS receives a Debug message, VHS logs the message as a DEBUG
message, sends the D;T;S (Display; Trace; Stop) commands to Debug, logs the result
of the commands to its primary log file, stops the application, and generates an EMS
message to the collector if the parameter GENERATE-INSPECT-EVENT is set to ON.
Application Prompt Processing
When VHS receives an application prompt (a WRITEREAD), it updates its opener
table to reflect that the last message received was a prompt and validates the text
message to ensure that no unprintable characters are present. If the parameter
ACCEPT-EXT-ASCII-CHARACTER (default is OFF) is set to ON, VHS accepts these
characters (for example, Kanji characters); if not, VHS converts these characters into
question marks (?). Next, it adds a timestamp to the message and writes it to its
current primary log file and to the prompt file. It then, if the parameter GENERATE-
PROMPT-EVENT is set to ON, generates an EMS message with the ZEMS-TKN-
TEXT token containing the prompt message received from the user application.
Reply Message Processing
When VHS receives a reply message, it sends the reply message to the application,
logs the reply text in its log file, and then deletes the application prompt from its prompt
file. VHS generates an EMS message to the collector if the parameter GENERATE-
PROMPT-EVENT is set to ON.