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.

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