HP 3000 Manuals

DEMO [ System Debug Reference Manual ] MPE/iX 5.0 Documentation


System Debug Reference Manual

DEMO 

Privileged Mode 

Adds/deletes/lists terminals used for demonstrating System Debug.

Syntax 

      DEMO
      DEMO LIST
      DEMO ADD    ldevs 
      DEMO DELETE ldevs 

The DEMO command is used for giving demonstrations of System Debug.  With
this command, the user is able to enslave up to 50 terminals.  Each of
the enslaved terminals receives all input and output generated by System
Debug.  Output generated by the CI through the use of the ":" command or
CIGETVAR and CIPUTVAR functions is not sent to the enslaved terminals.

Please read and heed the warnings listed in "Limitations, Restrictions."

Parameters 

DEMO    DEMO     List the terminal LDEV's that currently are receiving
LIST             System Debug I/O. Both command forms are identically
                 supported.

DEMO ADD         This keyword tells System Debug to add the following
                 LDEVs to the list of terminals to receive a copy of all
                 System Debug I/O.

DEMO DELETE      This keyword tells System Debug to remove the following
                 LDEVs from the list of terminals that receive a copy of
                 all System Debug I/O.

 ldevs           A list of terminal LDEV numbers (logical device
                 numbers), separated by blanks or commas.  A note of
                 caution:  remember that the LDEV numbers are interpreted
                 using the current input base for System Debug.

Examples 

     $nmdat > demo 
     No demonstration terminals are defined

     $nmdat > demo add #200 #201 #205 #206 

     $nmdat > demo list 
     DEMO LDEVS (#): 200 201 205 206

First, check to see if any demonstration LDEVs have been specified.
Next, add four LDEVs to the list of terminals to receive a copy of DAT's
input and output stream.  As soon as the DEMO ADD command is processed,
the indicated terminals begin receiving I/O. Finally, display the list of
demonstration terminals.

Limitations, Restrictions 

A total of 50 demonstration LDEVs are supported.

The functionality is implemented with low-level I/O routines.  I/O is
done directly to the LDEV. No attempt is made to lock or obtain ownership
of the LDEV before sending data to it.  Nonpreemptive I/O is used when
sending data to the LDEVs.  Therefore, if a read is pending at the LDEV
(For example, the CI prompt), System Debug blocks until the pending read
is satisfied.  It is good practice to free up the LDEVs that will be used
during a demonstration by issuing the :RESTORE command at each terminal
(do not REPLY to the resulting tape request).  This removes any pending
I/O from the LDEV. When the demonstration is finished, break out of the
RESTORE process and issue an ABORT command.

No validation of LDEV numbers is performed.  If you give an ldev, then no
matter what the value is, System Debug tries to write to it!

The same LDEV may be specified more than once, in which case the LDEV is
sent a copy of any I/O for each occurrence in the list of LDEVs.

The Control-S/Control-Q/stop keys suspend output only for the master
terminal (that is, the one where the demonstration is being run).  All of
the enslaved terminals continue to receive output as an uninterrupted
flow.


CAUTION The output format of all System Debug commands is subject to change without notice. Programs that are developed to postprocess System Debug output should not depend on the exact format (spacing, alignment, number of lines, uppercase or lowercase, or spelling) of any System Debug command output.


MPE/iX 5.0 Documentation