QL 1000
Series
Chapter 7 - QLVision
QLVision is a management system that lets administrators monitor and control Cubix QL Series communication products.
To use QLVision, the following system requirements must be met:
QLVision must be run on a NetWare workstation or nondedicated server with a minimum of 640K RAM. QLVision should not be run on a non-dedicated router. The NetWare version must be 2.15 or higher. The QLRCV TSR program (provided by Cubix) must be loaded on each QL node monitored by QLVision. The QL nodes to be managed must be operating with Cubix drivers version 1/A/4 or higher. On NetWare 386 servers, the Cubix Trap Socket Server NLM must be loaded. The QLVision management tool requires NetWare supervisory rights. QLVision supports, but does not require, a mouse.
To start QLVision, type QLVISION [enter].
The following functions are available from the QLVision Main Menu:
File Server / Router Selection
This selection displays a list of all file servers and routers in which QL nodes are installed.
QL Node Functions
This selection provides real time information on each of the selected QL nodes. It can connect to, or reset, a remote QL node.
File Server / Router Diagnostics
This selection monitors the QL server for communication information.
Deadman Timer
This selection monitors QL nodes for activity and automatically resets a node if it becomes non-functional.
Historical Log
This selection describes QL node activity over time.
QLVision Help
This selection provides detailed information on all QLVision functions.
Exit to DOS
This function terminates the QLVision session.
At any time during the QLVision session, press
Remember to select a file server or router before trying to perform any monitoring or management functions.
If a file server or router that has QL nodes installed does not appear on the File Server / Router Selection screen, verify that it has version 1/A/4 or higher Cubix drivers installed. If the device is a NetWare 386 server, verify that the Cubix Trap Socket Server NLM is loaded.
The following programs let you obtain some of the same information that is available through QLVISION, but you can do so from the DOS command line without using the QLVISION menus.
QLCONN.EXE and QLRCV.COM (QL Connect and Receive)
These two programs let you view a QL Series processor as if you were connected to it with a monitor and keyboard. The QL processor loads QLRCV.COM as part of its default batch file (QLUSER.BAT) in the \LOGIN subdirectory. The QLCONN.EXE program lets you connect to any QL workstation that has QLRCV.COM loaded.
To connect to a QL workstation that has QLRCV.COM loaded, type:
QLCONN xxx [enter] (where xxx is the QL Node number) or QLCONN -N xxx zzz [enter] (where xxx is the QL Network address and zzz is the QL Node number).
To disconnect from a connected workstation, simultaneously press:
[CTRL] [LEFT SHIFT]
These utility programs were designed as installation and troubleshooting aids. They could also be used for other applications such as starting batch jobs on unattended processors.
QLDWS.EXE
This utility program shows the status of all QL Processors. The screen displays the following information:
ADDR The node number for each QL Series Processor. TYPE The board type for the QL processor. PRESENT Shows that the file server recognizes the QL processor (QL Series LAN drivers loaded). ACTIVE Shows UP when the QL processor has successfully booted and executed IPX from its image file. STATUS This field shows the status of the QL processor.
Command Line Parameters
QLDWS [-N] [enter] If there are more than 20 QL processors, you can use the DOS MORE command to display one screen at a time. For example, type: QLDWS -N 71 |MORE [enter] This command displays the status of all the QL processors on the file server with network address 71, and pauses at the end of each page of display.
QLRESET.EXE
This utilitiy program lets you reset one or several processors.
Command Line Parameters
QLRESET [-N] xxx [xxx . . . ] [enter] where xxx is a QL node number. For example: QLRESET -N 71 290 292 [enter] resets ports 290 and 292 on the file server at network address 71.
QLSERVER.EXE
This utility displays a list of the Cubix trap socket servers on the network. The screen displays the following information:
NAME The name of the server IPX ADDRESS The net address, node number, and socket of the server
This utility can be used to determine the address parameter required by some of the other QL utilities.
NOTE: The first server listed is used as a default by the QL utilities when no explicit net address is specified.
QLPING.EXE
This utility tests communications between two network nodes by transmitting and receiving PING IPX packets.
Command Line Parameters
QLPING [<196>N] [-q] xxx (where xxx is a QL node number).
Without the -q option, QLPING continues to transmit and receive IPX packets to and from
the specified node until you enter
The -q option causes QLPING to transmit only one packet to the node, and wait for its response. QLPING with the -q option will return a DOS ERRORLEVEL value of 0 (if PING is successful), 1 (for a command line syntax error), or 2 (if PING is unsuccessful). You can use this in a batch file as follows:
QLPING <196>n 650 <196>q 1 IF ERRORLEVEL 1 GOTO RESET ECHO PING SUCCESSFUL GOTO END :RESET ECHO PING UNSUCCESSFUL QLRESET <196>n 650 1 :END ECHO END OF VERIFICATION
The QL Series utilities can generate the following error messages.
Error 0xXX returned by IPX Initialize This error is returned by IPX. An 0xF0 code means that IPX is not loaded yet.
Error 0xXX opening an IPX socket An IPX socket cannot be opened. This should only occur if the user has the maximum number of sockets open. This can be remedied using NetWare's SHELL.CFG.
No Cubix servers available No Cubix file servers or bridges can be found on the network.
Cubix network <
Cubix network <
Timeout on receive The program issued a request to a Cubix Server or Bridge, and the response did not return within a predetermined amount of time.
Error 0xXX on Receive Error code XX was returned by IPX while waiting for a response from a Cubix server or bridge.
Usage: . . . This error (specific to each utility) is returned when the program does not recognize the command line options. (Syntax Error.)
Invalid Workstation (or workstations) specified. (QLCONN) A processor number was entered that is less than 100 or greater than 300. Valid Cubix processor numbers are 120 to 2D0.
Only x of 9 receives have completed. (QLCONN) Generally indicates the program QLRCV is not resident on the processor to which you are attempting to connect. It can also mean incompatible video mode.
No Cubix workstations on server <
No Cubix workstations on server <
Workstation xxx has not been reset. (QLRESET) This message is displayed for each processor that could not be reset. This will occur if you attempt to reset a processor that does not exist on the specified Cubix server.
This document, and all Web contents, Copyright © 1997
by Cubix Corp., Carson City, NV, USA.