HP 3000 Manuals

Controlling System Peripherals [ Controlling System Activity ] MPE/iX 5.0 Documentation


Controlling System Activity

Chapter 4  Controlling System Peripherals 

System Operator Tasks 

When a system is installed, certain required devices are installed and
configured.  The system manager typically adds, modifies and deletes
devices by using the configurators that run in the SYSGEN utility.  Refer
to System Startup, Configuration, and Shutdown Reference Manual 
(32650-90042).  The operator and sometimes the general user, can use a
variety of commands to control peripheral devices.  These are explained
in this section.  For more detail, refer to Guide for the New System 
Operator (32650-90137).

Changing Batch Job Priority 

In the following example, the system operator issues JOBPRI 0, CS. This
command with its accompanying parameters raises the maximum execution
priority so that batch jobs can run at any subqueue requested.  If no
priority is specified in the batch job, the priority defaults to CS.

     JOBPRI 0,CS

Listing Input and Output Spoolfiles 

The LISTSPF command will list all input and output device files.

LISTSPF Syntax 

       [          {spoolid                }]
LISTSPF[[IDNAME=] {(spoolid [,spoolid]...)}]
[          {[select-eq]  }] [;DETAIL]
[[;SELEQ=] {^indirectfile}] [;STATUS]

          Table 4-1.  LISTSPF Parameters 

--------------------------------------------------------------------------------------------
|                |                                                                         |
|   Parameter    |                               Description                               |
|                |                                                                         |
--------------------------------------------------------------------------------------------
|                |                                                                         |
| spoolid        | One or more spoolfile IDs:  #Innnn for input spoolfiles or %Onnnn for   |
|                | output spoolfiles.  These IDs are assigned by the spooling subsystem at |
|                | spoolfile creation time.  The # is optional.  The O is optional if you  |
|                | are displaying the output spoolfiles; if neither [#]O nor [#] is        |
|                | specified, then [#]O is assumed.                                        |
|                |                                                                         |
|                | The symbol @ may be used to specify all spoolfiles.                     |
|                |                                                                         |
|                | The symbol O@ may be used to specify all output spoolfiles.             |
|                |                                                                         |
|                | The symbol I@ may be used to specify all input spoolfiles.              |
|                |                                                                         |
|                | If @, O@, or I@ is specified, it must be the only value supplied.  @,   |
|                | O@, and I@ are mutually exclusive.                                      |
|                |                                                                         |
|                | The default is all the spoolfiles created by the current user.account.  |
|                | The default spool indentification for the console user is all the       |
|                | spoolfiles on the system.                                               |
|                |                                                                         |
| select-eq      | The selection equation is used as a filter on the set of spoolfiles     |
|                | selected.  Only spoolfiles whose attributes satisfy all filter          |
|                | requirements is listed.                                                 |
|                |                                                                         |
| ^indirectfile  | Specifies the name of a file containing the selection equation.  The    |
|                | equation must be preceded by a caret (^).  The selection equation       |
|                | contained in the file may not exceed 277 characters in length,          |
|                | including the brackets in which it must reside.  There is no            |
|                | restriction on the indirect file code.  If the record size exceeds 277, |
|                | only 277 characters per record are read and a warning is issued.        |
|                | Backreferencing to a formal file designator is also allowed for an      |
|                | indirectfile name.  Any file will be accepted as an indirectfile,       |
|                | unless the file system returns an error from FOPEN, or FREAD.           |
|                |                                                                         |
| DETAIL         | Produces a two line description of the specified spoolfiles.  The       |
|                | default is a one line display.                                          |
|                |                                                                         |
| STATUS         | LISTSPF, by default, displays a listing of selected spoolfiles,         |
|                | followed by a statistical summary of those spoolfiles, known as the     |
|                | STATUS display.  The STATUS option is ignored if it is used in          |
|                | combination with any other parameters.                                  |
|                |                                                                         |
--------------------------------------------------------------------------------------------

To list all input spoolfiles, enter:

     LISTSPF I@ 

The screen displays:
_____________________________________________________________________
|                                                                   |
|                                                                   |
|      DEV/CL  DFIN  JOBNUM  FNAME   STATE  FRM SPACE RANK PRI #C   |
|      25      #I16  #S14    $STDIN  OPENED                         |
|      43      #I14  #S13    $STDIN  OPENED                         |
|      34      #110  #S12    $STDIN  READY                          |
|                                                                   |
|      3 FILES:                                                     |
|      0 ACTIVE                                                     |
|      1 READY; INCLUDING 1 SPOOFLES, 0 DEFERRED                    |
|      2 OPENED; INCLUDING 0 SPOOFLES                               |
|      0 LOCKED; INCLUDING 0 SPOOFLES                               |
|      1 SPOOFLES: 4 SECTORS                                        |
|                                                                   |
_____________________________________________________________________

Device files #I16, #114 and #I10 are session input device files on
logical device 25, 43, and 34 respectively.

Output Device Files 

An output device file contains data from a user program which is directed
to devices such as line printers or tape drives.  Output device files
fall into three categories:  standard list device files used by jobs and
sessions, other output device files created by job and sessions, and
operator-assigned device files.

Job/Session List Device Files 

When the system is first configured, each job or session accepting device
is assigned a corresponding default standard output device.  There is
exactly one such output device file assigned to each executing job and
session, which assumes the system-defined file name $STDLIST. For
example, the standard output device for sessions is a terminal.  (Since
sessions are interactive, the standard input device file, $STDIN, and
standard output device file, $STDLIST are always the same logical
device.)

Redirecting Output to Another Device 

Users may redirect output, which would normally appear on the $STDLIST
device, to another logical device or device class.  When running a
program, this is done with file equations, which use the FILE command to
equate a file name with a device, or a system-defined file name
(representing a device) with a user-defined file.  For example, the
LISTEQ command lists the file equations in use during the current
session.  By default, the information is displayed on your terminal.  To
redirect the output to device class LP, enter:

     FILE LIST;DEV=LP 
     LISTEQ *LIST 

Another method of redirection is:

     RUN myprog;STDLIST=myfile 

Listing Output Device Files 

To list the output device files and spoolfiles known to MPE, issue the
LISTSPF command, illustrated below:

     LISTSPF O@ 

The screen displays:
____________________________________________________________________
|                                                                  |
|                                                                  |
|      DEV/CL  DFID   JOBNUM  FNAME    STATE FRM SPACE RANK PRI #C |
|      PP      #O12   #J4     $STDLIST OPENED      2048      8   1 |
|      PP      #O24   #S11    BASLIST  OPENED      2048    D 0   1 |
|      PP      #O80   #S24    PP       READY       2048    D 0   1 |
|      19      #O131  #S21    SLP      ACTIVE      1408      8   1 |
|         41 FILES:                                                |
|          1 ACTIVE                                                |
|          3 READY; INCLUDING 3 SPOOFLES, 3 DEFERRED               |
|          37 OPENED; INCLUDING 7 SPOOFLES                         |
|          0 LOCKED; INCLUDING 0 SPOOFLES                          |
|          11 SPOOFLES:  19948 SECTORS                             |
|          OUTFENCE = 6                                            |
|                                                                  |
____________________________________________________________________

Controlling Device Availability 

As operator, you can control which peripheral devices are available to
users, and which are not.  The DOWN command makes a device unavailable
(called "downing a device"), while the UP command brings it back up.  Any
device, except the system console or system disk drive, can be downed.

For example, to take a tape drive (identified as logical device 7) down,
enter:

     DOWN 7 

To bring a device back up, enter:

     UP 7 

To determine that the device is again available, check its status with
the SHOWDEV command.  If it is, AVAIL will be displayed in the second
column of the listing.

     SHOWDEV 

The screen displays:
_____________________________________________________________________
|                                                                   |
|                                                                   |
|      LDEV   AVAIL   OWNERSHIP   VOLID   DEN   ASSOCIATION         |
|                                                                   |
|      7      AVAIL                                                 |
|                                                                   |
_____________________________________________________________________

Operator Control of Request for Device Services 

Certain device services must be provided by the system operator.  These
include mounting forms and changing paper on printers and mounting tapes.
Forms and paper requests are described later in this chapter.  Tape
requests are described below.

If users select a magnetic tape as the output device class for their job
or session, you must REPLY to the request.  Until you respond, their
program (which needs the device for output) will remain suspended unless
the tape device is configured with AUTOREPLY.

A user's request for a device class will generate a console message
similar to the following:

?8:32/#S5889/192/LDEV# FOR "T" ON TAPE (NUM)?

In this example, Session #5889 (#S5889) is requesting the use of a tape
drive in device class TAPE. To respond, send a message (via the REPLY
command) to the user's process, identified by the process identification
number, or pin.  (The pin is always the number which follows the second
slash mark (/) in the request.  In the example, the pin is 192.)  Your
reply may either grant the user access to a device in the class
identified by the device class name, or inform the user that no device is
available.  For example, to respond to the request by assigning logical
device 7 to pin 192, enter:

     REPLY 192,7 

To tell the user that no device is available, respond:

     REPLY 192,0 

This way, the user can request the device at a later time, rather than
remain suspended indefinitely.  Note that if the user has requested a
device class you may assign any available logical device in the class.
However, if the request is for a specific tape drive, identified by its
logical device number, you may assign the device if or when it becomes
available.



MPE/iX 5.0 Documentation