HP 3000 Manuals HP 3000 Manuals
Chapter 2 SYSTEM INFORMATION
MPE XL User Interface Enhancements
by Glenna Gorker, Information Software Division
On XL Release 1.1, several new enhancements have been made to the user
interface. A new command, :ERRDUMP, has been added; the :LISTF and
:PRINT commands have been enhanced; the system variables were extended to
include four new variables: HPErrdump, HPSchedjobs, HPWaitjobs, and
HPSuspjobs. Additional information on all commands and variables have
been documented in detail in the MPE XL Commands Reference Manual (P/N
32650-60002).
:ERRDUMP, A NEW COMMAND IS ADDED
The :ERRDUMP command was added primarily for system debugging purposes.
The syntax for :ERRDUMP is :
:ERRDUMP [ depth ] [ ;SYS ]
:ERRDUMP dumps the process or system error stack to the depth you
specify. On MPE XL, much of the operating system code uses the error
stacks as a way of recording warnings or errors in system operation.
Thus, if errors are being printed on the console, or the system is not
behaving as one might expect, the :ERRDUMP command can be used to obtain
more information on the possible causes of the problem. It can be used
to write a better problem description in a service request, or it could
be used by your local support personnel.
:LISTF COMMAND ENHANCED
The :LISTF command has been extended to include option 6 which allows you
to obtain a list of all files fully qualified. Thus, if you simply want
a list of file names, you need no longer be dependent on other :LISTF
output formats. This new :LISTF feature also allows you to reduce data
from a larger :LISTF listing without writing a program. For example :
:LISTF f@,6 produces
FEU.PUB.SYS
FIREFLY.PUB.SYS
FLAKE.PUB.SYS
FOOBAR.PUB.SYS
:PRINT COMMAND ENHANCED
The :PRINT command has been extended to use $STDINX as the default
filename if none is supplied. On prior releases, you were required to
explicitly specify a file name when the :PRINT command was used. Now, if
you simply wish to input data into a file from the terminal you can do so
by using this convenient default.
SYSTEM VARIABLE SET IS ENHANCED
Four new variables were added to the system variable set : HPErrdump,
HPSchedjobs, HPWaitjobs, and HPSuspjobs.
HPErrdump
The HPErrdump variable allows you to specify to what depth the process
error stack should be dumped (printed) after a Command Interpreter (CI)
command fails for any reason. HPErrdump may be assigned any value from
-1 to 16. 0 is the default value. -1 dumps the entire error stack. All
values from 1 to 16 indicate the depth to which the error stack should be
dumped; e.g., if HPErrdump is set to 1 and an error occurs on a command,
then only the top error message on the process error stack will be
printed. If the value of HPErrdump is greater than the number of errors
on the error stack, then all messages on the error stack will be printed,
with no warning or error.
HPSchedjobs
The HPSchedjobs variable contains the number of jobs currently
scheduled-by-time (in SCHED state). The value of HPSchedjobs will change
as the number of jobs in SCHED state changes. This variable is not
user-modifiable.
HPSuspjobs
The HPSuspjobs variable contains the number of jobs currently suspended
(in SUSP state ). The value of HPSuspjobs will change as the number of
jobs in SUSP state changes. This variable is not user-modifiable.
HPWaitjobs
The HPWaitjobs variable contains the number of jobs currently waiting (in
WAIT state) to log on to the system. The value of HPWaitjobs will change
as the number of jobs in WAIT state changes. This variable is not
user-modifiable.
Use of Job State Variables
The job state variables can be used to help automate operator tasks. For
example, the operator can now execute the following command file to
suspend all currently executing jobs before the daily backup, and resume
them after the backup has completed:
IF HPExecjobs <> 0 THEN
RUN BREAKJOB.PUB.SYS
ENDIF
FILE T;DEV=TAPE
STORE @.@.@;*T;SHOW
IF HPSuspjobs <> 0 THEN
RUN RESUMJOB.PUB.SYS
ENDIF
Note that this command file assumes that BREAKJOB and RESUMJOB are
programs to suspend all executing jobs and to resume all suspended jobs.