HP e3000 Installation manual

HP 3000 Series 9X8LX Computer Systems
Commands Reference
ABCDE
HP Part No. B3813-90011
Printed in USA 1994
First Edition
E0494

The information contained in this document is sub ject to c
hange
without notice.
Hewlett-Packard makes no warrantyof any kind with regard to this
material, including, but not limited to, the implied w
arranties of
merchantability or tness for a particular purpose. Hewlett-P
ackard
shall not be liable for errors contained herein or for direct, indirect,
special, incidental or consequential damages in connection with the
furnishing or use of this material.
Hewlett-Packard assumes no resp onsibilit y for the use or reliabilit
yof
its software on equipment that is not furnished by Hewlett-Packard.
This do cument contains proprietary information which is protected
by copyright. All rights are reserved. Reproduction, adaptation, or
translation without prior written p ermission is prohibited, except as
allowed under the copyrightlaws.
Copyright
c
 1994 by Hewlett-Packard Company
Use, duplication, or disclosure by the U.S. Government is sub ject
to restrictions as set forth in subparagraph (c) (1) (ii) of the
Rights in Technical Data and Computer Software clause at DFARS
252.227-7013. Rights for non-DoD U.S. Government Departments and
agencies are as set forth in FAR 52.227-19 (c) (1,2).
Hewlett-Packard Company
3000 Hanover Street
Palo Alto, CA 94304 U.S.A.
Restricted Rights Legend

Printing History
The following table lists the prin
tings of this do cumen
t, together with the
respective release dates for eac
h edition. The softw
are version indicates the
version of the software pro duct at the time this do cumen
twas issued. Many
pro duct releases do not require c
hanges to the do cumen
t. Therefore, do not
expect a one-to-one corresp ondence bet
ween pro duct releases and do cumen
t
editions.
Edition Date Software
Version
First Edition April 1994 B.50.00
iii

In This Book
This b o ok pro
vides a detailed explanation of eac
h command in this subset of
MPE/iX commands.
Chapter 1: Introduction to Command Parameters
This chapter provides introductory information on command
syntax and organization.
Chapter 2: MPE/iX Commands
This chapter provides reference information for all of the
primary MPE/iX commands. The commands are arranged in
alphab etical order.
Related Manuals
The Commands Reference is the fourth b o ok in a set of v
e manuals that
includes the following:
Understanding Your
System (B3813-90001)
If you are new to computers, this is a go o d place to
start. It provides an introduction to what computers do
and how they do it.
Getting Started
(B3813-90003)
Familiarizes you with your computer and computer
peripherals. It also explains how to get your system
ready for use, how to use and maintain your tap e drives
and how to communicate with your system using HP
Easytime/iX.
Task Reference
(B3813-90009)
Describ es how to communicate with your system using
MPE/iX commands. This bo ok also includes a chapter
on how to get more information on your system, a
chapter on troublesho oting and a glossary.
iv

New Features of
MPE/iX: Using the
Hierarchical File
System (32650-90351)
Describ es the changes to MPE/iX as of Release 4.5
and 5.0, which enhanced MPE/iX to mak
e it \POSIX
compatible." The b o ok also describes the features of
the hierarchical le system.
Note
The MPE/iX op erating system has b een enhanced as of Release
4.5 and 5.0 to include additional features that include POSIX
compatibility and the hierarchical le system . The hierarchical
le system is tree structured and can con
tain les at many
dierent levels. This organization provides a sp ecial kind of le
called a directory . Instead of holding data, directories con
tain
lists of les and p ointers to those les.
For more information on POSIX and the hierarchical le
system , refer to the bo ok, New Features of MPE/iX: Using
the Hierarchical File System (32650-90351), included in this
documentation set. This b o ok includes an o
verview of the
following enhancements of MPE/iX as of Release 4.5 and 5.0:
Open systems environment
Hierarchical le system (HFS)
Expanded le naming syntax
New and enhanced commands and utilities
v

Contents
1. Introduction to Command Parameters
Parameters within Syntax . . . . . . . . . . . . . . . . . 1-2
Required parameters . . . . . . . . . . . . . . . . . . 1-2
Optional parameters . . . . . . . . . . . . . . . . . . 1-2
Positional parameters . . . . . . . . . . . . . . . . . . 1-3
2. MPE/iX Commands
ABORTJOB/ 4
Ctrl
5 A ABORTJOB . . . . . . . . . . . . . . 2-2
ALLOW. . . . . . . . . . . . . . . . . . . . . . . . . 2-6
ALTACCT . . . . . . . . . . . . . . . . . . . . . . . . 2-11
ALTFILE . . . . . . . . . . . . . . . . . . . . . . . . 2-16
ALTGROUP . . . . . . . . . . . . . . . . . . . . . . . 2-19
ALTSEC . . . . . . . . . . . . . . . . . . . . . . . . . 2-23
ALTUSER . . . . . . . . . . . . . . . . . . . . . . . . 2-34
BREAKJOB . . . . . . . . . . . . . . . . . . . . . . . 2-38
BYE . . . . . . . . . . . . . . . . . . . . . . . . . . 2-40
CHDIR . . . . . . . . . . . . . . . . . . . . . . . . . 2-42
CHGROUP . . . . . . . . . . . . . . . . . . . . . . . 2-46
COMMENT . . . . . . . . . . . . . . . . . . . . . . . 2-48
CONSOLE . . . . . . . . . . . . . . . . . . . . . . . . 2-50
CONTINUE . . . . . . . . . . . . . . . . . . . . . . . 2-52
COPY . . . . . . . . . . . . . . . . . . . . . . . . . . 2-53
DISCUSE (UDC) . . . . . . . . . . . . . . . . . . . . . 2-57
DISKUSE . . . . . . . . . . . . . . . . . . . . . . . . 2-59
EDITOR . . . . . . . . . . . . . . . . . . . . . . . . 2-68
EOJ . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-71
FCOPY . . . . . . . . . . . . . . . . . . . . . . . . . 2-73
FILE . . . . . . . . . . . . . . . . . . . . . . . . . . 2-76
HELLO . . . . . . . . . . . . . . . . . . . . . . . . . 2-82
HELP . . . . . . . . . . . . . . . . . . . . . . . . . . 2-87
Contents-1

JOB . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-96
JOBFENCE . . . . . . . . . . . . . . . . . . . . . . . 2-103
LIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . 2-106
LISTACCT . . . . . . . . . . . . . . . . . . . . . . . 2-109
LISTFILE . . . . . . . . . . . . . . . . . . . . . . . . 2-112
LISTGROUP . . . . . . . . . . . . . . . . . . . . . . . 2-135
LISTSPF . . . . . . . . . . . . . . . . . . . . . . . . 2-138
LISTUSER . . . . . . . . . . . . . . . . . . . . . . . . 2-148
NEWACCT . . . . . . . . . . . . . . . . . . . . . . . 2-150
NEWDIR . . . . . . . . . . . . . . . . . . . . . . . . 2-155
NEWGROUP . . . . . . . . . . . . . . . . . . . . . . 2-158
NEWLINK . . . . . . . . . . . . . . . . . . . . . . . . 2-162
NEWUSER . . . . . . . . . . . . . . . . . . . . . . . 2-170
OUTFENCE . . . . . . . . . . . . . . . . . . . . . . . 2-173
PASSWORD . . . . . . . . . . . . . . . . . . . . . . . 2-177
PRINT . . . . . . . . . . . . . . . . . . . . . . . . . 2-178
PURGE . . . . . . . . . . . . . . . . . . . . . . . . . 2-181
PURGEACCT . . . . . . . . . . . . . . . . . . . . . . 2-184
PURGEDIR . . . . . . . . . . . . . . . . . . . . . . . 2-186
PURGEGROUP . . . . . . . . . . . . . . . . . . . . . 2-194
PURGELINK . . . . . . . . . . . . . . . . . . . . . . 2-196
PURGEUSER . . . . . . . . . . . . . . . . . . . . . . 2-198
RECALL/ 4
Ctrl
5 A RECALL . . . . . . . . . . . . . . . . . 2-200
RELEASE . . . . . . . . . . . . . . . . . . . . . . . . 2-202
RENAME . . . . . . . . . . . . . . . . . . . . . . . . 2-204
REPLY/ 4
Ctrl
5 A REPLY . . . . . . . . . . . . . . . . . . 2-206
REPORT . . . . . . . . . . . . . . . . . . . . . . . . 2-209
RESTORE . . . . . . . . . . . . . . . . . . . . . . . . 2-213
RESUME . . . . . . . . . . . . . . . . . . . . . . . . 2-227
RESUMEJOB . . . . . . . . . . . . . . . . . . . . . . 2-229
RUN . . . . . . . . . . . . . . . . . . . . . . . . . . 2-231
SECURE . . . . . . . . . . . . . . . . . . . . . . . . 2-236
SETCLOCK . . . . . . . . . . . . . . . . . . . . . . . 2-238
SHOWCLOCK . . . . . . . . . . . . . . . . . . . . . . 2-246
SHOWDEV . . . . . . . . . . . . . . . . . . . . . . . 2-247
SHOWJOB . . . . . . . . . . . . . . . . . . . . . . . 2-251
SHOWME . . . . . . . . . . . . . . . . . . . . . . . . 2-258
SHOWTIME . . . . . . . . . . . . . . . . . . . . . . . 2-261
Contents-2

SPOOLER . . . . . . . . . . . . . . . . . . . . . . . . 2-262
SPOOLF . . . . . . . . . . . . . . . . . . . . . . . . 2-270
STORE . . . . . . . . . . . . . . . . . . . . . . . . . 2-277
STREAM . . . . . . . . . . . . . . . . . . . . . . . . 2-289
STREAMS . . . . . . . . . . . . . . . . . . . . . . . . 2-297
SYSGEN . . . . . . . . . . . . . . . . . . . . . . . . 2-299
TELL . . . . . . . . . . . . . . . . . . . . . . . . . . 2-302
TELLOP . . . . . . . . . . . . . . . . . . . . . . . . 2-305
WARN . . . . . . . . . . . . . . . . . . . . . . . . . 2-307
WELCOME . . . . . . . . . . . . . . . . . . . . . . . 2-309
XEQ . . . . . . . . . . . . . . . . . . . . . . . . . . 2-311
Index
Contents-3

Figures
2-1. Hierarchical Directory Structure . . . . . . . . . . . . . 2-62
2-2. DISKUSE Output Format . . . . . . . . . . . . . . . . 2-63
2-3. Example File System . . . . . . . . . . . . . . . . . . 2-125
Tables
2-1. Primary EDIT/3000 Commands . . . . . . . . . . . . . 2-69
2-2. Format Options . . . . . . . . . . . . . . . . . . . . . 2-119
Contents-4

1
Introduction to Command Parameters
This chapter provides intro ductory information ab out parameters. T
o get help
on any parameter not found in this bo ok, use the MPE/iX online help facilit
y
described in the bo ok,
Task Reference (B3813-90009).
Each command in this b o ok is presen
ted in alphab etical order and contains the
following information:
Command
Name
Provides the command name at the top of eac
h page, followed
by a brief denition.
Syntax Provides a diagram that shows howtoenter the command and
its parameters.
Parameters Explains each parameter including its function, limitations, and
defaults.
Operation
Notes
Explains how to use the command and may also include
advisory information, such as requirements, restrictions, and
operating pro cesses.
Examples Includes examples of how to use the command.
Related
Commands
Provides the names of functionally related commands.
Introduction to Command Parameters 1-1

Parameters within Syntax
MPE/iX commands instruct the system to p erform a desired function. If y
ou
include parameters with the command b efore y
ou enter it, the parameters
specically instruct the system ho
w it should p erform the command function.
There are three types of parameters:
required
optional
positional
Required parameters
You must enter all required parameters; otherwise, MPE/iX displays an error
message when you enter the command. In the syntax diagrams for each
command, either braces {} or no marks surround required parameters.
In the follo wing example, myle is a required parameter b ecause no marks
surround it:
BUILD myle
Anything italicized, suchas myle , is a representational name or value and
must b e replaced with an actual name or v
alue.
Sometimes you must select one parameter from two or more parameters. In the
following example, you must provide either a job number or a session number
because braces surround these parameters:
ALTJOB

#J nnn
#S nnn

Optional parameters
You can either specify or ignore optional parameters, if any, depending on how
you want the command to execute. In the syntax diagrams for each command,
brackets [] surround optional parameters. If you ignore optional parameters,
MPE/iX uses the system-dened default values for each parameter.
1-2 Introduction to Command Parameters

In the following example, [;PASS] is an optional parameter because brac
kets
surround it:
NEWGROUP groupname
2
;PASS=
2
password
33
In this example, PASS is the parameter and password is the parameter value.
You would substitute an actual passw
ord in place of password to provide a
value for the parameter PASS . The syntax diagram indicates that the v
alue
password is optional within the optional parameter
PASS .
Positional parameters
The eect of a p ositional parameter depends on its lo cation in the parameter
list. In the syntax diagram for each command, the comma (,) separates
positional parameters. If you omit a positional parameter from the list,
you must provide a comma placeholder that would normally precede that
parameter.
In the following example, the parameter values that follow the command are
positional:
LIMIT 10,32
In the following example, a comma holds the p osition of the curren
tvalue of
the rst parameter:
LIMIT ,32
Introduction to Command Parameters 1-3

2
MPE/iX Commands
The commands presented in this chapter are a subset of the MPE/iX system
commands and, in some instances, a subset of a command's parameters. Eac
h
command is presented in alphab etical order. T
o get help on an
y parameter
not found in this chapter, use the MPE/iX online help facility describ ed in the
Task Reference (B3813-90009).
To get help on a command not in this bo ok, t
ype help and the command name
next to the MPE/iX prompt. For example, to get help on LISTFILE ,typ e:
:HELP LISTFILE
MPE/iX Commands 2-1

ABORTJOB/ 4
Ctrl
5 A ABORTJOB
The ABORTJOB/ 4
Ctrl
5 A ABORTJOB command terminates either a designated
job or session. Typically,you use this command to cancel a job that y
ou
decided not to run but had already streamed. Y
ou can also use this command
to terminate one or more sessions, if necessary
, for system emergencies or
scheduled shutdowns.
Syntax
From a terminal:
ABORTJOB
8
<
:
#J nnn
#S nnn
2
jobname ,
3
user . acct
9
=
;
From the console:
4
Ctrl
5 A ABORTJOB
8
<
:
#J nnn
#S nnn
2
jobname ,
3
user . acct
9
=
;
Parameters
#J nnn Species a job number.
#S nnn Species a session numb er.
jobname Species the name of the job, as iden
tied by the SHOWJOB
command.
user Species a user name.
acct Species an account name.
2-2 MPE/iX Commands

ABORTJOB/ 4
Ctrl
5 A ABORTJOB
Operation Notes
Note
You need to use the SHOWJOB command to determine the job
or session number of the op eration y
ou want to cancel. If y
ou
need more information on SHOWJOB , refer to the section on that
command later in this c
hapter.
Usage
You can enter this command from a session, a job, a program, or in break
mo de. Pressing 4
Break
5 does not aect this command.
You must enter the 4
Ctrl
5 A ABORTJOB command from the console. You can
enter the ABORTJOB command from a terminal other than the console if the
JOBSECURITY command is set to LOW ,orifyour system administrator has
used the ALLOW command, which permits you to enter this command.
Dierences b etween ABORTJOB and 4
Ctrl
5 A ABORTJOB
Both of these commands function identically except that you can enter 4
Ctrl
5 A
ABORTJOB only from the console. The = sign appears when you press 4
Ctrl
54
A
5 .
Pressing these keys enables you to enter certain commands on a console from
which another process (suchas STORE ) is currently running.
Recommended usage
If you use the [ jobname ,] user . acct form of the command when more than
one job or session is executing with the same name, the system selects the
job or session that it ab orts. Consequently,you should use the #J nnn or
#S nnn form of the command for more precise control of jobs or sessions to b e
terminated. Although the job or session abnormally terminates, log records
are issued, and CPU times and connect times are up dated. All I/O activit
y
terminates, such as printing, and reading or writing les.
Waiting and scheduled jobs
You can also use the ABORTJOB command for waiting and scheduled jobs,
as well as for executing jobs. If a request is p ending at the console, the
command automatically terminates the request, and the following message
appears on the console:
time /#S nnn / pin /REQUEST REQUIRING OPERATOR REPLY FOR
MPE/iX Commands 2-3

ABORTJOB/ 4
Ctrl
5 A ABORTJOB
PIN # nn HAS BEEN ABORTED
Refer to the Glossary for a denition of the pro cess iden
tication number
(PIN).
Examples
To terminate session number 139, en
ter:
:ABORTJOB #S139
The system resp onds b
y displaying the following logo message on the
console if the session ends successfully:
17:10/#S139/34/LOGOFF ON LDEV #12
To terminate job number 9, enter:
:ABORTJOB #J9
The system resp onds by displaying the following logo message if the
executing job successfully terminates:
20:18/#J9/26/LOGOFF ON LDEV #10
This message do es not app ear when y
ou terminate waiting or scheduled jobs.
To terminate session 6, which has the follo wing pending device allo cation
message, enter:
?17:00/#S6/23/LDEV# FOR "SCRTAPE" ON TAPE (NUM)?
:ABORTJOB #S6
The system resp onds by displaying the following message:
17:10/#S6/120/REQUEST REQUIRING OPERATOR REPLY FOR
PIN 23 HAS BEEN ABORTED
17:10/#S6/120/LOGOFF ON LDEV #58
2-4 MPE/iX Commands

ABORTJOB/ 4
Ctrl
5 A ABORTJOB
Related Commands
ALLOW
BREAKJOB
CONSOLE
JOBSECURITY
SHOWJOB
STREAM
MPE/iX Commands 2-5

ALLOW
The ALLOW command enables the system administrator to p ermit one or more
users to enter one or more op erator commands. The
ALLOW command sp ecies
which users can enter op erator commands, and species whic
h commands these
users can enter.
Syntax
Interactive and subsystem mo de:
ALLOW
2
6
6
4
@.@
@.acct
user.@
user.acct
3
7
7
5
;COMMANDS= command
2
, command , ...
3
Program mo de:
ALLOW FILE= formaldesignator
2
;SHOW
3
Parameters
@.@ Gives access to all users whether or not they are logged on.
@.acct Gives access to all users logged on to a sp ecic accoun
t.
user.@ Gives access to a sp ecic user logged on to an
y account.
user.acct Gives access to a sp ecic user logged on in a sp ecic accoun
t.
COMMANDS Species the names of the console commands that the user(s)
can access.
FILE Species an ASCII le name, formaldesignator , that consists
of from one to eight alphanumeric characters, b eginning with
an alphab etic character. The formaldesignator can be fully or
partially qualied and can b e backreferenced in a le equation.
SHOW Lists input lines to $STDLIST .
2-6 MPE/iX Commands

ALLOW
Operation Notes
Usage
You can enter this command from a session, a job, a program, or in break
mo de. Pressing 4
Break
5 terminates subsystem mo de and pro duces an error
message, but do es not aect commands already en
tered in subsystem mo de.
This command can only b e en
tered from the console, unless y
our system
administrator has used the ALLOW command, which permits you to enter this
command.
You can only allow commands to users curren
tly logged on unless y
ou use the
@.@ parameter. Rememb er, however, that this parameter allows commands
to all users. An alternativewould be to use the ALLOW command with the
@.@ parameter, then use the DISALLOW command to disallow commands to
selected users.
Additional commands that you allow for users are valid only for the duration
of their current session. When a user logs o and then bac
k on to the
system, the previously allowed commands are no longer available until they
are allowed again.
Command mo des
The ALLOW command enables you to enter the command in one of three
mo des:
interactive
subsystem
program
When using interactive mo de, you enter the entire command along with
the desired parameters as shown in syntax and press 4
Return
5 . Subsystem
mo de is similar, except you just enter the ALLOW command and then provide
the remaining parameters after the subsystem prompt ( > ) app ears. The
subsystem accepts command parameters until you enter the EXIT or END
command.
Program mo de is b enecial from an administrative p ersp ective, because you
can create a customized le granting specic p ermissions that you do not
MPE/iX Commands 2-7

ALLOW
have to alter, unless desired. When using program mo de, y
ou rst create a
le that:
Identies the users and accounts that are permitted to use op erator
commands.
Lists the allowed commands.
Then you enter the ALLOW command, using the SHOW parameter to display
each command line as it executes from the le.
Refer to \Examples" for examples of all three mo des.
Console commands versus operator commands
Console commands function dierently from operator commands. Console
commands are not allo wable, must be entered on the actual console (usually
congured as LDEV 20), and must b e preceded by 4
Ctrl
54
A
5 . Some console
commands have the same name as non-console commands, suchas RECALL ,
which can b e entered on any device.
Operator commands are generally used in the daily op eration of y
our system
and are generally allowable.
Allowable commands
You can allo w up to 19 of the follo
wing commands at a time in interactive
and subsystem modes. If you need to specify more than 19 commands, use
program mo de.
ABORTIO HEADON RESUMESPOOL
ABORTJOB JOBFENCE SHUTQ
ACCEPT JOBSECURITY STARTSPOOL
ALLOW LDSMOUNT STOPSPOOL
ALTJOB LIMIT STREAMS
ALTSPOOLFILE LOG UP
CONSOLE MRJECONTROL VMOUNT
DELETESPOOLFILE OPENQ VSCLOSE
DISALLOW OUTFENCE VPOPEN
DISCRPS REFUSE VSRELEASESYS
DOWN REPLY VSRESERVESYS
DOWNLOAD RESUMEJOB WARN
HEADOFF SPOOLER WELCOME
2-8 MPE/iX Commands