HP 3000 Manuals

Task-Related Commands [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation


MPE/iX Commands Reference Manual Volume I

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.

SYSGEN        Starts configuration dialog and/or installation tape
              creation.

Command Interpreter Programming 

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

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 900 Series HP 3000.

PREP          Prepares a compatibility mode program from a user
              subprogram library onto a program file.

PREPRUN       Prepares and executes a compiled compatibility mode
              program.

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       Aborts a single pending I/O request for a device.
=ABORTIO

ASSOCIATE     Gives a user operator control of a device.

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 

ALTSEC        Changes a file's security provisions.

BUILD         Creates and allocates a new empty file on disk.

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.

PRINT         Prints the contents of a file.

PURGE         Deletes a file from the system.

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      Aborts a job or session.
=ABORTJOB

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.

CALC          Evaluates an expression.

CHGROUP       Switches user from current group to another group within
              the logon account.

DO            Used to edit/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.

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.

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        Displays all pending console REPLY messages.
=RECALL

REPLY         Replies to pending resource request messages that require a
=REPLY        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          Changes the filter and/or priority limits of circular
              subqueues.

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-      Displays status information about opened user logging files
STATUS        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.

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 

ESCAPE        Allows the CI programmer to simulate all aspects of CI
              error handling.

OPTION        Modifies the environment of user-defined commands and
              command files.

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.



MPE/iX 5.0 Documentation