Support Home Page
Cubix Home Page
Feedback Forms

QL 1000 Series
Chapter 7 - QLVision


QLVision is a management system that lets administrators monitor and control Cubix QL Series communication products.


System Requirements

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.


Functions

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.


Helpful Hints

At any time during the QLVision session, press for help with the current function. All QLVision help screens are context-sensitive.

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.


QL Utilities Command Line Programs

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 C from the keyboard. Each time a packet is received, the screen displays a message.

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


QL Utilities Error Messages

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 <> is not available. A Cubix Server, matching the network number specified on the command line, cannot be found.

Cubix network <> is not available A Cubix Server, matching the server name specified on the command line, cannot be found.

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 <> (QLDWS) This message is returned when the Cubix server indicates that it has no processors present.

No Cubix workstations on server <> (QLRESET) Use QLRESET -N <> <> to reset each processor. This error message is returned when the Cubix server indicates that it has no processors present.

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.