Virtual Hometerm Subsystem (VHS) Manual (G06.24+, H06.04+, J06.03+)

Using VHS

Virtual Hometerm Subsystem (VHS) Manual—429311-002

3-11

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.

Configuring VHS Inspect Processing

To handle Inspect prompts, VHS uses a VHS Inspect file (VHSINSP) that contains

commands to execute depending on the process name, the program file name, or the

language of the application trapped into Inspect.

VHS AUTOMATIC-INSPECT-PROCESSING Parameter

The AUTOMATIC-INSPECT-PROCESSING parameter can be set to ON (true) or OFF

(false). Setting the parameter to ON causes VHS to automatically reply to the Inspect

prompt by sending the commands from the VHS Inspect file. If the parameter is set to

OFF, VHS writes the Inspect prompt to its prompt file and the user will be able to reply

to it via the Prompt Browser screen. The AUTOMATIC-INSPECT-PROCESSING

parameter can be set when starting VHS, as part of the VHS startup file (VHSSTART).

If the parameter value is not set, the default is ON.

The parameter value can also be set and changed online via the VHSCI by using the

ALTER command. The ALTER command will not have any effect on already existing

Inspect openers and subsequently for all applications that are handled by those

Inspect openers. The ALTER command will take effect only with new Inspect openers.

This means that, if a new application is trapping into Inspect and an already existing

Inspect (one already opening VHS) is handling this application, the new value of the

AUTOMATIC-INSPECT-PROCESSING parameter won’t be in effect.