3000
MPE/iX Commands Reference Manual
HP 3000 MPE/iX Computer Systems
Edition 10
32650-90864
E1098
Printed in: U.S.A. October 1998
Notice
The information contained in this document is subject to change
without notice.
Hewlett-Packard makes no warranty of any kind with regard to this
material, including, but not limited to, the implied warranties of
merchantability or fitness for a particular purpose. Hewlett-Packard
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 reliability of
its software on equipment that is not furnished by Hewlett-Packard.
This document contains proprietary information which is protected by
copyright. All rights reserved. Reproduction, adaptation, or translation
without prior written permission is prohibited, except as allowed under
the copyright laws.
Restricted Rights Legend
Use, duplication, or disclosure by the U.S. Government is subject to
restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in
Tec hnical Data and Computer Software clause at DF ARS 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.
© Copyright 1996, 1998 by Hewlett-Packard Company
3
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1. Commands by Task
Task-Related Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
2. Command Definitions A-B
Commands and Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Native Mode Command Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Remote Sessions and Command Intrinsics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Running the CI as a Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
ABORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
ABORTIO/ =ABORTIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
ABORTJOB/ =ABORTJOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
ACCEPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
ALLOCATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
ALLOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
ALTACCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
ALTFILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
ALTGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
ALTJOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
ALTLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
ALTPROC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
ALTSEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
ALTSPOOLFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
ALTUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
ASSOCIATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
BASIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
BASICGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
BASICOMP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
BASICPREP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
BBASIC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
BBASICGO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
BBASICOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
BBASICPREP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
BBXL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
BBXLCOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
BBXLGO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
BBXLLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
BREAKJOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
BUILD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
BYE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
3. Command Definitions C-E
CALC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
CCXL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
CCXLGO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
CCXLLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
CHANGELOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
CHDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
CHGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
COB74XL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
COB74XLG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
4
COB74XLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146
COB85XL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149
COB85XLG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153
COB85XLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156
COBOLII . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159
COBOLIIGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162
COBOLIIPREP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
COMMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
CONSOLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167
CONTINUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
DEALLOCATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177
DEBUG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .179
DELETESPOOLFILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
DELETEVAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
DISALLOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185
DISASSOCIATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188
DISCRPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
DISCUSE (UDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191
DISKUSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193
DISMOUNT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198
DO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
DOIONOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
DOWNLOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210
DSTAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
ECHO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
EDITOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
ELSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
ELSEIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218
ENDIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220
ENDWHILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221
EOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .222
EOJ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224
ERRCLEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225
ERRDUMP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226
ESCAPE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
EXIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
4. Command Definition F-K
FCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .232
FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
FINDDIR (UDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248
FINDFILE (UDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
FORMSALIGN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250
FORTGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254
FORTPREP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256
FORTRAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258
5
FREERIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
FTN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
FTNGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
FTNPREP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
FTNXL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
FTNXLGO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
FTNXLLK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
GETLOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
GETRIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
HEADOFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
HEADON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
HELLO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
HELP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
IF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
INPUT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
JOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
JOBFENCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
JOBPRI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
JOBSECURITY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
LDISMOUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
LIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
LINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
LISTACCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
LISTDIR (UDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
LISTEQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
LISTF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
5. Command Definitions L-O
LISTFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
LISTFTEMP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
LISTGROUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
LISTJOBQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
LISTLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
LISTREDO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
LISTSPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
LISTUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
LMOUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
LOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
=LOGOFF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
=LOGON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
MOUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
NEWACCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
NEWDIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
NEWGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
NEWJOBQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
NEWLINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
NEWUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
NSCONTROL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
OCTCOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
OPENQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
OPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
OUTFENCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
6
6. Command Definitions P-R
PASCAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .414
PASCALGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .416
PASCALPREP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .418
PASSWORD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .420
PASXL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .421
PASXLGO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .424
PASXLLK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .426
PAUSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .428
PLISTF (UDC). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .432
PREP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .434
PREPRUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .437
PRINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .442
PURGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .447
PURGEACCT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .450
PURGEDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .452
PURGEGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .457
PURGEJOBQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .459
PURGELINK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .460
PURGEUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .461
RECALL/=RECALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .463
REDO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .465
REFUSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .471
RELEASE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .472
RELLOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .474
RENAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .475
REPLY/=REPLY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .477
REPORT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .479
RESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .482
RESETACCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .484
RESETDUMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .485
RESTORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .486
RESUME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .501
RESUMEJOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .503
RESUMELOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .504
RESUMESPOOL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .505
RETURN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .507
RPG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .508
RPGGO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .510
RPGPREP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .512
RPGXL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .515
RPGXLGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .518
RPGXLLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .520
RUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .522
7. Command Definitions S-SO
SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .536
SECURE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .538
SEGMENTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .540
7
SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
SETCATALOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
SETCLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
SETCOUNTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
SETDUMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
SETJCW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
SETMSG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
SETVAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
SHOWALLOCATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
SHOWALLOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
SHOWCATALOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
SHOWCLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572
SHOWDEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573
SHOWIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
SHOWJCW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
SHOWJOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581
SHOWLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
SHOWLOGSTATUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
SHOWME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
SHOWOUT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
SHOWPROC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
SHOWQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
SHOWTIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
SHOWVAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
=SHUTDOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
SHUTQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
8. Command Definitions SP-Z
SPEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
SPL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614
SPLGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
SPLPREP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
SPOOLER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622
SPOOLF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
STARTSESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639
STARTSPOOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
STOPSPOOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647
STORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649
STREAM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667
STREAMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673
SUSPENDSPOOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675
SWITCHLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677
SYSGEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679
TELL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
TELLOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683
TUNE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684
UP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687
VMOUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
VSCLOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
VSOPEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693
VSRELEASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695
VSRELEASESYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697
VSRESERVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698
8
VSRESERVESYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .700
VSTORE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .701
VSUSER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .710
WARN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .711
WELCOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .713
WHILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .715
XEQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .717
A. Predefined Variables in MPE/iX
B. Expression Evaluator Functions
References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .733
Expression Evaluator Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .739
C. Terminal and Printer Types
D. Subsystem Formal File Designators
E. MPE/iX File Codes
F. Wildcard Characters
9
Restricted Rights Legend 2
Table 2-1. Parm= values for the CI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Table 2-2. Default Parameters for the ALTACCT Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Table 2-3. Default Values for the ALTGROUP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Table 2-4. Default Values for the ALTUSER Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Table 3-1. Logical Operators - The CALC Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Table 3-2. Results of CALC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Table 3-3. Command Acceptance of Naming Conventions - DISMOUNT Command. . . . . . . . . . . 199
Table 3-4. DO Command - Reexecute Directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Table 3-5. Editing Directives for the DO Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Table 3-6. Editing Samples for the DO Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Table 3-7. Disk Drive Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Table 3-8. Logical Operators - The ELSEIF Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Table 3-9. End-of-File Indicators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Table 4-1. Logical Operators - The IF Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Table 4-2. INPUT Command Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Table 4-3. Command Acceptance of Naming Conventions - LDISMOUNT Command. . . . . . . . . . 309
Table 4-4. Checklevel Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Table 4-5. Format Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Table 5-1. Format Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Table 5-2. List Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
Table 5-3. History Stack Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
Table 5-4. Command Acceptance of Naming Conventions - LMOUNT Command. . . . . . . . . . . . . 368
Table 5-5. Command Acceptance of Naming Conventions - MOUNT Command . . . . . . . . . . . . . . 375
Table 5-6. Account Manager Default Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
Table 5-7. CI Commands Affected by Symbolic Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Table 5-8. User Capabilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
Table 6-1. PRINT Command Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
Table 6-2. Re-execute Directives for the REDO Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
Table 6-3. Editing Directives for the REDO Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
Table 6-4. REDO Editing Samples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
Table 7-1. Logical Operators - The SETVAR Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
Table 7-2. Specified Variable-ID/Result. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
Table 8-1. Logical Operators - The WHILE Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715
Table A-1. Predefined Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719
Table B-1. Expression Evaluator Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726
Table B-2. FINFO Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735
Table C-1. MPE/iX Terminal Types and Similar MPE V/E Terminal Types. . . . . . . . . . . . . . . . . . 747
Table C-2. MPE/iX Printer Types and Similar MPE V/E Terminal Types . . . . . . . . . . . . . . . . . . . 747
Table C-3. MPE V/E Terminal and Similar MPE/iX Terminal Types . . . . . . . . . . . . . . . . . . . . . . . 748
Table C-4. MPE V/E Terminal and Similar MPE/iX Printer Types. . . . . . . . . . . . . . . . . . . . . . . . . 748
Table D-1. Formal File Designators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751
Table E-1. File Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757
Table F-1. Table F-1. Wildcard Character Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763
10
11
Preface
The ninth edition of the MPE/iX Commands Reference Manual is one volume with
command descriptions alphabetically from A through X. This manual is written for all
users of the HP 3000 MPE/iX Computers. MPE/iX, Multiprogramming Executive with
Integrated POSIX, is the latest in a series of forward-compatible operating systems for the
HP 3000 line of computers.
In HP documentation and in talking with HP 3000 users, you will encounter references to
MPE XL, the direct predecessor of MPE/iX. MPE/iX is a superset of MPE XL. All programs
written for MPE XL will run without change unde MPE/iX. You can continue to use MPE
XL system documentation, although it may not refer to features added to the operating
system to support POSIX (for example, hierarchical directories).
Finally, you may encounter references to MPE V, which is the operating system for HP
3000s, not based on the P A-RISC architecture . MPE V software can be run on the PA-RISC
(Series 900) HP 3000s in what is known as compatibility mode.
The MPE/iX Commands Reference Manual is organized into eight chapters. A description
of each chapter follows:
Chapters 2 thru 8 of this manual, explains the purpose, syntax, parameters, and operation
(including examples) for each MPE/iX command. If you know which command to use for
the task you wish to perform, turn directly to that command definition in chapter 2. For
your convenience, commands are organized alphabetically. If you don't know which
command to use, Chapter 1, which contains a listing of commands by task, is a good place
to start. After reading the brief description, turn to the appropriate command definition.
For supplemental information on command syntax and use, refer to the MPE/iX General
User's Reference Manual.
Chapter 1 Commands by Task provides an introduction to all MPE/iX commands
and their functions, categorized by the task they perform.
Chapters 2-8 Command Definitions provides documentation on each MPE/iX
command alphabetically for your ease of use.
Conventions
The following conventions are used throughout this manual.
italics In a syntax statement or an example, a word in intalics represents a
parameter or argument that you must replace with the actual value. In
the following example, you must replace filename with the name of the file:
COMMAND filename
{ } In a syntax statement, braces enclose required elements. When several
elements are included within braces, you must select one. In the following
example, you must select either
ON or OFF
12
COMMAND {ON | OFF}
[ ] In a syntax statement, brackets enclose optional elements. In the following
example,
OPTION can be omitted:
COMMAND filename [OPTION]
When several elements are enclosed within brackets, you canm select one
or none of the elements. In following example, you can select OPTION or
parameter or neither. The elements cannot be repeated.
COMMAND filename [OPTION | parameter]
[ ... ] In a syntax statement, horizontal ellipses enclosed in brackets indicate
that you can repeatedly select the element(s) that appear within the
immediately preceding pair of brackets or braces. In the example below,
you can select parameter zero or more times. Each instance of parameter
must be preceded by a comma:
[,parameter][...]
In the example below, you can only use the commas as a delimiter if
papameter is repeated; no comma is used before the first occurrence of
papameter:
[parameter][ ,... ]
| ... | In a syntax statement, horizontal ellipses enclosed in vertical bars indicate
that you can select more that one element within the immediately
prededing pair of brackets or braces. However, each particular element can
only be selected once. In the followig example you must select A, AB, BA,
or B. The elements cannot be repeated.
[A | B] |...|
Chapter 1 13
Commands by Task
1 Commands by Task
Commands are used to communicate with the MPE/iX operating system. They request
MPE/iX to perform a specific task or provide specific information.
14 Chapter 1
Commands by Task
Task-Related Commands
Task-Related Commands
This chapter is an introduction to MPE/iX commands and their functions, categorized by
the task they perform.
The categories of tasks identified for MPE/iX commands are:
• Accessing Subsystems and Utilities.
• Command Interpreter Programming Tools.
• Communicating with Other Users.
• Executing User Programs.
• Managing Accounts, Groups, and Users.
• Managing Devices.
• Managing Files.
• Managing Jobs and Sessions.
• Managing Spooler Operations.
• Managing System Resources.
• Managing User/System Logging.
• Managing Variables and Job Control Words.
• Managing Volumes (Disk Drives).
• Using Command Files and User-Defined Commands.
• Using Computer Language Programs.
To use this chapter, first determine what task you want to perform, for example, create a
new account. Check the list above to find an appropriate category, which in this case would
be "Managing Accounts, Groups, and Users". Turn to that category and you will find a list
of MPE/iX commands that perform tasks related to managing accounts and a description
of the particular function for each command.
Chapter 1 15
Commands by Task
Task-Related Commands
Check that list to find an appropriate functional description, which in this case is "Creates
a new account". Then check the lefthand column for the name of the command that
performs that function, which in this case is NEWACCT.
When you have located the command that most closely performs the task you want to
accomplish, turn to chapter 2 of this manual for complete information about the syntax,
parameters, operation, use, and examples for that command. For your convenience, the
commands in chapter 2 are listed in alphabetical order.
Command Function
Accessing Subsystems and Utilities
DEBUG Instructs MPE/iX to enter the system debugger.
EDITOR Starts the EDIT/3000 subsystem.
FCOPY Runs the FCOPY subsystem
HELP Accesses the help subsystem.
RESETDUMP Disarms the debug facility call that is made during abnormal process
termination.
SEGMENTER Starts the MPE segmenter.
SETDUMP Arms the system debug facility for a process abort.
SH UDC that executes SH.HPBIN.SYS, the POSIX shell
SYSGEN Starts configuration dialog and/or installation tape creation.
VOLUTIL Managing user volume sets
Command Interpreter Programming
CALC or # Evaluates an expression
COMMENT Inserts a comment into a job stream or user command.
CONTINUE Overrides a job error so that the job or user command continues executing.
ECHO Displays a message on the terminal for a session or the printer for a job.
ELSE Provides an alternate execution sequence within an IF statement.
ELSEIF Provides an alternate execution sequence within an IF statement.
ENDIF Terminates an IF block.
ENDWHILE Terminates a WHILE block.
ESCAPE Allows the CI programmer to simulate all aspects of CI error handling.
IF Used to control the execution sequence of a job, UDC, or command file.
INPUT Allows you to interactively assign a value to any variable that can be set
with the SETVAR command.
16 Chapter 1
Commands by Task
Task-Related Commands
RETURN Causes execution to return from the current user command (UDC or
command file) to the calling environment
SETVAR Creates or modifies a CI variable.
WHILE Used to control execution in a job, session, UDC, or command file.
Communicating with Other Users
TELL Sends a message to another active session.
TELLOP Sends a message to the system console.
WARN Sends an urgent message to jobs/sessions.
WELCOME Used to create the system welcome message.
Executing User Programs
LINK Creates an executable program file.
OCTCOMP Converts a compiled MPE V/E program into native mode code for the HP
3000 Series 900.
PREP Prepares a compatibility mode program from a user subprogram library
onto a program file.
PREPRUN Prepares and executes a compiled compatibility mode program.
PROGRAM
FILENAME Executes a program. Note the filename may be qualified using the
HPPATH CI variable
RUN Executes a prepared or linked program.
Managing Accounts, Groups, and Users
ALTACCT Changes the attributes of an existing account.
ALTGROUP Changes the attributes of an existing group.
ALTUSER Changes the attributes of an existing user.
LISTACCT Displays information about a specified account(s).
LISTGROUP Displays information about a specified group(s).
LISTUSER Displays information about a specified user(s).
NEWACCT Creates a new account.
NEWGROUP Creates a new group.
NEWUSER Creates a new user.
PURGEACCT Removes an account from the system.
PURGEGROUP Removes a group from the system.
Chapter 1 17
Commands by Task
Task-Related Commands
PURGEUSER Removes a user from an account.
REPORT Displays accounting information about the logon account and group.
Managing Devices
ABORTIO
=ABORTIO Aborts a single pending I/O request for a device.
ASSOCIATE Gives a user operator control of a device.
DEVCNTRL Script that ejects a tape an/or sets a tape device online.
DISASSOCIATE Removes control of a device from a user.
DOWN Removes a device from normal system use.
DOWNLOAD Downloads format information to a line printer.
HEADOFF Stops header/trailer output to a device.
HEADON Resumes header/trailer output to a device.
SET Sets terminal and $STDLIST configuration.
SETMSG Enables/disables receipt of user or operator messages on the terminal.
SHOWDEV Reports the status of input/output devices.
SHOWIN Reports the status of input device files.
SHOWOUT Displays the status of output device files.
SPEED Sets the input/output speed for a terminal.
STREAMS Enables/disables the STREAMS device allowing users to submit job/data
streams to a designated device.
UP Returns a device (except disk drives) stopped with a DOWN command to
normal function on the system.
Managing Files
ALTFILE Changes a file’s owner or group ID
ALTSEC Changes a file's security provisions.
BUILD Creates and allocates a new empty file on disk.
CHDIR Changes the current working directory.
COPY Copies one file to another file.
DATA Enters data into the system from a device file.
FILE Declares file attributes for a file when it is opened.
LISTEQ Displays all active file equations for a job or session.
LISTF Displays information about permanent files.
18 Chapter 1
Commands by Task
Task-Related Commands
LISTFILE Lists file information using native mode scanning/parsing that can be
easily expanded.
LISTFTEMP Displays information about temporary files.
NEWDIR Creates a directory
NEWLINK Creates a symbolic link
PRINT Prints the contents of a file.
PURGE Deletes a file from the system.
PURGEDIR Deletes a directory.
PURGELINK Deletes a symbolic link, empty directory, or a regular file.
RELEASE Removes all security provisions for a file.
RENAME Changes the name of a file.
RESET Cancels file equations.
RESTORE Returns files stored on tape to the system.
SAVE Saves a file in the permanent system file domain.
SECURE Restores security provisions for a file.
STORE Copies disk files onto magnetic tape for storage.
VSTORE Verifies data on native mode backup media and reports errors incurred by
STORE when writing the tape.
Managing Jobs and Sessions
ABORT Aborts the current program or operation.
ABORTJOB =ABORTJOB Aborts a job or session.
ACCEPT Permits a designated device to accept jobs/sessions and/or data.
ALTJOB Alters the attributes of waiting or scheduled jobs.
BREAKJOB Suspends an executing job.
BYE Ends an interactive session.
CHDIR Changes the current working directory.
CHGROUP Switches user from current group to another group within the logon
account.
DO Used to reexecute commands in the command line history stack.
:EOD Denotes end-of-data on the input stream from a job file or terminates data
initialized by the DATA command.
EOJ Ends a batch job.
EXIT Terminates the command interpreter.
Chapter 1 19
Commands by Task
Task-Related Commands
HELLO Initiates an interactive session.
JOB Defines a job to be activated in conjunction with the STREAM command to
run in batch mode.
JOBFENCE Defines the minimum input priority a job or session must have in order to
execute.
JOBPRI Sets or changes the default and/or maximum execution priority for batch
jobs.
JOBSECURITY Designates what level of user may request resources and control the
execution of jobs.
LIMIT Limits the number of concurrently running jobs/sessions for the entire
system or for individual job queues.
LISTJOBQ Lists a job queue
LISTREDO Displays the contents of the command line history stack.
=LOGOFF Aborts all executing jobs/sessions and prevents any further logons.
=LOGON Enables job/session processing following a =LOGOFF command.
NEWJOBQ Creates a new job queue
PAUSE Sleep for a specified number of seconds or until a job(s) terminates.
PURGEJOBQ Deletes a job queue
REDO Used to edit/reexecute commands in the command line history stack.
REFUSE Disables jobs/sessions and/or data on a designated device.
RESUME Resumes execution of a suspended operation.
RESUMEJOB Resumes a suspended job.
SHOWJOB Displays status information about jobs/sessions.
SHOWME Reports job/session status.
SHOWTIME Displays the current time and date.
STARTSESS Creates a session on the specified device for a user with programmatic
sessions (PS) capability.
STREAM Spools batch jobs or data from a session or job.
Managing Spooler Operations
ALTSPOOLFILE Alters the characteristics of an output spoolfile.
DELETESPOOLFILE Deletes a spoolfile from disk.
LISTSPF Produces a listing of spooled files, both input and output.
OPENQ Opens the spool queue for a specified logical device or device class.
20 Chapter 1
Commands by Task
Task-Related Commands
OUTFENCE Defines the minimum priority an output spoolfile needs in order to be
printed.
RESUMESPOOL Resumes suspended spooler output to a spooled device.
STARTSPOOL Initiates the spooler process for a device.
SHUTQ Closes the spool queue for a specified logical device or device class.
SPOOLER Controls spooler processes.
SPOOLF Allows a qualified user to alter, print, or delete output spoolfiles.
STOPSPOOL Terminates spooling to a specified device or device class.
SUSPENDSPOOL Suspends output to a spooled device.
Managing System Resources
ALLOCATE Loads a compatibility mode program or procedure into main memory.
ALLOW Grants a user access to a specific operator command.
ALTPROC Changes the priority for the specified processes.
CONSOLE Changes the system console from its current device to another
job-accepting terminal.
DEALLOCATE Deallocates a program or procedure previously loaded into memory with
the ALLOCATE command.
DISALLOW Prohibits access to a specific operator command.
DISCRPS Enables/disables rotational position sensing on a specified logical device.
ERRDUMP Dumps a process or system error stack.
FREERIN Releases a global resource identification number (RIN).
GETRIN Acquires and assigns a password to a global resource identification
number (RIN).
PAUSE Suspends current activity for a specified number of seconds.
RECALL =RECALL Displays all pending console REPLY messages.
REPLY =REPLY Replies to pending resource request messages that require a response.
RESETACCT Resets the system counters for CPU-time or connect-time, used by an
account and its groups, to zero.
SETCLOCK Sets the system clock.
SETCOUNTER Sets the next value of a resource counter.
SHOWALLOW Displays allowed operator commands.
SHOWCLOCK Displays information about the system date and time.
SHOWPROC Displays information about one or more processes.
Chapter 1 21
Commands by Task
Task-Related Commands
SHOWQ Displays process scheduling data and the contents of each subqueue.
=SHUTDOWN Initiates a shutdown of MPE/iX.
TUNE Alters the dispatcher subqueues which determine when processes must
relinquish the CPU.
Managing User/System Logging
ALTLOG Alters the attributes of an existing user logging identifier.
CHANGELOG Changes the user logging file without stopping or interrupting the logging
process.
GETLOG Establishes a logging identifier on the system.
LISTLOG Lists active logging identifiers and whether automatic log file changing
has been enabled.
LOG Starts, restarts, or stops user logging.
RELLOG Removes a user logging identifier from the system.
RESUMELOG Resumes system logging following suspension caused by an error.
SHOWLOG Displays the number of the system's current log file and the percentage of
disk space used.
SHOWLOG-
STATUS Displays status information about opened user logging files assigned to a
logging identifier.
SWITCHLOG Closes the current system log file, then creates and opens a new one.
Managing Variables and Job Control Words
DELETEVAR Deletes one or more MPE/iX variables.
ERRCLEAR Zeros out all HP predefined error-related variables.
INPUT Allows you to interactively assign a value to any variable that can be set
with the SETVAR command.
SETJCW Creates or assigns a value to a job control word (JCW) variable.
SETVAR Assigns values to MPE/iX variables.
SHOWJCW Displays the current status of job control word variables.
SHOWVAR Displays current values for specific variables.
Managing Volumes (Disk Drives)
DSTAT Displays current status of system disk drives.
DISMOUNT Causes a volume set that was explicitly reserved by a user to be released.
22 Chapter 1
Commands by Task
Task-Related Commands
LDISMOUNT Causes a volume set that was reserved system-wide by the user to be
released.
LMOUNT Reserves a volume set system-wide.
MOUNT Reserves an online volume set.
VMOUNT Enables/disables the MPE/iX movable volume facility.
VOLTIL Defragment diskspace, general user volume management
VSCLOSE Closes a specified volume set and takes it offline.
VSOPEN Reopens a volume set closed with VSCLOSE.
VSRELEASE Releases a volume set that was explicitly reserved by the user with
VSRESERVE.
VSRELEASESYS Cancels a previously issued VSRESERVESYS command for a specified
volume set.
VSRESERVE Reserves a particular volume set online.
VSRESERVESYS Reserves a volume set online system-wide.
VSUSER Lists all users of a currently reserved, mountable volume set.
Using Command Files and User-Defined Commands
ANYPARM Define a parameter that accepts all characters without the need for quotes.
ESCAPE Allows the CI programmer to simulate all aspects of CI error handling.
OPTION Modifies the environment of user-defined commands and command files.
PARM Defines a parameter for a UDL or command file.
RETURN Used in user command files to return execution to the calling environment.
SETCATALOG Specifies a file containing user-defined commands.
SHOWCATALOG Displays information about user-defined commands (UDCs).
XEQ Executes a program or command file.
Using Computer Language Programs
BASIC Interprets a compatibility mode BASIC/V program.
BASICGO Compiles, prepares, and executes a compatibility mode BASIC/V program.
BASICOMP Compiles a compatibility mode BASIC/V program.
BASICPREP Compiles and prepares a compatibility mode BASIC/V program.
BBASIC Starts execution of the HP Business BASIC/V interpreter in compatibility
mode.
BBASICGO Compiles, prepares, and executes an HP Business BASIC/V program in
compatibility mode.
Chapter 1 23
Commands by Task
Task-Related Commands
BBASICOMP Compiles an HP Business BASIC/V program in compatibility mode.
BBASICPREP Compiles and prepares an HP Business BASIC/V program in compatibility
mode.
BBXL Initiates execution of the HP Business BASIC/XL interpreter.
BBXLCOMP Compiles an HP Business BASIC/XL program.
BBXLGO Compiles, links, and executes an HP Business BASIC/XL program.
BBXLLK Compiles and links an HP Business BASIC/XL program.
CCXL Compiles an HP C/iX program.
CCXLGO Compiles, links, and executes an HP C/iX program.
CCXLLK Compiles and links an HP C/iX program.
COB74XL Compiles an HP COBOL II/XL program using the 1974 ANSI standard
entry point and creates an object file.
COB74XLG Compiles, links, and executes an HP COBOL II/XL program using the
ANSI 1974 standard entry point.
COB74XLK Compiles and links an HP COBOL II/XL program using the 1974 ANSI
standard entry point.
COB85XL Compiles an HP COBOL II/XL program using the 1985 ANSI standard
entry point and creates an object file.
COB85XLG Compiles, links, and executes an HP COBOL II/XL program using the
ANSI 1985 standard entry point.
COB85XLK Compiles and links an HP COBOL II/XL program using the 1985 ANSI
standard entry point.
COBOLII Compiles a compatibility mode COBOLII program on the COBOL 74
compiler.
COBOLIIGO Compiles, prepares, and executes a compatibility mode COBOLII program
on the COBOL 74 compiler.
COBOLIIPREP Compiles and prepares a compatibility mode COBOLII program on the
COBOL 74 compiler.
FORTGO Compiles, prepares, and executes a compatibility mode FORTRAN 66/V
program.
FORTPREP Compiles and prepares a compatibility mode FORTRAN 66/V program.
FORTRAN Compiles a compatibility mode FORTRAN 66/V program.
FTN Compiles a compatibility mode HP FORTRAN 77/V program.
FTNGO Compiles, prepares, and executes a compatibility mode HP FORTRAN
77/V program.
FTNPREP Compiles and prepares a compatibility mode HP FORTRAN 77/V
program.
24 Chapter 1
Commands by Task
Task-Related Commands
FTNXL Compiles an HP FORTRAN 77/iX program.
FTNXLGO Compiles, links, and executes an HP FORTRAN 77/iX program.
FTNXLLK Compiles and links an HP FORTRAN 77/iX program.
PASCAL Compiles a compatibility mode Pascal/V program.
PASCALGO Compiles, prepares, and executes a compatibility mode Pascal/V program.
PASCALPREP Compiles and prepares a compatibility mode Pascal/V program.
PASXL Compiles an HP Pascal/iX program.
PASXLGO Compiles, links, and executes an HP Pascal/iX program.
PASXLLK Compiles and links an HP Pascal/iX program.
RPG Compiles an RPG/V program in compatibility mode.
RPGGO Compiles, prepares, and executes an RPG/V program in compatibility
mode.
RPGPREP Compiles and prepares an RPG/V program in compatibility mode.
RPGXL Compiles an RPG/XL program.
RPGXLGO Compiles, links, and executes an RPG/XL program.
RPGXLLK Compiles and links an RPG/XL program.
SPL Compiles a compatibility mode SPL/V program.
SPLGO Compiles, prepares, and executes a compatibility mode SPL/V program.
SPLPREP Compiles and prepares a compatibility mode SPL/V program.
Chapter 2 25
Command Definitions A-B
2 Command Definitions A-B
This chapter provides information on MPE/iX commands. For your convenience, they are
arranged in alphabetical order. Each command specification contains the following
information:
Command Name Provides the command name at the top of each page followed by a brief
definition of its function.
Syntax Provides information in diagram format defining how to enter the
command and its parameters.
Parameters Provides an explanation of each parameter and its function, limitations,
and defaults.
Operation Notes Provides an explanation of the operation of the command and notes on
any special considerations.
Use Provides information on the conditions within which the command can be
used such as a session, job, program, or in BREAK. This entry also
indicates whether the command can be interrupted with the
Break key
and, if appropriate, lists any special capabilities required to use it. Refer to
the NEWACCT command for a list of special capabilities.
Examples Provides examples of how to use the command.
Related Information Provides pointers to other commands or manuals that might
contain additional information.
26 Chapter 2
Command Definitions A-B
Chapter 2 27
Command Definitions A-B
Commands and Parameters
Commands and Parameters
MPE/iX commands tell the computer to perform a specific function. The parameters you
enter for each command tell the computer to perform the function in a specific way.
MPE/iX uses four classifications of parameters:
• Required parameters.
• Optional parameters.
• Keyword parameters.
• Positional parameters.
These four classifications of parameters are briefly defined below. To understand the
command syntax diagrams, refer to the Conventions pages in the front of this manual.
Required Parameters
If a command has any required parameters, they must be entered or MPE/iX displays an
error message. In the syntax diagrams for each command in this chapter, required
parameters are either surrounded by no other marks or by braces { }. In the following
example, since myfile is not surrounded by any marks, it is a required parameter:
BUILD myfile
In some cases, you must select one parameter from a list of two or more parameters. In the
following example, you must provide either a job number or a session number since these
parameters are surrounded by braces:
ALTJOB [#Jnnn | #Snnn]
Optional Parameters
If a command has any optional parameters, you can either specify or ignore them,
depending upon how you want the command to execute. In the syntax diagrams for each
command in this chapter, optional parameters are surrounded by brackets [ ]. If you
ignore optional parameters, MPE/iX uses the system-defined default values for each
parameter. In the following example, [;PASS] is an optional parameter since it is
surrounded by brackets:
NEWGROUP groupname [;PASS=[password]]
28 Chapter 2
Command Definitions A-B
Commands and Parameters
Positional Parameters
The meaning of a positional parameter depends upon its position (location) in the
parameter list. In the syntax diagrams for each command in this chapter, positional
parameters are separated from each other by a comma (,). If you omit a positional
parameter from the list, you must provide the comma placeholder that would normally
precede that parameter. In the following example, the subparameters of the REC
parameter of the BUILD command can be treated as positional parameters:
BUILD filename;REC=128,1,F,ASCII
If you choose to use the system-defined default value F, you need not specify it, but you
must hold the position with a comma:
BUILD filename;REC=128,1,,ASCII
Keyword Parameters
A keyword parameter denotes the meaning or value of a given parameter. In the syntax
diagrams for each command in this chapter, keyword parameters appear in uppercase
(CAPITAL) letters (although you may enter them in either uppercase or lowercase) and are
preceded by a semicolon (;). In the following example, REC is a keyword parameter:
BUILD filename;REC=128,1,F,ASCII
Refer to the section "Combining Positional/Keyword Parameters," below, for additional
information.
Chapter 2 29
Command Definitions A-B
Commands and Parameters
30 Chapter 2
Command Definitions A-B
Native Mode Command Structure
Native Mode Command Structure
Many commands in this chapter have the designation Native Mode at the end of their
definition. This means that the command is parsed by the Native Mode Command
Parser. If Native Mode is not specified, the command is parsed by the Compatibility
Mode Command Parser. (A command parser separates command parameters.) There is
no relationship between the parser a command uses and the function(s) the command
performs. Also, just because a command is parsed by the Compatibility Mode parser
does not mean it functions in the same way it did in the Classic HP3000 environment.
All new commands for MPE/iX use the NM parser. Some commands used on MPE V/E
which have been changed for MPE/iX use the NM parser and some do not. MPE V/E
commands which have not been changed for MPE/iX generally use the CM parser.
The important thing to remember is that the Native Mode parser accepts several different
formats for commands that you enter at the colon prompt (:). You may enter these
NM-parsed commands in one of the following ways:
• By using the formal command specification shown in the syntax diagram for each
command in this chapter.
• By using positional parameter specifications to enter keyword parameter values.
• By combining positional and keyword specification
Another difference between the NM parser and the CM parser is that the CM parser
restricts a single comand parameter value to be <=255 characters. On the NM side, the
value is limited by the size of the CI’s command buffer.
Formal Command Specification
You may enter an NM-parsed command as shown in the syntax diagram for each
command, for example:
COMMAND KEYWORD1=A;KEYWORD2=B;KEYWORD3=C
Positional Parameter Specification
Y ou ma y also enter an NM-parsed command by omitting the keyword parameter name and
only entering the values as positional parameters, for example:
COMMAND A,B,C
If you omit the keyword specifications and enter the values as positional parameters, the
values must be treated as such, and all rules for positional parameters must be followed.
For example, if you only specify A and C, you must use the positional place holder (,) as
shown in the following example:
COMMAND A,,C
Loading...