HP 9X8LX Reference Guide

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 warrantyofany kind with regard to this

material, including, but not limited to, the implied w

merchantability or tness for a particular purpose. Hewlett-P

arranties of

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 responsibility 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.

c



Copyright

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

respective release dates for eac

version of the software pro duct at the time this documen

product releases do not require c

expect a one-to-one correspondence bet

editions.

Edition Date Software

First Edition April 1994 B.50.00

tings of this documen

h edition. The softw

hanges to the documen

ween product releases and documen

t, together with the

are version indicates the

twas issued. Many

t. Therefore, do not

Version

t

iii

In This Book

This b ook 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

alphabetical order.

Related Manuals

The

Commands Reference

is the fourth book in a set of v

includes the following:

Understanding Your

System

(B3813-90001)

If you are new to computers, this is a goo 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 tape drives

and how to communicate with your system using HP

Easytime/iX.

e manuals that

Task Reference

(B3813-90009)

iv

Describes how to communicate with your system using

MPE/iX commands. This book also includes a chapter

on how to get more information on your system, a

chapter on troubleshooting and a glossary.

New Features of

MPE/iX: Using the

Hierarchical File

System

(32650-90351)

Describes the changes to MPE/iX as of Release 4.5

and 5.0, which enhanced MPE/iX to mak

e it \POSIX

compatible." The bo ok also describes the features of

the hierarchical le system.

Note

The MPE/iX operating system has been enhanced as of Release

4.5 and 5.0 to include additional features that include POSIX

compatibility and the

le system

is tree structured and can con

hierarchical le system

tain les at many

. The

hierarchical

dierent levels. This organization provides a special kind of le

called a

directory

. Instead of holding data, directories con

tain

lists of les and pointers to those les.

For more information on

system

, refer to the book,

the Hierarchical File System

documentation set. This book includes an o

POSIX

and the

hierarchical le

New Features of MPE/iX: Using

(32650-90351), included in this

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

5

ABORTJOB/

A ABORTJOB . . . . . . . . . . . . . . 2-2

4

Ctrl

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

5

RECALL/

A RECALL . . . . . . . . . . . . . . . . . 2-200

4

Ctrl

RELEASE . . . . . . . . . . . . . . . . . . . . . . . . 2-202

RENAME . . . . . . . . . . . . . . . . . . . . . . . . 2-204

5

REPLY/

A REPLY . . . . . . . . . . . . . . . . . . 2-206

4

Ctrl

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

Introduction to Command Parameters

1

This chapter provides introductory information ab out parameters. T

o get help

on any parameter not found in this bo ok, use the MPE/iX online help facilit

described in the bo ok,

Each command in this bo ok is presen

Task Reference

(B3813-90009).

ted in alphabetical order and contains the

following information:

Command

Name

Syntax

Provides the command name at the top of eac

h page, followed

by a brief denition.

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 processes.

Examples

Related

Includes examples of how to use the command.

Provides the names of functionally related commands.

Commands

y

Introduction to Command Parameters 1-1

Parameters within Syntax

MPE/iX commands instruct the system to perform a desired function. If y

include parameters with the command before y

specically instruct the system ho

w it should perform the command function.

ou enter it, the parameters

ou

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

In the following example,

{}

or no marks surround required parameters.

myle

is a required parameter b ecause no marks

surround it:

BUILD

Anything italicized, suchas

must be replaced with an actual name or v

myle

myle

, is a representational name or value and

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:



nnn

nnn

ALTJOB



#J

#S

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,

surround it:

NEWGROUP

groupname

[;PASS]

2

;PASS=

is an optional parameter b ecause brac

2

33

password

kets

In this example,

You would substitute an actual passw

value for the parameter

password

is optional within the optional parameter

PASS

is the parameter and

PASS

. The syntax diagram indicates that the v

password

ord in place of

is the parameter value.

password

to provide a

alue

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 position 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

command is presented in alphabetical order. T

not found in this chapter, use the MPE/iX online help facility described in the

Task Reference

(B3813-90009).

o get help on an

y parameter

h

To get help on a command not in this bo ok, t

next to the MPE/iX prompt. For example, to get help on

:HELP LISTFILE

ype help and the command name

LISTFILE

,type:

MPE/iX Commands 2-1

5

ABORTJOB/

The

ABORTJOB/

4

A ABORTJOB

4

Ctrl

5

A ABORTJOB

Ctrl

command terminates either a designated

job or session. Typically,you use this command to cancel a job that y

decided not to run but had already streamed. Y

to terminate one or more sessions, if necessary

ou can also use this command

, for system emergencies or

scheduled shutdowns.

Syntax

From a terminal:

9

=

;

ABORTJOB

8

<

:

#J

#S

2

nnn

nnn

jobname

3

,

user.acct

From the console:

9

=

;

4

5

A ABORTJOB

Ctrl

8

<

:

#J

#S

2

nnn

nnn

jobname

3

,

user.acct

Parameters

#J

nnn

Species a job number.

ou

#S

nnn

jobname

Species a session number.

Species the name of the job, as iden

command.

user

acct

Species a user name.

Species an account name.

2-2 MPE/iX Commands

tied by the

SHOWJOB

Operation Notes

ABORTJOB/

5

A ABORTJOB

4

Ctrl

Note

You need to use the

or session number of the operation y

need more information on

command later in this c

SHOWJOB

SHOWJOB

hapter.

command to determine the job

ou want to cancel. If y

, refer to the section on that

Usage

You can enter this command from a session, a job, a program, or in break

5

mode. Pressing

4

You must enter the

enter the

JOBSECURITY

used the

ABORTJOB

command is set to

ALLOW

command, which permits you to enter this command.

Dierences b etween ABORTJOB and

does not aect this command.

Break

5

A ABORTJOB

4

Ctrl

command from the console. You can

command from a terminal other than the console if the

LOW

,orifyour system administrator has

5

A ABORTJOB

4

Ctrl

Both of these commands function identically except that you can enter

ABORTJOB

only from the console. The=sign app ears when you press

4

Ctrl54A

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#Jnnn

#S

nnn

form of the command for more precise control of jobs or sessions to be

or

terminated. Although the job or session abnormally terminates, log records

are issued, and CPU times and connect times are updated. All I/O activit

terminates, such as printing, and reading or writing les.

4

ou

Ctrl

5

A

5

.

y

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 pending 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

5

ABORTJOB/

A ABORTJOB

4

Ctrl

PIN #nnHAS BEEN ABORTED

Refer to the Glossary for a denition of the process iden

tication number

(PIN).

Examples

To terminate session number 139, en

ter:

:ABORTJOB #S139

The system responds 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 responds by displaying the following logo message if the

executing job successfully terminates:

20:18/#J9/26/LOGOFF ON LDEV #10

This message does not appear when y

ou terminate waiting or scheduled jobs.

To terminate session 6, which has the following pending device allo cation

message, enter:

?17:00/#S6/23/LDEV# FOR "SCRTAPE" ON TAPE (NUM)?

:ABORTJOB #S6

The system responds 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

Related Commands

ALLOW

BREAKJOB

CONSOLE

JOBSECURITY

SHOWJOB

STREAM

ABORTJOB/

5

A ABORTJOB

4

Ctrl

MPE/iX Commands 2-5

ALLOW

The

ALLOW

users to enter one or more operator commands. The

command enables the system administrator to permit one or more

ALLOW

which users can enter operator commands, and species whic

users can enter.

Syntax

Interactive and subsystem mode:

3

7

7

;COMMANDS=

5

command

2

,

command,...

ALLOW

2

@.@

6

@.acct

6

4

user.@

user.acct

Program mo de:

ALLOW FILE=

formaldesignator

2

;SHOW

3

Parameters

command sp ecies

h commands these

3

@.@

@.acct

user.@

user.acct

COMMANDS

Gives access to all users whether or not they are logged on.

Gives access to all users logged on to a specic accoun

Gives access to a specic user logged on to an

Gives access to a specic user logged on in a specic accoun

Species the names of the console commands that the user(s)

can access.

FILE

Species an ASCII le name,

of from one to eight alphanumeric characters, b eginning with

an alphab etic character. The

partially qualied and can b e backreferenced in a le equation.

SHOW

Lists input lines to

2-6 MPE/iX Commands

$STDLIST

formaldesignator

formaldesignator

.

t.

y account.

t.

, that consists

can be fully or

Operation Notes

Usage

You can enter this command from a session, a job, a program, or in break

5

mode. Pressing

4

message, but does not aect commands already en

terminates subsystem mode and produces an error

Break

tered in subsystem mode.

ALLOW

This command can only b e en

administrator has used the

tered from the console, unless y

ALLOW

command, which permits you to enter this

our system

command.

You can only allow commands to users curren

@.@

parameter. Rememb er, however, that this parameter allows commands

to all users. An alternativewould b e to use the

@.@

parameter, then use the

DISALLOW

tly logged on unless y

ALLOW

command with the

ou use the

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

modes:

interactive

subsystem

program

When using interactive mo de, you enter the entire command along with

5

the desired parameters as shown in syntax and press

mode is similar, except you just enter the

ALLOW

command and then provide

4

Return

. Subsystem

the remaining parameters after the subsystem prompt (>) appears. The

subsystem accepts command parameters until you enter the

EXITorEND

command.

Program mo de is benecial from an administrative persp ective, because you

can create a customized le granting specic permissions 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

5

congured as LDEV 20), and must be preceded by

4

Ctrl54A

commands have the same name as non-console commands, suchas

. Some console

RECALL

which can b e entered on any device.

Operator commands are generally used in the daily operation 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 sp ecify 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

ALLOW

Not all of these commands are described in this c

about commands not described in this c

hapter, use the Help F

Before allowing any users access to these commands, y

SHOWALLOW

command to determine which operator commands ha

been allowed.

Examples

In interactive mo de, to allow a user named

and

ABORTJOB

commands, enter the following command at the console:

USER.TECH

:ALLOW USER.TECH;COMMANDS=REPLY,ABORTJOB

In subsystem mode, to allow a user named

BREAKJOB

command, enter the following command sequence at the console:

MGR.MANUALS

:ALLOW

>MGR.MANUALS;COMMANDS=BREAKJOB

>EXIT

In program mo de, to allow the users named

JOHN.ACCTNG

to enter the

LIMIT

command, do the following:

SUSAN.PAYROLL

hapter. For information

acility.

ou should enter the

ve already

to enter the

REPLY

to enter the

and

1. Execute the

ALLOWTMP

, as shown:

:EDITOR

HP32201A.07.17 EDIT/3000 WED, MAY 8, 1991, 3:02 PM

(C) HEWLETT-PACKARD CO. 1990

/ADD

...

/K ALLOWTMP

/E

EDITOR

command, create a program le, and saveit to

1 SUSAN.PAYROLL;COMMANDS=LIMIT

2 JOHN.ACCTNG;COMMANDS=LIMIT

3 //

MPE/iX Commands 2-9

ALLOW

2. Execute the

display each command line as it executes from the le:

:ALLOW FILE=ALLOWTMP;SHOW

You can also include a lo c

:ALLOW FILE=ALLOWTMP/LOCKWORD;SHOW

You can backreference the le with a le equation, as sho

:FILE BACKF=ALLOWTMP

:ALLOW FILE=*BACKF;SHOW

Related Commands

CONSOLE

DISALLOW

SHOWALLOW

ALLOW

command using the

kword for the le, if an

SHOW

parameter, if desired, to

y, as shown:

wn:

2-10 MPE/iX Commands

ALTACCT

The

ALTACCT

command enables a system administrator to c

parameters of an existing accoun

Syntax

ALTACCT

hange the

t.

ALTACCT

2

;PASS=

2

;ACCESS=

Parameters

acctname

PASS

CAP

acctname

2

password

2

(

leaccess

332

;CAP=

33

)

2

capabilitylist

33

Species the name of the account that you want to alter. The

name must consist of one to eight alphanumeric characters,

beginning with an alphab etic character.

Species the account password, only used for verifying logon

access. Entering the

retains the current password. Entering

password

specifying

removes the existing password. Entering

password

ALTACCT

command without this parameter

PASS

without specifying

PASS

changes the current password or creates

one if a password did not previously exist.

Species the list of capabilities permitted for this accoun

were assigned with the

NEWACCT

command. Each capabilityis

indicated byatwo-letter mnemonic, separated by commas, as

follows:

SM = System manager

AM = Account manager

DI = Diagnostician

OP = System supervisor

NA = Network administrator

NM = Node manager

SF = Save files

ND = Access to nonshareable I/O devices

UV = Use volumes

and

t that

MPE/iX Commands 2-11

ALTACCT

CV = Create volumes

CS = Use communication subsystem

PS = Programmatic sessions

LG = User logging

PH = Process handling

DS = Extra data segments

MR = Multiple RINs

PM = Privileged mode

IA = Interactive access

BA = Batch access

ACCESS

The defaults are AM, SF, ND, IA, and BA, for all accoun

except for the

SYS

account. The defaults for the

SYS

ts

account

are SM, AM, AL, GL, DI, OP, SF, ND, PH, DS, MR, and PM.

You should not alter the

SYS

account because it is assigned the

maximum account capabilities when the system is delivered.

If you remove a capability from an account, it is unavailable to

users of that account only after they log o the system and

then log back on.

Species the restriction on le access p ertinent to this account.

Valid syntax options are as follo ws:

8

9

2

R

>

>

>

>

>

>

6

>

>

>

>

L

6

>

>

>

>

6

<

=

2

A

6

(

6

6

>

>

6

>

>

>

4

>

>

:

,

>

>

>

>

>

>

>

;

...

W

X

S

8

ANY

>

>

>

>

>

AC

<

3

:

GU

>

>

>

AL

>

>

:

GL

where R, L, A, W, X, and S sp ecify mo des of access b

9

>

>

>

>

>

=

>

>

>

>

>

;

3

7

7

7

2

7

,

7

7

7

5

...

3

)

ytypes

of users (ANY, AC, GU, AL, GL) and are dened as follows:

R = Read

L = Lock (exclusive file access)

A = Append (implies L)

W = Write (implies A and L)

X = Execute

S = Save

2-12 MPE/iX Commands

ALTACCT

The user types are dened as follo

ws:

ANY = Any user

AC = Member of this account only

GU = Member of this group only

AL = Account librarian user only

GL = Group librarian user only

You can specify t

wo or more user and/or access t

ypes if you

separate them with commas.

The defaults are R,A,L,W,X:AC for all accoun

SYS

. The

SYS

account defaults are (R,X:ANY;A,W,L:AC).

ts except for

Operation Notes

Usage

You can enter this command from a session, a job, a program, or in break

5

mode. Pressing

4

does not aect this command.

Break

You must have system manager (SM) capability in order to use this

command.

Altering account parameters

Basic guidelines for altering account parameters are as follows:

You can enter multiple parameters on a single command line b

y using the

semicolon (;) delimiter.

When you change one capability in a capability list that contains several

nondefault values, you must specify an entire new capability list.

A parameter remains unchanged for the accountifyou omit a parameter

and its value when entering the command.

When you include a parameter but omit its value as in

PASS=

4

Return

default value is assigned.

MPE/iX Commands 2-13

5

, the

ALTACCT

Activating the changes

If you alter one or more parameters while users are logged on, the c

do not become eectiv

euntil the users log o their curren

t jobs or sessions

hanges

and log back on. Since the system does not automatically generate a message

informing users of changes, you should notify users b efore y

accountchanges. This is particularly advisable when y

from an account. In this case, all accoun

account are denied the capabilit

y.

t members and groups within the

ou makeany

ou remove a capability

Restrictions

You cannot remove system manager (SM) capability from the

SYS

account

or account manager (AM) capability from any account. From within any

account, you can remove AM capability from all but one (the last) of the

users assigned the capability; however, you can remove AM capability from

all users in an accountifyou do this from another user and accoun

t with SM

capability.

Examples

Tochange the password of an account named

AC2toGLOBALX

,enter:

:ALTACCT AC2;PASS=GLOBALX

To add SM capability to an account named

capabilities, enter:

:ALTACCT AC2;CAP=SM,AM,AL,GL,ND,SF,BA,IA

2-14 MPE/iX Commands

AC2

and retain the default

Related Commands

ALTGROUP

ALTUSER

LISTACCT

LISTGROUP

LISTUSER

NEWACCT

NEWGROUP

NEWUSER

REPORT

RESETACCT

ALTACCT

MPE/iX Commands 2-15

ALTFILE

This command changes the attributes of an existing le or directory

SYNTAX

ALTFILE

22

;GROUPID=

2

FILE=

3

3

lename

22

POSIXgroupname

;OWNER=

3

3

ownername

3

PARAMETERS

lename

The le name of the ob ject to be altered. The lename

may name a le, hierarchical directory, root, MPE group

or account. Note that MPE groups or accounts can ONLY

be named via HFS (Hierarchical File System) syn

Temporary les are not recognized.

This is a required parameter. You cannot use wildcarding

to sp ecify le names, nor can you use back-referenced le

equations. This parameter cannot name a system-dened

le (such as $NULL). You can specify le names using b oth

MPE and HFS syntaxes. MPE-syntax names may not

include lo ckwords; the lockword for a lockworded le is not

needed for this command to succeed, and if included in the

lename

results in an error.

.

tax.

ownername

The name of the user who will become the o

of

lename

the system. Default is for the UID of the le to remain

unchanged. Note that no qualication is done on this

name; it must b e fully specied. This name will be

upshifted if it is NOT quoted. [Optional]

POSIXgroupname

The name of the group (GID) that this le will belong to.

This

This parameter cannot be used to change the GID of an

MPE group or account. The default is for the le to retain

its previous GID. This name is upshifted when you enclose

it in quotes.

2-16 MPE/iX Commands

. This

ownername

POSIXgroupname

wner (UID)

must already exist on

must already exist on the system.

Operation Notes

Usage

ALTFILE

You use the

modify the owner (UID) and POSIX group (GID) for a le, hierarc

directory, MPE group or accoun

ALTFILE

command to alter a le's c

t. You cannot alter the GID of MPE groups

haracteristics. You can

hical

or accounts.

Required Capabilities

The user must have the appropriate privilege to c

attribute. Tochange the UID of a le, y

ou must b e one of the follo

hange the requested

wing:

The le's account manager whose logon account matches the GID of the

le and who has the MPE/iX account manager capability. In this case,

ownername

must specify a user b elonging to the accoun

t manager's logon

account.

A system manager who has the MPE/iX system manager user capabilit

In this case,

ownername

may specify any user existing in the user

database.

Tochange the GID of a le, you must b e one of the following:

The le owner (a user whose logon name matches the UID of the le). In

this case,

POSIXgroupname

must specify the user's logon account.

The le's account manager whose logon account matches the GID of the

le and who has the MPE/iX account manager (AM) user capability.In

this case,

POSIXgroupname

must specify the account manager's logon

account.

y.

A system manager who has the MPE/iX system manager user capabilit

In this case,

POSIXgroupname

may specify any GID existing in the group

database.

You can use

ALTFILE

to mo dify multiple attributes at the same time. If you

try mo difying multiple attributes, all changes must succeed for any to take

eect. If you do not specify any attributes, the command has no eect on the

le specied.

MPE/iX Commands 2-17

y.

ALTFILE

Related Commands

ALTSEC

2-18 MPE/iX Commands

ALTGROUP

The

ALTGROUP

account.

Syntax

ALTGROUP

2

;PASS=

groupname

2

password

Parameters

ALTGROUP

command changes one or more parameters of a group within an

2

332

.

acctname

;CAP=

3

2

capabilitylist

332

;ACCESS=

2

(

leaccess

33

)

groupname

acctname

PASS

CAP

Species the name of the group for whic

hyou wantto

change parameters. The name must consist of one to eight

alphanumeric characters, b eginning with an alphabetic

character.

Species the account in which the group resides. You must

have system manager (SM) capabilit y to use this parameter.

Species the group password. Entering the

ALTGROUP

command

without this parameter retains the current password. Entering

PASS

without specifying

password. Entering

password

PASS

and sp ecifying

removes the existing

password

changes

the current password or creates one if a password did not

previously exist.

Species capability class attributes consisting of an

y or all of

the following:

BA = Batch access capability (default)

DS = Permits extra data segments

IA = Interactive access capability (default)

MR = Permits multiple resource identication numbers

(RINs)

PH = Process handling capability

PM = Privileged mode capability

MPE/iX Commands 2-19

ALTGROUP

ACCESS

The default is IA and BA, except for the

account. The default for

PUB.SYS

is PH, DS, MR, PM, IA,

and BA. Typically,you should not change

PUB

group of the

PUB.SYS

SYS

because it

is assigned the maximum group capabilities when the system

is delivered. You must separate each capability class with a

comma (BA,DS,IA, and so on).

Species the restriction on le access p ertinen

t to this group.

Capability options that you can change are as follows:

8

9

2

R

>

>

>

>

>

>

6

>

>

>

>

L

6

>

>

>

>

6

<

=

2

A

6

(

6

6

>

>

6

>

>

>

4

>

>

:

,

>

>

>

>

>

>

>

;

...

W

X

S

8

>

ANY

>

>

>

>

AC

<

3

GU

:

>

>

>

AL

>

>

:

GL

where R, L, A, W, X, and S sp ecify mo des of access b

of users (ANY, AC, GU, AL, GL) and are dened as follo

9

>

>

>

>

>

=

>

>

>

>

>

;

3

7

7

7

2

7

,

7

7

7

5

...

3

)

ytypes

ws:

R = Read

L = Lock (exclusive file access)

A = Append (implies L)

W = Write (implies A and L)

X = Execute

S = Save

The user types are dened as follows:

ANY = Any user

AC = Member of this account only

GU = Member of this group only

AL = Account librarian user only

GL = Group librarian user only

You can specify two or more user and/or access types if you

separate them with commas.

The defaults for the public group (

R,X:ANY;A,W,L,S:AL,GU

2-20 MPE/iX Commands

PUB

) are:

The default for all other groups is:

R,A,W,L,X,S:GU

ALTGROUP

Capabilities assigned to the user group for

exceed those assigned to the accoun

t.

ALTGROUP

cannot

Operation Notes

Usage

You can enter this command from a session, a job, a program, or in break

5

mode. Pressing

4

does not aect this command.

Break

You must have account manager (AM) or system manager (SM) capability in

order to use this command.

Altering group parameters

Basic guidelines for altering group parameters are as follows:

You can enter multiple parameters on a single command line by using the

semicolon (;) delimiter.

When you omit an entire parameter, the corresponding value for the group

remains unchanged.

5

When you include a parameter but omit its v

alue as in

PASS=

4

Return

, the

default value is assigned.

Activating the changes

If you alter one or more parameters, the changes in the directory become

eective immediately; however, the changes do not aect any active users

with op en les in the group until they log o from their current sessions and

log back on to the same group. Since the system do es not automatically

generate a message informing users of changes, you should notify users before

you makeanychanges to the group.

MPE/iX Commands 2-21

ALTGROUP

Examples

To assign a new passw

:ALTGROUP GROUPX;PASS=PASS2

To assign the same passw

PH capabilities, enter:

:ALTGROUP GROUPX;PASS=PASS2;CAP=IA,BA,DS,PH

Related Commands

ALTACCT

ALTUSER

LISTACCT

LISTGROUP

LISTUSER

NEWACCT

NEWGROUP

NEWUSER

ord,

PASS2

, to a group named

ord to the same group as abo

GROUPX

,enter:

ve and add DS and

2-22 MPE/iX Commands

ALTSEC

ALTSEC

This command changes the access permissions of an ob ject b

access control denition (ACD).

ACDs are the main method of con

directories, and devices. ACDs are automatically assigned to hierarc

directories and to les existing in hierarc

You can change access permissions for an

les

hierarchical directories

devices

device classes

You can also change le access masks with this command (only les ha

masks). The le status change time stamp is updated by

The

Note

ALTSEC

permissions for MPE groups, accounts, or the root directory.

trolling access to les, hierarchical

hical directories.

y of the following:

command cannot be used to change access

y altering the

ALTSEC

.

hical

ve access

MPE/iX Commands 2-23

ALTSEC

Syntax

ALTSEC

objectname

2;2

ACCESS=

8

2

;NEWACD=

>

>

<

6

;REPACD=

6

4

;ADDPAIR=

>

>

:

;REPPAIR=



;DELPAIR=



;COPYACD=

Parameters

2

4

3

(

leaccess

9

>

>



=

(

acdpair

^

lereference

>

>

;



(

userspec

^

lereference

objectname

8

FILENAME

<

,

LDEV

:

DEVCLASS

2;2

2



leaccess

2

;

acdpair

;

userspec

,FILENAME

,LDEV

9

=

;

32

32

3

5

;

32

;



...

;

...

...

2

33)3

3



)

3



)

;DELACD

3

7

7

5

3 2

;MASK

3

objectname

Species the actual le designator, directory name, logical

device number, or device class whose security provisions you

want to alter.

Either MPE or hierarchical le system (HFS) le name

syntax may be used for the actual le designator of the le or

directory whose access permissions are to b e altered.

You can only use wildcard characters with MPE syntax les

that reside in a group.

A logical device number must be a numeric value congured

on the system, or an @ sign, that indicates all devices on the

system. A device class name must b e congured on the system.

File equations are ignored during resolution of the ob ject

name to avoid having accidental le equation references cause

unintentional changes to an ob ject's access permissions.

2-24 MPE/iX Commands

MPE Syntax

ALTSEC

You can include MPE le name syn

information. If the ob ject is an MPE syn

lename[/lockword

You may sp ecify le loc

][.

groupname[.acctname

kwords for les protected by active

lockwords unless the ob jects are also protected b

tax but not RFA

tax le, its format is:

]]

y a current

ACD.

In a batch job, if a lo c

it. In a session, if a loc

kword exists on a le, y

ou must specied

kword exists and is omitted, MPE/iX

will prompt you for it.

HFS Syntax

You must b egin le designators using HFS le name syn

with either a dot (.) or a slash (/) c

haracter. The maximum

length is 255 characters (including the \./" or \/").

The

objectname

identiers

FILENAME

parameter is followed by one of the three

listed below.

Atype identier that indicates

objectname

refers to either a le or directory. The

FILENAME

type identier is the default if a type

identier is not specied.

tax

type

ACCESS

LDEV

Atype identier that indicates

refers to a logical device number.

DEVCLASS

Atype identier that indicates

refers to a device class.

Optional keyword that indicates a

leaccess

follows. This option aects security at the

MPE/iX Commands 2-25

objectname

objectname

specication

le

level only.

ALTSEC

leaccess

File access mask specications, en

8

>

>

>

>

>

<

>

>

>

>

>

:

9

R

>

>

>

>

>

L

=

2

,

>

>

>

>

>

;

...

A

W

X

8

>

>

>

>

>

>

>

<

3

:

>

>

>

>

>

>

>

:

ANY

AC

GU

AL

GL

CR

9

>

>

>

>

>

>

>

=

>

>

>

>

>

>

>

;

The R, L, A, W, and X specify

users (ANY, AC, GU, AL, GL, CR) as follo

tered as follows:

2

,

3

...

modes

of access bytypes of

ws:

R = READ

L = LOCK

A = APPEND

W = WRITE

X = EXECUTE

LOCK

allows opening the le with dynamic locking option.

APPEND

APPEND

You may sp ecify two or more

implicitly species

and

LOCK

.

LOCK.WRITE

modes

if you separate them by

implicitly species

commas. The user types are sp ecied as follows:

ANY = Any user

AC = Member of this account only

GU = Member of this group only

AL = Account librarian user only

GL = Group librarian user only

CR = Creator

You may sp ecify two or more user types if you separate them

by commas. The default is R,L,W,A,X:ANY. The colon (:)

separating one or more

required punctuation in the specication of

The

ACCESS

ACD, the ACD overrides the le access mask.

NEWACD

(Indicates \new ACD"). Use

the specied ob ject.

2-26 MPE/iX Commands

modes

from one or more user types is

leaccess

.

keyword is optional. If the le is protected byan

NEWACD

NEWACD

is used when an ACD does not

to create a new ACD for

ALTSEC

currently exist. It must b e followed byvalid ACD pair(s) as

described belo

w.

REPACD

ADDPAIR

REPAIR

acdpair

(Indicates \replace ACD"). Use

REPACD

to create a new ACD

or replace an entire existing ACD for the sp ecied ob ject. It

must be follow

(Indicates \add pair"). Use

to an existing A

ed byvalid ACD pairs as described belo

ADDPAIR

to add a new A

w.

CD pair

CD. It must be followed byvalid ACD pairs as

described below.

(Indicates \replace pair"). Use

ACD pair in an existing A

REPAIR

to replace an existing

CD. You must follow this with a

valid ACD pair as describ ed below. A new ACD pair will

replace an existing ACD pair if it has the same user and

account name.

An access control denition pair. Like the

this consists of a

part is separated from the

Acceptable

modes

modes

part and a

for les are:

userspec

userspec

part by a colon (:).

leaccess

part. The

parameter

modes

R : read file access

W : write file access

L : lock file access

A : append file access

X : execute file access

NONE : no access

RACD : copy or read the ACD permission

Acceptable

modes

for directories are:

CD : create directory entries access

DD : delete directory entries access

RD : read directory entries access

TD : traverse directory entries access

NONE : no access

RACD : copy or read the ACD permission

File ACD pairs may contain R, W, L, A, X, NONE, and

RACD. Directory ACD pairs may contain CD, DD, RD, TD,

NONE, and RACD.

MPE/iX Commands 2-27

ALTSEC

The

userspec

part consists of

Note

a fully qualied user name (

the le owner represented as

the le group represented as

the le group mask represen

@.accountname

, which represents all users in the accoun

username.accountname

$OWNER

$GROUP

ted as

$GROUP_MASK

)

t

accountname

@.@, which represents all users in the system

You cannot use wildcards cannot be used in an

y other manner

within a user specication.

Atypical ACD consisting of three ACD pairs might lo ok like

this:

(R,W:ENGR.MFG;R,W,RACD:@.MRKT;R:@.@)

This ACD would allow Read and Write access to the

of the

MRKT

MFG

account; Read and Write access to any user of the

account along with the ability to read or copy the ACD;

ENGR

and Read access to any user in any account.

user

^ lereference

A le containing one or more ACD pairs. ACD pairs must

be separated by semi-colons and may b e placed on separate

lines. A single ACD pair may

The le name must be preceded by the ^ sign (caret symbol) to

indicate that the designated le contains the ACD denition.

This is known as an indirect le.

The

ALTSEC

a syntactically correct ACD. ACD pairs may be on separate

lines, but a pair may not span lines. Parentheses are optional

when dening an

The le reference may be specied using MPE or HFS le

name syntax. For example:

2-28 MPE/iX Commands

not

span more than one line.

command fails if the indirect le does not contain

acdpair

within an indirect le.

ALTSEC

DELPAIR

userspec

COPYACD

lename

2

/

lockword

32

If the le has an active lo c

2

.

.

group

account

kword, you must b e specify it.

33

ACDs override lockwords. Lockwords can only be specied in

le references using MPE name syn

tax. Unqualied le names

are relative to the currentworking directory.

(Indicates \delete pair"). Use to delete one or more A

in an existing A

userspec

.

Username and accountname, the same as the

described abovein

the username or both the username and accoun

A wildcard may

CD).

DELPAIR

must be followed byavalid

userspec

acdpair

. A wildcard (@) may be used for

tname together.

not

be specied for the accountname unless it

CD pairs

is also specied for the username.

(Indicates \copyACD"). Use

an existing

objectname

COPYACD

to the specied

to copyan ACD from

objectname

.ACDs

can be copied only between like ob jects. You must sp ecify

FILENAME or LDEV.FILENAME

an ACD

from

a device class (

is the default. You cannot copy

DEVCLASS

), although you may

copytoall devices on the system by sp ecifying the@sign as

the target device.

DELACD

MASK

(Indicates \delete ACD"). Use

from the specied

objectname

DELACD

to delete all ACD pairs

.ACDs may b e removed only

from devices and les in MPE groups. The le access matrix

controls access to a le when an ACD is deleted.

(Indicates \recalculate MASK"). Use

MASK

to recalculate

the ACD le group class mask ($GROUP MASK) access

permissions.

MPE/iX Commands 2-29

ALTSEC

Operation Notes

You use the

directories, devices, and device classes b

control denition (ACD) or its access mask. All of these ob jects ma

ACDs, but only les ha

command. An ob ject's A

ACD keywords

and

MASK

or an access specication without a k

recommended practice to help distinguish bet

ALTSEC

command to alter security provisions for les, hierarc

ve access masks which can be c

CD may be altered using this command with the

NEWACD,REPACD,COPYACD,ADDPAIR,REPPAIR,DELPAIR,DELACD

. A le's access mask ma

y manipulating an ob ject's access

hanged using this

y be altered using either the

eyword. Using the

ACCESS

ween le access mask and A

yhave

ACCESS

keyword

keyword is a

hical

CD

operations.

Only the owner of a le can use the

ALTSEC

command to change a le's

access mask. Ob ject owners and users with appropriate privilege can use this

command to manipulate an ob ject's ACD. Files and hierarchical directories

have their owner's identity and a le group ID (GID) stored in their le labels.

System managers have the appropriate privilege to manipulate the ACDs for

all ob jects. Account managers for the account matching an ob ject's GID have

appropriate privilege. Devices are owned by system managers. The abilityto

manipulate an ACD or le mask is not aected by the ob ject access currently

granted to a user.

File ACDs override le lo ckwords and the le access matrix. ACDs permit

more precise access control than the le access matrix by allowing access

permissions to sp ecic users. MPE/iX allows you to specify a maximum of

40 ACD pairs for a particular ob ject. Since a large n

umber of ACD pair

specications overows the command line buer, you must enter large numbers

of ACD sp ecications maybeentered through an indirect le.

,

The

ALTSEC

command fails if you attempt to alter the access permissions for a

permanent disk le whose group's home volume set is not mounted.

File Access Matrix Examples

Note

You can use

LISTFILE,4

to view the le access matrix.

2-30 MPE/iX Commands

ALTSEC

You have created a le named

access permissions to gran

FDATA

, and wanttochange its le access matrix

t write access to only y

ourself. Enter:

ALTSEC FDATA;ACCESS=(W:CR)

Tochange le access permissions for the

users to execute programs, but only accoun

or write to the le, en

ter:

FPROG

program le to allo w all group

t and group librarian users to read

ALTSEC FPROG;ACCESS=(X:GU;R,W:AL,GL)

ACD Examples

Note

You can use

of the

LISTFILE

You have created a le named

granting write access to a user named

LISTFILE,-2

command displays

FDATA

, and want to assign a new ACD to

FRIEND.ACCT

to view ACD information. This form

only

ACD information.

FDATA

.Enter:

ALTSEC FDATA;NEWACD=(W:FRIEND.ACCT)

As the creator of a le, you can access the le by default, so you don't need to

grantyourself access through an ACD. Users with appropriate privileges are

always p ermitted to access les protected byACDs.

,

To extend the ACD for the

it, and all users within your account

FDATA

le so that all users on the system can read

ACCT

can also write to it, enter:

ALTSEC FDATA;ADDPAIR=(R:@.@;W,R:@.ACCT)

If you decide that users outside your account

to the le

FDATA

any longer, enter:

ACCT

should not have read access

ALTSEC FDATA;DELPAIR=(@.@)

This do es not delete all ACD pairs, only the ACD pair matching @.@. To

delete the entire ACD, enter:

ALTSEC FDATA;DELACD

To replace the entire ACD, enter:

ALTSEC FDATA;REPACD=(W:FRIEND.ACCT)

MPE/iX Commands 2-31

ALTSEC

You want to copy the ACD associated with LDEV 5 to all devices in device

class

TERM

:

ALTSEC TERM,DEVCLASS;COPYACD=5,LDEV

ACDs may be copied only bet

You want to grant users in account

ween ob jects of the same t

ACCT

all access to directory

ype.

Mydir1

:

ALTSEC ./Mydir1;ADDPAIR=(CD,DD,RD,TD,RACD:@.ACCT)

You want to grant read and write access to y

members of your group to an HFS syn

tax le named

ourself and read access for other

a_file_of_Mine

:

ALTSEC ./a_file_of_Mine;REPPAIR=(RACD,R,W:$OWNER;

RACD,R:$GROUP,$GROUP_MASK;NONE:@.@)

To add a new ACD to le

it, but only users in account

PROGNAME

ACCT

to write to it enter:

allowing all users on the system to execute

ALTSEC PROGNAME;NEWACD=(X:@.@;W,X:@.ACCT)

To add a new ACD pair to an ACD which already exists for le

which will allow the user

ENGR

of the

LAB

account to read, write, lo ck, append,

PROGNAME

execute and read the ACD information enter:

ALTSEC PROGNAME;ADDPAIR=(R,W,X,RACD:ENGR.LAB)

Note that L and A (lo ck and append) need not be specied because they are

implied with W (write).

To add an ACD that prevents any user except

with SM capability) from accessing LDEV 7 (a tape driv

OPERATOR.SYS

e), enter:

(and any user

ALTSEC 7,LDEV;NEWACD=(R,W:OPERATOR.SYS)

Note in the last example that X is not used because it mak

execute

a tape drive. It also makes no sense to

lockorappend

es no sense to

a tap e drive but

W tacitly provides L and A anyway.

To eliminate anyACD that may be in eect for device class LP, and to prevent

any user except MGR of the FINANCE account from writing to a printer in

device class LP,enter:

ALTSEC LP,DEVCLASS;DELACD

ALTSEC LP,DEVCLASS;NEWACD=(W:MGR.FINANCE)

2-32 MPE/iX Commands

Related Commands

LISTF

LISTFILE

RELEASE

SECURE

SHOWDEV

and the

ALTACCT

ALTGROUP

NEWACCT

NEWGROUP

leaccess

ALTSEC

parameter for:

MPE/iX Commands 2-33

ALTUSER

The

ALTUSER

Syntax

ALTUSER

2

;PASS=

2

;HOME=

Parameters

command changes the parameters currently dened for a user.

2

.

username

2

acctname

332

password

2

homegroupname

;CAP=

3

2

capabilitylist

33 2

;UID=

2

33

33

uid

username

acctname

PASS

CAP

Species the name of the user. The name m

ust consist of one

to eight alphanumeric characters, b eginning with an alphabetic

character.

Species the account in which the user resides. The name must

consist of one to eight alphanumeric characters, beginning with

an alphab etic character. You must have system manager (SM)

capability to use this parameter from outside the accoun

t, or

you must have account manager (AM) capability to use this

parameter from within the account.

Species the user password, used for verifying logon access

only. The password must consist of one to eight alphanumeric

characters, beginning with an alphab etic character. The

default is that no password is assigned.

If you omit the parameter

does not change. If you include

value

password

, the current password is removed.

PASS

, the existing password, if any,

PASS

but do not provide its

Species the list of capabilities permitted for the user. Each

capability is indicated byatwo letter mnemonic, separated by

commas, as follows:

SM = System manager

AM = Account manager

AL = Account librarian

2-34 MPE/iX Commands

GL = Group librarian

DI = Diagnostician

OP = System supervisor

NA = Network administrator

NM = Node manager

SF = Save files

ND = Access to nonshareable I/O devices

UV = Use volumes

CV = Create volumes

CS = Use communication subsystem

PS = Programmatic sessions

LG = User logging

PH = Process handling

DS = Extra data segments

MR = Multiple RINs

PM = Privileged mode

IA = Interactive access

BA = Batch access

The default is IA, BA, ND, and SF.

Note the following p oints about this parameter:

ALTUSER

HOME

Capabilities assigned to the user cannot exceed those

assigned to the account.

Any capabilities removed from the account cannot be

assigned to the user.

The user's capabilities are always veried to b e a subset of

the account's capabilities at logon. This prevents a user from

having a capability not assigned to the account.

Species the name of an existing group to be assigned as

the user's home group. The rst user established when an

account is created, by default, has

PUB

assigned as the home

group. Subsequent new users, by default, have no home group

assigned. If no home group is assigned, the user must always

specify a group when logging on.

MPE/iX Commands 2-35

ALTUSER

Operation Notes

Usage

You can enter this command from a session, a job, a program, or in break

5

mode. Pressing

4

does not aect this command.

Break

You must have account manager (AM) capability to en

ter this command.

You must have system manager (SM) capability to specify a user in an

account other than your own.

Altering user parameters

Basic guidelines for altering user parameters are as follo

ws:

You can enter multiple parameters on a single command line by using the

semicolon (;) delimiter.

If more than one user within an account is assigned AM capability,you

can remove the capability from all but one user.

When you omit an entire parameter, the corresponding value for the group

remains unchanged.

5

When you include a parameter but omit its value as in

PASS=

4

Return

, the

default value is assigned.

You cannot remove SM capability from

MANAGER.SYS

.

You cannot removeyour own AM capability.

Activating the changes

If you alter one or more parameters, the c

hanges in the directory b ecome

eective immediately,however, the changes do not aect any active users

until they log o from their current sessions and log back on to the same

user name and account. Since the system does not automatically generate a

message informing users of changes, you should notify users before you make

anychanges.

2-36 MPE/iX Commands

Examples

ALTUSER

Tochange the capability list of the user

to include privileged mode (PM) capabilit

:ALTUSER JONES;CAP=IA,BA,SF,PH,DS,PM

Tochange the password and capability list of

:ALTUSER JONES;PASS=JJ;CAP=IA,BA,SF,PH,DS,PM

Related Commands

ALTACCT

ALTGROUP

LISTACCT

LISTGROUP

LISTUSER

NEWACCT

NEWGROUP

NEWUSER

JONES

y,enter:

from IA, BA, SF, PH, and DS

JONES

,enter:

MPE/iX Commands 2-37

BREAKJOB

The

BREAKJOB

command suspends an

y executing job, including sp ooled and

streamed jobs. A job using a critical system resource does not suspend un

releases the resource.

Syntax

til it

BREAKJOB #J

nnn

Parameters

#J

nnn

Species a job number.

Operation Notes

Usage

You can enter this command from a session, a job, a program, or in break

5

mode. Pressing

4

does not aect this command.

Break

You must enter this command from the console. You can enter this

command from a terminal other than the console under one of the following

conditions:

The

JOBSECURITY

command is set to

LOW

and the job is logged on to your

user account. (AM users only need to match the job's account name.)

Your system administrator has used the

ALLOW

command, which permits

you to enter this command.

Nonshareable devices

When you enter this command for a job that controls a nonshareable device,

a console message appears that lists the device(s) that the job controls. As

many as ten devices may be listed. You can then decide whether to allow the

job to continue running until it releases the device(s), or whether you should

abort the job.

2-38 MPE/iX Commands

Examples

BREAKJOB

To suspend the processing of job n

:BREAKJOB #J68

To display suspended jobs, en

:SHOWJOB SUSP

JOBNUM STATE INPRI JIN JLIST INTRODUCED JOB NAME

#68 SUSP 105 LP WED. 7:56AM TEST,USER.ACCT

Related Commands

ALTJOB

ABORTJOB

CONSOLE

JOBSECURITY

RESUMEJOB

SHOWJOB

STREAM

umber 68, enter:

ter:

MPE/iX Commands 2-39

BYE

The

BYE

command terminates an in

teractive session and displays the following:

CPU seconds consumed

connect time minutes consumed

date and time of termination

Syntax

BYE

Parameters

None.

Operation Notes

Usage

You can enter this command from a session, but not from a job, a program,

5

or in break mo de. Pressing

4

does not aect this command.

Break

Automatic termination

The system automatically terminates your session under the following

circumstances:

If you enter the

HELLO

command without logging o your current session,

MPE terminates your current session and immediately initiates a new one.

If you are logged on over a telephone line and you hang up b efore

terminating your session, the system automatically issues the

BYE

command.

Example

To terminate a session, enter:

:BYE

CPU=48. CONNECT=35. FRI, MAY 4, 1990, 10:56 PM

2-40 MPE/iX Commands

BYE

The termination message shown above does not app ear if y

BYE

command b efore you initiated a session on the system.

Related Commands

EOJ

EXIT

HELLO

ou entered the

MPE/iX Commands 2-41

CHDIR

This command changes the process' curren

Syntax

CHDIR

22

DIR=

3

dir name

32

;SHOW | NOSHOW

Parameters

dir name

The name of the new current directory (optional). The

dir name

is assumed to be an MPE name. You can change to

HFS-named directories if

slash (/). The

dir name

wildcards is not allowed. If

directory is used. Your logon directory is your logon group, in

SHOW

NOSHOW

the form:

Displays to

changed to".

Does not display the absolute pathname.

/LOGON_ACCOUNT/LOGON_GROUP

$STDLIST

SHOW

the absolute pathname of the \directory

is the default.

Operation Notes

You can use the

dir name

is omitted, the logon group is assumed. The user alwa

CHDIR

command to change the process' CWD to

group.

tworking directory (CWD).

3

dir name

starts with a dot (.) or a

may not end in a slash, and using

dir name

is omitted, your logon

.

name

dir

ys has a logon

.If

The

CHDIR

means that

command changes the CWD to an MPE-named directory. This

dir name

must follow all MPE naming rules, unless it is prexed

with a dot (.) or a slash (/).

You can change the CWD to any HFS directory, MPE account, or MPE group

where you have the appropriate permission.

The CWD is a process-local attribute. When

the CI's CWD is changed for the life of that CI process (or until another

command is issued). When

CHDIR

is executed programmatically from a child

CHDIR

is executed from the CI,

CHDIR

2-42 MPE/iX Commands

CHDIR

process of the CI (for example, HPEDIT), only that pro cess' CWD is c

In this case, the paren

The

CHDIR

CHDIR

and

CHGROUP

does not post an

t pro cess' (for example, CI's) CWD is not aected.

commands change their pro cess' CWD; ho

y accounting information, and

CHGROUP

aects the

hanged.

wever,

CWD of every pro cess in the job/session structure. Connect and CPU time are

still accounted to the user's logon accoun

A new, read-only, predened CI variable,

the currentworking directory in HFS syn

/account name/logon group name

characters. If the CWD is to o long, or has b een remo

the .2 shell

The

CHGROUP

/account/group changedto

rmdir

command), then

command causes the

.

The table below summarizes the dierences and similarities b et

and

CHGROUP

commands.

t and logon group.

HPCWD

tax. At logon,

. The

HPCWD

HPCWD

HPCWD

will not be accessible.

variable to be set to

, contains the name of

HPCWD

contains

string value cannot exceed 255

ved (for example, with

ween the

CHDIR

Aects CHGROUP CHDIR

Accumulation of CPU and Connect time yes no

Set of accessible les yes no

CWD of process yes yes

HPCWD variable yes yes

Disk space accumulation yes yes

Use

You can issue the

break mo de. Pressing

CHDIR

4

command from a job, a session, a program, or in

5

has no eect on this command. You must have

Break

traverse directory entries (TD) permission to each directory componentin

dir name

on directory permissions.) If the

(refer to the

ALTSEC

command in this chapter for more information

CHDIR

command fails, the CWD do es not

change..

MPE/iX Commands 2-43

CHDIR

Examples

The following example shows the command entry to change to the directory

dir1

in the

MYGRP

group in the

MYACCT

account.

d a

CHDIR /MYACCT/MYGRP/dir1

c b

The following example shows the command entry to change to the MPE group

level (

AGROUP

) in the

MYACCT

account.

d a

CHDIR /MYACCT/AGROUP

c b

The following example shows the command entry to change to a directory

named

My_dir

. In this example,

My_dir

is a relative pathname, that is, relative

to the currentworking directory (CWD).

d a

CHDIR ./My_dir

c b

The following example shows the command entry to change to a directory

named

john

, in the group

JONES

, in the account

MYACCT

,by specifying the full

pathname.

d a

CHDIR /MYACCT/JONES/john

c b

2-44 MPE/iX Commands

CHDIR

The following example shows that a change is made to a directory named

final

currentworking directory after the change is made.

d a

c b

Related Commands

by specifying the relativ

CHDIR ./es/final

SHOWVAR HPCWD

HPCWD = /MYACCT/JONES/john/es/final

CHGROUP

FINDDIR (UDC)

LISTDIR (UDC)

NEWDIR

PURGEDIR

e pathname. The variable

HPCWD

displays the

MPE/iX Commands 2-45

CHGROUP

The

CHGROUP

command enables you to switch from your current group to

another group within your logon account.

Syntax

CHGROUP2groupname

2

/

grouppass

33

Parameters

groupname

Species the name of the group that y

ou want to switch to. If

you omit this parameter, you switch to the home group.

grouppass

Species the password of the group that you want to switch

to, if the group has a password. If you want to switchtoyour

home group, you do not need to provide a password.

Operation Notes

Usage

You can enter this command from a session or a job, but not from a program

5

or in break mo de. Pressing

4

does not aect this command.

Break

Command interpreter preservation

This command preserves the entire command interpreter environment

(temporary les, le equations, and variables).

Password requirements

In a batch job, you must supply a password if a password is assigned to

groupname

PASSWORD

a password is assigned to

; otherwise, the job fails and the error message

INCORRECT

appears. Similarly, during a session, you must supply a password if

groupname

; otherwise, the system prompts you for

a password.

2-46 MPE/iX Commands

Examples

To switch from the current group to your home group, enter:

:CHGROUP

CHGROUP

To switch from the current group to the group called

:CHGROUP GROUP2

To switch from the current group to the group called

assigned password

:CHGROUP GROUP2/SECRET

Related Commands

HELLO

SECRET

,enter:

GROUP2

GROUP2

,enter:

with the

MPE/iX Commands 2-47

COMMENT

The

COMMENT

user command.

Syntax

2

COMMENT

Parameters

command enables you to insert a commen

3

text

tinto a job stream or a

text

Consists of the comment text that includes an explanation

about the purpose of commands or the logic used in creating

the job. You can also use

text

to create job headings. The

can consist of any ASCII characters.

The default is that a record containing only the string

"COMMENT"

is inserted in the command stream.

Operation Notes

Usage

You can enter this command from a session, a job, a program, or in break

5

mode. Pressing

4

does not aect this command.

Break

Adding comment lines

To continue comment text onto the next line, use an ampersand (&) as the

last nonblank character of the line. Add the amp ersand for eac

h line of text

that you want to continue.

Example

To include the comment

THIS IS A SAMPLE JOB

in the job named

JOB1

the following in your text le:

text

, insert

!JOB JOB1,USER.FINANCE

!COMMENT -- THIS IS A SAMPLE JOB

!FORTGO MYPROG

!EOJ

2-48 MPE/iX Commands

Related Commands

None

COMMENT

MPE/iX Commands 2-49

CONSOLE

The

CONSOLE

command can display the logical device n

umber of the curren

console or can move the console to another logical device.

Syntax

2

3

CONSOLE

ldev

Parameters

t

ldev

Species the logical device number of the new console terminal.

If you omit this parameter, the command displays the logical

device number of the current console.

Operation Notes

Usage

You can enter this command from a session, a job, a program, or in break

5

mode. Pressing

4

does not aect this command.

Break

Any user can enter this command to determine the location of the console;

however, you must enter this command from the console to c

location, unless your system administrator has used the

ALLOW

hange its

command

which permits you to enter this command.

Command process

When you enter this command, a message that shows the new logical device

number appears on the new console as w

ell as the former console. All console

capabilities transfer to the new console; the former console becomes a

standard session device.

Restrictions

Restrictions or requirements on the use of this command are as follows:

You cannot move the console to a remote terminal, whichis a

terminal connected to your system through a distributed systems (DS)

communications line.

2-50 MPE/iX Commands

CONSOLE

You should not move the console to a terminal that uses a m

terminal software (MTS) line, or a pac

ket assembly and disassembly (PAD)

ultipoint

terminal over a modem.

Because the console is a session device, y

to the console in order to en

ter op erator commands.

ou must have a session logged on

Control and maintenance processor (CMP) and diagnostic con

(DCU) prompts and messages remain with the congured terminal, suc

channel 1, device 0, for example. Y

ou cannot move this feature to another

terminal.

You can only execute console (

5A) commands from the console.

4

Ctrl

Examples

To determine the current location of the console, enter:

:CONSOLE

CONSOLE IS CURRENTLY ASSIGNED TO LDEV 20

To transfer the console from the terminal iden

tied by the system as logical

device 20 to the terminal identied as logical device 31, enter:

trol unit

has

:CONSOLE 31

CONSOLE HAS BEEN SWITCHED FROM LDEV 20 TO LDEV 31

Related Commands

ALLOW

SHOWALLOW

MPE/iX Commands 2-51

CONTINUE

The

CONTINUE

command overrides a command error so that a job or user

command stream continues executing. You typically insert this command in

the command le line preceding an

y command that you suspect ma

y cause the

job or user command to ab ort. If an error o ccurs, the job or user command

continues to run, and the system displa

ys an accompanying error message.

Syntax

CONTINUE

Parameters

None.

Operation Notes

Usage

You can enter this command from a job, but not from a session, a program,

5

or in break mo de. Pressing

4

does not aect this command.

Break

Example

Tooverride a p ossible error resulting from the processing of

enable

JOB1

to continue executing, insert the following in your le:

!JOB JOB1,USER.FINANCE

!RUN MYPROG

!CONTINUE

!IF JCW <= WARN THEN

! RUN MYPROG2

!ENDIF

!EOJ

Related Commands

JOB

2-52 MPE/iX Commands

MYPROG

and

COPY

COPY

Copies one le to another b

le. This command can b e used to cop

y creating a new le or b

y les to and from HFS directories.

Also, users with SM capabilities are able to cop

of their current logon account.

Syntax

COPY

2

FROM=

3

sourcele



;TO=

,



targetle

Parameters

sourcele

The name of the le that is to be copied. A le with HFS

syntax must begin with a dot (.), or a slash (/).

targetle

The name of the le to which

targetle

is omitted, the source le is copied to

the user's currentworking directory (CWD). You may qualify

targetle

destination

with both le and group names, or specify only the

group

. If only

group

of the source le in a le called

group.

yoverwriting an existing

y les to MPE accoun

2



3

ASK

4

5

YES

NO

sourcele

is to be copied. If

sourcele

is specied,

sourcele

COPY

in the sp ecied

ts outside

in

puts a copy

ASK

Since

.groupname

can be specied as the

targetle

, and HFS

le names can also start with a dot (.), this could lead to

confusion as to whether an MPE group or HFS le name is

desired for the

starting with a dot (.), then the

with a dot and slash (./). For example, to representa

.FOO

in an HFS currentworking directory, the le must b e

represented as

If

targetle

targetle

./.FOO

. If the

.

already exists,

targetle

targetle

COPY

prompts the user to choose an

is an HFS lename

must be preceded

targetle

action with the following prompt:

PURGE OLD

targetle

?

MPE/iX Commands 2-53

COPY

Valid replies to this prompt are:

YES

YorYES

NorNO

ASK

is the default, except in a job or in other cases when the

user is not using in

meaning, and

Instructs

COPY

message is displayed for the user, as w

ASK.YES

is the default in jobs, or at other times when the user

Instructs

COPY

and create a new

Instructs

COPY

teractive mode. In suc

YES

becomes the default.

to purge

targetle

to purge the original

targetle

.

to terminate.

h cases,

ASK

if it already exists. No

ould be the case with

targetle

has no

is not using an interactive mode.

NO

Instructs

COPY

to terminate if

targetle

already exists.

You may not specify system-wide ($prex), CM KSAM, or

privileged les as

sourceleortargetle

.

Operation Notes

This command performs a fast copyof

sourcele

unchanged. Both les must be nonspooled disk les residing on the

sourceletotargetle

and leaves

host system. You may specify les that are backreferenced with a le equation

(*). However, this command only supports three le equation options: the le

name, the nal disposition (

class (

;DEV= DISCor;DEV=<DISC LDEV NUMBER>

;TEMPor;SAVE

), and the disk volume or volume

). All other le equation

options are ignored.

The le disposition of

sourceleisTEMP,targetle

created as

PERM

. This le disp osition can b e overridden by using a le equation.

targetle

is created

defaults to that of

TEMP

.If

sourceleisPERM,targetle

sourcele

.For example, if

is

This is one of the three options supported for le equations.

All le access attributes of the source le, including ACDs (access control

denitions) are duplicated for the target le.

If a source le has an ACD, the ACD is copied to the target le. If a le does

not haveanACD, and it is copied outside an MPE group, it is automatically

assigned an ACD.

2-54 MPE/iX Commands

COPY

Use

This command maybeinvoked from a session, a job, a program, or in break

5

mode. Pressing

targetle

The

.

COPY

command can be in

4

aborts the execution of this command and purges the

Break

voked in break mode and does not suer from

process creation overhead.

The

Note

targetle max extent

sourcele

.

value may not be the same as for

Note

Directories cannot be copied using the

sourceleortargetle

is actually a directory, an error is

COPY

command. If

returned.

CM les and temporary les cannot b e copied to HFS directories.

Examples

To copy

ABCD.

logongrouptoEFG.

logongroup

,enter:

COPY ABCD, EFG

To copy

To copy

In the next example the le

ABCD.

logongrouptoABCD.

COPY ABCD, .

ABCD.

grptoABCD.

COPY ABCD.

grp

newgroup

newgroup

logongroup

,enter:

MYFILE.PUB.SYS

,enter:

is copied to

MyFile

under the

currentworking directory (CWD). Note that the target le name has to have

the dot and slash (./) prex.

d a

COPY myfile.pub.sys, ./MyFile

c b

MPE/iX Commands 2-55

COPY

In the next example, the le

File1

under the CWD is copied to

MYFILE.PUB

in

the current account.

d a

COPY ./File1, myfile.pub

c b

In the next example,

dir1

.

file1

in directory

dir0

is copied to

file2

in directory

d a

COPY ./dir0/file1, ./dir1/file2

c b

In the following example, the le

LOCK. The le is copied into

TEST

file1

has a lo ckword which is the word

in the

dir0

directory.

d a

COPY TEST/LOCK, ./dir0/file1

c b

The following example copies the le

example, if your CWD is

/ACCT/GRP/file

.

/ACCT/GRP

/a/b/file

to the CWD as \le". For

, then the copied le will be named

d a

COPY /a/b/file

c b

Related Commands

FCOPY

2-56 MPE/iX Commands

DISCUSE (UDC)

DISCUSE (UDC)

The

DISCUSE

UDC executes the

DISKUSE

command to display disk space

usage, in sectors, for one or more directories or a directory tree. This UDC is

provided for those who are used to sp elling disk with a \c".

Note

Syntax

DISCUSE

Parameters

Refer to the

used with the

DISCUSE

UDC.

dir name

TREE

NOTREE

USENAME

System-dened UDCs are not automatically a

System Manager must use the

SETCATALOG

vailable. Your

command to make

these UDCs available for your use. For example:

SETCATALOG HPPXUDC.PUB; SYSTEM

22

DISKUSE

3

DIR=

DISCUSE

dir name

32

;USENAME | ;TREE | ;NOTREE

3

command for a complete explanation of the parameters

UDC. The following parameters are supported with the

Directory name for which information is being listed (optional).

Causes all directories below and including

dir name

to b e

reported.

Causes

Causes

dir name

DISKUSE

only to be reported.

to use

dir name

name to decide whether or

not to displaymultiple levels of directories.

Operation Notes

The

DISCUSE

UDC runs the

DISKUSE

in sectors, for a directory. Refer to the

explanation of the operation.

command and reports disk space,

DISKUSE

command for a complete

MPE/iX Commands 2-57

DISCUSE (UDC)

Use

This UDC may b e issued from a session, a job, a program, or in break mo de.

5

Pressing

4

aborts execution.

Break

Examples

The following example illustrates the use of the

message is printed to remind you to use the

DISCUSE

DISKUSE

UDC. Note that a

command.

d a

DISCUSE

Please use the DISKUSE command.

^

SECTORS

TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)

BELOW

2100 330 .

c b

Refer to the

DISKUSE

command later in this chapter for additional examples.

Related Commands

DISKUSE

LISTFILE

REPORT

2-58 MPE/iX Commands

DISKUSE

DISKUSE

This command displays disk space usage, in sectors, for one or more directories

or a directory tree.

Syntax

DISKUSE

Parameters

dir name

TREE

NOTREE

22

DIR=

3

dir name

32

; TREE | NOTREE | USENAME

3

Directory name for which information is being listed (optional).

The

dir name

HFS-named directories may be shown if

dot (.) or a slash (/). If

in a slash, then all ob jects at all lev

dir name

The use of wildcards is permitted. If

is assumed to be an MPE syntax name.

dir name

dir name

is an HFS name and ends

els under and including

are rep orted, unless the

NOTREE

option is specied.

dir name

starts with a

is omitted, the

process' currentworking directory (CWD) is assumed.

Causes all directories below and including

reported. The

dir name

mayor may not end in a slash (/),

dir name

to b e

with no error or warning detected. Since the MPE naming

convention does not support a trailing slash (/), the

TREE

option is the only way to report multi-level disk space usage for

an MPE-named directory in a single command.

Causes

dir name

only to be reported. If

dir

name

name and ends in a slash (/), a warning tells you that

is an HFS

NOTREE

overrides the trailing slash (/).

USENAME

Causes

not to displaymultiple levels of directories. If

DISKUSE

to use

dir name

name to decide whether or

dir name

is an

HFS name and ends in a slash (/), then it and all directories

under it are shown. If

then only

dir name

dir name

does not end in a slash (/),

is rep orted. The

USENAME

parameter

only applies to HFS-named directories and is ignored for

MPE-named directories. The

USENAME

parameter is the

default.

MPE/iX Commands 2-59

DISKUSE

Operation Notes

You can use the

directory. Disk space allo cated to directories themselv

and MPE groups) is coun

DISKUSE

command to report on disk space, in sectors, for a

es (including accounts

ted as part of the total n

umber of sectors. The

process' CWD is shown for all relative pathnames.

The number of comp onents in the pathname con

being reported. If a pathname has four comp onen

then only directories with four or more comp onen

This also applies to the use of wildcard comp onen

/@/@/@/@

only counts directories with at least four componen

pathname (absolute or relative, depending on ho

names follow the same formula:

level below MPE groups. (

@.@.@

@.@

is the same since it is qualied with the logon

reports only MPE-named directories one

trols the level of directories

ts, for example,

/a/b/c/d

ts contribute to the output.

t names. For example,

ts in their

witwas specied). MPE

,

account name.)

Use

You must have traverse directory entries (TD) and read directory entries (RD)

permissions to each directory contributing to the rep orted totals. TD access is

needed to each directory component named in

dir

. (Refer to the

ALTSEC

name

command in this chapter for additional information on directory permissions.)

Note that the MPE syntax cannot specify a

only p ermits

alphanumeric. (If

called

group.account.logon account

dir.group.acctifdir

group.account

is a valid MPE name; that is, all upp ercase

were specied, it would be interpreted as a le

.)

group.account

. MPE syntax

Directory errors can occur while

DISKUSE

is collecting le space information.

For example, if you lack traverse directory entries (TD) access to one or more

of the lower level directories, an error o ccurs.

If you sp ecify

and RD access to.

;TREE

,you will only be able to see directories that you haveTD

DISKUSE

stops on the rst error encountered. This may

result in no data (other than a header) displayed, or in the case of wildcard

names, some directories are seen (up to the directory where the error o ccurred).

Even in the wildcard directory name case, once an error is encountered,

DISKUSE

terminates.

There are several ways to see all disk space used on the system:

2-60 MPE/iX Commands

DISKUSE

To show the disk space for ev

ery directory on the system, en

ter:

DISKUSE /

To show only the total system disk space in one line, en

ter:

DISKUSE /;NOTREE

NOTREE option overrides directory name ending in "/". (CIWARN 9041)

Note

Since the

warning is issued to tell y

dir name

in the ab ove example ends in a slash, a

ou the

NOTREE

option overrides the

trailing slash.

To display disk space used by all directories directly under the ro ot, en

ter:

DISKUSE /@

Examples

Figure 2-1 illustrates a hierarchical directory structure. In this gure, directory

names are shown as the characterdplus a number (for example,d0), and le

names are shown as the characterfplus a number (for examplef1). All of

the examples following Figure 2-1 assume the directory structure shown. For

illustrative purposes, the

HPPROMPT

variable has b een set to show the current

working directory (HPCWD). For example:

:setvar hpprompt "!!hpcwd:"

/ACCT/GROUP/d0:

MPE/iX Commands 2-61

DISKUSE

d a

/ACCT/GROUP/d0 = CWD

-----------------------------------|---------------------------------------

| | | | | |

d1 d2 d3 f1 f2 f3

| |

--------------|--------------- ----|--------------

| | | | | | | | | | |

d4 f4 f5 d5 d6 f6 d7 f7 f8 f9 f10

| | | |

---|-- ---| -----|---- --|-----------------------

| | | | | | | | | | | |

f11 f12 d8 f13 f14 f15 d9 f16 f17 f18 f19 f20

c b

Figure 2-1. Hierarchical Directory Structure

|

The example shown in Figure 2-2 illustrates the format of the

In this example, the

TREE

option is implied by the trailing slash (/).

DISKUSE

output.

2-62 MPE/iX Commands

DISKUSE

d a

/ACCT/GROUP/d0:diskuse ./

SECTORS

TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)

BELOW

64 + 0 ./d1/

96 32 ./d2/d4/

64 0 ./d2/d5/d8/

128 64 ./d2/d5/

112 48 ./d2/d6/

448 + 240 ./d2/

64 0 ./d3/d7/d9/

208 144 ./d3/d7/

336 + 128 ./d3/

48 + 0 (files directly below specified directory)

960 240 ./ (64 +)

/ACCT/GROUP/d0:

c b

Figure 2-2. DISKUSE Output Format

Note

The currentworking directory (CWD) relative displayis

shown as part of the header line. If the CWD name is long, it

truncates with a dollar sign ($).

Each of the columns contains information about the directory.

DIRECTORY

(left-justied) Displays the selected directory name, in

HFS-format. The directory pathname wraps around to the

next line if it is longer than the eld.

LEVEL BELOW

(right-justied) Shows the number of sectors allo cated directly

to all ob jects immediately under the named directory. The

space used by the listed directory le (container) do es not

contribute to this number, nor do es the space used by the

ob jects under directories under the displayed directory. The

sum of the number of sectors rep orted bya

LISTFILE

dir name

/@,2;NOTREE

MPE/iX Commands 2-63

DISKUSE

equals the number shown under the

number in the

LEVEL BELOW

column is zero if the reported

LEVEL BELOW

column. The

directory is empty.

TREE

(right-justied) Displays the total number of sectors used b

the directory listed. This includes space used b

itself, all les immediately under the directory

by all sub directory en

tries. The sum of the n

y the directory

, and space used

umber of sectors

y

seen in a

LISTFILE

equals the total number in the

dir name

,2;TREE

TREE

column.

The plus signs (+) shown in the TREE column of Figure 2-2 refer to the

directories that are one level below the target directory. When added, the

sectors shown in this example equal 896. The last entry shows the total

number of sectors (960) used by all subdirectories under the target directory

(896) plus the sectors used by the target directory itself (64).

The next example illustrates the use of the

NOTREE

option. Only the directory

name is displayed.

d a

/ACCT/GROUP/d0:diskuse /ACCT/GROUP/d0 ;notree

SECTORS

TREE LEVEL DIRECTORY

BELOW

960 240 /ACCT/GROUP/d0/

/ACCT/GROUP/d0:

c b

If the directory name parameter is omitted, the CWD is assumed, as seen in

the following example:

2-64 MPE/iX Commands

DISKUSE

d a

/ACCT/GROUP/d0:diskuse

SECTORS

TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)

BELOW

960 240 ./

c b

The next example illustrates the use of the

reported for the

dir name

(d3) and all directories b elo

TREE

option. Information is

w.

d a

/ACCT/GROUP/d0:diskuse ./d3/@ ;tree

SECTORS

TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)

BELOW

64 0 ./d3/d7/d9/

208 + 144 ./d3/d7/

208 ./d3/@

/ACCT/GROUP/d0:

c b

You can use MPE syntax as shown in the following example (note that the

dir name

(MYDIR) is upshifted.) This example is not based on the directory

structure shown in Figure 2-1.

d a

DISKUSE mydir.group.acct

SECTORS

TREE LEVEL DIRECTORY

BELOW

2100 330 /ACCT/GROUP/MYDIR

c b

MPE/iX Commands 2-65

DISKUSE

Note

You can use wildcards to see a \horizon

arbitrary directory depth. Wildcarding can be used in

output, as shown in the following examples.

d a

/ACCT/GROUP/d0:diskuse ./@

TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)

/ACCT/GROUP/d0:

c b

The output is presented in HFS syn

name is supplied in MPE syn

specify the directory name in MPE syn

output is the user-supplied directory name (upshifted) in MPE

format.

SECTORS

BELOW

64 + 0 ./d1/

448 + 240 ./d2/

336 + 128 ./d3/

848 ./@

tax. If wildcards were used to

tal cut" of disk space usage at an

tax, even if the directory

tax, then the nal line of

TREE

and

NOTREE

Using Wildcards with NOTREE Output

2-66 MPE/iX Commands

DISKUSE

d a

/ACCT/GROUP/d0:diskuse ./@/

SECTORS

TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)

BELOW

64 + 0 ./d1/

96 32 ./d2/d4/

64 0 ./d2/d5/d8/

128 64 ./d2/d5/

112 48 ./d2/d6/

448 + 240 ./d2/

64 0 ./d3/d7/d9/

208 144 ./d3/d7/

336 + 128 ./d3/

848 ./@

/ACCT/GROUP/d0:

c b

Using Wildcards with TREE Output

The last line of output contains the directory name and the total n

of sectors (under the

the sum of all other

TREE

column). The nal

TREE

numbers for directories with the same n

TREE

number always equals

umber

umber of

components as contained in the user-specied name that are designated with

a plus sign (+) in the

with three components, then the sum of the

TREE

column. For example, if you sp ecied a pathname

TREE

eld for all directory names

with exactly three components equals the nal total value.

Related Commands

LISTFILE

REPORT

MPE/iX Commands 2-67

EDITOR

The

EDITOR

create and alter ASCII text les.

Syntax

EDITOR

Parameters

None.

Operation Notes

Usage

command starts the EDIT/3000 subsystem, whic

h enables you to

You can enter this command from a session or a job. Y

it from a program unless you or the program have process handling (PH)

capability.You also cannot enter this command from break mo de.

5

Pressing

command continues execution.

Examples

Table 2-1 lists the primary EDIT/3000 commands, explains their purpose, and

provides an example of each command.

4

suspends execution of this command; entering the

Break

ou cannot enter

RESUME

2-68 MPE/iX Commands

Table 2-1. Primary EDIT/3000 Commands

Command Purpose Example

EDITOR

ADD

CHANGE

COPY

DELETE

END

FIND

HOLD

INSERT

JOIN

KEEP

Toenter lines of text in

to the work le or

from the hold le

To replace old text with new text

To duplicate portions of text from one

location to another in the w

ork le

To delete characters and lines from the

work le

To terminate execution of EDIT/3000

To locate a point in the work le

To copy text from the work le into the

hold le (either replacing or appending)

To insert text into the work le from the

terminal and the hold le

To add all or part of a le to the w

ork le

Tosave all or part of the work le in a

user le

ADD 60,HOLD

CHANGE "RECORD" TO

"LINE" IN 40/70

COPY 11/20 TO 80 BY .1

DELETE

50/75,150(3)/155(7)

END

FIND *; FIND "PROGRAM"

HOLD 100/150,APPEND;

HOLD 1/10

INSERT 25(4)

JOIN FILE02 TO 1000 by

.1

KEEP FILE02

LIST

MODIFY

REPLACE

To displayany part or all of the work le

To modify text in the work le using

three operations of delete (D), insert (I),

and replace (R)

To replace lines in the work le

LIST 10/30

MODIFY 50/100

REPLACE 10/20,HOLD,NOW

MPE/iX Commands 2-69

EDITOR

Table 2-1. Primary EDIT/3000 Commands (continued)

Command Purpose Example

TEXT

XPLAIN

Related Commands

FCOPY

PRINT

To copy the contents of a user le in

work le to be edited

To get help on one or more commands.

(XPLAIN ALL provides help on all

commands.)

to the

TEXT FILE02

XPLAIN TEXT

2-70 MPE/iX Commands

EOJ

The

EOJ

command terminates an input le batc

h job and displays the CPU

time and the elapsed time since the beginning of the job. This command

is used in conjunction with the

JOB

command to create an input le for

streaming.

Syntax

EOJ

Parameters

None.

Operation Notes

Usage

You can enter this command from a job, but not from a session, a program,

5

or in break mode. Pressing

4

does not aect this command.

Break

EOJ

Omitting the command

If you omit this command from an input le, the next

JOB

command

terminates the current job and starts a new one. The standard end-of-job

display indicates the end of the rst job, and the normal job initiation

display indicates the beginning of the next job.

Example

To terminate an input le batch job, insert the following in your text le:

!JOB USER.PUBS

!RUN MYPROG1

!RUN MYPROG2

!EOJ

MPE/iX Commands 2-71

EOJ

Related Commands

EXIT

JOB

STREAM

2-72 MPE/iX Commands

FCOPY

FCOPY

FCOPY

is a utility within the system similar to the

COPY

command, which

enables you to copy data from one le to another le. The

utility provides more exibility and capabilities than the

however.

Syntax

From MPE:

FCOPY

8

FROM=

sourcele

;TO=

92

targetle

32

3

;NEW

From the FCOPY subsystem:

FCOPY

Parameters

FROM

TO

NEW

Species the name of the le (

Species the name of the le (

to be copied. If you omit

$STDLIST

device.

sourcele

targetle

) to be copied.

) to which

targetle,sourcele

Creates a new permanent disk le. The default is that

targetle

must already exist.

FCOPY

COPY

command,

is copied to the

command

sourcele

is

Operation Notes

Usage

You can enter this command from a session, a job, or a program. Pressing

4

5

suspends the execution of this command. Entering the

Break

RESUME

command continues execution of the command.

If you enter this command from a program, either you or the program must

have process handling (PH) capability.

Utility capabilities

The

FCOPY

command enables you to do the following tasks:

MPE/iX Commands 2-73

FCOPY

Copy data from any input device to any output device.

Create multiple copies of les.

Create account-independent magnetic tap e copies of disk les to

move from one HP 3000 system to another. (The

commands, however, are recommended for mo

STORE

and

RESTORE

ving les between systems.)

Transfer programs or data from one medium to another (magnetic tape to

disk, for example).

Convert data from one computer co de system (EBCDIC, for instance) to

another (ASCI I, for instance) as y

ou copy the data.

Copy portions of a le.

Refer to the

FCOPY Reference Manual

(32212-90003) for information on using

these capabilities.

Examples

To copy the le

TEST

to a new le named

TEMP

from the MPE command

interpreter, enter:

:FCOPY FROM=TEST;TO=TEMP;NEW

HP32212A.03.30 FILE COPIER (C) HEWLETT-PACKARD CO. 1990

EOF FOUND IN FROMFILE AFTER RECORD 23

23 RECORDS PROCESSED *** 0 ERRORS

END OF SUBSYSTEM

:

2-74 MPE/iX Commands

FCOPY

To copy the le

subsystem and then exit, en

:FCOPY

HP32212A.03.30 FILE COPIER (C) HEWLETT-PACKARD CO. 1990

>FROM=TEST2;TO=TEMP2;NEW

EOF FOUND IN FROMFILE AFTER RECORD 23

23 RECORDS PROCESSED *** 0 ERRORS

>EXIT

END OF SUBSYSTEM

:

Related Commands

COPY

RENAME

TEST2

to a new le named

ter:

TEMP2

from the

FCOPY

utility

MPE/iX Commands 2-75

FILE

This' command enables you to create a le equation that o

programmatic or system default le sp ecications.

Syntax

3

F

5

U

V



333



,BINARY

,ASCII

formsmsg

35353



3

FILE

formaldesignator

2

2#32

;DEV=

2

;REC=

2

recsize

4

2

;ENV=

envle

2

;FORMID=

device

32

formid

32,2

2

3

2

4

,

;ACC=



3

;NOCCTL

;CCTL



*formaldesignator

=

lereference

outpri32,

numcopies

2

3

blockfactor

2

4

332

APPEND



2

4

,

;FORMS=

Parameters

formal-

designator

The formal le designator, interpreted according to

MPE-escaped semantics

formaldesignator

MPE le (i.e., one that uses MPE syntax) or it can be a

POSIX le name beginning with a dot or a slash. F

you can use the escaped pathname

equivalent to the MPE name

/SYS/PUB/FILE

FILE.PUB.SYS

verrides

5

, can be either an

or example,

since it is

.

If the le designator follows MPE syntax, it must use this

format:

lename[.groupname[.accountname]][:envid]

2-76 MPE/iX Commands

The

lename,groupname

and

accountname

identiers may

each contain up to eight uppercase alphanumeric characters.

The

envid

has twovalid forms:

node[.domain[.organization]]

envname[.domain[.organization]]

If

formaldesignator

is not equated to another le, the

parameter species the name of an actual le.

FILE

*formal-

designator

lereference

Species a backreference to a formal le designator dened in

the

FILE

command. Note that this bac

only if it appears to the righ

t of the equal sign (=).

kreferenced form is valid

The actual le designator of the le, interpreted according to

MPE-escaped semantics.

lereference

can be either an MPE

le (i.e., one that uses MPE syntax) or it can be a POSIX le

name beginning with a dot or a slash. F

use the escaped pathname

to the MPE name

FILE.PUB.SYS

/SYS/PUB/FILE

.

or example, you can

since it is equivalent

If the le designator follows MPE syntax, it must use this

format:

lename[/lockword][.groupname[.accountname]][:envid]

The

lename,groupname

and

accountname

identiers may

each contain up to eight uppercase alphanumeric characters.

The

envid

has twovalid forms:

node[.domain[.organization]]

envname[.domain[.organization]]

If you include this command in a job and

lereference

includes

alockword that you omit from the command line, MPE/iX

will not open the le. In a session, MPE/iX prompts you for a

lockword as necessary.

MPE/iX Commands 2-77

FILE

DEV

REC

Species a parameter with one or more of three parameter

options:

device,outpri

,or

numcopies

.Ifyou use

DEV

,you

must include at least one of these parameters or the # sym

which species the default device class of

You can use a previously dened en

the

DEV

parameter, but you cannot use the domain and

DISC

.

vironment identier for

organization qualiers.

Descriptions of the parameter options are as follo

device

Species the logical device class name or

ws:

logical device number of a device, suchasa

disk, tap e, printer, or a terminal. The default

is

DISC

.

outpri

Species the output priority requested for an

output sp ool le, which can range from 1 (the

lowest priority) to 13 (the highest priority).

numcopies

Species the number of copies requested for an

output sp ool le. The maximum n

umber is

127.

Species a parameter with the follo wing parameter options:

recsize

Indicates the record size. If you do not use the

DEV

parameter, the default is

DISC

with 1023

records.

bol,

2-78 MPE/iX Commands

A positiv e number indicates words; a negative

number indicates bytes. For xed-length

les,

recsize

undened-length les,

record size. For variable-length les,

is the logical record size. For

recsize

is the maximum

recsize

is the maximum logical record size if the

blockfactor

Only this parameter option applies to

$STDINX

parameter options for these les, the

is 1.

,or

$STDLIST

$STDIN

.If you sp ecify other

FILE

command returns an error.

,

FILE

ENV

blockfactor

Species the number of logical records per

physical block for new les. The maximum size

is 255.

F, U,orV

Denes the format of the records of the le.

A le can contain xed-length records (F),

undened-length records (U), or variable-length

records (V). The default isFfor disk les.

BINARY

ASCII

or

Species the type of records.

BINARY

indicates

binary-coded records and is the default.

ASCII

indicates ASCII-co ded records.

Species the name of a le,

envle

, containing printer

environment information, which controls the print output

formats on the printer. Not all printers support this feature

of accepting environment information. The

envle

can be an

actual le designator, or it can be a formal le designator

preceded by an asterisk (*).

The information in the

envle

can contain specications

for page size, character fonts, forms, and other printer

requirements to b e used with the HP laser prin

The le must be in a suitable form for do

ting system.

wnloading to the

printer.

ACC

FORMS

For example, to specify the environment le

ACCTENV.HPENV.SYS

to be used when printing, enter:

FILE ACCTLIST;DEV=ACCTPP;ENV=ACCTENV.HPENV.SYS

For information on creating an environment le for your

printer, refer to your printer documentation.

Species only app end access to any le.

Provides an op erator message requesting that certain forms be

mounted. The message must appear and be replied to at the

console b efore the output data can print on a line printer.

The message can consist of a string of 49 or fewer ASCII

characters terminated by a period. You can use this parameter

MPE/iX Commands 2-79

FILE

to send control characters for bells and in

attempt to send other con

the asso ciated control character letter may appear.

FORMID

Identies a special form to b e moun

applies to output spool les. The parameter consists of a string

of up to eight alphanumeric characters, beginning with a letter,

that uniquely identies the special form.

A message displaying the

$STDLIST

spooler pro cess then w

forms are mounted before printing the le for which the

was specied.

NOCCTL

CCTL

or

Indicates whether or not you are sp ecifying carriage-control

characters.

specifying carriage-control characters in writes to the le.

indicates that you are specifying carriage-control characters in

writes to the le.

Operation Notes

Usage

verse video. If you

trol characters, however, blanks and

ted. This parameter only

formid

prints on the console or

of the asso ciated user of the spo oled device. The

aits for verication that the special

formid

NOCCTL

, the default, indicates that you are not

CCTL

You can enter this command from a session, a job, a program, or in break

5

mode. Pressing

4

does not aect this command.

Break

Requirements

To use this command for a le, you must specify a valid, formal le

designator, which is the name by whichyour program recognizes the le.

The formal le designator enables commands and code outside y

our program

to reference the le.

Command duration

The

FILE

command remains in eect for the entire job or session unless you

cancel it by using the

RESET

command or you enter another

FILE

command

for the same formal le designator.

2-80 MPE/iX Commands

Examples

FILE

To run the program

references two les by the le names (

uses two existing disk les,

MYPROG

that do es the follo

formaldesignators)SOURCE

INX

and

OUTX

, as the actual les for the

wing:

program

Enter:

:FILE SOURCE=INX

:FILE DEST=OUTX

:RUN MYPROG

To send output to a new le,

FILEX

, that has 64-word xed-length records

and two records per block in ASCI I code, enter:

:FILE DEST=FILEX,NEW;REC=64,2,F,ASCII

:RUN MYPROG

Note that the le equation only mo dies the specied items.

Related Commands

BUILD

LISTEQ

RESET

and

DEST

MPE/iX Commands 2-81

HELLO

The

HELLO

command initiates an in

Syntax

2

HELLO

sessionname

2

/

acctpass

Parameters

32

,

groupname

3

,

username

2

teractive session.

2

/

userpass

/

grouppass

33



3

.

acctname

;INPRI=

;HIPRI

inputpriority



sessionname

username

userpass

acctname

acctpass

Species an arbitrary name used in conjunction with the

username

and

acctname

parameters to form a fully qualied

session identity. The name must contain from one to eight

alphanumeric characters, b eginning with an alphabetic

character. The default is no assigned session.

Species a user name that your system manager assigns,

enabling you to log on to this account. The name must contain

from one to eight alphanumeric characters, b eginning with an

alphabetic character.

Species a user password that your system manager optionally

assigns. The password must contain from one to eight

alphanumeric characters, b eginning with an alphabetic

character. A slash (/) must precede the user password.

Species the account name that your system manager assigns.

The name must contain from one to eight alphanumeric

characters, beginning with an alphab etic character. A p eriod

(.) must precede the account name.

Species the account password that your system manager

assigns. The password must contain from one to eight

alphanumeric characters, b eginning with an alphabetic

character. A slash (/) must precede the account password.

2-82 MPE/iX Commands

HELLO

groupname

grouppass

INPRI

HIPRI

Species the group name that y

our system manager assigns

to be used for the local le domain and the CPU-time and

connect-time charges. The name must contain from one to

eight alphanumeric characters, b eginning with an alphabetic

character. The default is your home group if y

manager does not assign y

ou a group name. This parameter is

our system

required if a home group is not assigned.

Species the group password that your system manager

assigns, but is not required to log on to y

The password must contain from one to eigh

our home group.

t alphanumeric

characters, beginning with an alphab etic character. A slash (/)

must precede the group password.

The value

inputpriority

determines the relative input priority

of the session used in checking against access restrictions

imposed by the jobfence. The value of this parameter becomes

eective at the time of logon.

The value of

inputpriority

can range from 1 (lowest priority) to

13 (highest priority). The default is 8. If you supply a value

less than or equal to the current jobfence, access is denied to

the session.

Enables you to either override the system jobfence or to

override the session limit to log on. If y

ou sp ecify this

parameter to override the jobfence, the system rst determines

whether or not you have system manager (SM) or system

operator (OP) capability.Ifyou have either of these

capabilities, you are logged on and your input priority defaults

to the system's jobfence and execution limit.

If you do not have either capability and you specify this

parameter, the following message appears:

MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY HIPRI, MAXIMUM

INPRI OF 13 IS USED (CIWARN 1460)

MPE/iX Commands 2-83

HELLO

Operation Notes

Usage

You must enter this command from a terminal; y

ou cannot use any other

device to enter this command. You cannot enter this command from a job, a

program, or in break mo de. Pressing

this command, but may prematurely terminate the prin

4

Break

5

does not ab ort the execution of

ting of the welcome

message.

You must supply both a v

command, or the system rejects y

alid

username

and

acctname

our logon attempt and displa

in your logon

ys an error

message. If your logon attempt is accepted, the system displays specic logon

information and prompts you for your next op erating system command. If

your system administrator has set up a welcome message, it appears after the

system verication of your logon.

If you connect through a modem and do not log on within the allo

system-congured time, the line drops. You must redial and press

wable

4

Return

5

again.

If you are already logged on and you enter the

HELLO

command, you are

logged o your current session and logged on to a new session.

In addition to the user and account names, you may be required to provide a

group name and one or more passwords.

Providing a group name

The group you select at logon for your lo cal le domain is known as your

logon group. If your system administrator has asso ciated a home group with

your

username

, and if you want to use this group as your logon group, you

need not specify it. The system automatically assigns the home group as

your logon group when you log on; however, if you want to use another group

as your logon group, you must sp ecify the name of that group in your logon

string as shown in the following example:

MPE XL:HELLO USER.TECH,MYGROUP

If your user name is not related to a home group, you must enter a group

name in the

HELLO

command string, or your logon attempt fails.

2-84 MPE/iX Commands

Entering passwords

HELLO

Your system administrator can assign y

to enhance the securit

yofyour account and to prevent unauthorized

ou user and group passw

ords

accumulation of charges against your account. When you sp ecify your home

group as your logon group, you need not en

group has a passw

name, or group that has a passw

ord; however, If you want to access any other account, user

ord, you must supply the password when

ter a password, even if your home

you log on.

You can supply the passw

by a forward slash (

password

XPASS

, and if you want to access this group as your logon group,

ord after the name of the protected en

/

). For instance, if a group named

XGROUP

tity, preceded

requires the

you could enter the password as shown:

MPE XL:HELLO USER.TECH,XGROUP/XPASS

For security purposes, the system also provides another method of entering

passwords so that they do not appear to others in y

our work area. To

use this metho d, just enter the command string without the required

password(s); the system will prompt you for the password(s). The system

turns o character echo so that what you type does not appear on the

screen. If you enter the incorrect password, the prompt reappears and you

havetwo more opp ortunities to enter the correct password. After the third

incorrect entry, the message

5

press

4

Return

to receive a new prompt, and then you must enter the

INCORRECT PASSWORD

appears. You must then

HELLO

command again to start a new logon process.

Access p ermissions and restrictions

After logging on, if the normal (default) le securit

y provisions of the system

are op erative, you can access all les in your logon and home groups. You

can also read les and execute programs stored in the

of your account and the

PUB

(public) group of the

PUB

(public) group

SYS

(system) account;

however, you cannot access any other les.

MPE/iX Commands 2-85

HELLO

Example

To start a session with the follo wing names assigned to the asso ciated

parameters:

ALPHA

USER

TECH

XGROUP

XPASS

Enter the following command string at the MPE/iX op erating system prompt:

The system responds by displaying the follo wing logon message:

Related Commands

for the session name

for the user name

for the account name

for the group name

for the group password

MPE XL:HELLO ALPHA,USER.TECH,XGROUP/XPASS

HP3000 RELEASE: V.UU.FF USER VERSION: V.UU.FF WED, May 1, 1991, 10:12 AM

MPE XL HP31900 A.11.70 Copyright Hewlett-Packard 1987. All Rights Reserved.

:

BYE

EXIT

JOB

JOBFENCE

LIMIT

SHOWJOB

2-86 MPE/iX Commands

HELP

HELP

The

HELP

command provides online reference information for individual

commands. You can request partial or complete information for a particular

command. You can also use the

a le. You can either enter the

directly,oryou can access the Help F

HELP

commands from the subsystem. Refer to \Operation Notes" for more

HELP

command to display the contents of

HELP

command and the desired parameters

acility subsystem and enter individual

information.

Syntax

Direct access:

9

3

>

>

>

>

7

>

>

7

>

>

5

>

>

>

=

>

>

>

>

>

>

>

>

>

>

>

;

HELP

8

>

>

>

>

>

>

>

commandname

>

>

>

>

<

lename

>

>

>

>

>

HELPSTUDY

>

>

>

>

SUMMARY

>

>

:

CLASS

2

,PARMS

6

,OPERATION

6

4

,EXAMPLE

,ALL

Subsystem access:

8

>

>

>

>

>

>

>

>

>

>

>

>

>

<

4

Return

5

>

>

>

>

>

>

>

>

>

>

>

>

>

:

HELP

commandname

HELPMENU

HELPSTUDY

SUMMARY

CLASS

EXIT

2

,PARMS

6

,OPERATION

6

4

,EXAMPLE

,ALL

9

3

>

>

>

>

7

>

>

7

>

>

5

>

>

>

>

>

=

>

>

>

>

>

>

>

>

>

>

>

>

>

;

MPE/iX Commands 2-87

HELP

Parameters

command-

name

lename

Species any command. Without additional k

system displays the command name, syn

description. Specifying the follo

wing keywords provides the

eywords, the

tax, and a brief

information indicated:

PARMS

This keyword lists and provides a description

for all parameters of the specied command.

OPERATION

This keyword describes how to use the

specied command.

EXAMPLE

This keyword displays an example showing

usage of the specied command.

ALL

This keyword displays the information from all

of the keywords (

PARMS,OPERATION,EXAMPLE

).

If you wanttoenter a keyword with a command, you must

separate the keyword from the command using a space or

comma.

Species any existing le name. When you specify this

parameter with the command, the system displays the contents

of the le and a header indicating whether it is a command le

or program le. You cannot specify this parameter from within

the Help Facility subsystem.

HELPMENU

Displays the main menu of the Help Facilit y subsystem, from

whichyou can choose several options. This automatically

appears when you invoke the subsystem, but you can also

access this menuby specifying this parameter after the Help

Facility prompt (>) within any p ortion of the facility.

HELPSTUDY

Provides a tutorial designed to familiarize novice users with the

fundamentals of commands and command syntax.

SUMMARY

Provides a brief summary of operating system changes,

including a quickoverview of the operation of the Help Facility.

CLASS

Lists commands by functional class.

2-88 MPE/iX Commands