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

Using VHS
Virtual Hometerm Subsystem (VHS) Manual—429311-002
3-19
Using VHS With a ViewPoint Filter
The system displays all the applications that use the specified VHS process as
home terminal. For example:
2. Stop any applications that use VHS as a home terminal.
3. To ensure that no applications open a VHS process, use the LISTOPENS
command in VHSCI:
-> LISTOPENS
VHS W00201 No process currently open VHS server
Probable Cause
There is no process that actually opens the VHS server.
Recommended Action
This is a warning. No action is necessary.
4. When the LISTOPENS command shows that no processes are opening VHS, then
stop VHS by typing this TACL command:
3> STOP $VHS
Using VHS With a ViewPoint Filter
VHS sends all messages it receives to the EMS collector $0. You can highlight the
VHS messages so that critical or action-event messages can be easily identified on the
ViewPoint console.
When your application is not instrumented with EMS, you need to analyze the
messages to determine the keywords that ViewPoint should highlight. For example,
many applications use these keywords to indicate when operator intervention is
needed:
•
Error
•
Abend
•
Abnormal
•
Unsuccessful
For a sample ViewPoint filter used to highlight application messages, see Appendix I,
ViewPoint Event Filter.
Process Pri PFR %WT Userid Program file Hometerm
$ZATM 0,82 170 005 215,4 $SYSTEM.SYSTEM.ATM VHS
$Z798 0,127 150 001 215,4 $SYSTEM.SYSTEM.ATM $VHS
$Z801 0,145 160 001 215,4 $SYSTEM.SYSTEM.INVC $VHS
$OMFN 0,151 160 001 215,4 $SYSTEM.SYSTEM.INVC $VHS
Caution. If any application has used the NonStop procedure MYTERM to get the home
terminal name, but has not yet opened the home terminal, the application might later fail. This
situation cannot be detected by VHS. One way to detect this condition is to do a STATUS *,
TERM $vhs-process at the TACL prompt.