HP (Hewlett-Packard) 3000 User Manual

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 ﬁtness 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.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1. Commands by Task

Task-Related Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

2. Command Deﬁnitions 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 Deﬁnitions C-E

CALC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

CCXL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

CCXLGO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

CCXLLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

CHANGELOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

CHDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

CHGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

COB74XL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

COB74XLG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

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 Deﬁnition F-K

FCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .232

FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234

FINDDIR (UDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248

FINDFILE (UDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249

FORMSALIGN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250

FORTGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254

FORTPREP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256

FORTRAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258

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 Deﬁnitions 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. Command Deﬁnitions 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 Deﬁnitions S-SO

SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .536

SECURE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .538

SEGMENTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .540

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 Deﬁnitions 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

VSRESERVESYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .700

VSTORE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .701

VSUSER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .710

WARN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .711

WELCOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .713

WHILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .715

XEQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .717

A. Predeﬁned 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

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. Speciﬁed Variable-ID/Result. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605

Table 8-1. Logical Operators - The WHILE Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715

Table A-1. Predeﬁned Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719

Table B-1. Expression Evaluator Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726

Table B-2. FINFO Speciﬁcations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 Deﬁnitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763

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 deﬁnition 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 deﬁnition.

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 Deﬁnitions 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 ﬁlename with the name of the ﬁle:

COMMAND ﬁlename

{ } 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

COMMAND {ON | OFF}

[ ] In a syntax statement, brackets enclose optional elements. In the following

example,

OPTION can be omitted:

COMMAND ﬁlename [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 ﬁlename [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 ﬁrst 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] |...|

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 speciﬁc task or provide speciﬁc information.

Chapter 1 13

Commands by Task

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 identiﬁed 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-Deﬁned Commands.

• Using Computer Language Programs. To use this chapter, ﬁrst determine what task you want to perform, for example, create a

new account. Check the list above to ﬁnd an appropriate category, which in this case would be "Managing Accounts, Groups, and Users". Turn to that category and you will ﬁnd a list of MPE/iX commands that perform tasks related to managing accounts and a description of the particular function for each command.

14 Chapter 1

Commands by Task

Task-Related Commands

Check that list to ﬁnd 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 conﬁguration 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 ﬁle. INPUT Allows you to interactively assign a value to any variable that can be set

with the SETVAR command.

Chapter 1 15

Commands by Task

Task-Related Commands

RETURN Causes execution to return from the current user command (UDC or

command ﬁle) to the calling environment

SETVAR Creates or modiﬁes a CI variable. WHILE Used to control execution in a job, session, UDC, or command ﬁle.

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 ﬁle. 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 ﬁle.

PREPRUN Prepares and executes a compiled compatibility mode program. PROGRAM

FILENAME Executes a program. Note the ﬁlename may be qualiﬁed 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 speciﬁed account(s). LISTGROUP Displays information about a speciﬁed group(s). LISTUSER Displays information about a speciﬁed 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.

16 Chapter 1

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 conﬁguration. 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 ﬁles. SHOWOUT Displays the status of output device ﬁles. 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 ﬁle’s owner or group ID ALTSEC Changes a ﬁle's security provisions. BUILD Creates and allocates a new empty ﬁle on disk. CHDIR Changes the current working directory. COPY Copies one ﬁle to another ﬁle. DATA Enters data into the system from a device ﬁle. FILE Declares ﬁle attributes for a ﬁle when it is opened. LISTEQ Displays all active ﬁle equations for a job or session. LISTF Displays information about permanent ﬁles.

Chapter 1 17

Commands by Task

Task-Related Commands

LISTFILE Lists ﬁle information using native mode scanning/parsing that can be

easily expanded.

LISTFTEMP Displays information about temporary ﬁles. NEWDIR Creates a directory NEWLINK Creates a symbolic link PRINT Prints the contents of a ﬁle. PURGE Deletes a ﬁle from the system. PURGEDIR Deletes a directory. PURGELINK Deletes a symbolic link, empty directory, or a regular ﬁle. RELEASE Removes all security provisions for a ﬁle. RENAME Changes the name of a ﬁle. RESET Cancels ﬁle equations. RESTORE Returns ﬁles stored on tape to the system. SAVE Saves a ﬁle in the permanent system ﬁle domain. SECURE Restores security provisions for a ﬁle. STORE Copies disk ﬁles onto magnetic tape for storage. VSTORE Veriﬁes 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 ﬁle or terminates data

initialized by the DATA command. EOJ Ends a batch job. EXIT Terminates the command interpreter.

18 Chapter 1

Commands by Task

Task-Related Commands

HELLO Initiates an interactive session. JOB Deﬁnes a job to be activated in conjunction with the STREAM command to

run in batch mode.

JOBFENCE Deﬁnes 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 speciﬁed 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 speciﬁed 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 spoolﬁle. DELETESPOOLFILE Deletes a spoolﬁle from disk. LISTSPF Produces a listing of spooled ﬁles, both input and output. OPENQ Opens the spool queue for a speciﬁed logical device or device class.

Chapter 1 19

Commands by Task

Task-Related Commands

OUTFENCE Deﬁnes the minimum priority an output spoolﬁle 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 speciﬁed logical device or device class. SPOOLER Controls spooler processes. SPOOLF Allows a qualiﬁed user to alter, print, or delete output spoolﬁles. STOPSPOOL Terminates spooling to a speciﬁed 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 speciﬁc operator command. ALTPROC Changes the priority for the speciﬁed 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 speciﬁc operator command. DISCRPS Enables/disables rotational position sensing on a speciﬁed logical device. ERRDUMP Dumps a process or system error stack. FREERIN Releases a global resource identiﬁcation number (RIN). GETRIN Acquires and assigns a password to a global resource identiﬁcation

number (RIN).

PAUSE Suspends current activity for a speciﬁed 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.

20 Chapter 1

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 identiﬁer. CHANGELOG Changes the user logging ﬁle without stopping or interrupting the logging

process.

GETLOG Establishes a logging identiﬁer on the system. LISTLOG Lists active logging identiﬁers and whether automatic log ﬁle changing

has been enabled.

LOG Starts, restarts, or stops user logging. RELLOG Removes a user logging identiﬁer from the system. RESUMELOG Resumes system logging following suspension caused by an error. SHOWLOG Displays the number of the system's current log ﬁle and the percentage of

disk space used.

SHOWLOGSTATUS Displays status information about opened user logging ﬁles assigned to a

logging identiﬁer.

SWITCHLOG Closes the current system log ﬁle, 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 predeﬁned 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 speciﬁc 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.

Chapter 1 21

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 speciﬁed volume set and takes it ofﬂine. 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 speciﬁed

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-Deﬁned Commands

ANYPARM Deﬁne 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 Modiﬁes the environment of user-deﬁned commands and command ﬁles. PARM Deﬁnes a parameter for a UDL or command ﬁle. RETURN Used in user command ﬁles to return execution to the calling environment. SETCATALOG Speciﬁes a ﬁle containing user-deﬁned commands. SHOWCATALOG Displays information about user-deﬁned commands (UDCs). XEQ Executes a program or command ﬁle.

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.

22 Chapter 1

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 ﬁle. 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 ﬁle. 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.

Chapter 1 23

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.

24 Chapter 1

Command Deﬁnitions A-B

2 Command Deﬁnitions A-B

This chapter provides information on MPE/iX commands. For your convenience, they are arranged in alphabetical order. Each command speciﬁcation contains the following information:

Command Name Provides the command name at the top of each page followed by a brief

deﬁnition of its function. Syntax Provides information in diagram format deﬁning 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

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.

Break key

Chapter 2 25

Command Deﬁnitions A-B

26 Chapter 2

Command Deﬁnitions A-B

Commands and Parameters

MPE/iX commands tell the computer to perform a speciﬁc function. The parameters you enter for each command tell the computer to perform the function in a speciﬁc way. MPE/iX uses four classiﬁcations of parameters:

• Required parameters.

• Optional parameters.

• Keyword parameters.

• Positional parameters. These four classiﬁcations of parameters are brieﬂy deﬁned 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 myﬁle is not surrounded by any marks, it is a required parameter:

BUILD myﬁle

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-deﬁned default values for each parameter. In the following example, [;PASS] is an optional parameter since it is surrounded by brackets:

NEWGROUP groupname [;PASS=[password]]

Chapter 2 27

Command Deﬁnitions 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 ﬁlename;REC=128,1,F,ASCII

If you choose to use the system-deﬁned default value F, you need not specify it, but you must hold the position with a comma:

BUILD ﬁlename;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 ﬁlename;REC=128,1,F,ASCII

Refer to the section "Combining Positional/Keyword Parameters," below, for additional information.

28 Chapter 2

Command Deﬁnitions A-B

Commands and Parameters

Chapter 2 29

Command Deﬁnitions A-B

Native Mode Command Structure

Many commands in this chapter have the designation Native Mode at the end of their deﬁnition. This means that the command is parsed by the Native Mode Command

Parser. If Native Mode is not speciﬁed, 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 speciﬁcation shown in the syntax diagram for each command in this chapter.

• By using positional parameter speciﬁcations to enter keyword parameter values.

• By combining positional and keyword speciﬁcation

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 Speciﬁcation

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 Speciﬁcation

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 speciﬁcations 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

30 Chapter 2

+ 744 hidden pages