<< LINES .001/.009 ARE RESERVED FOR SYSTEMS INTEGRATION>>               00005000
\ENTRY=HELPMENU,SESSIONS,JOBS,PROGRAMS,FILES,MANAGE,OPERATOR,SPOOL,UTIL 00010000
Information is available on the following classes of commands:          00015000
  Running Sessions                                                      00020000
  Running Jobs                                                          00025000
  Managing Files                                                        00030000
  Running Subsystems and Programs                                       00035000
  System Management, Status, and Accounting                             00040000
  Operator Control                                                      00045000
  Spooler Control                                                       00050000
  Utility Functions                                                     00055000
                                                                        00060000
For more information, enter a KEYWORD.  You can also enter any command  00065000
name as a keyword.  Enter 'help' for information on help.  Enter 'exit' 00070000
to leave help.                                                          00075000
\ITEM=SESSIONS                                                          00080000
Running Sessions.  Following are the commands used:                     00085000
   COMMAND ( ) LOG ON                                                   00090000
   ABORT                                                                00095000
   BYE                                                                  00100000
   DSLINE                                                               00105000
   EOD                                                                  00110000
   EOF                                                                  00115000
   HELLO                                                                00120000
   HELP                                                                 00125000
   REMOTE                                                               00130000
   REMOTE HELLO                                                         00135000
   RESUME                                                               00140000
   STARTSESS                                                            00145000
                                                                        00150000
You can use any command as a keyword.                                   00155000
\ITEM=JOBS                                                              00160000
Running Jobs.  Following are the commands used.                         00165000
   COMMENT                                                              00170000
   CONTINUE                                                             00175000
   DATA                                                                 00180000
   EOD                                                                  00185000
   EOF                                                                  00190000
   EOJ                                                                  00195000
   IF                                                                   00200000
   ENDIF                                                                00205000
   ELSE                                                                 00210000
   JOB                                                                  00215000
   SET                                                                  00220000
   SETJCW                                                               00225000
   SHOWJCW                                                              00230000
   STREAM                                                               00235000
                                                                        00240000
You can use any command name as a keyword.                              00245000
\ITEM=PROGRAMS                                                          00250000
Running Subsystems & Programs.  Following are the commands used:        00255000
   APL            DEBUG          PREP           SPLPREP                 00260000
   BASIC          DSCOPY         PREPRUN        VINIT                   00265000
   BASICGO        EDITOR         RESETDUMP                              00270000
   BASICOMP       FCOPY          RJE                                    00275000
   BASICPREP      FORTGO         RPG                                    00280000
   COBOLII        FORTPREP       RPGGO                                  00285000
   COBOLIIGO      FORTRAN        RPGPREP                                00290000
   COBOLIIPREP    IMF            SEGMENTER                              00295000
   COBOL          IMFMGR         SETDUMP                                00300000
   COBOLGO        MRJE           SPL                                    00305000
   COBOLPREP      NRJE           SPLGO                                  00310000
                                                                        00315000
You can use any command name as a keyword.                              00320000
\ITEM=FILES                                                             00325000
Managing Files/Device Files.  Following are the commands used:          00330000
   ALTSEC         LISTEQ         PURGEVSET         STORE                00335000
   ALTVSET        LISTF          RELEASE           VSUSER               00340000
   ASSOCIATE      LISTFTEMP      RENAME                                 00345000
   BUILD          LISTVS         RESET                                  00350000
   DISASSOCIATE   MOUNT          RESTORE                                00355000
   DISMOUNT       NEWVSET        SAVE                                   00360000
   FILE           PURGE          SECURE                                 00365000
                                                                        00370000
                                                                        00375000
You can use any command name as a keyword.                              00380000
\ITEM=MANAGE                                                            00385000
System Management, Status and Accounting.                               00390000
   Status            Accounting           System      Resource          00395000
   ------            ----------         Management   Management         00400000
                                        ----------   ----------         00405000
                                                                        00410000
   DSTAT        ALTACCT    NEWGROUP     ALLOCATE       ALTLOG           00415000
   SHOWCACHE    ALTGROUP   NEWUSER      DEALLOCATE     CACHECONTROL     00420000
   SHOWDEV      ALTUSER    PURGEACCT    FULLBACKUP     FREERIN          00425000
   SHOWIN       LISTACCT   PURGEGROUP   JOBPRI         GETLOG           00430000
   SHOWJOB      LISTGROUP  PURGEUSER    PARTBACKUP     GETRIN           00435000
   SHOWNMLOG    LISTUSER   REPORT       RESUMELOG      LINKCONTROL      00440000
   SHOWOUT      NEWACCT    RESETACCT    RESUMENMLOG    LISTLOG          00445000
                                        SHOWLOG        NRJECONTROL      00450000
                                        SHOWQ          RELLOG           00455000
                                        SWITCHLOG      SNACONTROL       00460000
                                        SWITCHNMLOG    STARTCACHE       00465000
                                        SYSDUMP        STOPCACHE        00470000
                                        TUNE                            00475000
You can use any command name as a keyword.                              00480000
\ITEM=OPERATOR                                                          00485000
Operator Control.  Following are the commands used:                     00490000
                                                                        00495000
    ABORTIO           GIVE          REFUSE                              00500000
    ABORTJOB          HEADOFF       REPLY                               00505000
    ACCEPT            HEADON        RESUMEJOB                           00510000
    ALLOW             IMFCONTROL    RESUMESPOOL                         00515000
    ALTJOB            JOBFENCE      SHOWCOM                             00520000
    ALTSPOOLFILE      JOBSECURITY   SHUTQ                               00525000
    BREAKJOB          LIMIT         STARTSPOOL                          00530000
    CONSOLE           LDISMOUNT     STOPSPOOL                           00535000
    DELETESPOOLFILE   LMOUNT        STREAMS                             00540000
    DISALLOW          LOG           SUSPENDSPOOL                        00545000
    DISCRPS           MPLINE        TAKE                                00550000
    DOWN              MRJECONTROL   UP                                  00555000
    DOWNLOAD          OPENQ         VMOUNT                              00560000
    DSCONTROL         OUTFENCE      WARN                                00565000
    FOREIGN           RECALL        WELCOME                             00570000
                                                                        00575000
You can use any command name as a keyword.                              00580000
\ITEM=SPOOLER                                                           00585000
Spooler Control.  Following are the commands used:                      00590000
                                                                        00595000
     ALTSPOOLFILE                                                       00600000
     DELETESPOOLFILE                                                    00605000
     RESUMESPOOL                                                        00610000
     STARTSPOOL                                                         00615000
     STOPSPOOL                                                          00620000
     SUSPENDSPOOL                                                       00625000
                                                                        00630000
You can use any command name as a keyword.                              00635000
                                                                        00640000
\ITEM=UTILITY                                                           00645000
Utility Functions.  Following are the commands used:                    00650000
   CONSOLE       SHOWALLOW                                              00655000
   PTAPE         SHOWCATALOG                                            00660000
   SETCATALOG    SHOWME                                                 00665000
   SETMSG        SHOWTIME                                               00670000
   SPEED         TELL                                                   00675000
   RECALL        TELLOP                                                 00680000
   REDO                                                                 00685000
                                                                        00690000
You can use any command name as a keyword.                              00695000
                                                                        00700000
                                                                        00705000
\ENTRY=COMMAND,PARMS,OPERATION,EXAMPLE                                  00710000
    :() COMMAND LOG ON                                                  00715000
                                                                        00720000
Begins a session, executes the enclosed MPE command, and ends the       00725000
session upon completion of the command.                                 00730000
                                                                        00735000
SYNTAX                                                                  00740000
                                                                        00745000
    :([:]commandname) [sessionname,]username[/userpass]                 00750000
        .acctname[/acctpass][,groupname[/grouppass]]                    00755000
                                                                        00760000
         [;TERM=termtype]                                               00765000
         [;TIME=cpusecs]                                                00770000
                                                                        00775000
                 BS                                                     00780000
                 CS                                                     00785000
         [;PRI= {  }                                                    00790000
                 DS                                                     00795000
                 ES                                                     00800000
                                                                        00805000
          ;INPRI=inputpriority                                          00810000
         [                    ]                                         00815000
          ;HIPRI                                                        00820000
                                                                        00825000
\ITEM=PARMS                                                             00830000
PARAMETERS                                                              00835000
                                                                        00840000
commandname        Any MPE command, including its parameter list.       00845000
                   The prompting colon may be omitted.  (REQUIRED       00850000
                   PARAMETER)                                           00855000
                                                                        00860000
sessionname        Arbitrary name used in conjunction with <username>   00865000
                   and <acctname> to form a fully-qualified session     00870000
                   identity.  Contains from 1 to 8 alphanumeric         00875000
                   characters, beginning with a letter.  Default is     00880000
                   no session name.                                     00885000
                                                                        00890000
username           A user name, established by the Account Manager, that00895000
                   allows you to log on under this account.  This name  00900000
                   is unique within the account.  Contains from 1 to 8  00905000
                   alphanumeric characters, beginning with a letter.    00910000
                   (REQUIRED PARAMETER)                                 00915000
                                                                        00920000
userpass           Your user password, optionally assigned by the       00925000
                   Account Manager.  Contains from 1 to 8 alphanumeric  00930000
                   characters, beginning with a letter.                 00935000
                                                                        00940000
acctname           Name of your account, as established by the System   00945000
                   Manager.  Contains from 1 to 8 alphanumeric          00950000
                   characters, beginning with a letter.                 00955000
                                                                        00960000
                                                                        00965000
                                     NOTE                               00970000
                                                                        00975000
                   Must be preceded by a period as a delimiter.         00980000
                                                                        00985000
                   (REQUIRED PARAMETER)                                 00990000
                                                                        00995000
acctpass           Account password, optionally assigned by the System  01000000
                   Manager.  Contains from 1 to 8 alphanumeric          01005000
                   characters, beginning with a letter.                 01010000
                                                                        01015000
groupname          Name of file group to be used for local file domain  01020000
                   and central processor time charges, as established   01025000
                   by the Account Manager.  Contains from 1 to 8        01030000
                   alphanumeric characters, beginning with a letter.    01035000
                   Default is your home group if one is assigned.       01040000
                   (REQUIRED IF HOME GROUP NOT ASSIGNED)                01045000
                                                                        01050000
grouppass          Group password, optionally assigned by the Account   01055000
                   Manager.  Contains from 1 to 8 alphanumeric          01060000
                   characters, beginning with a letter.  Not needed     01065000
                   when you log on under home group; otherwise, required01070000
                   if assigned.                                         01075000
                                                                        01080000
termtype           Type of terminal used for input.  (MPE uses this     01085000
                   parameter to determine device-dependent              01090000
                   characteristics such as delay factors for carriage   01095000
                   returns.  Must be a number from 0 to 15, as follows: 01100000
                                                                        01105000
                   0    HP 2749B (ASR 33 EIA-compatible) (10 characters 01110000
                        per second (cps)).                              01115000
                                                                        01120000
                   1    ASR 37 EIA-compatible (10 cps).                 01125000
                                                                        01130000
                   2    ASR 35 EIA-compatible (10 cps).                 01135000
                                                                        01140000
                   3    Execuport 300 Data Communication Transceiver    01145000
                        Terminal (10, 15, 30 cps).                      01150000
                                                                        01155000
                   4    HP 2600A or Datapoint 3300 (10-240 cps).        01160000
                                                                        01165000
                   5    Memorex 1240 (10, 15, 30, 60 cps).              01170000
                                                                        01175000
                   6    HP 2762A/B (GE Terminet 300 or 1200), or Data   01180000
                        Communications Terminal, Model B (10, 15, 30,   01185000
                        120 cps).                                       01190000
                                                                        01195000
                   9    HP 2615A (Beehive MiniBee) (10-240 cps).        01200000
                                                                        01205000
                  10    HP 2640A/B, HP 2641A, HP 2644A, or HP 2645A.    01210000
                        Character mode or full program control of block 01215000
                        mode transmission (10-240 cps).                 01220000
                                                                        01225000
                  11    HP 2640A/B, HP 2641A, HP 2644A, or HP 2645A.    01230000
                        Allows use of block mode without program control01235000
                        of block mode transmission.  Requires you to    01240000
                        position cursor before pressing ENTER.          01245000
                        Recommended for speeds exceeding 30 cps when you01250000
                        expect to switch between character mode block/  01255000
                        line mode.  May not be used in block/page mode  01260000
                        (10-240 cps).                                   01265000
                                                                        01270000
                  12    HP 2645K  Katakana/Roman Data Terminal.         01275000
                                                                        01280000
                  13    Message switching network or other computer.    01285000
                                                                        01290000
                  14    Multi-Point Terminal.                           01295000
                                                                        01300000
                  15    HP 2635A Printing Terminal.  8-bit protocol     01305000
                        (for second character set).                     01310000
                                                                        01315000
                  16    HP 2635A Printing Terminal.  7-bit protocol     01320000
                        (standard character set).                       01325000
                                                                        01330000
                                       NOTE                             01335000
                                                                        01340000
                   On Series 33, only term types 4, 6, 9, 10, 11,       01345000
                 12, 15, and 16 may be used.                            01350000
                                                                        01355000
                  Default:  For hardwired terminals, determined by      01360000
                  System Supervisor during system configuration.  No    01365000
                  default for terminals that are not hard wired.        01370000
                  (Required parameter to insure correct listings if     01375000
                  your terminal is not the default <termtype>.)         01380000
                                                                        01385000
cpusecs           Maximum central processor time that your session can  01390000
                  use, entered in seconds.  When this limit is reached, 01395000
                  session is aborted.  Must be a value from 1 to 32767. 01400000
                  To specify no limit, specify question mark or omit    01405000
                  this parameter.  Default is no limit.                 01410000
                                                                        01415000
BS,CS,DS,ES       The execution priority class that the Command         01420000
                  Interpreter uses for your session, and also the       01425000
                  default priority for all programs executed within     01430000
                  the session.  BS is highest priority, ES is lowest.   01435000
                  If you specify a priority that exceeds the highest    01440000
                  permitted for your account or user name by the system,01445000
                  MPE assigns the highest priority possible below BS.   01450000
                  Default is CS.                                        01455000
                                                                        01460000
                                                                        01465000
                                     NOTE                               01470000
                                                                        01475000
                  DS and ES are intended primarily for batch jobs,      01480000
                  their use for sessions is generally discouraged.      01485000
                                                                        01490000
                                                                        01495000
inputpriority     Relative input priority used in checking against      01500000
                  access restrictions imposed by <jobfence>, if one     01505000
                  exists.  Takes effect at logon time.  Must be a value 01510000
                  from 1 (lowest priority) to 13 (highest priority).  If01515000
                  you supply a value less than or equal to current      01520000
                  <jobfence> set by Console Operator, session is denied 01525000
                  access.  Default is 8.                                01530000
                                                                        01535000
HIPRI             Request for maximum session selection input priority, 01540000
                  causing session to be scheduled regardless of current 01545000
                  <jobfence> or execution limit for sessions.  Default  01550000
                  is the current <jobfence> and execution limit.        01555000
                                                                        01560000
                                       NOTE                             01565000
                                                                        01570000
                  You can specify this parameter only if you have       01575000
                  System Manager or System Supervisor capability.       01580000
                                                                        01585000
\ITEM=OPERATION                                                         01590000
OPERATION                                                               01595000
                                                                        01600000
This command initiates a session and immediately executes the command   01605000
contained within the parentheses.  Once in contact with the command or  01610000
subsystem specified inside the parentheses, all input, output, break    01615000
capabilities, and prompts operate as described in the command or        01620000
subsystem instructions.  After the execution of the command or subsytem 01625000
is completed, either normally or through an abort, a log off is         01630000
performed automatically.                                                01635000
                                                                        01640000
                        NOTE                                            01645000
                                                                        01650000
      You must enter the :( ) command log on at a terminal -- no        01655000
      other device can be used for this command.                        01660000
                                                                        01665000
      :( ) command log on is not recognized within sessions, as         01670000
      for example, the :HELLO command is.                               01675000
                                                                        01680000
      Commands which would normally cause an end of file, such as       01685000
      :HELLO, :BYE, :JOB, :DATA, :EOF, and :EOJ are not recognized      01690000
      and if used the session is terminated immediately.                01695000
                                                                        01700000
      Only one MPE command is allowed within the parentheses.           01705000
      Also, the leading and trailing blanks are suppressed within       01710000
      the parentheses.                                                  01715000
                                                                        01720000
The logon and logoff messages can be terminated using BREAK, and the    01725000
command specified within the parentheses is breakable or not in         01730000
accordance with its usual break or no break capability.  When the       01735000
command inside the parentheses is aborted, a log off is performed       01740000
immediately.                                                            01745000
                                                                        01750000
If you omit any passwords required in the :( ) command log on, MPE      01755000
prompts you for them individually.                                      01760000
                                                                        01765000
When MPE initiates the session, it displays the HP 3000 Model Number,   01770000
and the date and time as follows:                                       01775000
                                                                        01780000
    HP3000 / MPE IV C.00.00.  FRI, APR  6, 1979,  9:11 AM               01785000
                                                                        01790000
After the logon message is printed at your terminal, MPE executes the   01795000
command specified within the parentheses.  The information MPE generates01800000
as a result of this command is transmitted to your terminal immediately;01805000
just as if you had called that command or subsystem during a session.   01810000
When the command or subsystem is exited, MPE terminates the session at  01815000
once and displays the cpu time used (in seconds), the connect time (in  01820000
minutes), and the date and time, as follows:                            01825000
                                                                        01830000
    CPU=1.  CONNECT=1.  FRI, APR 6, 1979,  9:11 AM                      01835000
                                                                        01840000
\ITEM=EXAMPLE                                                           01845000
EXAMPLE                                                                 01850000
                                                                        01855000
To log on under <username> MAC, <acctname> TECHPUB, and <groupname>     01860000
XGROUP, and execute the LISTF command, enter:                           01865000
                                                                        01870000
    :(LISTF) MAC.TECHPUB,XGROUP                                         01875000
                                                                        01880000
    HP3000 / MPE IV C.00.00.  FRI, APR  6, 1979,  9:11 AM               01885000
                                                                        01890000
    FILENAME                                                            01895000
                                                                        01900000
    FIRST     GP005     TRIAL     XPROG                                 01905000
                                                                        01910000
    CPU=1.  CONNECT=1.  FRI, APR  6, 1979,  9:11 AM                     01915000
                                                                        01920000
                                                                        01925000
\ENTRY=ABORT,PARMS,OPERATION,EXAMPLE                                    01930000
    :ABORT                                                              01935000
                                                                        01940000
Aborts current program or operation.                                    01945000
                                                                        01950000
SYNTAX                                                                  01955000
                                                                        01960000
    :ABORT                                                              01965000
                                                                        01970000
\ITEM=PARMS                                                             01975000
PARAMETERS                                                              01980000
                                                                        01985000
None                                                                    01990000
                                                                        01995000
\ITEM=OPERATION                                                         02000000
OPERATION                                                               02005000
                                                                        02010000
After you suspend a program or MPE command operation by pressing the    02015000
BREAK key, the :ABORT command immediately terminates that program or    02020000
operation.  Note that the :ABORT command is available only from a       02025000
session and only during a break.  An :ABORT command results in the      02030000
Job Control Word (JCW) being set to the SYSTEM 0 state.                 02035000
                                                                        02040000
\ITEM=EXAMPLE                                                           02045000
EXAMPLE                                                                 02050000
                                                                        02055000
To abort the current operation, enter:                                  02060000
                                                                        02065000
    :ABORT                                                              02070000
                                                                        02075000
                                                                        02080000
\ENTRY=ABORTIO,PARMS,OPERATION,EXAMPLE                                  02085000
    :ABORTIO                                                            02090000
                                                                        02095000
Aborts all pending I/O requests for a device.                           02100000
                                                                        02105000
SYNTAX                                                                  02110000
                                                                        02115000
    :ABORTIO ldn                                                        02120000
                                                                        02125000
\ITEM=PARMS                                                             02130000
PARAMETERS                                                              02135000
                                                                        02140000
ldn    The logical device number of the device for which I/O is         02145000
       being aborted.                                                   02150000
                                                                        02155000
\ITEM=OPERATION                                                         02160000
OPERATION                                                               02165000
                                                                        02170000
This command causes all pending I/O operations on the specified ldn     02175000
to be aborted.  If no queued I/O requests are present at the time       02180000
the command is issued, the message "LDEV #ldn NO I/O PENDING" will be   02185000
printed on the system console.                                          02190000
                                                                        02195000
JOB/DATA accepting devices always have outstanding read requests        02200000
pending due to the auto-recognition feature of MPE.  The :ABORTIO       02205000
command is used to clear these pending input requests.  Clearing        02210000
all outstanding I/O requests is sometimes required to allow proper      02215000
execution of other console commands.  In certain cases :ABORTJOB,       02220000
:TAKE, :DOWN, and :REFUSE will not correctly function unless an         02225000
:ABORTIO command is first issued to clear pending I/O operations        02230000
on the appropriate device.                                              02235000
                                                                        02240000
\ITEM=EXAMPLE                                                           02245000
EXAMPLE                                                                 02250000
                                                                        02255000
To abort all pending output requests for logical device 20, enter:      02260000
                                                                        02265000
     :ABORTIO 20                                                        02270000
     11:16/3/LDEV#20 NO I/O PENDING                                     02275000
                                                                        02280000
To completely clear spooled device 5 it is necessary to abort all       02285000
pending I/O operations as shown below:                                  02290000
                                                                        02295000
     :STOPSPOOL 5                                                       02300000
     11:20/31/SP#5/STOPPED                                              02305000
     11/20/31/LDEV#5 NOT READY                                          02310000
     :REFUSE 5                                                          02315000
     :ABORTIO 5                                                         02320000
     :ABORTIO 5                                                         02325000
     11:21/40/LDEV#5 NO I/O PENDING                                     02330000
                                                                        02335000
\ENTRY=ABORTJOB,PARMS,OPERATION,EXAMPLE                                 02340000
     :ABORTJOB                                                          02345000
                                                                        02350000
Aborts a job, session, or scheduled job.                                02355000
                                                                        02360000
SYNTAX                                                                  02365000
                                                                        02370000
                #Jnnn                                                   02375000
     :ABORTJOB {#Snnn                  }                                02380000
                [jobname,]user.account                                  02385000
                                                                        02390000
\ITEM=PARMS                                                             02395000
PARAMETERS                                                              02400000
                                                                        02405000
#Jnnn                   A job number.                                   02410000
                                                                        02415000
#Snnn                   A session number.                               02420000
                                                                        02425000
jobname,user.account    A user's name as identified by SHOWJOB.         02430000
                                                                        02435000
\ITEM=OPERATION                                                         02440000
OPERATION                                                               02445000
                                                                        02450000
This command terminates the designated job, session, or scheduled       02455000
job and displays the message *SESSION (or JOB) ABORTED BY SYSTEM        02460000
MANAGEMENT* on the job/session list device.  Although the job/          02465000
session/scheduled job is abnormally terminated, standard cleanup        02470000
is performed (log records are issued and CPU connect times are          02475000
updated).                                                               02480000
                                                                        02485000
:ABORTJOB can be applied to waiting as well as executing jobs/sessions. 02490000
If the input devicefile for a ready batch job is spooled, then it       02495000
will be deleted; whereas if the output devicefile is spooled, it is     02500000
made ready for spooling.  This is the case whenever a batch job         02505000
terminates.                                                             02510000
                                                                        02515000
The successful execution of an :ABORTJOB command results in a logoff    02520000
message associated with the job (if the job was in execution) or        02525000
session affected as shown below:                                        02530000
                                                                        02535000
     :ABORTJOB #J9                                                      02540000
     11:20/#j9/34/LOGOFF                                                02545000
                                                                        02550000
If the logoff message does not appear, it means the affected            02555000
process was WAITing or is not in an abortable state.  One reason        02560000
for this can be outstanding device allocation messages that have        02565000
not been replied to.  You must satisfy the allocation message to        02570000
allow the :ABORTJOB to continue by responding with a REPLY pin, 0       02575000
(where pin is the process identification number).  This is a            02580000
negative response to an allocation message and causes a file open       02585000
error in the accessing program, as shown in one of the examples         02590000
below.                                                                  02595000
                                                                        02600000
If the user specifies the Scheduled Job to be aborted by using the      02605000
[jobname],username.account parameter, then only the first job that      02610000
statisfies the specification will be aborted.  For Scheduled Jobs,      02615000
this will be the job scheduled to be introduced the earliest.           02620000
                                                                        02625000
\ITEM=EXAMPLE                                                           02630000
EXAMPLES                                                                02635000
                                                                        02640000
To terminate session number 139, enter:                                 02645000
                                                                        02650000
     :ABORTJOB #S139                                                    02655000
                                                                        02660000
To terminate job number 9, enter:                                       02665000
                                                                        02670000
     :ABORTJOB #J9                                                      02675000
     20:18/#J9/26/LOGOFF                                                02680000
                                                                        02685000
(The execution was successful.)                                         02690000
                                                                        02695000
To terminate session 6, which has a pending device allocation message,  02700000
you must reply to the message as shown below:                           02705000
                                                                        02710000
     ?17:00/#S6/23/LDEV# FOR "SCRTAPE" ON TAPE1600 (NUM)?               02715000
     :ABORTJOB #S6                                                      02720000
     :REPLY 23,0                                                        02725000
     17:10:/#S6/34/LOGOFF                                               02730000
                                                                        02735000
To terminate Scheduled Job number 138, enter:                           02740000
                                                                        02745000
     :ABORTJOB #J138                                                    02750000
                                                                        02755000
\ENTRY=ACCEPT,PARMS,OPERATION,EXAMPLE                                   02760000
    :ACCEPT                                                             02765000
                                                                        02770000
Permits the device to accept jobs/sessions and/or data.                 02775000
                                                                        02780000
SYNTAX                                                                  02785000
                                                                        02790000
              JOBS,                                                     02795000
     :ACCEPT [     ] ldn                                                02800000
              DATA,                                                     02805000
                                                                        02810000
\ITEM=PARMS                                                             02815000
PARAMETERS                                                              02820000
                                                                        02825000
ldn          The logical device number of the device for which :JOB     02830000
             or :HELLO) and :DATA commands are being enabled.           02835000
                                                                        02840000
JOBS         Specifies that :JOB and :HELLO commands will be recog-     02845000
             nized by the designated device.  The device must be        02850000
             interactive to support sessions.                           02855000
                                                                        02860000
DATA         Specifies that :DATA commands will be recognized by the    02865000
             designated device.                                         02870000
                                                                        02875000
\ITEM=OPERATION                                                         02880000
OPERATION                                                               02885000
                                                                        02890000
If both the JOBS and DATA parameters are omitted, both :JOB (or         02895000
:HELLO) and :DATA commands are allowed.                                 02900000
                                                                        02905000
The :ACCEPT command is rejected if JOBS is explicitly requested         02910000
and the device has not been configured with a default output device     02915000
(refer to Output Devicefiles).                                          02920000
                                                                        02925000
\ITEM=EXAMPLE                                                           02930000
EXAMPLES                                                                02935000
                                                                        02940000
To permit logical device 35 to accept jobs and data, enter:             02945000
                                                                        02950000
     :ACCEPT 35                                                         02955000
     :SHOWDEV 35                                                        02960000
     LDEV   AVAIL     OWNERSHIP     VOLID                               02965000
                                                                        02970000
      35 A  AVAIL                                                       02975000
                                                                        02980000
To permit logical device 10 to accept jobs and data, and to allow       02985000
the device to be spooled, enter:                                        02990000
                                                                        02995000
     :ACCEPT 10                                                         03000000
     :STARTSPOOL 10                                                     03005000
     11:12/31/SP#10/SPOOLED IN                                          03010000
     11:12/6/LDEV#10 NOT READY                                          03015000
     :SHOWDEV 10                                                        03020000
     LDEV    AVAIL    OWNERSHIP     VOLID                               03025000
                                                                        03030000
      10  A  AVAIL    SPOOLER IN                                        03035000
                                                                        03040000
\ENTRY=ALLOCATE,PARMS,OPERATION,EXAMPLE                                 03045000
    :ALLOCATE (System Supervisor capability required)                   03050000
                                                                        03055000
Loads a program or procedure.                                           03060000
                                                                        03065000
SYNTAX                                                                  03070000
                                                                        03075000
               PROCEDURE                                                03080000
    :ALLOCATE [        ,]name                                           03085000
               PROGRAM                                                  03090000
                                                                        03095000
\ITEM=PARMS                                                             03100000
PARAMETERS                                                              03105000
                                                                        03110000
PROGRAM       The program file indicated by <name> is allocated.        03115000
                                                                        03120000
PROCEDURE     The procedure indicated by <name> in SL.PUB.SYS is        03125000
              allocated.  The default is PROGRAM.                       03130000
                                                                        03135000
name          The name of the program file or procedure to be allocated.03140000
              (REQUIRED PARAMETER)                                      03145000
                                                                        03150000
\ITEM=OPERATION                                                         03155000
OPERATION                                                               03160000
                                                                        03165000
(System Supervisor capability required)                                 03170000
This command loads the code segments for a program or procedure.  These 03175000
segments remain loaded until DEALLOCATED.                               03180000
                                                                        03185000
The user issuing the :ALLOCATE command must have execute access for any 03190000
file referenced in the name parameter of this command.                  03195000
                                                                        03200000
\ITEM=EXAMPLE                                                           03205000
EXAMPLE                                                                 03210000
                                                                        03215000
To permanently allocate a procedure identified as PROC1, residing in    03220000
SL.PUB.SYS, enter:                                                      03225000
                                                                        03230000
    :ALLOCATE PROCEDURE,PROC1                                           03235000
                                                                        03240000
                                                                        03245000
\ENTRY=ALLOW,PARMS,OPERATION,EXAMPLE                                    03250000
     :ALLOW                                                             03255000
                                                                        03260000
Grants a user access to a specific operator command.                    03265000
                                                                        03270000
SYNTAX                                                                  03275000
                                                                        03280000
             FILE=formaldesignator [;SHOW]                              03285000
                                                                        03290000
               @.@                                                      03295000
            [  user.@                                               ]   03300000
     :ALLOW   {@.acct   } ;COMMANDS=command1[,command2,...,commandn]    03305000
               user.acct                                                03310000
                                                                        03315000
\ITEM=PARMS                                                             03320000
PARAMETERS                                                              03325000
                                                                        03330000
formaldesignator    A formal ASCII file name.                           03335000
                                                                        03340000
SHOW                Lists input lines on $STDLIST.                      03345000
                                                                        03350000
@.@                 Grants access to all users whether logged on or     03355000
                    not.                                                03360000
                                                                        03365000
user.@              Grants access to a specific user in all accounts.   03370000
                                                                        03375000
@.acct              Grants access to all users in a specific account.   03380000
                                                                        03385000
user.acct           Grants access to a specific user in a specific      03390000
                    account.                                            03395000
                                                                        03400000
\ITEM=OPERATION                                                         03405000
OPERATION                                                               03410000
                                                                        03415000
Through the :ALLOW command, the console operator has the ability to     03420000
distribute console capabilities among system users by directly          03425000
entering:                                                               03430000
                                                                        03435000
             @.@                                                        03440000
     :ALLOW {user.@   };COMMANDS=command1[,command2,...,commandn]       03445000
             @.acct                                                     03450000
             user.acct                                                  03455000
                                                                        03460000
This command can also be used in an indirect and subsystem mode.        03465000
In the indirect mode, an EDITOR file is created that contains:          03470000
                                                                        03475000
             @.@                                                        03480000
            {user.@   };COMMANDS=command1[,command2,...,commandn]       03485000
             @.acct                                                     03490000
             user.acct                                                  03495000
                                                                        03500000
The :ALLOW command is then executed by entering at the system           03505000
console:                                                                03510000
                                                                        03515000
     :ALLOW FILE=formaldesignator[;SHOW]                                03520000
                                                                        03525000
which enables the EDITOR file.                                          03530000
                                                                        03535000
In subsystem mode, just type ALLOW followed by a carriage return.       03540000
The command prompts you with a > sign, accepting command parameters     03545000
until an EOF is received or EXIT is entered.                            03550000
                                                                        03555000
The user receiving the capabilities must be logged on at the time       03560000
and automatically loses the capability by logging off.  (Notice @.@     03565000
effects all users whether they`re logged on or off.                     03570000
                                                                        03575000
\ITEM=EXAMPLE                                                           03580000
EXAMPLES                                                                03585000
                                                                        03590000
To give the user BARB.LEWIS the ability to execute the REPLY and        03595000
ABORTIO commands, enter on the system console:                          03600000
                                                                        03605000
     :ALLOW BARB.LEWIS;COMMANDS=REPLY,ABORTIO                           03610000
                                                                        03615000
To give the user PAUL.JONES the ability to execute the BREAKJOB         03620000
command in subsystem mode, enter on the system console:                 03625000
                                                                        03630000
     :ALLOW                                                             03635000
     >PAUL.JONES;COMMANDS=BREAKJOB                                      03640000
     >EXIT                                                              03645000
                                                                        03650000
\ENTRY=ALTACCT,PARMS,OPERATION,EXAMPLE                                  03655000
    :ALTACCT (System Manager capability required)                       03660000
                                                                        03665000
Changes the attributes of an existing account.                          03670000
                                                                        03675000
SYNTAX                                                                  03680000
                                                                        03685000
    :ALTACCT acctname                                                   03690000
             [;PASS=[password]]                                         03695000
             [;FILES=[filespace]]                                       03700000
             [;CPU=[cpu]]                                               03705000
             [;CONNECT=[connect]]                                       03710000
             [;CAP=[capabilitylist]]                                    03715000
             [;ACCESS=[fileaccess]]                                     03720000
             [;MAXPRI=[subqueuename]]                                   03725000
             [;LOCATTR=[localattribute]]                                03730000
                          SPAN                                          03735000
             [;VS=volset:{    }]                                        03740000
                          ALT                                           03745000
                                                                        03750000
\ITEM=PARMS                                                             03755000
PARAMETERS                                                              03760000
                                                                        03765000
acctname             The name of the account to be altered. (REQUIRED   03770000
                     PARAMETER)                                         03775000
                                                                        03780000
password             Account password (used for verifying logon access  03785000
                     only).  If omitted, any existing password is       03790000
                     removed.                                           03795000
                                                                        03800000
filespace            Disc storage limit, in sectors, for the permanent  03805000
                     files in the account.  <Filespace> limit cannot be 03810000
                     less than the number of sectors currently in use   03815000
                     for the account.  Default is unlimited <filespace>.03820000
                                                                        03825000
cpu                  The limit on cpu time, in seconds, for the account.03830000
                     This limit is checked only when a job/session is   03835000
                     initiated -- thus, the limit never causes a        03840000
                     job/session to abort. The maximum value permitted  03845000
                     is 2,147,483,647 seconds.  Default is unlimited    03850000
                     cpu time.                                          03855000
                                                                        03860000
connect              The limit on total session connect time, in        03865000
                     minutes, allowed the account.  This limit is       03870000
                     checked only at log on.  The maximum value allowed 03875000
                     is 2,147,483,647 minutes.  Default is unlimited    03880000
                     connect time.                                      03885000
                                                                        03890000
capabilitylist       List of capabilities, mutually separated by commas,03895000
                     permitted this account.  Each capability is denoted03900000
                     by a two-letter mnemonic, as follows:              03905000
                                                                        03910000
                     System Manager          = SM                       03915000
                     Account Manager         = AM                       03920000
                     Account Librarian       = AL                       03925000
                     Group Librarian         = GL                       03930000
                     Diagnostician           = DI                       03935000
                     System Supervisor       = OP                       03940000
                     Network Administrator   = NA                       03945000
                     Node Manager            = NM                       03950000
                                                                        03955000
                     Permanent Files         = SF                       03960000
                     Access of non-sharable                             03965000
                     I/O devices             = ND                       03970000
                     Create Volumes          = CV                       03975000
                     Use Volumes             = UV                       03980000
                     Use Communications                                 03985000
                     Subsystems              = CS                       03990000
                     Create                                             03991000
                     Programmatic Sessions   = PS                       03992000
                                                                        03995000
                     Process Handling        = PH                       04000000
                     Extra Data Segments     = DS                       04005000
                     Multiple RINS           = MR                       04010000
                     Privileged Mode         = PM                       04015000
                     Interactive Access      = IA                       04020000
                     Local Batch Access      = BA                       04025000
                     User Logging            = LG                       04030000
                     Default is AM, AL, GL, SF, ND, IA, BA.             04035000
                                                                        04040000
fileaccess           File security specifications, entered as follows:  04045000
                                                                        04050000
                      R                                                 04055000
                      L     ANY                                         04060000
                     {A} : {   }                                        04065000
                      W     AC                                          04070000
                      X                                                 04075000
                                                                        04080000
                     where R, L, A, W, X specify modes of access by     04085000
                     types of users (ANY, AC) as follows:               04090000
                                                                        04095000
                     R = Read                                           04100000
                     L = Lock (allows exclusive access to file)         04105000
                     A = Append (implicitly specifies L also)           04110000
                     W = Write (implicitly specifies A and L also)      04115000
                     X = Execute                                        04120000
                                                                        04125000
                     Two or more modes may be specified if they are     04130000
                     separated by commas.                               04135000
                                                                        04140000
                     The user types are specified as follows:           04145000
                                                                        04150000
                     ANY = Any user                                     04155000
                     AC  = Member of this account only                  04160000
                                                                        04165000
                     Two or more user types may be specified if they are04170000
                     separated by commas.                               04175000
                                                                        04180000
                     The default is:                                    04185000
                                                                        04190000
                        R, L, A, W, X: AC  (All accounts except SYS)    04195000
                        R, X: ANY; L, A, W: AC  (SYS account only)      04200000
                                                                        04205000
subqueuename         Name of the subqueue of highest priority that can  04210000
                     be requested by any process of any job/session in  04215000
                     the account, specified as xS, where x is A, B, C,  04220000
                     D, or E.  Default is CS.                           04225000
                                                                        04230000
locatattribute       Local attribute of the user, as defined at the     04235000
                     installation site.  This is a double-word of       04240000
                     arbitrary meaning which might be used to further   04245000
                     classify users.  While it is not involved in       04250000
                     standard MPE security provisions, it is available  04255000
                     to processes through the WHO intrinsic for use in  04260000
                     the programmer's own security provisions.  Default 04265000
                     is double-word 0 (null).                           04270000
                                                                        04275000
volset:SPAN          Volset is a volume set or class reference which,   04280000
                     when fully qualified, is in the form               04285000
                                                                        04290000
                     vcsid.groupname.acctname                           04295000
                                                                        04300000
                     where vcsid refers to a previously-defined volume  04305000
                     set or class definition.                           04310000
                                                                        04315000
                     SPAN indicates that the acctname is to be inserted 04320000
                     in the accounting directory of the specified volume04325000
                     set (volset).  The specified volume set must have  04330000
                     been previously mounted (via a MOUNT command) for  04335000
                     the SPAN operation to succeed.                     04340000
                                                                        04345000
volset:ALT           ALT directs the altering of an account or group    04350000
                     entry on the specified volume set.  ALT is useful  04355000
                     only if it is necessary to alter account and group 04360000
                     file space limits for entries that have already    04365000
                     been spanned.                                      04370000
                                                                        04375000
\ITEM=OPERATION                                                         04380000
OPERATION                                                               04385000
                                                                        04390000
(System Manager capability required)                                    04395000
This command changes the attributes of an existing account.  When       04400000
altering the <capabilitylist> for the SYS account, the SM capability    04405000
cannot be removed.  If <acctname> is SYS, and the <fileaccess> parameter04410000
is omitted, the following default security is assigned:                 04415000
                                                                        04420000
    R, X: ANY; A, W, L: AC                                              04425000
                                                                        04430000
When an entire keyword parameter group is omitted from the :ALTACCT     04435000
command, that parameter remains unchanged for the account.  When a      04440000
keyword is included but the corresponding parameter is omitted (as in   04445000
;PASS=), the default value is assigned as follows:                      04450000
                                                                        04455000
    PARAMETER        DEFAULT VALUES                                     04460000
                                                                        04465000
    password         No password                                        04470000
                                                                        04475000
    filespace        Unlimited                                          04480000
                                                                        04485000
    cpu              Unlimited                                          04490000
                                                                        04495000
    connect          Unlimited                                          04500000
                                                                        04505000
    capabilitylist   AM, AL, GL, SF, ND, IA, BA                         04510000
                                                                        04515000
    fileaccess       R, A, W, L, X: AC  (All accounts except SYS)       04520000
                                                                        04525000
                     R, X: ANY; A, W, L: AC  (SYS account only)         04530000
                                                                        04535000
    subqueuename     CS subqueue                                        04540000
                                                                        04545000
    localattribute   Double-word 0 (null)                               04550000
                                                                        04555000
When removing a capability and/or a local attribute from an account,    04560000
all groups and users within the account will automatically lose that    04565000
same capability/attribute.  However, the system will ensure that any    04570000
user with Account Manager capability will always have at least one      04575000
of the logon capabilities, i.e. IA or BA.                               04580000
                                                                        04585000
When changing one capability in a <capabilitylist> presently containing 04590000
several non-default values, you must re-specify the entire new <capabil-04595000
itylist>, not just the changed parameter.                               04600000
                                                                        04605000
Any value changed through the :ALTACCT command becomes effective the    04610000
next time MPE is requested to check this value; if an attribute is taken04615000
away from an account, users of this account currently running with that 04620000
attribute will retain it until again logging on.  For this reason, it is04625000
recommended that all account users be advised of all changes in advance.04630000
                                                                        04635000
\ITEM=EXAMPLE                                                           04640000
EXAMPLE                                                                 04645000
                                                                        04650000
To change an account named AC2 so that its password is GLOBALX and its  04655000
<filespace> is limited to 50,000 sectors, enter:                        04660000
                                                                        04665000
    :ALTACCT AC2;PASS=GLOBALX;FILES=50000                               04670000
\ENTRY=ALTGROUP,PARMS,OPERATION,EXAMPLE                                 04675000
                                                                        04680000
                                                                        04685000
    :ALTGROUP (Account Manager capability required)                     04690000
                                                                        04695000
Changes one or more attributes of a group.                              04700000
                                                                        04705000
                                                                        04710000
SYNTAX                                                                  04715000
                                                                        04720000
    :ALTGROUP groupname                                                 04725000
              [;PASS=[password]]                                        04730000
              [;CAP=[capabilitylist]]                                   04735000
              [;FILES=[filespace]]                                      04740000
              [;CPU=[cpu]]                                              04745000
              [;CONNECT=[connect]]                                      04750000
              [;ACCESS=[fileaccess]]                                    04755000
                             SPAN                                       04760000
              [;VS=[volset[:{    }]]]                                   04765000
                             ALT                                        04770000
                                                                        04775000
\ITEM=PARMS                                                             04780000
PARAMETERS                                                              04785000
                                                                        04790000
groupname        Specifies the name of the group whose attributes are to04795000
                 be changed.  (REQUIRED PARAMETER)                      04800000
                                                                        04805000
password         The new password to be assigned to the group. (This    04810000
                 password is used to verify logon access only.)  If     04815000
                 omitted, any existing password is removed.             04820000
                                                                        04825000
capabilitylist   Specifies the list of capabilities permitted this      04830000
                 group.  Each capability is denoted by a two-letter     04835000
                 mnemonic, as follows:                                  04840000
                                                                        04845000
                 Process Handling        = PH                           04850000
                 Extra Data Segments     = DS                           04855000
                 Multiple RINs           = MR                           04860000
                 Privileged Mode         = PM                           04865000
                 Interactive Access      = IA                           04870000
                 Local Batch Access      = BA                           04875000
                                                                        04880000
                 Two or more capabilities may be specified if they are  04885000
                 separated by commas.                                   04890000
                                                                        04895000
                 Default is IA, BA.                                     04900000
                                                                        04905000
filespace        Disc storage limit, in sectors, for the permanent files04910000
                 of the group.  A group's <filespace> cannot be         04915000
                 specified as greater than the corresponding limits     04920000
                 currently defined for the group's account, nor can it  04925000
                 be changed to be less than the number of sectors       04930000
                 currently allocated for the group. However, an         04935000
                 account's <filespace> can later be changed so that some04940000
                 of its groups are left with limits that exceed the new 04945000
                 account limits.  Default is unlimited file space.      04950000
                                                                        04955000
cpu              The limit on total cpu time, in seconds, for the group.04960000
                 This limit is checked only when a job or session is    04965000
                 initiated -- thus, the limit never causes a job/session04970000
                 to abort.  The maximum value permitted is 2,147,483,64704975000
                 seconds. A group's cpu limit cannot be specified as    04980000
                 greater than the corresponding limit currently defined 04985000
                 for the group's account.  However, an account's cpu    04990000
                 limit can be changed later so that some of its groups  04995000
                 are left with a limit that exceeds the new account     05000000
                 limits.  Default is unlimited cpu time.                05005000
                                                                        05010000
connect          The limit on total session connect time, in minutes,   05015000
                 allowed the group.  This limit is checked only at log  05020000
                 on time. The maximum value allowed is 2,147,483,647    05025000
                 minutes.  A group's connect limit cannot be specified  05030000
                 as greater than the corresponding limit currently      05035000
                 defined for the group's account.  However, an account's05040000
                 connect limit can be changed later so that some of its 05045000
                 groups are left with a limit that exceeds the new      05050000
                 account limits.  Default is unlimited connect time.    05055000
                                                                        05060000
fileaccess       File security specifications, entered as follows:      05065000
                                                                        05070000
                  R     ANY                                             05075000
                  L     AC                                              05080000
                 {A} : {GU }                                            05085000
                  W     AL                                              05090000
                  X     GL                                              05095000
                  S                                                     05100000
                                                                        05105000
                 where R, L, A, W, X, S specify modes of access by types05110000
                 of users (ANY, AC, GU, AL, GL) as follows:             05115000
                                                                        05120000
                 R = Read                                               05125000
                 L = Lock (allows exclusive access to file)             05130000
                 A = Append (implicitly specifies L also)               05135000
                 W = Write (implicitly specifies A and L also)          05140000
                 X = Execute                                            05145000
                 S = Save                                               05150000
                                                                        05155000
                 Two or more modes may be specified if they are         05160000
                 separated by commas.                                   05165000
                                                                        05170000
                 The user types are specified as follows:               05175000
                                                                        05180000
                 ANY = Any user                                         05185000
                 AC  = Member of this account only                      05190000
                 GU  = Member of this group only                        05195000
                 AL  = Account librarian user only                      05200000
                 GL  = Group librarian user only                        05205000
                                                                        05210000
                 Two or more user types may be specified if they are    05215000
                 separated by commas.                                   05220000
                                                                        05225000
                 Default is R, A, W, L, X, S : GU (all groups except    05230000
                 PUB); or R, X : ANY; A, W, L, S : AL, GU (PUB group    05235000
                 only).                                                 05240000
                                                                        05245000
volset:SPAN      Volset is a volume set or class reference which, when  05250000
                 fully qualified, is in the form                        05255000
                                                                        05260000
                 vcsid.groupname.acctname                               05265000
                                                                        05270000
                 where vcsid refers to a previously-defined volume set  05275000
                 or class definition.                                   05280000
                                                                        05285000
                 If volset is different from the old volume set, and the05290000
                 old volume set is the system set, then the old volume  05295000
                 set must be examined for the presence of files         05300000
                 belonging to groupname.  If no such files are found,   05305000
                 the command will succeed, and the group is reassigned  05310000
                 to volset as its new home volume set.                  05315000
                                                                        05320000
                 If volset is omitted from the VS= parameter, the group 05325000
                 will be reassigned to the system volume set.  If the   05330000
                 old volume set already is the system volume set and    05335000
                 contains files belonging to groupname, the command     05340000
                 will fail (that is, nothing is altered).               05345000
                                                                        05350000
                 It is permissible to reassign a group to a different   05355000
                 volume set regardless of the presence of files         05360000
                 belonging to groupname, so long as the old volume set  05365000
                 is not the system volume set and that groupname is not 05370000
                 currently bound (either explicitly via the MOUNT       05375000
                 command or implicitly via the FOPEN intrinsic) to its  05380000
                 home volume set.                                       05385000
                                                                        05390000
                 SPAN indicates that groupname is to be inserted in     05395000
                 the accounting directory of the specified volume       05400000
                 set (volset).  The specified volume set must have      05405000
                 been previously mounted (via the MOUNT command) for    05410000
                 the span operation to succeed.                         05415000
                                                                        05420000
volset:ALT       ALT directs the altering of an account or group entry  05425000
                 on the specified volume set.  ALT is useful only if it 05430000
                 is necessary to alter account and group file space     05435000
                 limits for entries that have already been spanned.     05440000
                                                                        05445000
\ITEM=OPERATION                                                         05450000
OPERATION                                                               05455000
                                                                        05460000
(Account Manager capability required)                                   05465000
This command changes one or more attributes of a group.  When an entire 05470000
parameter is omitted from an :ALTGROUP command, the corresponding value 05475000
for the group remains unchanged.  When a keyword is included but the    05480000
corresponding parameter is omitted (as in ;PASS=), the default value is 05485000
assigned as follows:                                                    05490000
                                                                        05495000
    PARAMETER       DEFAULT                                             05500000
                                                                        05505000
    password        Null (no password)                                  05510000
                                                                        05515000
    capabilitylist  IA, BA                                              05520000
                                                                        05525000
    filespace       Unlimited                                           05530000
                                                                        05535000
    cpu             Unlimited                                           05540000
                                                                        05545000
    connect         Unlimited                                           05550000
                                                                        05555000
    fileaccess      R, A, W, L, X, S: GU  (All groups except PUB)       05560000
                                                                        05565000
                    R, X: ANY; A, W, L, S: AL, GU (PUB group only)      05570000
                                                                        05575000
When a parameter is modified through :ALTGROUP, it immediately takes    05580000
effect in the directory but does not apply to current accesses under the05585000
group; thus, if an attribute is taken away from a group, users of the   05590000
group currently running with that attribute retain it until again       05595000
logging on.  For this reason, it is recommended that all group users be 05600000
advised of the change in advance.                                       05605000
                                                                        05610000
\ITEM=EXAMPLE                                                           05615000
EXAMPLE                                                                 05620000
                                                                        05625000
To assign a new password of PASS2 to a group named GROUPX, enter:       05630000
                                                                        05635000
    :ALTGROUP GROUPX;PASS=PASS2                                         05640000
                                                                        05645000
                                                                        05650000
\ENTRY=ALTJOB,PARMS,OPERATION,EXAMPLE                                   05655000
     :ALTJOB                                                            05660000
                                                                        05665000
Alters attributes of waiting jobs.                                      05670000
                                                                        05675000
SYNTAX                                                                  05680000
              #Jnnn                                                     05685000
     :ALTJOB {     }                                                    05690000
              #Snnn                                                     05695000
             [;INPRI=inputpriority]                                     05700000
                       ldn                                              05705000
             [;OUTDEV={        }]                                       05710000
                       devclass                                         05715000
                                                                        05720000
\ITEM=PARMS                                                             05725000
PARAMETERS                                                              05730000
                                                                        05735000
#Jnnn     A job number.                                                 05740000
                                                                        05745000
#Snnn     A session number.  (Although syntactically correct, this      05750000
          parameter is rarely used; sessions do not wait.)              05755000
                                                                        05760000
INPRI     Specifies the new input priority (1=lowest;13=highest).       05765000
                                                                        05770000
OUTDEV    Specifies the logical device number or device class name      05775000
          of the device file`s destination device.  (Optional           05780000
          parameter.)                                                   05785000
                                                                        05790000
\ITEM=OPERATION                                                         05795000
OPERATION                                                               05800000
                                                                        05805000
Only jobs in the introduced or WAITing state can be altered.            05810000
                                                                        05815000
Jobs with input priority less than or equal to the current jobfence,    05820000
which consists of a numerical value from 0 to 14, will be deferred.     05825000
                                                                        05830000
The :ALTJOB command in conjunction with the :JOBFENCE command allows    05835000
you to control the flow of all non-HIPRI jobs on the system.            05840000
                                                                        05845000
\ITEM=EXAMPLE                                                           05850000
                                                                        05855000
EXAMPLES                                                                05860000
                                                                        05865000
Three jobs are submitted by a user.  All jobs have an INPRI value       05870000
of 8.  To change the INPRI values of the user jobs to insure that       05875000
JOB1 runs first, JOB2 runs last, and JOB3 runs second with LP           05880000
allocated to the OUTDEV for JOB3, enter the following commands:         05885000
                                                                        05890000
:JOBFENCE 14                                                            05895000
15:11/#J4/24/DEFERRED JOB INTRODUCED ON LDEV #10                        05900000
15:11/#J5/25/DEFERRED JOB INTRODUCED ON LDEV #10                        05905000
15:13/#J6/26/DEFERRED JOB INTRODUCED ON LDEV #10                        05910000
:SHOWJOB                                                                05915000
                                                                        05920000
JOBNUM  STATE  IPRI  JIN  JLIST   INTRODUCED   JOB  NAME                05925000
                                                                        05930000
#S23    EXEC         20   20      THU  2:15P   FIELD.SUPPORT            05935000
#J4     WAIT    D 8  10S  12      THU  3:11P   JOB2,FIELD.SUPPORT       05940000
#J5     WAIT    D 8  10S  12      THU  3:11P   JOB3,FIELD.SUPPORT       05945000
#J6     WAIT    D 8  10S  12      THU  3:13P   JOB1,FIELD.SUPPORT       05950000
                                                                        05955000
4 JOBS:                                                                 05960000
  0 INTRO                                                               05965000
  3 WAIT; INCL 3 DEFERRED                                               05970000
  1 EXEC; INCL 1 SESSIONS                                               05975000
  0 SUSP                                                                05980000
JOBFENCE= 14; JLIMIT= 5; SLIMIT= 16                                     05985000
                                                                        05990000
:ALTJOB #J6; INPRI=12                                                   05995000
15:15/#J6/26/DEFERRED JOB INTRODUCED ON LDEV #10                        06000000
:ALTJOB #J5;INPRI=11;OUTDEV=LP                                          06005000
15:16/#J5/25/DEFERRED JOB INTRODUCED ON LDEV #10                        06010000
:ALTJOB #J4;INPRI=9                                                     06015000
15:17/#J4/24/DEFERRED JOB INTRODUCED ON LDEV #10                        06020000
:SHOWJOB                                                                06025000
                                                                        06030000
JOBNUM  STATE  IPRI  JIN  JLIST   INTRODUCED   JOB  NAME                06035000
#S23    EXEC          20  20      THU  2:15    FIELD.SUPPORT            06040000
#J6     WAIT    D12   10S 12      THU  3:13P   JOB1,FIELD.SUPPORT       06045000
#J5     WAIT    D11   10S LP      THU  3:11P   JOB3,FIELD.SUPPORT       06050000
#J4     WAIT    D 9   10S 12      THU  3:11P   JOB2,FIELD.SUPPORT       06055000
                                                                        06060000
4 JOBS:                                                                 06065000
   0 INTRO                                                              06070000
   3 WAIT; INCL  3 DEFERRED                                             06075000
   1 EXEC; INCL  1 SESSIONS                                             06080000
   0 SUSP                                                               06085000
JOBFENCE= 14; JLIMIT= 5; SLIMIT=16                                      06090000
                                                                        06095000
:LIMIT 1,16                                                             06100000
:JOBFENCE 0                                                             06105000
                                                                        06110000
\ENTRY=ALTLOG,PARMS,OPERATION,EXAMPLE                                   06115000
     :ALTLOG                                                            06120000
                                                                        06125000
Alters the attributes of an existing logging identifier.                06130000
SYNTAX                                                                  06135000
                                                                        06140000
                            ,DISC                                       06145000
:ALTLOG logid [;LOG=logfile{     }][;PASS=password]                     06150000
                            ,TAPE                                       06155000
                                                                        06160000
\ITEM=PARMS                                                             06165000
PARAMETERS                                                              06170000
                                                                        06175000
logid          The logging identifier containing from 1 to 8            06180000
               alphanumeric characters whose attributes are to          06185000
               be changed, (REQUIRED PARAMETER).                        06190000
                                                                        06195000
logfile        The new destination file name for the logfile.           06200000
               Must be specified as residing on tape or disc.           06205000
                                                                        06210000
password       The new password containing from 1 to 8 alpha-           06215000
               numeric characters for the logging identifier.           06220000
                                                                        06225000
\ITEM=OPERATION                                                         06230000
OPERATION                                                               06235000
                                                                        06240000
Changes the attributes of an existing logging identifier to those       06245000
specified in the parameter list.  Parameters not included in the        06250000
:ALTLOG command retain their current values.  This command can          06255000
be used only by the creator of the logging identifier.                  06260000
                                                                        06265000
\ITEM=EXAMPLE                                                           06270000
EXAMPLE                                                                 06275000
                                                                        06280000
To change the destination logfile of the logging identifier             06285000
DATALOG to FILEX, and specify that FILEX reside on tape, enter:         06290000
     :ALTLOG DATALOG;LOG=FILEX,TAPE                                     06295000
                                                                        06300000
Since the ;PASS parameter was not included, DATALOG retains             06305000
the password previously specified.                                      06310000
\ENTRY=ALTSEC,PARMS,OPERATION,EXAMPLE                                   06315000
    :ALTSEC                                                             06320000
                                                                        06325000
Permanently changes file's security provisions.                         06330000
                                                                        06335000
SYNTAX                                                                  06340000
                                                                        06345000
    :ALTSEC filereference[;([fileaccess                                 06350000
            [;[fileaccess[;. . .]]])]                                   06355000
                                                                        06360000
\ITEM=PARMS                                                             06365000
PARAMETERS                                                              06370000
                                                                        06375000
filereference        Actual designator of the file whose security       06380000
                     provisions are to be altered, written in the       06385000
                     format:                                            06390000
                                                                        06395000
                     filename[/lockword][.groupname[.accountname]]      06400000
                                                                        06405000
                     The lockword, if any, must be specified. (REQUIRED 06410000
                     PARAMETER)                                         06415000
                                                                        06420000
fileaccess           File security specifications, entered as follows:  06425000
                                                                        06430000
                      R     ANY                                         06435000
                      L     AC                                          06440000
                     {A} : {GU }                                        06445000
                      W     AL                                          06450000
                      X     GL                                          06455000
                            CR                                          06460000
                                                                        06465000
                     where R, L, A, W, X specify modes of access by     06470000
                     types of users (ANY, AC, GU, AL, GL, CR) as        06475000
                     follows:                                           06480000
                                                                        06485000
                     R = Read                                           06490000
                     L = Lock (allows opening with dynamic locking      06495000
                         option)                                        06500000
                     A = Append (implicitly specifies L also)           06505000
                     W = Write (implicitly specifies A and L also       06510000
                     X = Execute                                        06515000
                                                                        06520000
                     Two or more modes may be specified if they are     06525000
                     separated by commas.                               06530000
                     The user types are specified as follows:           06535000
                                                                        06540000
                     ANY = Any user                                     06545000
                     AC  = Member of this account only                  06550000
                     GU  = Member of this group only                    06555000
                     AL  = Account librarian user only                  06560000
                     GL  = Group librarian user only                    06565000
                     CR  = Creating user only                           06570000
                                                                        06575000
                     Two or more user types may be specified if they are06580000
                     separated by commas.                               06585000
                                                                        06590000
                     Default is R, A, W, L, X: ANY                      06595000
                                                                        06600000
\ITEM=OPERATION                                                         06605000
OPERATION                                                               06610000
                                                                        06615000
Permanently deletes all security provisions for a file at the file      06620000
level, and replaces them as specified by the <fileaccess> parameter.    06625000
Does not affect account and group level security provisions or file     06630000
lockword.  This command can be issued only by the creator of the file.  06635000
                                                                        06640000
Note that you can only use this command for a permanent disc file that  06645000
you have created, and that this command will fail if the group's home   06650000
volume set is not mounted.  When the normal (default) MPE security      06655000
provisions are in effect, the file must be in your logon account and    06660000
must belong to your logon or home group.                                06665000
                                                                        06670000
Even though you may be barred by <fileaccess> restrictions from         06675000
accessing a file that you have created, you still can issue an :ALTSEC  06680000
command for that file.  Thus, you can change the security provisions to 06685000
allow yourself access to it.                                            06690000
                                                                        06695000
\ITEM=EXAMPLE                                                           06700000
EXAMPLE                                                                 06705000
                                                                        06710000
You have created a file named FDATA and you wish to change its security 06715000
provisions to allow write access to yourself only.  Enter:              06720000
                                                                        06725000
    :ALTSEC FDATA;(W:CR)                                                06730000
                                                                        06735000
To change the security provisions for a program file (FPROG) so that any06740000
group user can execute the program but only account and group librarian 06745000
users can read or write on the file, enter:                             06750000
                                                                        06755000
    :ALTSEC FPROG;(X:GU;R,W:AL,GL)                                      06760000
                                                                        06765000
                                                                        06770000
\ENTRY=ALTSPOOLFILE,PARMS,OPERATION,EXAMPLE                             06775000
     :ALTSPOOLFILE                                                      06780000
                                                                        06785000
Alters the characteristics of an active or ready spoolfile.             06790000
                                                                        06795000
SYNTAX                                                                  06800000
                                                                        06805000
                           [;PRI=outpriority ]                          06810000
                   {#Onnn} [;COPIES=numcopies]                          06815000
     :ALTSPOOLFILE {ldn1 } [;DEV={ldn2    }  ]                          06820000
                           [     {devclass}  ]                          06825000
                           [;DEFER           ]                          06830000
                                                                        06835000
\ITEM=PARMS                                                             06840000
PARAMETERS                                                              06845000
                                                                        06850000
#Onnn          The output devicefile identification.                    06855000
ldn1           The logical device of an active spoolfile.               06860000
ldn2           The logical device number of the device for which        06865000
               the spooled file is being altered.                       06870000
                                                                        06875000
PRI            Specifies the output priority of the designated          06880000
               devicefile (0=lowest; 14=highest).                       06885000
                                                                        06890000
COPIES         Specifies the number of copies to be produced from       06895000
               the designated devicefile.                               06900000
                                                                        06905000
DEV            Specifies the logical device number or device class      06910000
               name of the devicefile's destination device.             06915000
                                                                        06920000
DEFER          Results in the output priority of the currently          06925000
               active spooled device file being changed immediately     06930000
               to 0 and the file being returned to ready state,         06935000
               thus deferring the file.                                 06940000
                                                                        06945000
\ITEM=OPERATION                                                         06950000
OPERATION                                                               06955000
                                                                        06960000
Output spooled devicefiles with a priority less than or equal to        06965000
the current output fence will not be selected (they will be deferred)   06970000
for spooling.                                                           06975000
                                                                        06980000
Before using the DEFER option parameters it is desirable to physically  06985000
stop the output device first.  This allows you time to enter the        06990000
command and to ascertain that the currently ACTIVE spooled file         06995000
corresponds to the devicefile physically being output.                  07000000
                                                                        07005000
                           NOTE                                         07010000
                                                                        07015000
             If you stop the device before entering                     07020000
             the command, you must return the device to                 07025000
             the on-line state before the command can                   07030000
             be physically executed.                                    07035000
                                                                        07040000
\ITEM=EXAMPLE                                                           07045000
EXAMPLES                                                                07050000
To defer the currently active spooled file being output to logical      07055000
device 6 (a line printer), first stop the device, then enter:           07060000
                                                                        07065000
     :ALTSPOOLFILE 6;DEFER                                              07070000
                                                                        07075000
                           NOTE                                         07080000
                                                                        07085000
             The DEFER optional parameter places the                    07090000
             currently ACTIVE output spooled file in                    07095000
             the READY state, and in addition lowers                    07100000
             the outputpriority to 0 (lowest priority).                 07105000
             Action by you is required to raise the                     07110000
             outputpriority of the DEFERed file.                        07115000
                                                                        07120000
To display and then change the priority of deferred devicefile #O---    07125000
from 0 to 3, enter:                                                     07130000
                                                                        07135000
     :SHOWOUT SP                                                        07140000
                                                                        07145000
                                                                        07150000
 DEV/CL   DFID    JOBNUM  FNAME    STATE FRM SPACE RANK PRI #C          07155000
 LP       #O930   #S507   TEPELIST READY       384  1    8   1          07160000
                                                                        07165000
                                                                        07170000
     :ALTSPOOLFILE #O930;PRI=3                                          07175000
                                                                        07180000
                                                                        07185000
\ENTRY=ALTUSER,PARMS,OPERATION,EXAMPLE                                  07190000
    :ALTUSER (Account Manager capability required)                      07195000
                                                                        07200000
Alters attributes currently defined for a user.                         07205000
                                                                        07210000
SYNTAX                                                                  07215000
                                                                        07220000
    :ALTUSER username                                                   07225000
             [;PASS=[password]]                                         07230000
             [;CAP=[capabilitylist]]                                    07235000
             [;MAXPRI=[subqueuename]]                                   07240000
             [;LOCATTR=[localattribute]]                                07245000
             [;HOME=[homegroupname]]                                    07250000
                                                                        07255000
\ITEM=PARMS                                                             07260000
PARAMETERS                                                              07265000
                                                                        07270000
username             The name assigned to the user (with the :NEWUSER   07275000
                     command or the first user assigned with a :NEWACCT 07280000
                     command).  (REQUIRED PARAMETER)                    07285000
                                                                        07290000
password             The new password to be assigned to the user. If    07295000
                     omitted, any existing password is removed.         07300000
                                                                        07305000
capabilitylist       List of capabilities, mutually separated by commas,07310000
                     permitted this account.  Each capability is denoted07315000
                     by a two-letter mnemonic, as follows:              07320000
                                                                        07325000
                     System Manager          = SM                       07330000
                     Account Manager         = AM                       07335000
                     Account Librarian       = AL                       07340000
                     Group Librarian         = GL                       07345000
                     Diagnostician           = DI                       07350000
                     System Supervisor       = OP                       07355000
                     Network Administrator   = NA                       07360000
                     Node Manager            = NM                       07365000
                                                                        07370000
                     Permanent Files         = SF                       07375000
                     Access of non-sharable                             07380000
                     I/O devices             = ND                       07385000
                     Create Volumes          = CV                       07390000
                     Use Volumes             = UV                       07395000
                     Use Communications                                 07396000
                     Subsystems              = CS                       07397000
                     Create                                             07398000
                     Programmatic Sessions   = PS                       07399000
                                                                        07400000
                     Process Handling        = PH                       07405000
                     Extra Data Segments     = DS                       07410000
                     Multiple RINS           = MR                       07415000
                     Privileged Mode         = PM                       07420000
                     Interactive Access      = IA                       07425000
                     Local Batch Access      = BA                       07430000
                     User Logging            = LG                       07435000
                     Default is SF, ND, IA, BA.                         07440000
                                                                        07445000
subqueuename         The name of the subqueue of highest priority that  07450000
                     can be requested by any process of any job/session 07455000
                     in the account, specified as xS, where x is A, B,  07460000
                     C, D, or E.                                        07465000
                                                                        07470000
                     The priority specified with the :ALTUSER command   07475000
                     cannot be greater than that specified with the     07480000
                     :NEWACCT or :ALTACCT commands.  (But, if the user's07485000
                     account is altered later, he may be left with      07490000
                     excessive limits.)  The <subqueuename> defined for 07495000
                     the user is checked against the <subqueuename>     07500000
                     defined for his account at logon time, and the     07505000
                     lower priority of the two is used as the maximum   07510000
                     priority restricting all processes of the          07515000
                     job/session. Also, the priority requested by the   07520000
                     user when he logs on is checked against the        07525000
                     <subqueuename> defined for him, and he is granted  07530000
                     the lower of these two values.  Default is CS.     07535000
                                                                        07540000
localattribute       The local attribute of the user, as defined at the 07545000
                     installation site.  This is a double-word of       07550000
                     arbitrary meaning which might be used to further   07555000
                     classify users.  While it is not involved in       07560000
                     standard MPE security provisions, it is available  07565000
                     to processes through the WHO intrinsic for use in  07570000
                     the programmer's own security provisions.  Default 07575000
                     is double-word 0 (null).                           07580000
                                                                        07585000
homegroupname        The name of an existing group to be assigned as the07590000
                     homegroup for this user.  Default is no homegroup. 07595000
                                                                        07600000
\ITEM=OPERATION                                                         07605000
OPERATION                                                               07610000
                                                                        07615000
(Account Manager capability required)                                   07620000
This command alters the attributes currently defined for a user.        07625000
                                                                        07630000
When an entire keyword parameter group is omitted from the :ALTUSER     07635000
command, the corresponding value for this user remains unchanged. When a07640000
keyword is included but the corresponding parameter is omitted (as in   07645000
;PASS=), a default value is assigned as follows:                        07650000
                                                                        07655000
    PARAMETER          DEFAULT VALUE                                    07660000
                                                                        07665000
    password           Null (no password)                               07670000
                                                                        07675000
    capabilitylist     SF, ND, IA, BA (provided the account has these   07680000
                       capabilities)                                    07685000
                                                                        07690000
    subqueuename       CS                                               07695000
                                                                        07700000
    localattribute     Null (double-word 0)                             07705000
                                                                        07710000
    homegroupname      None (no home group).  If a user has no homegroup07715000
                       assigned, he must specify a logon group when     07720000
                       initiating a job or session.                     07725000
                                                                        07730000
When a parameter is modified with the :ALTUSER command, it takes effect 07735000
immediately in the directory, but does not apply to users currently     07740000
logged on; it will take effect for the next log on by such users.  For  07745000
this reason, it is recommended that the users involved be advised of the07750000
change in advance.  It is not recommended that the capabilitylist or    07755000
homegroupname of the MANAGER.SYS user be altered.                       07760000
                                                                        07765000
\ITEM=EXAMPLE                                                           07770000
EXAMPLE                                                                 07775000
                                                                        07780000
Suppose an account's capabilities are AM, AL, GL, SF, ND, PH, DS, MR,   07785000
IA, BA.  To change the <capabilitylist> of the user JONES from IA, BA,  07790000
SF, PH, DS to include the Multiple RIN capability (MR), enter:          07795000
                                                                        07800000
    :ALTUSER JONES;CAP=IA,BA,SF,PH,DS,MR                                07805000
                                                                        07810000
                                                                        07815000
\ENTRY=ALTVSET,PARMS,OPERATION,EXAMPLE                                  07820000
    :ALTVSET                                                            07825000
                                                                        07830000
(System Manager, or Account Manager with Volume Set Creation (CV)       07835000
capability required)                                                    07840000
                                                                        07845000
Modifies volume set definitions.                                        07850000
                                                                        07855000
SYNTAX                                                                  07860000
                                                                        07865000
    :ALTVSET vsname                                                     07870000
             [;ADDCLASS=vcname:vname[,vname],...[,vname]]               07875000
             [;EXPANDCLASS=vcname:vname[,vname],...[,vname]]            07880000
             [;EXPANDSET=vname:type[,vname:type],...[vname:type]]       07885000
                                                                        07890000
\ITEM=PARMS                                                             07895000
PARAMETERS                                                              07900000
                                                                        07905000
vsname             Existing volume set name.  MPE will implicitly       07910000
                   reference <vsname> as <vsname.groupname.acctname>,   07915000
                   where <groupname> and <acctname> are the logon group 07920000
                   and account.  (REQUIRED PARAMETER)                   07925000
                                                                        07930000
vcname:vname       Volume class name, consisting of up to eight         07935000
                   alphanumeric characters, beginning with a letter.    07940000
                   Each volume class consists of a volume class name and07945000
                   an associated list of volume names <vname>. The list 07950000
                   of volume names must be a subset of the volumes      07955000
                   comprising the volume set, and one of the volume     07960000
                   names must be that of the volume set's master volume.07965000
                                                                        07970000
;ADDCLASS          Add a volume class and an associated list of volume  07975000
                   names.  The list of volume names must be a subset of 07980000
                   the volumes comprising the volume set and one of the 07985000
                   volume names must be that of the volume set's master 07990000
                   volume.                                              07995000
                                                                        08000000
;EXPANDCLASS       Add names of new members in the volume class.  These 08005000
                   new members can only be members of already existing  08010000
                   classes of the parent volume set.                    08015000
                                                                        08020000
;EXPANDSET         Add names of new members in the volume set and types 08025000
                   of devices required to accomodte the new members.    08030000
                   Total members in a volume set may not exceed eight.  08035000
                   The <type> must be specified with each volume member 08040000
                   name to define the type of disc drive.  Types of disc08045000
                   drives that may be specified are HP7905, HP7906,     08050000
                   HP7920, HP7925, HP7933, and HP7935.                  08055000
                                                                        08060000
                                                                        08065000
\ITEM=OPERATION                                                         08070000
OPERATION                                                               08075000
                                                                        08080000
(System Manager, or Account Manager with Volume Set Creation (CV)       08085000
capability required)                                                    08090000
                                                                        08095000
The :ALTVSET command is used to modify volume set definitions.  Volume  08100000
class names can be added or deleted, and the number of member volumes   08105000
can be increased.  The overall size of the volume set, however, cannot  08110000
be decreased (member volumes cannot be deleted; deleting a volume class 08115000
does not delete the volumes in that class).                             08120000
                                                                        08125000
\ITEM=EXAMPLE                                                           08130000
EXAMPLE                                                                 08135000
                                                                        08140000
To add member volumes MEM3 and MEM4 to the existing volume set USERSET, 08145000
enter:                                                                  08150000
                                                                        08155000
    :ALTVSET USERSET;ADDVOL MEM3:HP7920,MEM4:HP7920                     08160000
\ENTRY=APL,PARMS,OPERATION,EXAMPLE                                      08165000
    :APL                                                                08170000
                                                                        08175000
Accesses APL subsystem.                                                 08180000
                                                                        08185000
SYNTAX                                                                  08190000
                                                                        08195000
    :APL                                                                08200000
                                                                        08205000
\ITEM=PARMS                                                             08210000
PARAMETERS                                                              08215000
                                                                        08220000
None                                                                    08225000
                                                                        08230000
\ITEM=OPERATION                                                         08235000
OPERATION                                                               08240000
                                                                        08245000
Accesses the APL subsystem, which is used to create and execute APL     08250000
programs.                                                               08255000
                                                                        08260000
                                                                        08265000
                           NOTE                                         08270000
                                                                        08275000
      The recommended way of accessing the APL subsystem from           08280000
      terminals equipped with the APL character set is through          08285000
      the command log on.  The unusual APL character set and its        08290000
      resultant coding causes unreadable logon and logoff               08295000
      messages when the :HELLO and :BYE commands are used at APL        08300000
      terminals.                                                        08305000
                                                                        08310000
\ITEM=EXAMPLE                                                           08315000
EXAMPLE                                                                 08320000
                                                                        08325000
    :(APL) MAC.TECHPUBS                                                 08330000
\ENTRY=ASSOCIATE,EXAMPLE                                                08335000
     :ASSOCIATE                                                         08340000
                                                                        08345000
Gives a user operator control of a device.                              08350000
                                                                        08355000
SYNTAX                                                                  08360000
                                                                        08365000
     :ASSOCIATE devclass                                                08370000
                                                                        08375000
\ITEM=PARMS                                                             08380000
                                                                        08385000
PARAMETERS                                                              08390000
                                                                        08395000
devclass        The device class specified during SYSDUMP.              08400000
                                                                        08405000
\ITEM=OPERATION                                                         08410000
OPERATION                                                               08415000
                                                                        08420000
The :ASSOCIATE command allows a user to use any operator command        08425000
dealing with a specific device class.  Once this occurs, the            08430000
associated user receives device status messages relating to             08435000
that device.  The device messages no longer go to the system            08440000
console; they go to the terminal of the associated user.                08445000
However, the messages are still logged in the console log               08450000
file if enabled. When a user :ASSOCIATEs a device the operator is       08455000
notified; and if the operator attempts to control an ASSOCIATEd         08460000
device, the operator is notified that the device is ASSOCIATEd          08465000
and who the user in control is.  At this point, the operator is         08470000
asked whether he wants to continue with the operation.                  08475000
                                                                        08480000
Associations continue until the original user in control of the         08485000
device or the operator explicitly DISASSOCIATEs (gives control          08490000
to) the device, or when the user in control logs off.                   08495000
                                                                        08500000
                              NOTE                                      08505000
In order for a user to use the :ASSOCIATE command, the System           08510000
Manager must create a device-user association table.  This              08515000
table is created by running the ASOCTABL utility.  (Refer to the        08520000
System Utilities Reference Manual).                                     08525000
                                                                        08530000
\ITEM=EXAMPLE                                                           08535000
EXAMPLES                                                                08540000
                                                                        08545000
To be the controller of deviceclass TAPE, enter:                        08550000
                                                                        08555000
     :ASSOCIATE TAPE                                                    08560000
                                                                        08565000
\ENTRY=BASIC,PARMS,OPERATION,EXAMPLE                                    08570000
    :BASIC                                                              08575000
                                                                        08580000
Interprets a BASIC program.                                             08585000
                                                                        08590000
SYNTAX                                                                  08595000
                                                                        08600000
    :BASIC [commandfile][,[inputfile][,listfile]]                       08605000
                                                                        08610000
\ITEM=PARMS                                                             08615000
PARAMETERS                                                              08620000
                                                                        08625000
commandfile          Actual designator of source file (device) from     08630000
                     which BASIC commands and statements are input.  Can08635000
                     be any ASCII input file. Formal designator is      08640000
                     BASCOM.  Default is $STDINX.                       08645000
                                                                        08650000
inputfile            Actual designator of file containing data input for08655000
                     BASIC program.  Can be any ASCII input file. Formal08660000
                     designator is BASIN. Default is $STDINX.           08665000
                                                                        08670000
listfile             Actual designator of destination file for program  08675000
                     listing and output.  Can be any ASCII output file. 08680000
                     Formal designator is BASLIST.  Default is $STDLIST.08685000
                                                                        08690000
                              NOTE                                      08695000
                                                                        08700000
      The formal file designators used in this command                  08705000
      (BASCOM, BASIN, BASLIST)                                          08710000
      cannot be back referenced as actual file designators              08715000
      in the command parameter list.  For further information,          08720000
      see the discussion of implied :FILE commands in                   08725000
      Section VII of the MPE Commands Reference Manual.                 08730000
                                                                        08735000
\ITEM=OPERATION                                                         08740000
OPERATION                                                               08745000
                                                                        08750000
Generally used for on-line programming in BASIC, but it can also be used08755000
to interpret BASIC programs submitted in batch mode.  In batch mode, the08760000
BASIC >EOD command is required after any data following the BASIC >RUN  08765000
command, or after the >RUN command itself if there is no data.          08770000
                                                                        08775000
\ITEM=EXAMPLE                                                           08780000
EXAMPLE                                                                 08785000
                                                                        08790000
To enter commands and data from your standard input device, with program08795000
listing and output transmitted to the standard output device, enter:    08800000
                                                                        08805000
    :BASIC                                                              08810000
                                                                        08815000
To submit BASIC interpreter commands and statements from the command    08820000
file MYCOMDS, and data from the input file MYDATA, with program listing 08825000
and output written to the list file MYLIST, enter:                      08830000
                                                                        08835000
    :BASIC MYCOMDS,MYDATA,MYLIST                                        08840000
                                                                        08845000
(All three files are disc files.)                                       08850000
                                                                        08855000
Note that input files created on the Editor must be kept with the UNN   08860000
option of the Editor KEEP command.                                      08865000
                                                                        08870000
                                                                        08875000
\ENTRY=BASICGO,PARMS,OPERATION,EXAMPLE                                  08880000
    :BASICGO                                                            08885000
                                                                        08890000
Compiles, prepares, and executes a BASIC program.                       08895000
                                                                        08900000
SYNTAX                                                                  08905000
                                                                        08910000
    :BASICGO [commandfile][,listfile]                                   08915000
                                                                        08920000
\ITEM=PARMS                                                             08925000
PARAMETERS                                                              08930000
                                                                        08935000
commandfile           Actual designator of input file from which BASIC  08940000
                      compiler commands are read.  Can be any ASCII     08945000
                      input file.  Formal designator is BSCTEXT. Default08950000
                      is $STDINX.                                       08955000
                                                                        08960000
listfile              Actual designator of file on which program listing08965000
                      is written.  Can be any ASCII output file.  Formal08970000
                      designator is BSCLIST.  Default is $STDLIST.      08975000
                                                                        08980000
                              NOTE                                      08985000
      The formal file designators used in this command                  08990000
      (BSCTEXT and BSCLIST) cannot be back referenced as                08995000
      actual file designators in the command parameter                  09000000
      list.  For further information, see the discussion                09005000
      of implied :FILE commands in Section VII of the                   09010000
      MPE Commands Reference Manual.                                    09015000
                                                                        09020000
\ITEM=OPERATION                                                         09025000
OPERATION                                                               09030000
                                                                        09035000
Compiles, prepares, and executes a program from a SAVE FAST file        09040000
(created by BASIC interpreter).  This enables the program to run faster 09045000
than it would if executed by the interpreter.  After the program is     09050000
written, it can be saved with the BASIC interpreter command SAVE        09055000
<filename>, FAST.  The program then can be compiled, prepared, and      09060000
executed with the :BASICGO command.                                     09065000
                                                                        09070000
\ITEM=EXAMPLE                                                           09075000
EXAMPLE                                                                 09080000
                                                                        09085000
To compile, prepare, and execute the BASIC program MYPROG, with the     09090000
listing directed to the disc file LISTFL, enter:                        09095000
                                                                        09100000
    :BASICGO ,LISTFL              Calls the BASIC compiler              09105000
                                                                        09110000
    :$CONTROL USLINIT,SOURCE      Initializes USL and requests program  09115000
                                  listing                               09120000
                                                                        09125000
    :COMPILE MYPROG               Compiles program MYPROG               09130000
                                                                        09135000
    $EXIT                         Exits from compiler                   09140000
                                                                        09145000
                                                                        09150000
\ENTRY=BASICOMP,PARMS,OPERATION,EXAMPLE                                 09155000
    :BASICOMP                                                           09160000
                                                                        09165000
Compiles a BASIC program.                                               09170000
                                                                        09175000
SYNTAX                                                                  09180000
                                                                        09185000
    :BASICOMP [commandfile][,[uslfile][,listfile]]                      09190000
                                                                        09195000
\ITEM=PARMS                                                             09200000
PARAMETERS                                                              09205000
                                                                        09210000
commandfile            Actual designator of input file from which       09215000
                       compiler commands are read.  Can be any ASCII    09220000
                       input file.  Formal designator is BSCTEXT.       09225000
                       Default is $STDINX.                              09230000
                                                                        09235000
uslfile                Actual designator of user subprogram library     09240000
                       (USL) file on which compiled object program is   09245000
                       written.  Can be any binary output file with     09250000
                       filecode of USL (or 1024). Formal designator is  09255000
                       BSCUSL. This parameter, if entered, must specify 09260000
                       a file created previously in one of four ways:   09265000
                                                                        09270000
                       1.  By saving a USL file (with the :SAVE command)09275000
                           created by a previous compilation where the  09280000
                           default value was used for the uslfile       09285000
                           parameter.                                   09290000
                                                                        09295000
                       2.  By building the USL with the Segmenter       09300000
                           command -BUILDUSL (see the MPE Segmenter     09305000
                           Reference Manual).                           09310000
                                                                        09315000
                       3.  By creating a new USL file with the MPE      09320000
                           :BUILD command and a filecode parameter of   09325000
                           USL or 1024.                                 09330000
                                                                        09335000
                       4.  By specifying a non-existent <uslfile>       09340000
                           parameter, thereby creating a permanent file 09345000
                           of the correct size and type.                09350000
                                                                        09355000
                       Default is $NEWPASS is assigned.                 09360000
                                                                        09365000
listfile               Actual designator of file on which program       09370000
                       listing is written.  Can be any ASCII output     09375000
                       file.  Formal designator is BSCLIST.  Default is 09380000
                       $STDLIST.                                        09385000
                                                                        09390000
                              NOTE                                      09395000
                                                                        09400000
      The formal file designators used in this command                  09405000
      (BSCTEXT, BSCUSL, BSCLIST)                                        09410000
      cannot be back referenced as actual file designators              09415000
      in the command parameter list.  For further information,          09420000
      see the discussion of implied :FILE commands in                   09425000
      Section VII of the MPE Commands Reference Manual.                 09430000
                                                                        09435000
\ITEM=OPERATION                                                         09440000
OPERATION                                                               09445000
                                                                        09450000
Compiles a program from a SAVE FAST file (created by the BASIC inter-   09455000
preter) onto disc in USL format.  This enables the program to run faster09460000
than it would if left in the form generated by the interpreter.  After  09465000
the program is written, it is stored in a SAVE FAST file with the BASIC 09470000
interpreter command SAVE filename,FAST.  The program then can be        09475000
compiled with the compiler command COMPILE, prepared with the MPE :PREP 09480000
command, and executed with the MPE :RUN command.                        09485000
                                                                        09490000
\ITEM=EXAMPLE                                                           09495000
EXAMPLE                                                                 09500000
                                                                        09505000
To compile the BASIC program MYPROG onto the USL named OBJECT, enter:   09510000
                                                                        09515000
    :BUILD OBJECT;CODE=USL           Builds USL file                    09520000
                                                                        09525000
    :BASICOMP ,OBJECT                Calls BASIC compiler, specifies USL09530000
                                     named OBJECT                       09535000
                                                                        09540000
    $COMPILE MYPROG                  Compiles SAVE FAST program named   09545000
                                     MYPROG                             09550000
                                                                        09555000
    $EXIT                            Exits from compiler                09560000
                                                                        09565000
                                                                        09570000
                                                                        09575000
\ENTRY=BASICPREP,PARMS,OPERATION,EXAMPLE                                09580000
    :BASICPREP                                                          09585000
                                                                        09590000
Compiles and prepares a BASIC program.                                  09595000
                                                                        09600000
SYNTAX                                                                  09605000
                                                                        09610000
    :BASICPREP [commandfile][,[progfile][,listfile]]                    09615000
                                                                        09620000
\ITEM=PARMS                                                             09625000
PARAMETERS                                                              09630000
                                                                        09635000
commandfile           Actual designator of input file from which        09640000
                      compiler commands are read.  Can be any ASCII     09645000
                      file.  Formal designator is BSCTEXT. Default is   09650000
                      $STDINX.                                          09655000
                                                                        09660000
progfile              Actual designator of program file on which        09665000
                      prepared program segments are written.  Can be any09670000
                      binary output file with file code of PROG (or     09675000
                      1029).  This parameter, if entered, must indicate 09680000
                      a file created in one of two ways:                09685000
                                                                        09690000
                      1.  With the MPE :BUILD command using the filecode09695000
                          parameter PROG or 1029, and a numextents      09700000
                          parameter value of 1.                         09705000
                                                                        09710000
                      2.  By specifying a non-existent file in the      09715000
                          progfile parameter, in which case a job       09720000
                          temporary file of the correct size and type is09725000
                          created.                                      09730000
                                                                        09735000
                      Default is $NEWPASS is assigned.                  09740000
                                                                        09745000
listfile              Actual designator of file on which program listing09750000
                      is written.  Can be any ASCII output file.  Formal09755000
                      designator is BSCLIST.  Default is $STDLIST.      09760000
                                                                        09765000
                              NOTE                                      09770000
                                                                        09775000
      The formal file designators used in this command                  09780000
      (BSCTEXT, BSCPROG,BSCLIST) cannot be back                         09785000
      referenced as actual file designators in the                      09790000
      command parameter list.  For further information,                 09795000
      see the discussion of implied :FILE commands in                   09800000
      Section VII of the MPE Commands Reference Manual.                 09805000
                                                                        09810000
\ITEM=OPERATION                                                         09815000
OPERATION                                                               09820000
                                                                        09825000
Compiles and prepares a program from a SAVE FAST file (created by BASIC 09830000
interpreter) into a program file on disc.  This enables the program to  09835000
run considerably faster than it would if executed by the interpreter.   09840000
After the program is written, it can be stored in a SAVE FAST file with 09845000
the BASIC interpreter command SAVE filename,FAST. It then can be        09850000
compiled/prepared with the MPE :BASICPREP command and executed with the 09855000
MPE :RUN command.                                                       09860000
                                                                        09865000
\ITEM=EXAMPLE                                                           09870000
EXAMPLE                                                                 09875000
                                                                        09880000
To compile and prepare a program named MYPROG from the BASIC SAVE FAST  09885000
file named MYCOMDS, with listing directed to the standard list device,  09890000
enter:                                                                  09895000
                                                                        09900000
    :BASICPREP ,MYCOMDS                                                 09905000
                                                                        09910000
The file MYCOMDS is an ASCII file that contains the following BASIC     09915000
compiler commands:                                                      09920000
                                                                        09925000
    $CONTROL USLINIT,SOURCE       Initializes USL and lists program     09930000
                                                                        09935000
    $COMPILE MYPROG               Compiles SAVE FAST program            09940000
                                                                        09945000
    $EXIT                         Exits from compiler                   09950000
                                                                        09955000
                                                                        09960000
\ENTRY=BREAKJOB,PARMS,OPERATION,EXAMPLE                                 09965000
     :BREAKJOB                                                          09970000
                                                                        09975000
Suspends an executing job.                                              09980000
                                                                        09985000
SYNTAX                                                                  09990000
                                                                        09995000
     :BREAKJOB #Jnnn                                                    10000000
                                                                        10005000
\ITEM=PARMS                                                             10010000
PARAMETERS                                                              10015000
                                                                        10020000
#Jnnn          A job number.                                            10025000
                                                                        10030000
\ITEM=OPERATION                                                         10035000
OPERATION                                                               10040000
                                                                        10045000
                                                                        10050000
Any executing job may be suspended, including spooled and streamed      10055000
jobs.  A job that is holding a critical system resource, such as        10060000
a SIR Table (System Internal Resource), will be allowed to continue     10065000
running until it releases the resource at which time it will be         10070000
suspended.                                                              10075000
                                                                        10080000
All commands that normally function on, or pertain to executing jobs,   10085000
such as :ABORTJOB, will be operative on suspended jobs.                 10090000
                                                                        10095000
If a request is made to suspend a job that owns a non-sharable device,  10100000
such as a tape drive, a console message will be issued to inform you    10105000
that the job owns the device.  Up to ten non-sharable devices can       10110000
be listed.  You may then decide if the job should be allowed to run     10115000
until it releases the devices, or if it should be aborted.              10120000
                                                                        10125000
a SHOWJOB listing will show SUSP for jobs that are in the suspended     10130000
state.  SUSP may also be used as a qualifier in the :SHOWJOB command.   10135000
Thus :SHOWJOB SUSP will display all suspended jobs present in the       10140000
system.                                                                 10145000
                                                                        10150000
\ITEM=EXAMPLE                                                           10155000
EXAMPLES                                                                10160000
                                                                        10165000
To suspend job number 68, enter:                                        10170000
                                                                        10175000
     :BREAKJOB #J68                                                     10180000
                                                                        10185000
\ENTRY=BUILD,PARMS,OPERATION,EXAMPLE                                    10190000
    :BUILD                                                              10195000
                                                                        10200000
Creates and immediately allocates new empty file on disc.               10205000
                                                                        10210000
SYNTAX                                                                  10215000
                                                                        10220000
                                                         F   BINARY     10225000
    :BUILD filereference[;REC=[recsize][,[blockfactor][,[U][,      ]]]] 10230000
                                                         V   ASCII      10235000
                                                                        10240000
           ;CCTL                                                        10245000
          [        ]                                                    10250000
           ;NOCCTL                                                      10255000
                                                                        10260000
          [;TEMP]                                                       10265000
          [;DEV=[[dsdevice]#][device]]                                  10270000
          [;CODE=[filecode]]                                            10275000
          [;DISC=[numrec][,[numextents[,[initalloc]]]]]                 10280000
          [;RIO]                                                        10285000
          [;NORIO]                                                      10290000
          [;MSG]                                                        10295000
          [;CIR]                                                        10300000
                                                                        10305000
\ITEM=PARMS                                                             10310000
PARAMETERS                                                              10315000
                                                                        10320000
filereference          Actual name of file to be created, in the        10325000
                       following format:                                10330000
                                                                        10335000
                       filename[/lockword][.groupname][.acctname]       10340000
                                                                        10345000
                       Names may contain from 1 to 8 alphanumeric       10350000
                       characters, beginning with a letter.  If         10355000
                       <acctname> is specified, it must be that of your 10360000
                       logon account (you cannot create a file in       10365000
                       another account).  Default <groupname> and       10370000
                       <acctname> are the logon group and account.      10375000
                       (REQUIRED PARAMETER)                             10380000
                                                                        10385000
recsize                Record size.  A positive number indicates words  10390000
                       while negative indicates bytes. For fixed-length 10395000
                       files, this is logical record size.  For         10400000
                       undefined-length, this is the maximum record     10405000
                       size.  For variable-length files this is the     10410000
                       maximum physical record size.  Default is        10415000
                       determined at device configuration.              10420000
                                                                        10425000
blockfactor            Number of logical records per physical block.    10430000
                       Default is calculated by dividing the specified  10435000
                       <recsize> into the configured <blocksize>; this  10440000
                       value is rounded downward to an integer that is  10445000
                       never less than 1.                               10450000
                                                                        10455000
F, U, V                File contains fixed (F), undefined (U), or       10460000
                       variable (V) length records.  Default is <F> for 10465000
                       disc files, <U> for all others.                  10470000
                                                                        10475000
BINARY                 File contains binary-coded records.  Default.    10480000
                                                                        10485000
ASCII                  File contains ASCII-coded records.  Default is   10490000
                       BINARY.                                          10495000
                                                                        10500000
CCTL                   Indicates carriage-control characters will be    10505000
                       supplied with write requests.  Default is NOCCTL.10510000
                                                                        10515000
NOCCTL                 Indicates carriage-control characters will not be10520000
                       supplied with write requests. Default.           10525000
                                                                        10530000
TEMP                   File will be created as a job temporary file and 10535000
                       will be saved in the job/session temporary file  10540000
                       domain when closed. Default is permanent file.   10545000
                                                                        10550000
dsdevice               The device class name or logical device number   10555000
                       that was used to open the communications link    10560000
                       to the remote computer where the source file     10565000
                       resides.  Default is the local system (that is,  10570000
                       the system where the transfer request is         10575000
                       submitted).  A (#) is a delimiter between the    10580000
                       file name of the remote computer and the remote  10585000
                       device file name.                                10590000
                                                                        10595000
device                 Specifies the device on which the file is to     10600000
                       reside, entered in either the devclass or ldev   10605000
                       forms.  The devclass form represents a device    10610000
                       class name of up to eight alphanumeric characters10615000
                       beginning with a letter, e.g., DISC or PVDISC1.  10620000
                       If devclass is specified, the file is allocated  10625000
                       to any available device in that class.  If you   10630000
                       are opening a file which is to reside on a       10635000
                       private volume, you must specify a device class  10640000
                       which includes the drives upon which the home    10645000
                       volume set is mounted; the file is then allocated10650000
                       to any of the home volume set's volumes that fall10655000
                       within that device class.  Note that a file      10660000
                       cannot span more than one volume set, but can    10665000
                       reside on more than one volume within the set.   10670000
                                                                        10675000
                       The logical device number (ldev) consists of a   10680000
                       three digit number specifying a particular       10685000
                       device.  If you are opening a file which is to   10690000
                       reside on a private volume, you must specify a   10695000
                       a disc drive on which one of the volumes in the  10700000
                       home volume set resides.                         10705000
                                                                        10710000
                       Default is device class name DISC.               10715000
                                                                        10720000
filecode               Code indicating a specially-formatted file.  This10725000
                       code is recorded in the file label and is        10730000
                       available to processes accessing the file through10735000
                       the FGETINFO intrinsic.  For this parameter, any 10740000
                       user can specify a positive integer ranging from 10745000
                       0 to 1023.  Certain integers have HP-defined     10750000
                       meanings, as follows:                            10755000
                                                                        10760000
                       Mnemonic     Integer       Meaning               10765000
                                                                        10770000
                       USL          1024     USL file.                  10775000
                       BASD         1025     BASIC data file.           10780000
                       BASP         1026     BASIC program file.        10785000
                       BASFP        1027     BASIC fast program file.   10790000
                       RL           1028     RL file.                   10795000
                       PROG         1029     Program file.              10800000
                       SL           1031     SL file.                   10805000
                       VFORM        1035     V/3000 FORMS file.         10810000
                       VFAST        1036     V/3000 FAST FORMS file.    10815000
                       VREF         1037     V/3000 Reformat file       10820000
                       XLSAV        1040     Cross Loader ASCII file    10825000
                                             (SAVE).                    10830000
                       XLBIN        1041     Cross Loader relocated     10835000
                                             binary file.               10840000
                       XLDSP        1042     Cross Loader ASCII file    10845000
                                             (DISPLAY).                 10850000
                       EDITQ        1050     Edit KEEPQ file (non-      10855000
                                             COBOL).                    10860000
                       EDTCQ        1051     Edit KEEPQ file (COBOL).   10865000
                       EDTCT        1052     Edit TEXT file (COBOL).    10870000
                       TDPDT        1054     TDP/3000 Diary keep file   10875000
                       TDPQM        1055     TDP/3000 Standard Q-Mark   10880000
                       TDPP         1056     TDP/3000 Standard P-Mark   10885000
                       TDPCP        1057     TDP/3000 Cobol P-Mark      10890000
                       TDPQ         1058     TDP/3000 Work File         10895000
                       TDPCQ        1059     TDP/3000 Work File         10900000
                       RJEPN        1060     RJE punch file.            10905000
                       QPROC        1070     QUERY procedure file.      10910000
                                    1071     QUERY work file.           10915000
                                    1072     QUERY work file.           10920000
                       KSAMK        1080     KSAM key file.             10925000
                       GRAPH        1083     GRAPH Specification file   10930000
                       SD           1084     Self-describing file       10935000
                       LOG          1090     User Logging logfile.      10940000
                       WDOC         1100     HP Word Document           10945000
                       WDICT        1101     Hyphenation Dict.          10950000
                       WCONF        1102     HP Word Configuration file 10955000
                       W2601        1103     HP 2601 Environment file   10960000
                       PCELL        1110     IDS/3000 Character Set file10965000
                       PFORM        1111     IDS/3000 Form file         10970000
                       P2680        1112     IFS/3000 Environment file  10975000
                       PCCMP        1113     IFS/3000 Char file         10980000
                       RASTR        1114     Graphics Image             10985000
                                              in RASTR format           10990000
                       OPTLF        1130     On-line Performance        10995000
                                              Tool file                 11000000
                       TEPES        1131     TEPE/3000 Script file      11005000
                       TEPEL        1132     TEPE/3000 Log file         11010000
                       SAMPL        1133     APS/3000 Log file          11015000
                       MPEDL        1139     MPEDCP/DRP Log file        11020000
                       TSR          1140     TOOLSET Root file          11025000
                       TSR          1141     TOOLSET Log file           11030000
                       DRAW         1145     Drawing file for HP Draw   11035000
                       FIG          1146     Figure file for HP Draw    11040000
                       DSTOR        1156     Store file for             11045000
                                              RAPID/3000 DICTDBU        11050000
                       TCODE        1157     Code file for TRANSACT/300011055000
                       RCODE        1158     Code file for REPORT/3000  11060000
                       ICODE        1159     Code file for INFORM/3000  11065000
                       MDIST        1166     HPMAIL Distribution list   11070000
                       MTEXT        1167     HPMAIL Text                11075000
                       NCONF        1192     Network Configuration file 11080000
                       NTRAC        1193     Network Trace file         11085000
                       NLOG         1194     Network Log file           11090000
                                                                        11095000
                       Default is 0.                                    11100000
                                                                        11105000
numrec                 Maximum number of logical records.  For          11110000
                       fixed and undefined length files the             11115000
                       maximum value allowed for this field is          11120000
                       2,147,483,647.  For variable length files        11125000
                       this value is dependent upon input record        11130000
                       size and blocksize.  The file system uses        11135000
                       these values to compute other character-         11140000
                       istics of the file as well.  Therefore           11145000
                       the values (or default values) specified         11150000
                       on the :FILE command may be valid within         11155000
                       their respective fields, but may cause           11160000
                       overflow errors in the computation of            11165000
                       internally needed file specifications.           11170000
                       Default is a value of 1023.                      11175000
                                                                        11180000
                                                                        11185000
numextents             Maximum number of disc extents.  This is a value 11190000
                       from 1 to 32.  Default is 8.                     11195000
initialloc             Number of extents to be initially allocated to   11200000
                       the file at the time it is opened.  This is a    11205000
                       value from 1 to 32.  Default is 1.               11210000
                                                                        11215000
RIO                    If RIO is specified, a relative I/O file         11220000
                       is created.  The record length parameter         11225000
                       will implicitly be changed to fixed              11230000
                       record length.  RIO is a special file            11235000
                       access method supported by Cobol II.             11240000
                                                                        11245000
NORIO                  A non-relative I/O file is created.              11250000
                                                                        11255000
MSG                    If MSG is specified, a message file              11260000
                       is created.  MSG is a special file organi-       11265000
                       zation which allow processes to communicate      11270000
                       with each other via uni-directional files.       11275000
                                                                        11280000
CIR                    If CIR is specified, a circular file is          11285000
                       created.  A CIR file is a special file access    11290000
                       which causes the oldest record in the file to    11295000
                       be deleted as a new record is added once the file11300000
                       is full.                                         11305000
\ITEM=OPERATION                                                         11310000
OPERATION                                                               11315000
                                                                        11320000
Builds a new file on disc and immediately allocates space for it,       11325000
initialized to blanks (if an ASCII file) or zeros (if a binary file).   11330000
Unless <TEMP> parameter specified, file is permanent.  (Note that you   11335000
must have SAVE access to the group to which the new file is to belong   11340000
and that you can only build a file belonging to your logon account.)    11345000
If the home volume set is not mounted for the group in which the new    11350000
file is to be built, this command will implicitly cause a volume set    11355000
mount request to be generated.                                          11360000
                                                                        11365000
\ITEM=EXAMPLE                                                           11370000
EXAMPLE                                                                 11375000
                                                                        11380000
To create a permanent disc file named WORKFILE, with fixed-length       11385000
records each 80 bytes long, 3 records per block (blockfactor), and in   11390000
ASCII code, enter:                                                      11395000
                                                                        11400000
    :BUILD WORKFILE;REC=-80,3,F,ASCII;DISC=2000,10,2                    11405000
                                                                        11410000
The file can reside on any disc, has a maximum capacity of 2000 records 11415000
divided into 10 extents, with 2 extents allocated immediately.          11420000
\ENTRY=BYE,PARMS,OPERATION,EXAMPLE                                      11425000
    :BYE                                                                11430000
                                                                        11435000
Ends an interactive session.                                            11440000
                                                                        11445000
SYNTAX                                                                  11450000
                                                                        11455000
    :BYE                                                                11460000
                                                                        11465000
\ITEM=PARMS                                                             11470000
PARAMETERS                                                              11475000
                                                                        11480000
None                                                                    11485000
                                                                        11490000
\ITEM=OPERATION                                                         11495000
OPERATION                                                               11500000
                                                                        11505000
Terminates a session, resulting in a display of logoff information in   11510000
the following format:                                                   11515000
                                                                        11520000
CPU=<cpusecs>. CONNECT=<connectmin>. <currentdatetime>                  11525000
                                                                        11530000
    cpusecs             Total central processor time used by the        11535000
                        session, in seconds, charged against the logon  11540000
                        group and account.                              11545000
                                                                        11550000
    connectmin          Total elapsed time between log on and log off,  11555000
                        rounded upward to nearest minute, charged       11560000
                        against logon group and account.                11565000
                                                                        11570000
    currentdatetime     The current day, date and time at logoff.       11575000
                                                                        11580000
\ITEM=EXAMPLE                                                           11585000
EXAMPLE                                                                 11590000
                                                                        11595000
To terminate a session, enter:                                          11600000
                                                                        11605000
    :BYE                                                                11610000
                                                                        11615000
    CPU=190. CONNECT=16. MON, NOV 10, 1980, 11:14 AM                    11620000
                                                                        11625000
\ENTRY=CACHECONTROL,PARM,OPERATION,EXAMPLE                              11630000
                                                                        11635000
The :CACHECONTROL command modifies up to three global caching           11640000
parameters for the system.                                              11645000
                                                                        11650000
SYNTAX                                                                  11655000
                                                                        11660000
                    {RANDOM = N           }  [;...[;...]]               11665000
     :CACHECONTROL  {SEQUENTIAL = N       }  [;...[;...]]               11670000
                    {BLOCKONWRITE = YES/NO}  [;...[;...]]               11675000
                                                                        11680000
                    1 <= N <= 96                                        11685000
                                                                        11690000
                                                                        11695000
\ITEM=PARMS                                                             11700000
PARAMETERS                                                              11705000
                                                                        11710000
RANDOM         Assigns the number of sectors read from disc on          11715000
               a cache read miss of a random access file. The           11720000
               disc read will stop at extent boundaries and will        11725000
               fetch at least the amount required. The number           11730000
               sectors must be between 1 to 96. The sytem default       11735000
               is 16.                                                   11740000
                                                                        11745000
SEQUENTIAL     Assigns the number of sectors read from disc on          11750000
               a cache read miss of a sequential file. The disc         11755000
               read will stop at extent boundaries and will             11760000
               fetch at least the amount requested. The number          11765000
               of sectors must be between 1 to 96. The system           11770000
               default is 96.                                           11775000
                                                                        11780000
BLOCKONWRITE   Specifies whether or not to "block" the process          11785000
               until the posting of cache buffers to disc               11790000
               completes. The NO option is the default and allows       11795000
               the posting to complete in the background. (I.e.         11800000
               the request will be considered complete as soon          11805000
               as the data has been moved to the cache domain. If       11810000
               the YES option is specified, then each time a write      11815000
               request is issued the process will wait until the        11820000
               write has been physically posted to disc. This           11825000
               only applies to writes since reads do not alter          11830000
               the contents of the cache buffers.                       11835000
                                                                        11840000
                                                                        11845000
                                                                        11850000
\ITEM=OPERATION                                                         11855000
OPERATION                                                               11860000
                                                                        11865000
This command will alter up to three global disc caching parameters      11870000
and is used primarily in tuning of disc caching to best                 11875000
accomodate the current system load.                                     11880000
                                                                        11885000
Disc caching maintains portions of frequently referenced disc           11890000
"domains" in memory. (A disc "domain" is a copy of a portion of         11895000
disc currently residing in main memory.) When an I/O read               11900000
request is made to read data that is not currently in memory            11905000
(i.e. a read "miss"), the requested portion of disc must be             11910000
fetched into memory. Disc caching will use information about            11915000
the file extent size and the access type (random or sequential)         11920000
in its fetch strategy to maximize the "hit" ratio. In other words,      11925000
subsequent read requests may be satisfied by a disc domain              11930000
fetched on a miss.                                                      11935000
                                                                        11940000
The size of the fetch will always be limited by the extent size         11945000
of the file. Within this limitation, the disc domain fetched will       11950000
be equal to the greater of two sizes:                                   11955000
                                                                        11960000
         1) Requested size.                                             11965000
         2) The largest integer multiple of the requested               11970000
            size that is smaller than the value specified               11975000
            by the SEQUENTIAL parameter (for sequential                 11980000
            access) or by the RANDOM parameter (for random              11985000
            access).                                                    11990000
                                                                        11995000
One important factor in maximizing disc caching performance is          12000000
achieving a high hit ratio on read requests. Thus changing the          12005000
value of the SEQUENTIAL and/or RANDOM caching parameters may            12010000
help increase the hit ratio for user I/Os. Note that a poor             12015000
choice for either or both of these parameters can also help             12020000
decrease the hit ratio.                                                 12025000
                                                                        12030000
When disc caching is enabled on your system, all user I/Os will         12035000
complete immediately after moving the data to/from a disc domain,       12040000
thus eliminating the wait for a physical I/O to complete. (I.e          12045000
I/Os now complete at processor speed, not disc speed.)  When the        12050000
I/O request is for a write, the physical write to post the disc         12055000
will be initiated after the move to the disc domain is complete.        12060000
However, the physical post will complete in the background while        12065000
the process continues. Thus write requests look completed to the        12070000
user process before the disc has been updated. By specifying "YES"      12075000
to the BLOCKONWRITE parameter, all user write requests will not         12080000
show complete until the domain has be posted to disc. This              12085000
guarantees that the information is on disc when the request             12090000
completes. However, this does eliminate a performance benefit           12095000
(i.e. completion at processor speed rather than disc access             12100000
speed) for writes that disc caching normally provides.                  12105000
                                                                        12110000
                                                                        12115000
                                                                        12120000
\ITEM=EXAMPLE                                                           12125000
EXAMPLE                                                                 12130000
                                                                        12135000
To alter the number of sectors read on a sequential fetch to be         12140000
90, and the number of sectors on a random fetch to be 10,the            12145000
command would be:                                                       12150000
                                                                        12155000
    :CACHECONTROL SEQUENTIAL=90;RANDOM=10                               12160000
                                                                        12165000
                                                                        12170000
\ENTRY=COBOL,PARMS,OPERATION,EXAMPLE                                    12175000
    :COBOL                                                              12180000
                                                                        12185000
Compiles a COBOL program.                                               12190000
                                                                        12195000
SYNTAX                                                                  12200000
                                                                        12205000
 :COBOL [textfile][,[uslfile][,[listfile][,[masterfile][,newfile]]]]    12210000
        [;INFO=quotedstring]                                            12215000
                                                                        12220000
\ITEM=PARMS                                                             12225000
PARAMETERS                                                              12230000
                                                                        12235000
textfile              Actual designator of input file from which source 12240000
                      program is read.  Can be any ASCII input file.    12245000
                      Formal designator is COBTEXT. Default is $STDIN.  12250000
                                                                        12255000
uslfile               Actual designator of user subprogram library (USL)12260000
                      file on which object program is written. Can be   12265000
                      any binary output file with filecode of USL (or   12270000
                      1024).  Formal designator is COBUSL.  If entered, 12275000
                      this parameter must indicate a file created in    12280000
                      one of four ways:                                 12285000
                                                                        12290000
                      1.  By saving a USL file (with the :SAVE command) 12295000
                          created by a previous compilation where the   12300000
                          default value was used for the <uslfile>      12305000
                          parameter.                                    12310000
                                                                        12315000
                      2.  By building the USL with the Segmenter command12320000
                          -BUILDUSL.                                    12325000
                                                                        12330000
                      3.  By creating a new USL file with the MPE :BUILD12335000
                          command and a <filecode> parameter of USL or  12340000
                          1024.                                         12345000
                                                                        12350000
                      4.  By specifying a non-existent <uslfile>        12355000
                          parameter, thereby creating a permanent file  12360000
                          of the correct size and type.                 12365000
                                                                        12370000
                      If no <uslfile> parameter is supplied, the        12375000
                      USL file is saved in the temporary file, $OLDPASS.12380000
                                                                        12385000
listfile              Actual designator of file on which program listing12390000
                      is written.  Can be any ASCII output file.  Formal12395000
                      designator is COBLIST. Default is $STDLIST.       12400000
                                                                        12405000
masterfile            Actual designator of master file which is merged  12410000
                      against <textfile> to produce composite source.   12415000
                      Can be any ASCII input file.  Formal designator is12420000
                       COBMAST. Default is master file is not read,input12425000
                      is read from <textfile>.                          12430000
                                                                        12435000
newfile               Actual designator of merged <textfile> and        12440000
                      <masterfile>.  Can be any ASCII output file.      12445000
                      Formal designator is COBNEW.  Default is no file  12450000
                      is written.                                       12455000
                                                                        12460000
quotedstring          A string of ASCII characters delimited by a pair  12465000
                      of single or double quotation marks.  If the      12470000
                      delimiting character is desired within the string 12475000
                      it can be doubled.                                12480000
                                                                        12485000
                      The COBOL compiler does not recognize this string 12490000
                      but the syntax is described here for completeness 12495000
                      of the language commands' syntax.                 12500000
                                                                        12505000
                              NOTE                                      12510000
                                                                        12515000
      The formal file designators used in this command                  12520000
      (COBTEXT, COBUSL, COBLIST, COBMAST, COBNEW)                       12525000
      cannot be back referenced as actual file designators              12530000
      in the command parameter list.  For further information,          12535000
      see the discussion of implied :FILE commands in                   12540000
      Section VII of the MPE Commands Reference Manual.                 12545000
                                                                        12550000
\ITEM=OPERATION                                                         12555000
OPERATION                                                               12560000
                                                                        12565000
Compiles COBOL program onto a USL file on disc.  If you do not specify a12570000
source text file, MPE expects input from your standard input device.  If12575000
you create the USL prior to compilation, you must specify a <filecode>  12580000
of USL or 1024.  If you do not specify a <listfile>, MPE sends the      12585000
program listing to the current list device.                             12590000
                                                                        12595000
\ITEM=EXAMPLE                                                           12600000
EXAMPLE                                                                 12605000
                                                                        12610000
To compile a COBOL program that you enter from your current input device12615000
into an object program in the USL file $NEWPASS, and write the listing  12620000
to your current list device, enter:                                     12625000
                                                                        12630000
    :COBOL                                                              12635000
                                                                        12640000
If the next command is one to prepare an object program, $NEWPASS can be12645000
passed to that command by specifying $OLDPASS for the <uslfile>         12650000
parameter.                                                              12655000
                                                                        12660000
To compile a COBOL program residing on the disc file SOURCE into an     12665000
object program on the USL file OBJECT, with the program listing to be   12670000
sent to the disc file LISTFL, enter:                                    12675000
                                                                        12680000
    :BUILD OBJECT;CODE=USL                                              12685000
    :COBOL SOURCE,OBJECT,LISTFL                                         12690000
                                                                        12695000
                                                                        12700000
\ENTRY=COBOLGO,PARMS,OPERATION,EXAMPLE                                  12705000
    :COBOLGO                                                            12710000
                                                                        12715000
Compiles, prepares, and executes a COBOL program.                       12720000
                                                                        12725000
SYNTAX                                                                  12730000
                                                                        12735000
    :COBOLGO [textfile][,[listfile][,[masterfile][,newfile]]]           12740000
             [;INFO=quotedstring]                                       12745000
                                                                        12750000
\ITEM=PARMS                                                             12755000
PARAMETERS                                                              12760000
                                                                        12765000
textfile            Actual designator of input file from which source   12770000
                    program is read.  Can be any ASCII input file.      12775000
                    Formal designator is COBTEXT. Default is $STDIN.    12780000
                                                                        12785000
listfile            Actual designator of file on which program listing  12790000
                    is written.  Can be any ASCII output file.  Formal  12795000
                    designator is COBLIST.  Default is $STDLIST.        12800000
                                                                        12805000
masterfile          Actual designator of master file which is merged    12810000
                    against <textfile> to produce composite source.  Can12815000
                    be any ASCII input file.  Formal designator is      12820000
                    COBMAST.  Default is master file is not read, input 12825000
                    is read from <textfile>.                            12830000
                                                                        12835000
newfile             Actual designator of merged <textfile> and          12840000
                    <masterfile>.  Can be any ASCII output file. Formal 12845000
                    designator is COBNEW.  Default is no file is        12850000
                    written.                                            12855000
                                                                        12860000
quotedstring        A string of ASCII characters delimited by a pair    12865000
                    of single or double quotation marks.  If the        12870000
                    delimiting character is desired within the string   12875000
                    it can be doubled.                                  12880000
                                                                        12885000
                    The COBOL compiler does not recognize this string   12890000
                    but the syntax is described here for completeness   12895000
                    of the language commands' syntax.                   12900000
                                                                        12905000
                              NOTE                                      12910000
                                                                        12915000
      The formal file designators used in this command                  12920000
      (COBTEXT, COBLIST, COBMAST, COBNEW)                               12925000
      cannot be back referenced as actual file designators              12930000
      in the command parameter list.  For further information,          12935000
      see the discussion of implied :FILE commands in                   12940000
      Section VII of the MPE Commands Reference Manual.                 12945000
                                                                        12950000
\ITEM=OPERATION                                                         12955000
OPERATION                                                               12960000
                                                                        12965000
Compiles, prepares, and allocates/executes a COBOL program.  If you do  12970000
not specify <textfile>, MPE expects your input from your current input  12975000
device.  If you do not specify <listfile>, MPE writes the listing to    12980000
your current list device.  This command creates a temporary USL file    12985000
($NEWPASS) that cannot be accessed, and a temporary program file that   12990000
can be accessed under the name $OLDPASS.                                12995000
                                                                        13000000
\ITEM=EXAMPLE                                                           13005000
EXAMPLE                                                                 13010000
                                                                        13015000
To compile, prepare, and execute a COBOL program entered from your      13020000
current input device, with the program listing sent to your current list13025000
device, enter:                                                          13030000
                                                                        13035000
    :COBOLGO                                                            13040000
                                                                        13045000
To compile, prepare, and execute a COBOL program from the disc file     13050000
SOURCE and send the program listing to the disc file LISTFL, enter:     13055000
                                                                        13060000
    :COBOLGO SOURCE,LISTFL                                              13065000
                                                                        13070000
                                                                        13075000
\ENTRY=COBOLPREP,PARMS,OPERATION,EXAMPLE                                13080000
    :COBOLPREP                                                          13085000
                                                                        13090000
Compiles and prepares a COBOL program.                                  13095000
                                                                        13100000
SYNTAX                                                                  13105000
                                                                        13110000
:COBOLPREP [textfile][,[progfile][,[listifile]]]                        13115000
           [,[masterfile][,newfile]]]][;INFO=quotedstring]              13120000
                                                                        13125000
\ITEM=PARMS                                                             13130000
PARAMETERS                                                              13135000
                                                                        13140000
textfile                Actual designator of input file from which      13145000
                        source program is read.  Can be any ASCII input 13150000
                        file.  Formal designator is COBTEXT. Default is 13155000
                        $STDIN.                                         13160000
                                                                        13165000
progfile                Actual designator of program file on which      13170000
                        prepared program segments are written.  Can be  13175000
                        any binary output file with <filecode> of PROG  13180000
                        or 1029.  If parameter is specified, it must    13185000
                        indicate a file created in one of two ways:     13190000
                                                                        13195000
                        1.  With the MPE :BUILD command, specifying a   13200000
                            <filecode> of PROG or 1029 and a            13205000
                            <numextents> parameter value of 1.          13210000
                                                                        13215000
                        2.  By specifying a non-existent file in the    13220000
                            <progfile> parameter in which case a job    13225000
                            temporary file of the correct size and type 13230000
                            is created.                                 13235000
                                                                        13240000
                        If no <uslfile> parameter is supplied, the USL  13245000
                        file is saved in the temporary file, $OLDPASS.  13250000
                                                                        13255000
                         Formal designator is COBPROG.                  13260000
                                                                        13265000
listfile                Actual designator of file on which program      13270000
                        listing is written.  Can be any ASCII output    13275000
                        file.  Formal designator is COBLIST. Default is 13280000
                        $STDLIST.                                       13285000
                                                                        13290000
masterfile              Actual designator if master file which is merged13295000
                        against <textfile> to produce composite source. 13300000
                        Can be any ASCII input file.  Formal designator 13305000
                        is COBMAST. Default is master file is not read, 13310000
                        input is read from <textfile>.                  13315000
                                                                        13320000
newfile                 Actual designator of merger <textfile> and      13325000
                        <masterfile>.  Can be any ASCII output file.    13330000
                        Formal designator is COBNEW.  Default is no file13335000
                        is written.                                     13340000
                                                                        13345000
quotedstring            A string of ASCII characters delimited by a pair13350000
                        of single or double quotation marks.  If the    13355000
                        delimiting quote is desired within the string   13360000
                        it can be doubled.                              13365000
                                                                        13370000
                        The COBOL compiler doesn't recognize this string13375000
                        but the syntax is discussed for completeness.   13380000
                        of the language commands' syntax.               13385000
                                                                        13390000
                              NOTE                                      13395000
                                                                        13400000
      The formal file designators used in this command                  13405000
      (COBTEXT, COBPROG, COBLIST, COBMAST, COBNEW)                      13410000
      cannot be back referenced as actual file designators              13415000
      in the command parameter list.  For further information,          13420000
      see the discussion of implied :FILE commands in                   13425000
      Section VII of the MPE Commands Reference Manual.                 13430000
                                                                        13435000
\ITEM=OPERATION                                                         13440000
OPERATION                                                               13445000
                                                                        13450000
Compiles and prepares a COBOL program onto a program file on disc. If   13455000
you do not specify <textfile>, MPE expects your input from your current 13460000
input device.  If you create the program file prior to compilation, you 13465000
must use the <filecode> parameter of PROG or 1029 and a <numextents>    13470000
parameter value of 1.  If you do not specify <listfile>, MPE sends the  13475000
listing output to your current list device.  The USL file created during13480000
compilation is a temporary file passed directly to the preparation      13485000
mechanism; you can access it under the name $OLDPASS only if the program13490000
file is not $NEWPASS.                                                   13495000
                                                                        13500000
\ITEM=EXAMPLE                                                           13505000
EXAMPLE                                                                 13510000
                                                                        13515000
To compile and prepare a COBOL program entered through your current     13520000
input device, onto the file $NEWPASS, with the listing printed on the   13525000
current list device, enter:                                             13530000
                                                                        13535000
    :COBOLPREP                                                          13540000
                                                                        13545000
If the next command is one to execute the program, the file $NEWPASS is 13550000
referenced in the execute command under the name $OLDPASS.              13555000
                                                                        13560000
To compile and prepare a COBOL source program input from the textfile   13565000
named SFILE into a program file named MYPROG, with the resulting listing13570000
sent to the current list device, enter:                                 13575000
                                                                        13580000
    :COBOLPREP SFILE,MYPROG                                             13585000
                                                                        13590000
                                                                        13595000
\ENTRY=COBOLII,PARMS,OPERATION,EXAMPLE                                  13600000
    :COBOLII                                                            13605000
                                                                        13610000
Compiles a COBOLII program.                                             13615000
                                                                        13620000
SYNTAX                                                                  13625000
                                                                        13630000
 :COBOLII [textfile][,[uslfile][,[listfile][,[masterfile][,newfile]]]]  13635000
          [;INFO=quotedstring][;WKSP=wkspfilename]                      13640000
                                                                        13645000
\ITEM=PARMS                                                             13650000
PARAMETERS                                                              13655000
                                                                        13660000
textfile              Actual designator of input file from which source 13665000
                      program is read.  Can be any ASCII input file.    13670000
                      Formal designator is COBTEXT. Default is $STDIN.  13675000
                                                                        13680000
uslfile               Actual designator of user subprogram library (USL)13685000
                      file on which object program is written. Can be   13690000
                      any binary output file with filecode of USL (or   13695000
                      1024).  Formal designator is COBUSL.  If entered, 13700000
                      this parameter must indicate a file created in    13705000
                      one of four ways:                                 13710000
                                                                        13715000
                      1.  By saving a USL file (with the :SAVE command) 13720000
                          created by a previous compilation where the   13725000
                          default value was used for the <uslfile>      13730000
                          parameter.                                    13735000
                                                                        13740000
                      2.  By building the USL with the Segmenter command13745000
                          -BUILDUSL.                                    13750000
                                                                        13755000
                      3.  By creating a new USL file with the MPE :BUILD13760000
                          command and a <filecode> parameter of USL or  13765000
                          1024.                                         13770000
                                                                        13775000
                      4.  By specifying a non-existent <uslfile>        13780000
                          parameter, thereby creating a permanent file  13785000
                          of the correct size and type.                 13790000
                                                                        13795000
                      If no <uslfile> parameter is supplied, the USL    13800000
                      file is saved to the temporary file, $OLDPASS.    13805000
                                                                        13810000
listfile              Actual designator of file on which program listing13815000
                      is written.  Can be any ASCII output file.  Formal13820000
                      designator is COBLIST. Default is $STDLIST.       13825000
                                                                        13830000
masterfile            Actual designator of master file which is merged  13835000
                      against <textfile> to produce composite source.   13840000
                      Can be any ASCII input file.  Formal designator is13845000
                       COBMAST. Default is master file is not read,input13850000
                      is read from <textfile>.                          13855000
                                                                        13860000
newfile               Actual designator of merged <textfile> and        13865000
                      <masterfile>.  Can be any ASCII output file.      13870000
                      Formal designator is COBNEW.  Default is no file  13875000
                      is written.                                       13880000
                                                                        13885000
quotedstring        A string of ASCII characters delimited by a matching13890000
                    set of either 's or "s.  If the delimiting character13895000
                    is desired within the string it can be doubled as in13900000
                    most programming languages. This feature is used    13905000
                    for specifying compiler options, which will appear  13910000
                    in front of the source listing.                     13915000
                                                                        13920000
wkspfilename        Actual designator of the file to be used as an      13925000
                    HPTOOLSET workspace. Formal designator is COBWKSP.  13930000
                                                                        13935000
                              NOTE                                      13940000
                                                                        13945000
      The formal file designators used in this command                  13950000
      (COBTEXT, COBUSL, COBLIST, COBMAST, COBNEW, COBWKSP)              13955000
      cannot be back referenced as actual file designators              13960000
      in the command parameter list.  For further information,          13965000
      see the discussion of implied :FILE commands in                   13970000
      Section VII of the MPE Commands Reference Manual.                 13975000
                                                                        13980000
\ITEM=OPERATION                                                         13985000
OPERATION                                                               13990000
                                                                        13995000
Compiles COBOLII program onto a USL file on disc.  If you do not        14000000
specify a source text file, MPE expects input from your standard input  14005000
device.  If you create the USL prior to compilation, you must specify   14010000
a <filecode> of USL or 1024.  If you do not specify a <listfile>,       14015000
MPE sends the program listing to the current list device.               14020000
                                                                        14025000
\ITEM=EXAMPLE                                                           14030000
EXAMPLE                                                                 14035000
                                                                        14040000
To compile a COBOLII program that you enter from your current input     14045000
device into an object program in the USL file $NEWPASS, and write the   14050000
listing to your current list device, enter:                             14055000
                                                                        14060000
    :COBOLII                                                            14065000
                                                                        14070000
If the next command is one to prepare an object program, $NEWPASS can be14075000
passed to that command by specifying $OLDPASS for the <uslfile>         14080000
parameter.                                                              14085000
                                                                        14090000
To compile a COBOLII program residing on the disc file SOURCE into an   14095000
object program on the USL file OBJECT, with the program listing to be   14100000
sent to the disc file LISTFL, enter:                                    14105000
                                                                        14110000
    :BUILD OBJECT;CODE=USL                                              14115000
    :COBOLII SOURCE,OBJECT,LISTFL                                       14120000
                                                                        14125000
                                                                        14130000
\ENTRY=COBOLIIGO,PARMS,OPERATION,EXAMPLE                                14135000
    :COBOLIIGO                                                          14140000
                                                                        14145000
Compiles, prepares, and executes a COBOLII program.                     14150000
                                                                        14155000
SYNTAX                                                                  14160000
                                                                        14165000
    :COBOLIIGO [textfile][,[listfile][,[masterfile][,newfile]           14170000
               [;INFO=quotedstring][;WKSP=wkspfilename]                 14175000
                                                                        14180000
\ITEM=PARMS                                                             14185000
PARAMETERS                                                              14190000
                                                                        14195000
textfile            Actual designator of input file from which source   14200000
                    program is read.  Can be any ASCII input file.      14205000
                    Formal designator is COBTEXT. Default is $STDIN.    14210000
                                                                        14215000
listfile            Actual designator of file on which program listing  14220000
                    is written.  Can be any ASCII output file.  Formal  14225000
                    designator is COBLIST.  Default is $STDLIST.        14230000
                                                                        14235000
masterfile          Actual designator of master file which is merged    14240000
                    against <textfile> to produce composite source.  Can14245000
                    be any ASCII input file.  Formal designator is      14250000
                    COBMAST.  Default is master file is not read, input 14255000
                    is read from <textfile>.                            14260000
                                                                        14265000
newfile             Actual designator of merged <textfile> and          14270000
                    <masterfile>.  Can be any ASCII output file. Formal 14275000
                    designator is COBNEW.  Default is no file is        14280000
                    written.                                            14285000
                                                                        14290000
quotedstring        A string of ASCII characters delimited by a matching14295000
                    set of either 's or "s.  If the delimiting character14300000
                    is desired within the string it can be doubled as in14305000
                    most programming languages. This feature is used    14310000
                    for specifying compiler options, which will appear  14315000
                    in front of the source listing.                     14320000
                                                                        14325000
wkspfilename        Actual designator of the file to be used as an      14330000
                    HPTOOLSET workspace.  Formal designator is          14335000
                    COBWKSP.                                            14340000
                                                                        14345000
                              NOTE                                      14350000
                                                                        14355000
      The formal file designators used in this command                  14360000
      (COBTEXT, COBLIST, COBMAST, COBNEW, COBWKSP)                      14365000
      cannot be back referenced as actual file designators              14370000
      in the command parameter list.  For further information,          14375000
      see the discussion of implied :FILE commands in                   14380000
      Section VII of the MPE Commands Reference Manual.                 14385000
                                                                        14390000
\ITEM=OPERATION                                                         14395000
OPERATION                                                               14400000
                                                                        14405000
Compiles, prepares, and allocates/executes a COBOLII program.  If you do14410000
not specify <textfile>, MPE expects your input from your current input  14415000
device.  If you do not specify <listfile>, MPE writes the listing to    14420000
your current list device.  This command creates a temporary USL file    14425000
($NEWPASS) that cannot be accessed, and a temporary program file that   14430000
can be accessed under the name $OLDPASS.                                14435000
                                                                        14440000
\ITEM=EXAMPLE                                                           14445000
EXAMPLE                                                                 14450000
                                                                        14455000
To compile, prepare, and execute a COBOLII program entered from your    14460000
current input device, with the program listing sent to your current list14465000
device, enter:                                                          14470000
                                                                        14475000
    :COBOLIIGO                                                          14480000
                                                                        14485000
To compile, prepare, and execute a COBOLII program from the disc file   14490000
SOURCE and send the program listing to the disc file LISTFL, enter:     14495000
                                                                        14500000
    :COBOLIIGO SOURCE,LISTFL                                            14505000
                                                                        14510000
                                                                        14515000
\ENTRY=COBOLIIPREP,PARMS,OPERATION,EXAMPLE                              14520000
    :COBOLIIPREP                                                        14525000
                                                                        14530000
Compiles and prepares a COBOLII program.                                14535000
                                                                        14540000
SYNTAX                                                                  14545000
                                                                        14550000
:COBOLIIPREP [textfile][,[progfile][,[listfile]                         14555000
           [,[masterfile][newfile]]]]                                   14560000
           [;INFO=quotedstring][;WKSP=wkspfilename]                     14565000
                                                                        14570000
\ITEM=PARMS                                                             14575000
PARAMETERS                                                              14580000
                                                                        14585000
textfile                Actual designator of input file from which      14590000
                        source program is read.  Can be any ASCII input 14595000
                        file.  Formal designator is COBTEXT. Default is 14600000
                        $STDIN.                                         14605000
                                                                        14610000
progfile                Actual designator of program file on which      14615000
                        prepared program segments are written.  Can be  14620000
                        any binary output file with <filecode> of PROG  14625000
                        or 1029.  If parameter is specified, it must    14630000
                        indicate a file created in one of two ways:     14635000
                                                                        14640000
                        1.  With the MPE :BUILD command, specifying a   14645000
                            <filecode> of PROG or 1029 and a            14650000
                            <numextents> parameter value of 1.          14655000
                                                                        14660000
                        2.  By specifying a non-existent file in the    14665000
                            <progfile> parameter in which case a job    14670000
                            temporary file of the correct size and type 14675000
                            is created.                                 14680000
                                                                        14685000
                        If no <uslfile> parameter is supplied the USL   14690000
                        file is saved to the temporary file $OLDPASS.   14695000
                         Formal designator is COBPROG.                  14700000
                                                                        14705000
listfile                Actual designator of file on which program      14710000
                        listing is written.  Can be any ASCII output    14715000
                        file.  Formal designator is COBLIST. Default is 14720000
                        $STDLIST.                                       14725000
                                                                        14730000
masterfile              Actual designator if master file which is merged14735000
                        against <textfile> to produce composite source. 14740000
                        Can be any ASCII input file.  Formal designator 14745000
                        is COBMAST. Default is master file is not read, 14750000
                        input is read from <textfile>.                  14755000
                                                                        14760000
newfile                 Actual designator of merger <textfile> and      14765000
                        <masterfile>.  Can be any ASCII output file.    14770000
                        Formal designator is COBNEW.  Default is no file14775000
                        is written.                                     14780000
                                                                        14785000
quotedstring            A string of ASCII characters delimited by a     14790000
                        matching set of either 's or "s.  If the        14795000
                        delimiting character is desired within the      14800000
                        string it can be doubled as in most programming 14805000
                        languages.  This feature is used for specifying 14810000
                        compiler options, which will appear in front    14815000
                        of the source listing.                          14820000
                                                                        14825000
wkspfilename            Actual designator of the file to be used as     14830000
                        an HPTOOLSET workspace.  The formal             14835000
                        designator is COBWKSP.                          14840000
                                                                        14845000
                         NOTE                                           14850000
                                                                        14855000
      The formal file designators used in this command                  14860000
      (COBTEXT, COBPROG, COBLIST, COBMAST, COBNEW, COBWKSP)             14865000
      cannot be back referenced as actual file designators              14870000
      in the command parameter list.  For further information,          14875000
      see the discussion of implied :FILE commands in                   14880000
      Section VII of the MPE Commands Reference Manual.                 14885000
                                                                        14890000
\ITEM=OPERATION                                                         14895000
OPERATION                                                               14900000
                                                                        14905000
Compiles and prepares a COBOLII program onto a program file on disc. If 14910000
you do not specify <textfile>, MPE expects your input from your current 14915000
input device.  If you create the program file prior to compilation, you 14920000
must use the <filecode> parameter of PROG or 1029 and a <numextents>    14925000
parameter value of 1.  If you do not specify <listfile>, MPE sends the  14930000
listing output to your current list device.  The USL file created during14935000
compilation is a temporary file passed directly to the preparation      14940000
mechanism; you can access it under the name $OLDPASS only if the program14945000
file is not $NEWPASS.                                                   14950000
                                                                        14955000
\ITEM=EXAMPLE                                                           14960000
EXAMPLE                                                                 14965000
                                                                        14970000
To compile and prepare a COBOLII program entered through your current   14975000
input device, onto the file $NEWPASS, with the listing printed on the   14980000
current list device, enter:                                             14985000
                                                                        14990000
    :COBOLIIPREP                                                        14995000
                                                                        15000000
If the next command is one to execute the program, the file $NEWPASS is 15005000
referenced in the execute command under the name $OLDPASS.              15010000
                                                                        15015000
To compile and prepare a COBOLII source program input from the textfile 15020000
named SFILE into a program file named MYPROG, with the resulting listing15025000
sent to the current list device, enter:                                 15030000
                                                                        15035000
    :COBOLIIPREP SFILE,MYPROG                                           15040000
                                                                        15045000
                                                                        15050000
\ENTRY=COMMENT,PARMS,OPERATION,EXAMPLE                                  15055000
    :COMMENT                                                            15060000
                                                                        15065000
Inserts comment into command stream.                                    15070000
                                                                        15075000
SYNTAX                                                                  15080000
                                                                        15085000
    :COMMENT [text]                                                     15090000
                                                                        15095000
\ITEM=PARMS                                                             15100000
PARAMETERS                                                              15105000
                                                                        15110000
text            Information comprising comment text.  If last non-blank 15115000
                character is ampersand (&), comment text is continued   15120000
                onto next line.  Default is null comment.  (A record    15125000
                containing only :COMMENT is inserted in command stream.)15130000
                                                                        15135000
\ITEM=OPERATION                                                         15140000
OPERATION                                                               15145000
                                                                        15150000
Inserts a record containing the characters :COMMENT, optionally followed15155000
by text, into command stream.  Used primarily in batch jobs.            15160000
                                                                        15165000
\ITEM=EXAMPLE                                                           15170000
EXAMPLE                                                                 15175000
                                                                        15180000
    :JOB MAC.PUBS                                                       15185000
     PRIORITY = DS; INPRI= 8; TIME = 2500 SECONDS                       15190000
     JOB NUMBER = #J3                                                   15195000
     FRI, APR  6, 1979,   1:03 PM                                       15200000
     HP3000 / MPE IV C.00.00                                            15205000
    :COMMENT  THIS IS A SAMPLE JOB                                      15210000
                                                                        15215000
                                                                        15220000
\ENTRY=CONSOLE,PARMS,OPERATION,EXAMPLE                                  15225000
     :CONSOLE                                                           15230000
                                                                        15235000
Changes the system console from its current device to another           15240000
job-accepting (non-DS) terminal.                                        15245000
                                                                        15250000
SYNTAX                                                                  15255000
                                                                        15260000
     :CONSOLE [ldn]                                                     15265000
                                                                        15270000
\ITEM=PARMS                                                             15275000
PARAMETERS                                                              15280000
                                                                        15285000
ldn          The logical device number of the new console operator      15290000
                                                                        15295000
\ITEM=OPERATION                                                         15300000
OPERATION                                                               15305000
                                                                        15310000
Once the :CONSOLE command is executed, a message is printed on          15315000
the old console device telling the old console operator where           15320000
the system console went.  The old console is now just another           15325000
session device and all the console capabilities are transferred         15330000
to the other terminal.                                                  15335000
                                                                        15340000
                                                                        15345000
The :CONSOLE command, when used without parameters, will                15350000
report to any user the current device number of the system              15355000
console.                                                                15360000
                                                                        15365000
Users with SM (system manager) capability may use the                   15370000
:CONSOLE command even if they have not been allowed the                 15375000
command.                                                                15380000
                                                                        15385000
                        NOTE                                            15390000
                                                                        15395000
        Before you, the Console Operator, transfer                      15400000
        the system console to another terminal, you                     15405000
        should give yourself the capability to take                     15410000
        the console back at any time by :ALLOWING your-                 15415000
        self the use of the :CONSOLE command.                           15420000
                                                                        15425000
The system console is a session device.  The console must be            15430000
logged on to use the console operator commands; however, if             15435000
the device is logged off, the console messages are still                15440000
printed.                                                                15445000
                                                                        15450000
                                                                        15455000
\ITEM=EXAMPLE                                                           15460000
EXAMPLES                                                                15465000
                                                                        15470000
To change logical device 81 (a terminal) to a system console, enter:    15475000
                                                                        15480000
     :CONSOLE 81                                                        15485000
                                                                        15490000
To determine the location of the console, enter:                        15495000
                                                                        15500000
     :CONSOLE                                                           15505000
     CONSOLE IS CURRENTLY ASSIGNED TO LDEV 20.                          15510000
                                                                        15515000
\ENTRY=CONTINUE,PARMS,OPERATION,EXAMPLE                                 15520000
    :CONTINUE                                                           15525000
                                                                        15530000
Overrides job/session error.                                            15535000
                                                                        15540000
SYNTAX                                                                  15545000
                                                                        15550000
    :CONTINUE                                                           15555000
                                                                        15560000
\ITEM=PARMS                                                             15565000
PARAMETERS                                                              15570000
                                                                        15575000
None                                                                    15580000
                                                                        15585000
\ITEM=OPERATION                                                         15590000
OPERATION                                                               15595000
                                                                        15600000
The :CONTINUE command permits a job or session to continue even         15605000
though the next command results in an error (with accompanying          15610000
error message).  Typically used when anticipating errors that you       15615000
wish to override.  Applies only to command immediately following        15620000
:CONTINUE.                                                              15625000
                                                                        15630000
                                                                        15635000
\ITEM=EXAMPLE                                                           15640000
EXAMPLE                                                                 15645000
                                                                        15650000
If you anticipate a possible error resulting from the command           15655000
                                                                        15660000
    :RUN MYPROG                                                         15665000
                                                                        15670000
and wish to override this error and allow a job to continue, enter:     15675000
                                                                        15680000
    :JOB MAC.PUBS                                                       15685000
    :CONTINUE                                                           15690000
    :RUN MYPROG                                                         15695000
    :RUN MYPROG2                                                        15700000
    :EOJ                                                                15705000
                                                                        15710000
                                                                        15715000
\ENTRY=DATA,PARMS,OPERATION,EXAMPLE                                     15720000
    :DATA                                                               15725000
                                                                        15730000
Enters data into system from devicefile.  (Cannot be used to enter data 15735000
from $STDIN.)                                                           15740000
                                                                        15745000
SYNTAX                                                                  15750000
                                                                        15755000
    :DATA [jsname,]username[/userpass].acctname[/acctpass][;filename]   15760000
                                                                        15765000
\ITEM=PARMS                                                             15770000
PARAMETER                                                               15775000
                                                                        15780000
jsname              Name of job or session that is to read data. Default15785000
                    is no job/session name.                             15790000
                                                                        15795000
username            Your user name that allows you to access MPE under  15800000
                    this account, as established by Account Manager.    15805000
                    (REQUIRED PARAMETER)                                15810000
                                                                        15815000
userpass            Your user password, optionally assigned by Account  15820000
                    Manager.                                            15825000
                                                                        15830000
acctname            Name of account under which job/session is running, 15835000
                    as established by System Manager. (REQUIRED         15840000
                    PARAMETER)                                          15845000
                                                                        15850000
acctpass            Account password, optionally assigned by System     15855000
                    Manager.                                            15860000
                                                                        15865000
filename            Additional qualifying name for the data that can be 15870000
                    used by job or session to access the data.  May be  15875000
                    used, for instance, to distinguish two separate data15880000
                    decks from different card readers read by the same  15885000
                    program.  Default is no distinguishing name is      15890000
                    assigned.                                           15895000
                                                                        15900000
Note that the <jsname>, <username>, <userpass>, <acctname>, <acctpass>, 15905000
and <filename> parameters all are names that can contain up to 8 alpha- 15910000
numeric characters, beginning with a letter.                            15915000
                                                                        15920000
\ITEM=OPERATION                                                         15925000
OPERATION                                                               15930000
                                                                        15935000
Identifies input consisting entirely of data to be read from devicefile 15940000
other than standard input file.  The input device must be one that is   15945000
configured by the System Supervisor or Console Operator to automatically15950000
accept :DATA command.  This command often is used to access data from a 15955000
batch input device while in session mode -- for instance, to read a deck15960000
from a card reader while running an interactive session.  A :DATA       15965000
command is required for card decks not embedded in standard input stream15970000
($STDIN) and which are submitted from devices configured to accept      15975000
:DATA; and may not be used for data submitted from a device not         15980000
configured to accept the :DATA command, nor for data embedded within the15985000
input stream, or for data on disc files.                                15990000
                                                                        15995000
To designate data for your job or session, enter the :DATA command,     16000000
followed by the data, followed by the :EOD command.  The data can only  16005000
be read by a job/session that has the same identity ([jsname,]          16010000
username.acctname).                                                     16015000
                                                                        16020000
If the <filename> parameter is omitted, data can be read by any access  16025000
from a job/session with the same identity.                              16030000
                                                                        16035000
When the data file is placed on the input device and the device is      16040000
readied, MPE reads the entire file (if input from a spooled device), or 16045000
the :DATA command only (if input from a non-spooled device).  From this 16050000
point on, your job can access the data, which remains available until it16055000
is actually read.                                                       16060000
                                                                        16065000
The :DATA command implicitly initiates communication with MPE, and thus 16070000
is the only command not entered within a formally-initiated job or      16075000
session.  Files identified by :DATA may be input on cards, magnetic     16080000
tape, paper tape, or from a terminal (but not from disc). When entered  16085000
from magnetic tape, such a file must reside on a single tape volume.    16090000
                                                                        16095000
\ITEM=EXAMPLE                                                           16100000
EXAMPLE                                                                 16105000
                                                                        16110000
To designate a data file on cards for a session identified as           16115000
SESS1,BLACK.ACCTSP, enter:                                              16120000
                                                                        16125000
    :DATA SESS1,BLACK.ACCTSP                                            16130000
          .                                                             16135000
          .                                                             16140000
        data                                                            16145000
          .                                                             16150000
          .                                                             16155000
    :EOD                                                                16160000
                                                                        16165000
                                                                        16170000
\ENTRY=DEALLOCATE,PARMS,OPERATION,EXAMPLE                               16175000
    :DEALLOCATE (System Supervisor capability required)                 16180000
                                                                        16185000
Removes from virtual memory a program file or procedure segment that has16190000
been permanently allocated with an :ALLOCATE command.                   16195000
                                                                        16200000
SYNTAX                                                                  16205000
                                                                        16210000
                 PROGRAM                                                16215000
    :DEALLOCATE [         ],name                                        16220000
                 PROCEDURE                                              16225000
                                                                        16230000
\ITEM=PARMS                                                             16235000
PARAMETERS                                                              16240000
                                                                        16245000
PROGRAM     The program file indicated by <name> is deallocated.        16250000
            Default.                                                    16255000
                                                                        16260000
PROCEDURE   The code segment containing the procedure specified by      16265000
            <name> in SL.PUB.SYS is deallocated.  Default is PROGRAM.   16270000
                                                                        16275000
\ITEM=OPERATION                                                         16280000
OPERATION                                                               16285000
                                                                        16290000
(System Supervisor capability required)                                 16295000
This command removes from virtual memory a program file or procedure    16300000
segment that has been permanently allocated with an :ALLOCATE command.  16305000
                                                                        16310000
The program file or procedure segment is deallocated immediately if it  16315000
is not being used by a process; otherwise, it is deallocated as soon as 16320000
it is no longer in use.                                                 16325000
                                                                        16330000
\ITEM=EXAMPLE                                                           16335000
EXAMPLE                                                                 16340000
                                                                        16345000
To deallocate a program file named PROGX, enter:                        16350000
                                                                        16355000
    DEALLOCATE ,PROGX                                                   16360000
                                                                        16365000
                                                                        16370000
\ENTRY=DEBUG,PARMS,OPERATION                                            16375000
    :DEBUG (Privileged Mode capability required)                        16380000
                                                                        16385000
Invokes the MPE Debug facility.                                         16390000
                                                                        16395000
SYNTAX                                                                  16400000
                                                                        16405000
    :DEBUG                                                              16410000
                                                                        16415000
\ITEM=PARMS                                                             16420000
PARAMETERS                                                              16425000
                                                                        16430000
None                                                                    16435000
                                                                        16440000
\ITEM=OPERATION                                                         16445000
OPERATION                                                               16450000
                                                                        16455000
(Privileged Mode capability required)                                   16460000
The :DEBUG command is an extension of the MPE Debug facility and is used16465000
primarily by systems programmers; its use is explained in the MPE       16470000
Debug/Stack Dump Reference Manual.                                      16475000
                                                                        16480000
                          IMPORTANT NOTE                                16485000
                                                                        16490000
      The normal checks and limitations that apply to the               16495000
      standard users in MPE are bypassed in privileged mode.            16500000
      It is possible for a privileged mode user to destroy              16505000
      the integrity, including the MPE operating system                 16510000
      software itself.  Hewlett-Packard will investigate and            16515000
      attempt to resolve problems resulting from the use of             16520000
      privileged mode code.  This service, which is not                 16525000
      provided under the standard Service Contract, is                  16530000
      available on a time and materials billing basis.                  16535000
      However, Hewlett-Packard will not support, correct,               16540000
      or attend to any modification of the MPE operating                16545000
      system software.                                                  16550000
                                                                        16555000
                                                                        16560000
\ENTRY=DELETESPOOLFILE,PARMS,OPERATION,EXAMPLE                          16565000
     :DELETESPOOLFILE                                                   16570000
                                                                        16575000
Deletes a spooled file.                                                 16580000
                                                                        16585000
SYNTAX                                                                  16590000
                                                                        16595000
                      {#Onnn}                                           16600000
     :DELETESPOOLFILE {#Innn}                                           16605000
                      {ldn  }                                           16610000
                                                                        16615000
\ITEM=PARMS                                                             16620000
PARAMETERS                                                              16625000
                                                                        16630000
#Onnn          The output devicefile identification.                    16635000
                                                                        16640000
#Innn          The input devicefile identification                      16645000
                                                                        16650000
ldn            The logical device number of the device of an active     16655000
               spoolfile.                                               16660000
                                                                        16665000
                                                                        16670000
\ITEM=OPERATION                                                         16675000
OPERATION                                                               16680000
                                                                        16685000
None.                                                                   16690000
                                                                        16695000
\ITEM=EXAMPLE                                                           16700000
EXAMPLES                                                                16705000
                                                                        16710000
To delete an output spooled file from being output to logical device    16715000
6 (a line printer), first stop the device, then enter:                  16720000
                                                                        16725000
     11:21/7/LDEV#6 NOT READY (message generated by the system          16730000
     :DELETESPOOLFILE 6        when device is taken offline)            16735000
                                                                        16740000
\ENTRY=DISALLOW,PARMS,OPERATION,EXAMPLE                                 16745000
     :DISALLOW                                                          16750000
                                                                        16755000
Prohibits a user access to a specific operator command.                 16760000
                                                                        16765000
SYNTAX                                                                  16770000
                                                                        16775000
                FILE=formaldesignator [;SHOW]                           16780000
                 @.@                                                    16785000
                 user.@                                                 16790000
     :DISALLOW {{@.acct   } ;COMMANDS=command1[,command2,...commandn]}  16795000
                 user.acct                                              16800000
                                                                        16805000
\ITEM=PARMS                                                             16810000
PARAMETERS                                                              16815000
                                                                        16820000
formaldesignator     A formal ASCII file name.                          16825000
                                                                        16830000
SHOW                 Lists input lines on $STDLIST.                     16835000
                                                                        16840000
@.@                  Prohibits access to all users whether logged       16845000
                     on or not.                                         16850000
                                                                        16855000
user.@               Prohibits access to a specific user in all         16860000
                     accounts.                                          16865000
                                                                        16870000
@.acct               Prohibits access to all users in a specific        16875000
                     account.                                           16880000
                                                                        16885000
user.acct            Prohibits access to a specific user in a           16890000
                     specific account.                                  16895000
                                                                        16900000
                                                                        16905000
\ITEM=OPERATION                                                         16910000
OPERATION                                                               16915000
                                                                        16920000
Through the :DISALLOW command, the console operator has the ability     16925000
to withhold console capabilities among system users by directly         16930000
entering:                                                               16935000
                                                                        16940000
                @.@                                                     16945000
     :DISALLOW {user.@   } ;COMMANDS=command1[,command2,...commandn]    16950000
                @.acct                                                  16955000
                user.acct                                               16960000
                                                                        16965000
This command can also be used in indirect and subsystem mode.  In       16970000
the indirect mode, a user predefined EDITOR file is deactivated         16975000
that contains:                                                          16980000
                                                                        16985000
                @.@                                                     16990000
     :DISALLOW {user.@   } ;COMMANDS=command1[,command2,...commandn]    16995000
                @.acct                                                  17000000
                user.acct                                               17005000
                                                                        17010000
The :DISALLOW command is then executed by entering at the system        17015000
console:                                                                17020000
                                                                        17025000
     :DISALLOW FILE=formaldesignator [;SHOW]                            17030000
                                                                        17035000
which deactivates the EDITOR file.  In subsystem mode, just type        17040000
DISALLOW, followed by a carriage return.  The subsystem prompts you     17045000
with a ">" sign, accepting command parameters until an EOF is           17050000
received or EXIT is entered.                                            17055000
                                                                        17060000
\ITEM=EXAMPLE                                                           17065000
EXAMPLES                                                                17070000
To prohibit the user BARB.LEWIS the ability to execute the REPLY        17075000
and ABORTIO commands, enter on the system console:                      17080000
                                                                        17085000
     :DISALLOW BARB.LEWIS;COMMANDS=REPLY,ABORTIO                        17090000
                                                                        17095000
To prohibit the user PAUL.USER the ability to execute the BREAKJOB      17100000
command in subsystem mode, enter on the system console:                 17105000
                                                                        17110000
     :DISALLOW                                                          17115000
     >PAUL.USER;COMMANDS=BREAKJOB                                       17120000
     >EXIT                                                              17125000
                                                                        17130000
\ENTRY=DISASSOCIATE,PARMS,OPERATION,EXAMPLE                             17135000
     :DISASSOCIATE                                                      17140000
                                                                        17145000
Removes a device from the control of a user.                            17150000
                                                                        17155000
SYNTAX                                                                  17160000
                                                                        17165000
     :DISASSOCIATE devclass                                             17170000
                                                                        17175000
\ITEM=PARMS                                                             17180000
PARAMETERS                                                              17185000
                                                                        17190000
devclass          The device class specified during SYSDUMP.            17195000
                                                                        17200000
\ITEM=OPERATION                                                         17205000
OPERATION                                                               17210000
                                                                        17215000
When a user DISASSOCIATEs a device, the operator is notified.           17220000
                                                                        17225000
\ITEM=EXAMPLE                                                           17230000
EXAMPLES                                                                17235000
                                                                        17240000
To return control of devclass TAPE to the console operator, enter:      17245000
                                                                        17250000
     :DISASSOCIATE TAPE                                                 17255000
                                                                        17260000
\ENTRY=DISCRPS,PARMS,OPERATION,EXAMPLE                                  17265000
  DISCRPS                                                               17270000
                                                                        17275000
    Enable/Disable the Rotational Position Sensing.                     17280000
                                                                        17285000
  SYNTAX                                                                17290000
                                                                        17295000
    :DISCRPS ldn,[ ENABLE/DISABLE ]                                     17300000
                                                                        17305000
\ITEM=PARMS                                                             17310000
  PARAMETERS                                                            17315000
                                                                        17320000
    ldn : logical device that RPS is requested                          17325000
                                                                        17330000
                                                                        17335000
    ENABLE : enables RPS of the device ldn with the default             17340000
             value specified by the driver.                             17345000
                                                                        17350000
    DISABLE : disables RPS of the device ldn.                           17355000
                                                                        17360000
                                                                        17365000
\ITEM=OPERATION                                                         17370000
  OPERATION                                                             17375000
                                                                        17380000
    Alters the status of Rotationl Position Sensing of the              17385000
    Command Set 80 discs. They are currently HP7933/35 and              17390000
    HP7911/12/14.                                                       17395000
                                                                        17400000
                                                                        17405000
\ITEM=EXAMPLE                                                           17410000
  EXAMPLE                                                               17415000
                                                                        17420000
    To disable RPS of logical device 3.                                 17425000
                                                                        17430000
    :DISCRPS 3,DISABLE                                                  17435000
                                                                        17440000
                                                                        17445000
\ENTRY=DISMOUNT,PARMS,OPERATION,EXAMPLE                                 17450000
    :DISMOUNT                                                           17455000
                                                                        17460000
Causes a volume set that was previously explicitly mounted by the user  17465000
to be dismounted.                                                       17470000
                                                                        17475000
SYNTAX                                                                  17480000
                                                                        17485000
                  *                                                     17490000
    :DISMOUNT {         }[.groupname[.acctname]]]                       17495000
                vcsname                                                 17500000
                                                                        17505000
\ITEM=PARMS                                                             17510000
PARAMETERS                                                              17515000
                                                                        17520000
*                   Specifies the home volume set for the group and     17525000
                    account specified, or the logon group and account   17530000
                    if <groupname.acctname> are not specified.  Default.17535000
                                                                        17540000
vcsname             Volume set/class name, specifying a previously-     17545000
                    defined volume class name or volume set name.       17550000
                    Default is *.                                       17555000
                                                                        17560000
groupname.acctname  Specify the group and account which created the     17565000
                    volume set.  Default is logon group and account.    17570000
                                                                        17575000
\ITEM=OPERATION                                                         17580000
OPERATION                                                               17585000
                                                                        17590000
The :DISMOUNT command allows you to have dismounted                     17595000
a volume set that you previously explicitly mounted via a               17600000
:MOUNT command.  If there are no other users of the volume set, the     17605000
devices on which it resides are made available to the system.  You      17610000
can only request a dismount for a volume set which you have caused to be17615000
mounted; you cannot affect the status of the volume set with respect to 17620000
other users.                                                            17625000
                                                                        17630000
\ITEM=EXAMPLE                                                           17635000
EXAMPLE                                                                 17640000
                                                                        17645000
To dismount the volume set MYSET, previously mounted by you via a :MOUNT17650000
command, enter:                                                         17655000
                                                                        17660000
    :DISMOUNT MYSET                                                     17665000
                                                                        17670000
                                                                        17675000
\ENTRY=DOWN,PARMS,OPERATION,EXAMPLE                                     17680000
    :DOWN                                                               17685000
                                                                        17690000
Removes a device from normal system use.                                17695000
                                                                        17700000
SYNTAX                                                                  17705000
                                                                        17710000
     :DOWN ldn                                                          17715000
                                                                        17720000
\ITEM=PARMS                                                             17725000
PARAMETERS                                                              17730000
                                                                        17735000
ldn          The logical device number of the device being taken        17740000
             off-line.                                                  17745000
                                                                        17750000
\ITEM=OPERATION                                                         17755000
OPERATION                                                               17760000
                                                                        17765000
If the device is in use, the :DOWN request will be satisfied when       17770000
the last access is complete.                                            17775000
                                                                        17780000
For non-system domain disc drives, if a master volume is mounted        17785000
on a DOWNed device, MPE rejects all further requests to use ANY         17790000
volume of the set to which the master volume belongs.                   17795000
                                                                        17800000
When any device is powered-down and the :DOWN command is not used,      17805000
access to that device can result in indefinite waiting, erroneous       17810000
transfers, or other incorrect operation.  Often these failures will     17815000
occur with no indication to you or the user.  For this reason, it       17820000
is very important that every device which is not fully operational      17825000
(especially powered-down) to be :DOWNed.  A device that will be         17830000
inoperable for more than a few hours can be temporarily removed         17835000
from the I/O configuration at system start-up time.                     17840000
                                                                        17845000
\ITEM=EXAMPLE                                                           17850000
EXAMPLES                                                                17855000
                                                                        17860000
To take logical device number 20 off-line, enter:                       17865000
                                                                        17870000
     :DOWN 20                                                           17875000
                                                                        17880000
To take logical device number 10 off-line (an input-spooled job-        17885000
accepting magnetic tape), enter:                                        17890000
                                                                        17895000
     :DOWN 10                                                           17900000
     :STOPSPOOL 10                                                      17905000
     11:16/31/SP#10/STOPPED                                             17910000
     11:16/31/LDEV#10 NOT READY                                         17915000
                                                                        17920000
\ENTRY=DOWNLOAD,PARMS,OPERATION,EXAMPLE                                 17925000
     :DOWNLOAD                                                          17930000
                                                                        17935000
Downloads/Resets the output device.                                     17940000
                                                                        17945000
SYNTAX                                                                  17950000
                                                                        17955000
                   [,filename ]                                         17960000
     :DOWNLOAD ldn [          ]                                         17965000
                   [,MARGIN=nn]                                         17970000
                                                                        17975000
\ITEM=PARMS                                                             17980000
PARAMETERS                                                              17985000
                                                                        17990000
ldn          The logical device number of the output device.  This      17995000
             device must be a 2608 or a 2631 line printer.              18000000
                                                                        18005000
filename     The fully qualified name of a file containing the down-    18010000
             load control information and data.                         18015000
                                                                        18020000
nn           The print position that the first byte of data will        18025000
             assume.  This number can be between 1 and 16 inclusive.    18030000
                                                                        18035000
\ITEM=OPERATION                                                         18040000
OPERATION                                                               18045000
                                                                        18050000
This command is primarily for control of an HP 2608 and an HP 2631      18055000
line printer.  The user will in a forms message indicate what forms     18060000
and VFC (Vertical Format Control) must be used for printing the job.    18065000
On all other printers, the VFC is controlled by a loop or tape in-      18070000
serted in the printer.  The HP 2608 has electronic VFC only.            18075000
                                                                        18080000
The VFC image file can define the margin setting as well as the VFC     18085000
image.  The number of print lines per form is limited to 127.           18090000
For information on VFC files, enter the command:  HELP VFC.             18095000
                                                                        18100000
\ITEM=EXAMPLE                                                           18105000
EXAMPLES                                                                18110000
                                                                        18115000
To respond to a forms message, enter:                                   18120000
                                                                        18125000
     IO/15:46/22/FORMS: PLEASE MOUNT PAYCHECK FORMS USE VFC=VFCPAY      18130000
     IO/1 55:46/22SP#12/LDFV# FOR #S93:OUTFILE ON 2608 (1)              18135000
                                                                        18140000
          :DOWNLOAD 11,VFCPAY                                           18145000
                                                                        18150000
To reset the VFC to its original state, enter:                          18155000
                                                                        18160000
     :DOWNLOAD 11,VFC6.PUB.SYS                                          18165000
                                                                        18170000
To set the left margin print position to column 4, enter:               18175000
                                                                        18180000
      :DOWNLOAD 11,MARGIN=4                                             18185000
                                                                        18190000
\ENTRY=DSCONTROL,PARMS,OPERATION,EXAMPLE                                18195000
     :DSCONTROL                                                         18200000
                                                                        18205000
Enables or disables the DS subsystem on the communication link.         18210000
Replaces former  =DSLINE console command.  Uses keywords to combine     18215000
functions.  Console may be moved.                                       18220000
                                                                        18225000
SYNTAX                                                                  18230000
                                                                        18235000
    :DSCONTROL dsdevice;function [;function [;... function]]            18240000
                                                                        18245000
where the command syntax has the following meaning:                     18250000
                                                                        18255000
function       ::=  OPEN [,open option [,...open option]]               18260000
                    SHUT                                                18265000
                                                                        18270000
                    TRACE,ON [trace options]                            18275000
                    TRACE,OFF                                           18280000
                                                                        18285000
                    COMP                                                18290000
                    NOCOMP                                              18295000
                                                                        18300000
                    MON [,mon option]                                   18305000
                    MOFF                                                18310000
                                                                        18315000
                    RETRY=[retry option]                                18320000
                                                                        18325000
open option    ::=  MASTER                                              18330000
                    SLAVE                                               18335000
                    SPEED=linespeed                                     18340000
                                                                        18345000
trace options  ::=  [,[ALL][,[mask][,[numentries][,[WRAP]               18350000
                             [,filename]]]]]                            18355000
                                                                        18360000
mon option     ::=  DS                                                  18365000
                    CS                                                  18370000
                                                                        18375000
retry option   ::=  DEFAULT                                             18380000
                    retry count                                         18385000
                                                                        18390000
\ITEM=PARMS                                                             18395000
                                                                        18400000
PARAMETERS                                                              18405000
                                                                        18410000
dsdevice            The logical device number or the device class       18415000
                    name of the DS/3000 communications device. On       18420000
                    your system's I/O configuration listing, the        18425000
                    device is back referenced by a pound sign (#)       18430000
                    to a previously defind HSI,INP, or SSLC.            18435000
                    (Required parameter.)                               18440000
                                                                        18445000
OPEN                Establishes a communication link with another       18450000
                    HP 3000.  Makes the line available for remote       18455000
                    communication via the DS/3000 Subsystem.            18460000
                    (Required parameter.)                               18465000
                                                                        18470000
SHUT                Initiates an orderly line shutdown.  Refer to       18475000
                    OPERATION for details about the line closing        18480000
                    procedure.                                          18485000
                                                                        18490000
MASTER              Limits DS/3000 line activity to outgoing            18495000
                    requests only.  No incoming slave sessions          18500000
                    are allowed.                                        18505000
                                                                        18510000
SLAVE               Limits DS/3000 line activity to incoming            18515000
                    slave requests only, no outgoing master             18520000
                    activity is allowed.                                18525000
                                                                        18530000
                                    NOTE                                18535000
                                                                        18540000
                         OPEN,MASTER = SHUT,SLAVE                       18545000
                         OPEN,SLAVE  = SHUT,MASTER                      18550000
                         SHUT,MASTER = OPEN,SLAVE                       18555000
                         SHUT,SLAVE  = OPEN,MASTER                      18560000
                                                                        18565000
                    Default:  Both MASTER and SLAVE processing          18570000
                              are allowed.                              18575000
                                                                        18580000
linespeed           Transmission rate in characters per second.         18585000
                    This parameter is effective only if your sys-       18590000
                    tem generation for the line controller (HSI,        18595000
                    INP, or SSLC) selected SPEED CHANGEABLE.            18600000
                    Specify linespeed if yours is a European            18605000
                    installation with modems running at half            18610000
                    speed; or if the length of cables used for          18615000
                    data communications at your site have been          18620000
                    changed since the system was configured.            18625000
                    Default: System configuration values.               18630000
                                                                        18635000
                    HSI speed:          250,000 (cable lengths          18640000
                                        less than 1000 ft.)             18645000
                                        125,000 (cable lengths          18650000
                                        greater than 1000 ft.)          18655000
                    INP or SSLC speed:  250,300,600, or 1200            18660000
                                                                        18665000
TRACE,ON            Activates the TRACE facility to provide a           18670000
                    record of communications activities.  Trace         18675000
                    parameters are positional.  The line must           18680000
                    already be open, or the OPEN keyword must           18685000
                    also be included (to open the line).                18690000
                                                                        18695000
ALL                 Generates trace records for all line                18700000
                    activity. Default: Records are written only         18705000
                    for transmission errors.                            18710000
                                                                        18715000
mask                An octal number preceded by a percent sign          18720000
                    (%nn). Used to select type of trace entries         18725000
                    generated. Refer to DS/3000 Reference Manual        18730000
                    for an explanation of the mask bits.                18735000
                    Default: %37 (all except STN).                      18740000
                                                                        18745000
numentries          Decimal integer for the maximum number of           18750000
                    entries in a trace record, not greater than         18755000
                    255.  INP maximum is 24.  Default: 24.              18760000
                    (See OPERATION)                                     18765000
                                                                        18770000
WRAP                Trace entries that overflow the trace record        18775000
                    overlay the prior trace record entries.             18780000
                    Default: Overflow entries are discarded.            18785000
                                                                        18790000
filename            A name for the trace file.                          18795000
                    Default: DSTRCxxx.PUB.SYS (where xxx is the         18800000
                             ldn of the dsdevice).                      18805000
                                                                        18810000
TRACE,OFF           Deactivates the TRACE facility so that no           18815000
                    records are kept of DS/3000 actions, states,        18820000
                    and events.  Also closes the trace file.            18825000
                                                                        18830000
COMP                Activates the data compression facility for         18835000
                    all line users.  The line need not be open to       18840000
                    use COMP.                                           18845000
                                                                        18850000
NOCOMP              Deactivates the data compression facility for       18855000
                    all line users.  Line need not be open to           18860000
                    use NOCOMP.                                         18865000
                                                                        18870000
MON                 Activates internal monitoring of DS/3000            18875000
                    activity to give additional information on a        18880000
                    subsequent cold dump of the system.  The line       18885000
                    must be open for the use of MON.                    18890000
                    Only use for system troubleshooting.                18895000
                                                                        18900000
MOFF                Deactivates internal DS/3000 monitor records.       18905000
                    Line must be open for the use of MOFF.              18910000
                                                                        18915000
RETRY               Changes communications error retry count to         18920000
                    specified value.  Specifying "DEFAULT" causes       18925000
                    a retry count of 15.  The retry count must be       18930000
                    between 0 and 255 inclusive.                        18935000
                                                                        18940000
\ITEM=OPERATION                                                         18945000
                                                                        18950000
OPERATION                                                               18955000
                                                                        18960000
                                                                        18965000
Unless :DSCONTROL is issued from the master console, this command       18970000
requires the user to have CS capability.  In addition, all users        18975000
except the console operator are granted access to :DSCONTROL only       18980000
if they are ALLOWed to use the command or are ASSOCIATEd with the       18985000
specified DS device.                                                    18990000
                                                                        18995000
Only one DS/3000 communications device can be active (OPEN) on a        19000000
controller at any given time.  Once opened (with the :DSCONTROL         19005000
command), a communications link can be shared by multiple DS/3000       19010000
users.  It cannot, however, be shared by users of other communi-        19015000
cations subsystems supported by your system (for example,               19020000
MRJE/3000).  Thus you must SHUT a DSLINE before it can be opened        19025000
for use by another subsystem.                                           19030000
                                                                        19035000
Before issuing a :DSCONTROL command, use the :SHOWDEV command to        19040000
check whether a communications link is already established. The         19045000
ldn for the SSLC, INP, or HSI port will be UNAVAIL if the com-          19050000
munication link is in use by any subsystem; the ldn for a DS            19055000
communication pseudo device (driver IODS0) will be AVAIL if it is       19060000
currently in use by DS/3000.                                            19065000
                                                                        19070000
If a DS device class includes more than one DS device, the func-        19075000
tions specified in the :DSCONTROL command apply to all devices in       19080000
that class.  If you have not been ALLOWed to use this command,          19085000
you can only control those devices in the device class with which       19090000
you have been ASSOCIATEd (if any).                                      19095000
                                                                        19100000
If you include more than one function in a :DSCONTROL command,          19105000
each function (with its subparameter list) must be separated by a       19110000
semicolon.  A function that duplicates or conflicts with a pre-         19115000
vious function overrides that function.  Functions can appear in        19120000
any order but are executed in the following order:                      19125000
                                                                        19130000
1.  OPEN/SHUT                                                           19135000
                                                                        19140000
2.  TRACE                                                               19145000
                                                                        19150000
3.  MON/MOFF                                                            19155000
                                                                        19160000
4.  COMP/NOCOMP                                                         19165000
                                                                        19170000
5.  RETRY                                                               19175000
                                                                        19180000
                                                                        19185000
The SPEED= keyword in the open option may be omitted from a             19190000
:DSCONTROL command.  For example, the following two commands have       19195000
exactly the same effect:                                                19200000
                                                                        19205000
     :DSCONTROL 60;OPEN,MASTER,SPEED=25000                              19210000
                                                                        19215000
     :DSCONTROL 60;OPEN,MASTER,25000                                    19220000
                                                                        19225000
                                                                        19230000
When you turn on the trace facility, the trace file is                  19235000
DSTRCxxx.PUB.SYS (where xxx is the logical device number of             19240000
the dsdevice), unless you specify otherwise in the "filename"           19245000
option of the trace options.  If the trace file already exists,         19250000
and the record size is not compatible with the requested record         19255000
size (based on the requested numentries), the old file is               19260000
purged before a new, permanent file (with the old file's                19265000
file limit and maximum number of extents) is created.  If you           19270000
do not include the numentries parameter, the file will be               19275000
created to hold 24 entries per record.  To change numentries,           19280000
simply turn trace off and then turn it on again with the new            19285000
number of entries.                                                      19290000
                                                                        19295000
The SHUT parameter initiates an orderly line closing procedure.         19300000
If no sessions or applications are using the line when you shut         19305000
it, line disconnection occurs immediately.  If any user                 19310000
(including applications) has the line open, the line remains            19315000
connected until all sessions and applications CLOSE the line, or        19320000
until those accessing the line terminate or are aborted.  Once          19325000
closed by the console operator, no new users may access the line        19330000
until the operator reopens it.                                          19335000
                                                                        19340000
Specifying a high retry count in the RETRY parameter increases          19345000
the chance of obtaining a connection with a user :DSLINE command        19350000
when attempting to connect over bad phone lines.                        19355000
                                                                        19360000
\ITEM=EXAMPLE                                                           19365000
                                                                        19370000
EXAMPLES                                                                19375000
                                                                        19380000
                                                                        19385000
To open DS line number 55, thereby making it available for use by       19390000
the DS/3000 Subsystem, enter:                                           19395000
                                                                        19400000
     :DSCONTROL 55;OPEN                                                 19405000
                                                                        19410000
                                                                        19415000
To permit the local HP 3000 to process only master (outgoing)           19420000
requests on DS line number 55, enter:                                   19425000
                                                                        19430000
     :DSCONTROL 55;OPEN,MASTER                                          19435000
                                                                        19440000
                                                                        19445000
To activate the CS Trace facility for DS line 55 (the line is           19450000
already open), enter:                                                   19455000
                                                                        19460000
     :DSCONTROL 55;TRACE,ON                                             19465000
                                                                        19470000
                                                                        19475000
To open DS line 55 and activate CS Trace with a maximum of 250          19480000
entries in a trace record, enter:                                       19485000
                                                                        19490000
     :DSCONTROL 55;OPEN;TRACE,ON,,,250                                  19495000
                                                                        19500000
                                                                        19505000
To open the line named REMSYS and provide compression and               19510000
internal monitoring, enter:                                             19515000
                                                                        19520000
     :DSCONTROL REMSYS;OPEN;COMP;MON                                    19525000
                                                                        19530000
                                                                        19535000
To open the line named SDS and set the retry count for that line        19540000
to 100, enter:                                                          19545000
                                                                        19550000
     :DSCONTROL SDS;OPEN;RETRY=100                                      19555000
                                                                        19560000
                                                                        19565000
\ENTRY=DSCOPY,PARMS,OPERATION,EXAMPLE                                   19570000
    :DSCOPY                                                             19575000
                                                                        19580000
Utility which copies entire files either locally or across DS           19585000
lines.                                                                  19590000
                                                                        19595000
                                                                        19600000
SYNTAX                                                                  19605000
                                                                        19610000
The syntax of the DSCOPY command is:                                    19615000
                                                                        19620000
<copy command> ::=                                                      19625000
                                                                        19630000
     DSCOPY  [ <source id> ] [ TO [ <target id> ] ]                     19635000
                             [ ;                  ]                     19640000
                                                                        19645000
<source id>    ::=                                                      19650000
                                                                        19655000
     <source file> [, [node] [, [device] ]]                             19660000
                   [         [# [device] ]]                             19665000
                                                                        19670000
                                                                        19675000
<target id>    ::=                                                      19680000
                                                                        19685000
     <target file> [, [node] [, [device] ]]                             19690000
                   [  [ *  ] [# [device] ]]                             19695000
                                                                        19700000
                                                                        19705000
\ITEM=PARMS                                                             19710000
                                                                        19715000
PARAMETERS                                                              19720000
                                                                        19725000
<source id>       Gives the name and location of source file.           19730000
                                                                        19735000
<target id>       Gives the name and location of target file.           19740000
                                                                        19745000
<source file>                                                           19750000
<target file>     The fully qualified file names of the source          19755000
                  and target files.  Syntactically each may be          19760000
                  any sequence of characters which does not             19765000
                  contain a comma, semi-colon, "#", quote or            19770000
                  blank.  There is no default for <source file>.        19775000
                  The default <target file> will generally be           19780000
                  derived from <source file>.  The default will         19785000
                  consist of the first sequence of characters           19790000
                  in <source file> which constitutes a legal            19795000
                  HP/3000 file name.  For example, in "DSCOPY           19800000
                  file.group.node1" the default <target file>           19805000
                  would be "file".  If a default KSAM keyfile           19810000
                  name must be generated also, the data file            19815000
                  name plus a "K" will be used.  The user spec-         19820000
                  ifies a data and keyfile name pair by enclosing       19825000
                  them in quotes and separating them with a             19830000
                  comma (DSCOPY source TO "datafile,keyfile").          19835000
                                                                        19840000
<node>                                                                  19845000
*                 The name of the network node where the file           19850000
                  resides or will reside.  This will be a dsline        19855000
                  name or number.  If <node> is not given for a         19860000
                  source or target file, the file is assumed to         19865000
                  be local.  The asterisk can be used to indicate       19870000
                  that the target system is the same as the             19875000
                  source system.                                        19880000
                                                                        19885000
<device>          The name of the device or device class where          19890000
                  the file resides as defined by the system             19895000
                  where it resides.  The default is DISC.  If a         19900000
                  user desires to specify the device for a KSAM         19905000
                  keyfile separately, he may use the same tech-         19910000
                  nique used for target file names, (DSCOPY K TO        19915000
                  "data,keys", , "datadev,keydev").  The default        19920000
                  for the keyfile device is the same device the         19925000
                  data file resides on.                                 19930000
                                                                        19935000
\ITEM=OPERATION                                                         19940000
                                                                        19945000
OPERATION                                                               19950000
                                                                        19955000
The DSCOPY command invokes the file transfer process (NFT).             19960000
DSCOPY only copies entire files.  Its goal is to provide easy to        19965000
use, efficient transfer of files across DS lines.  If parameters are    19970000
included in the DSCOPY command, then control will return                19975000
to the user after the completion of the file transfer.  To invoke       19980000
the file transfer process for a series of transactions, only the        19985000
command DSCOPY is entered.  NFT will then open the file DSCOPYI         19990000
and read requests from it.  DSCOPYI defaults to $STDINX.  NFT           19995000
will prompt the user with the word DSCOPY.  The syntax of the           20000000
response is:                                                            20005000
                                                                        20010000
    <source id> [TO [ <target id> ] ]                                   20015000
                [;                  ]                                   20020000
                                                                        20025000
To continue a response to a second line, place an "&" as the last       20030000
non-blank on the current line and hit carriage return.  A               20035000
continue prompt will be issued and the remaining input may be           20040000
entered.  To cancel a request while entering a continuation line,       20045000
hit control-Y.  Control-Y is also used to cancel a copy in progress.    20050000
If control-Y is hit during a copy, NFT will respond with the            20055000
percent complete and prompt the user for cancel or continue.            20060000
NFT should never be broken and ABORTed during a copy.                   20065000
                                                                        20070000
To terminate NFT hit control-Y or enter "//" in response to the         20075000
DSCOPY prompt.                                                          20080000
                                                                        20085000
While in sub-system mode, MPE commands may be entered and               20090000
executed.  (eg. DSCOPY :LISTF)                                          20095000
                                                                        20100000
The NFT process produces various bits and pieces of printed             20105000
output to document its input and results.  This output may              20110000
be obtained by equating the line printer or a file to the               20115000
formal designator "DSCOPYL".                                            20120000
                                                                        20125000
DSCOPY is not allowed in break.                                         20130000
                                                                        20135000
\ITEM=EXAMPLE                                                           20140000
                                                                        20145000
EXAMPLES                                                                20150000
                                                                        20155000
1.   :DSCOPY file TO newfile                                            20160000
                                                                        20165000
      Makes a local copy named newfile of the local file "file".        20170000
                                                                        20175000
2.   :DSCOPY file; newfile, sysa                                        20180000
                                                                        20185000
      Makes a copy of the local "file" on the system attached to        20190000
  the dsline sysa.  The newfile will be named newfile.  A user          20195000
  DSLINE command and a REMOTE HELLO  must precede this or any           20200000
  DSCOPY request which references a dsline.  The word "TO" has          20205000
  been replaced with a semi-colon.                                      20210000
                                                                        20215000
3.   :DSCOPY                                                            20220000
                                                                        20225000
      Enter sub-system mode.  The remainder of the example is in        20230000
  sub-system mode.  The word DSCOPY is furnished by NFT as a            20235000
  prompt.                                                               20240000
                                                                        20245000
4.   DSCOPY file,sysa; newfile                                          20250000
                                                                        20255000
      Source file is remote, target file is local.                      20260000
                                                                        20265000
5.   DSCOPY file, sysa TO newfile, sysb                                 20270000
                                                                        20275000
      The source and target files are on different remote systems.      20280000
                                                                        20285000
6.   DSCOPY file, sysa                                                  20290000
                                                                        20295000
      The source file is on sysa.  The target file has the same         20300000
  name as the source, but is local.                                     20305000
                                                                        20310000
7.   DSCOPY file, sysa TO newfile,*                                     20315000
                                                                        20320000
      The "*" means the target system is the same as the source         20325000
  system.                                                               20330000
                                                                        20335000
8.   DSCOPY file                                                        20340000
                                                                        20345000
      The file name of the target is the same as the source and         20350000
  both are local.  An error message will always result.                 20355000
                                                                        20360000
9.   DSCOPY file.group.acct                                             20365000
                                                                        20370000
      The target file will have the same name as the target, but        20375000
  will default to the logon group and account.                          20380000
                                                                        20385000
10.  DSCOPY //                                                          20390000
                                                                        20395000
      Terminates NFT.  Control returns to user.                         20400000
                                                                        20405000
                                                                        20410000
                                                                        20415000
\ENTRY=DSLINE,PARMS,OPERATION,EXAMPLE                                   20420000
    :DSLINE                                                             20425000
                                                                        20430000
Opens or closes communication lines with DS/3000.                       20435000
This is the Users command, refer DSCONTROL for Console command.         20440000
                                                                        20445000
                                                                        20450000
SYNTAX                                                                  20455000
                                                                        20460000
To open a DS communications line:                                       20465000
                                                                        20470000
    :DSLINE dsdevice                                                    20475000
            [;LINEBUF=bufsize]                                          20480000
            [;COMP]                                                     20485000
            [;NOCOMP]                                                   20490000
            [;LOCID=local-id-sequence]                                  20495000
            [;REMID=remote-id-sequence1[,remote-id-sequence2]....]      20500000
            [;PHNUM=telephone number]                                   20505000
            [;EXCLUSIVE]                                                20510000
            [;QUIET]                                                    20515000
                                                                        20520000
To close a communication line:                                          20525000
                                                                        20530000
             dsdevice                                                   20535000
    :DSLINE [ds-line-number][;CLOSE]                                    20540000
             @                                                          20545000
                                                                        20550000
\ITEM=PARMS                                                             20555000
PARAMETERS                                                              20560000
                                                                        20565000
dsdevice           Device class name or logical device number           20570000
                   assigned to the DS/3000 communications driver        20575000
                   IODS0 during system configuration.  This para-       20580000
                   meter specifies what physical line you wish          20585000
                   to use.  (REQUIRED PARAMETER)                        20590000
                                                                        20595000
bufsize            A decimal integer specifying the size (in words)     20600000
                   of the DS/3000 line buffer to be used in conjunc-    20605000
                   tion the particular communications line.  The        20610000
                   integer must be within the range 304 < buffer        20615000
                   size < 4096.  Default is the buffer size entered     20620000
                   in response to the PREFERRED BUFFER SIZE prompt      20625000
                   during system configuration.                         20630000
                                                                        20635000
                                                                        20640000
COMP               Overrides default line configuration and allows      20645000
                   Compression for this user.                           20650000
                                                                        20655000
NOCOMP             Overrides default line configuration and             20660000
                   prevents compression for this user.                  20665000
                                                                        20670000
QUIET              Prevents the logon and logoff messages from          20675000
                   writing to $STDLIST device for the remote            20680000
                   DS session or job.                                   20685000
                                                                        20690000
EXCLUSIVE          Specifies that you want exclusive use of the         20695000
                   particular communications line.  If the requested    20700000
                   line already is open and you have specified the      20705000
                   exclusive option, DS/3000 will deny you access       20710000
                   to the line.  Use of this parameter requires CS      20715000
                   capability.  Default is the line is opened non-      20720000
                   exclusive.                                           20725000
                                                                        20730000
local-id-sequence  A string of ASCII characters contained within        20735000
                   quotation marks or a string of octal numbers         20740000
                   separated by commas and contained within             20745000
                   parameters.  If you wish to use a quotation mark     20750000
                   within an ASCII string, use two successive           20755000
                   quotation marks.  In the case of an octal se-        20760000
                   quence each octal number represents one byte and     20765000
                   must be within the range 0 - 377.  The maximum       20770000
                   number of ASCII characters or octal numbers          20775000
                   allowed is 16.                                       20780000
                                                                        20785000
                   The supplied string of ASCII characters or octal     20790000
                   numbers defines the ID sequence that will be sent    20795000
                   from your HP 3000 to the remote HP 3000 when you     20800000
                   attempt to establish the telephone connection.       20805000
                   If the remote HP 3000 does not recognize the         20810000
                   supplied ID sequence as valid, the telephone         20815000
                   connection is terminated.  Default is the ASCII      20820000
                   or octal string entered in response to the LOCAL     20825000
                   SEQUENCE prompt during system configuration.         20830000
                                                                        20835000
remote-id-sequence A string of ASCII characters or octal numbers in     20840000
                   the same format as described under the local-id-     20845000
                   sequence parameter.                                  20850000
                                                                        20855000
                   The supplied strings of ASCII characters or octal    20860000
                   numbers define those remote HP 3000 ID sequences     20865000
                   that will be considered valid when you attempt to    20870000
                   establish the telephone connection.  If the remote   20875000
                   HP 3000 does not send a valid ID sequence, the       20880000
                   telephone connection is terminated.  Default is      20885000
                   the ASCII and octal strings entered in response to   20890000
                   the REMOTE ID SEQUENCE prompt during system          20895000
                   configuration.                                       20900000
                                                                        20905000
telephone-number   A telephone number consisting of digits and dashes.  20910000
                   The maximum length permitted (including both digits  20915000
                   and dashes) is 20 characters.  Provided that YES     20920000
                   was entered in response to the DIAL FACILITY         20925000
                   prompt during system configuration, this telephone   20930000
                   number will be displayed at the operator's console   20935000
                   of your HP 3000 and the operator will then           20940000
                   establish the telephone connection by dialing that   20945000
                   number at the MODEM.  Default is the first one       20950000
                   entered in response to the PHONE NUMBER prompt       20955000
                   during system configuration.                         20960000
                                                                        20965000
ds-line-number     The DS line number assigned to you by DS/3000        20970000
                   when the particular line was opened.                 20975000
                                                                        20980000
@                  Specifies that you wish to close all lines that      20985000
                   you currently have open.                             20990000
                                                                        20995000
CLOSE              Specifies that you wish to close the specified       21000000
                   lines.                                               21005000
                                                                        21010000
\ITEM=OPERATION                                                         21015000
OPERATION                                                               21020000
                                                                        21025000
The :DSLINE command opens or closes hardwired or telephone              21030000
communications lines with DS/3000.                                      21035000
                                                                        21040000
\ITEM=EXAMPLE                                                           21045000
EXAMPLE                                                                 21050000
                                                                        21055000
To initiate a local session on System A, obtain access to the           21060000
hardwired communications line that connects System A to System B, and   21065000
initiate a remote session on System B, enter:                           21070000
                                                                        21075000
  :HELLO USER.X                                                         21080000
  :DSLINE HDS1                                                          21085000
  :REMOTE HELLO USER.X                                                  21090000
                                                                        21095000
Another example using compression and quiet.                            21100000
                                                                        21105000
   :DSLINE REMSYS;COMP;QUIET                                            21110000
                                                                        21115000
Closing the line, to remove logical access; to correct errors;          21120000
and to allow the Console Operator to SHUT the line:                     21125000
                                                                        21130000
   :DSLINE @;CLOSE                                                      21135000
                                                                        21140000
                                                                        21145000
\ENTRY=DSTAT,PARMS,OPERATION,EXAMPLE                                    21150000
    :DSTAT                                                              21155000
                                                                        21160000
Displays the current status of the disc drives on the system.           21165000
                                                                        21170000
SYNTAX                                                                  21175000
                                                                        21180000
              ldn                                                       21185000
    :DSTAT  [     ]                                                     21190000
              ALL                                                       21195000
                                                                        21200000
\ITEM=PARMS                                                             21205000
PARAMETERS                                                              21210000
                                                                        21215000
ldn      An integer specifying the logical device number of the disc    21220000
         drive whose status is desired.                                 21225000
                                                                        21230000
ALL      Causes the status of all disc drives, system and non-system, to21235000
         be displayed.                                                  21240000
                                                                        21245000
The default is that if no parameter is included, only the status of     21250000
non-system discs is displayed.                                          21255000
                                                                        21260000
\ITEM=OPERATION                                                         21265000
OPERATION                                                               21270000
                                                                        21275000
The :DSTAT command causes the display of the current status of the disc 21280000
drives on the system.                                                   21285000
                                                                        21290000
\ITEM=EXAMPLE                                                           21295000
EXAMPLE                                                                 21300000
                                                                        21305000
To display the status of all disc drives, enter:                        21310000
                                                                        21315000
    :DSTAT ALL                                                          21320000
                                                                        21325000
                                                                        21330000
\ENTRY=EDITOR,PARMS,OPERATION,EXAMPLE                                   21335000
    :EDITOR                                                             21340000
                                                                        21345000
Invokes the Editor.                                                     21350000
                                                                        21355000
SYNTAX                                                                  21360000
                                                                        21365000
    :EDITOR [listfile]                                                  21370000
                                                                        21375000
\ITEM=PARMS                                                             21380000
PARAMETERS                                                              21385000
                                                                        21390000
listfile             Actual designator of file to receive any output    21395000
                     resulting from Editor commands LIST and XPLAIN when21400000
                     the OFFLINE option is specified.  Can be any ASCII 21405000
                     output file. Formal designator is EDTLIST.  Because21410000
                     this file often is a line printer, it usually is   21415000
                     defined in an MPE :FILE command and back           21420000
                     referenced as follows:                             21425000
                                                                        21430000
                     :FILE LISTFILE;DEV=LP                              21435000
                     :EDITOR*LISTFILE                                   21440000
                                                                        21445000
                     Default:  If omitted, default is EDITLIST.   If    21450000
                               specified with no device parameter,      21455000
                               default is device LP.                    21460000
                                                                        21465000
                             NOTE                                       21470000
                                                                        21475000
      The formal file designator used in this command                   21480000
      (EDTLIST)                                                         21485000
      cannot be back referenced as an actual file designator            21490000
      in the command parameter list.  For further information,          21495000
      see the discussion of implied :FILE commands in                   21500000
      Section VII of the MPE Commands Reference Manual.                 21505000
                                                                        21510000
\ITEM=OPERATION                                                         21515000
OPERATION                                                               21520000
                                                                        21525000
Accesses the Editor subsystem.                                          21530000
                                                                        21535000
\ITEM=EXAMPLE                                                           21540000
EXAMPLE                                                                 21545000
                                                                        21550000
To access the Editor during a session and specify a line printer        21555000
(device class LP1) as the list device for offline output, enter:        21560000
                                                                        21565000
    :FILE LISTFILE;DEV=LP1                                              21570000
    :EDITOR*LISTFILE                                                    21575000
                                                                        21580000
                                                                        21585000
                                                                        21590000
\ENTRY=ELSE,PARMS,OPERATION,EXAMPLE                                     21595000
    :ELSE                                                               21600000
                                                                        21605000
Provides an alternate execution sequence for an :IF statement.          21610000
                                                                        21615000
SYNTAX                                                                  21620000
                                                                        21625000
    :ELSE                                                               21630000
                                                                        21635000
\ITEM=PARMS                                                             21640000
PARAMETERS                                                              21645000
                                                                        21650000
None                                                                    21655000
                                                                        21660000
\ITEM=OPERATION                                                         21665000
OPERATION                                                               21670000
                                                                        21675000
The :ELSE command is used only with the :IF command.  The :IF command   21680000
is used with the :ENDIF command and, optionally, the :ELSE command,     21685000
to control the execution of a job.  The :IF command, :ENDIF command,    21690000
and optional :ELSE command constitute an IF block.  A logical           21695000
expression is evaluated and, if true, the IF block is executed, if      21700000
false, the ELSE block (if one exists) is executed.                      21705000
                                                                        21710000
\ITEM=EXAMPLE                                                           21715000
EXAMPLE                                                                 21720000
                                                                        21725000
    :RUN UPDATE1               (Run first data base update)             21730000
    :IF JCW<WARN THEN          (Continue if OK so far)                  21735000
    :  SETJCW UPDATE1JCW:=JCW  (Save that return code)                  21740000
    :  RUN UPDATE2             (Run second data base update)            21745000
    :  IF JCW<WARN THEN        (Continue if still OK)                   21750000
    :    SETJCW UPDATE2JCW:=JCW    (Save the second return code)        21755000
    :    RUN DBSTATUS              (Report current status of DB)        21760000
    :    IF (UPDATE1JCW < 50) AND (UPDATE2JCW < 50) THEN                21765000
    :      RUN DAILYRPT                                                 21770000
    :    ENDIF                                                          21775000
    :    IF ((UPDATE1JCW = 1) OR (UPDATE2JCW =1)) THEN                  21780000
    :      RUN WEEKLYRPT                                                21785000
    :    ENDIF                                                          21790000
    :  ELSE           (Second update program failed)                    21795000
    :    RUN FIXUP    (Repair data base and report)                     21800000
    :  ENDIF                                                            21805000
    :ENDIF                                                              21810000
                                                                        21815000
                                                                        21820000
\ENTRY=ENDIF,PARMS,OPERATION,EXAMPLE                                    21825000
    :ENDIF                                                              21830000
                                                                        21835000
Terminates an IF block.                                                 21840000
                                                                        21845000
SYNTAX                                                                  21850000
                                                                        21855000
    :ENDIF                                                              21860000
                                                                        21865000
\ITEM=PARMS                                                             21870000
PARAMETERS                                                              21875000
                                                                        21880000
None                                                                    21885000
                                                                        21890000
\ITEM=OPERATION                                                         21895000
OPERATION                                                               21900000
                                                                        21905000
The :ENDIF command is used to terminate an IF block.  The :IF           21910000
command, :ENDIF command, and optional :ELSE commad, constitute an IF    21915000
block and are used to control the execution of a job.  A logical        21920000
expression is evaluated and, if true, the IF block is executed; if      21925000
false, the :ELSE block (if one exists) is executed.                     21930000
                                                                        21935000
\ITEM=EXAMPLE                                                           21940000
EXAMPLE                                                                 21945000
    :RUN UPDATE1               (Run first data base update)             21950000
    :IF JCW<WARN THEN          (Continue if OK so far)                  21955000
    :  SETJCW UPDATE1JCW:=JCW  (Save that return code)                  21960000
    :  RUN UPDATE2             (Run second data base update)            21965000
    :  IF JCW<WARN THEN        (Continue if still OK)                   21970000
    :    SETJCW UPDATE2JCW:=JCW    (Save the second return code)        21975000
    :    RUN DBSTATUS              (Report current status of DB)        21980000
    :    IF (UPDATE1JCW < 50) AND (UPDATE2JCW < 50) THEN                21985000
    :      RUN DAILYRPT                                                 21990000
    :    ENDIF                                                          21995000
    :    IF ((UPDATE1JCW = 1) OR (UPDATE2JCW =1)) THEN                  22000000
    :      RUN WEEKLYRPT                                                22005000
    :    ENDIF                                                          22010000
    :  ELSE           (Second update program failed)                    22015000
    :    RUN FIXUP    (Repair data base and report)                     22020000
    :  ENDIF                                                            22025000
    :ENDIF                                                              22030000
                                                                        22035000
                                                                        22040000
\ENTRY=EOD,PARMS,OPERATION,EXAMPLE                                      22045000
    :EOD                                                                22050000
                                                                        22055000
Denotes end-of-data on input stream.                                    22060000
                                                                        22065000
SYNTAX                                                                  22070000
                                                                        22075000
    :EOD                                                                22080000
                                                                        22085000
\ITEM=PARMS                                                             22090000
PARAMETERS                                                              22095000
                                                                        22100000
None                                                                    22105000
                                                                        22110000
\ITEM=OPERATION                                                         22115000
OPERATION                                                               22120000
                                                                        22125000
Denotes the end-of-data read through an input stream.  Used primarily to22130000
signify the end-of-data entered through standard input device. Also used22135000
for data submitted through a non-sharable device via the :DATA command. 22140000
                                                                        22145000
\ITEM=EXAMPLE                                                           22150000
EXAMPLE                                                                 22155000
                                                                        22160000
To terminate a data file entered on cards for a session identified as   22165000
:DATA SESS1,BLACK.ACCTSP, you would enter:                              22170000
                                                                        22175000
    :DATA SESS1,BLACK.ACCTSP                                            22180000
             .                                                          22185000
             .                                                          22190000
           data                                                         22195000
             .                                                          22200000
             .                                                          22205000
    :EOD                                                                22210000
                                                                        22215000
                                                                        22220000
\ENTRY=EOF,PARMS,OPERATION,EXAMPLE                                      22225000
    :EOF:                                                               22230000
                                                                        22235000
Simulates hardware end-of-file on input stream from any device.         22240000
                                                                        22245000
SYNTAX                                                                  22250000
                                                                        22255000
    :EOF:  (The last colon in this command must be followed by a blank) 22260000
                                                                        22265000
\ITEM=PARMS                                                             22270000
PARAMETERS                                                              22275000
                                                                        22280000
None                                                                    22285000
                                                                        22290000
\ITEM=OPERATION                                                         22295000
OPERATION                                                               22300000
                                                                        22305000
Denotes end-of-file read through an input stream.  Required to simulate 22310000
a physical end-of-file on HP 2894A Card Reader/Punch when that device is22315000
configured to refuse data submitted via a :DATA command. (This device   22320000
does not provide a true hardware end-of-file indication.)               22325000
                                                                        22330000
\ITEM=EXAMPLE                                                           22335000
EXAMPLE                                                                 22340000
                                                                        22345000
    :EOF:  (The last colon in this command must be followed by a blank) 22350000
\ENTRY=EOJ,PARMS,OPERATION,EXAMPLE                                      22355000
    :EOJ                                                                22360000
                                                                        22365000
Ends a batch job.                                                       22370000
                                                                        22375000
SYNTAX                                                                  22380000
                                                                        22385000
    :EOJ                                                                22390000
                                                                        22395000
\ITEM=PARMS                                                             22400000
PARAMETERS                                                              22405000
                                                                        22410000
None                                                                    22415000
                                                                        22420000
\ITEM=OPERATION                                                         22425000
OPERATION                                                               22430000
                                                                        22435000
Terminates a batch job, and displays the cpu time used (in seconds),    22440000
the elapsed time (in minutes), and the date and time, as follows:       22445000
                                                                        22450000
    CPU=4.  CONNECT=8.  TUE, OCT 18, 1977, 4:17 PM                      22455000
                                                                        22460000
\ITEM=EXAMPLE                                                           22465000
EXAMPLE                                                                 22470000
                                                                        22475000
    :EOJ                                                                22480000
                                                                        22485000
    CPU=4.  CONNECT=8.  TUE, OCT 18, 1977, 4:17 PM                      22490000
                                                                        22495000
                                                                        22500000
\ENTRY=FCOPY                                                            22505000
    :FCOPY                                                              22510000
                                                                        22515000
Accesses the FCOPY subsystem.                                           22520000
                                                                        22525000
SYNTAX                                                                  22530000
                                                                        22535000
    :FCOPY [fcopycommand]                                               22540000
                                                                        22545000
\ITEM=PARMS                                                             22550000
PARAMETERS                                                              22555000
                                                                        22560000
fcopycommand      an FCOPY subsystem command.  (See the FCOPY Reference 22565000
                  Manual for a description of the command syntax.)      22570000
                                                                        22575000
\ITEM=OPERATION                                                         22580000
OPERATION                                                               22585000
                                                                        22590000
This command accesses the FCOPY subsystem from MPE.  If the command is  22595000
entered with no parameters, FCOPY prompts (>) the user for subsystem    22600000
commands one at a time until an EXIT command is entered.  When the MPE  22605000
command contains <fcopycommand> as a parameter, FCOPY executes the      22610000
command and then returns control to MPE.                                22615000
                                                                        22620000
\ITEM=EXAMPLE                                                           22625000
EXAMPLE                                                                 22630000
                                                                        22635000
To access the FCOPY subsystem to execute multiple commands, enter:      22640000
                                                                        22645000
             :FCOPY                                                     22650000
             HP32212A.3.12 FILE COPIER (C) HEWLETT-PACKARD CO. 1980     22655000
                                                                        22660000
             >             (FCOPY subsystem prompt character)           22665000
                                                                        22670000
To access FCOPY to execute a single command and return control to       22675000
MPE, enter the command as follows:                                      22680000
                                                                        22685000
             :FCOPY FROM=UDC.COHEN;TO=;OCTAL;CHAR                       22690000
                                                                        22695000
\ENTRY=FILE,PARMS,NAME,DEVICE,ACCESS,DISP,OPERATION,EXAMPLE             22700000
    :FILE                                                               22705000
                                                                        22710000
Specifies a file's attributes when it is opened.                        22715000
                                                                        22720000
SYNTAX                                                                  22725000
                                                                        22730000
                    { devicespec [access] [disposition] }               22735000
     :FILE namespec { access [devicespec] [disposition] }               22740000
                    { disposition [access] [devicespec] }               22745000
                                                                        22750000
PARAMETERS                                                              22755000
                                                                        22760000
namespec (NAME)       Consists of the formal name used by the program   22765000
                      and may be equated to another file in the system. 22770000
                      (REQUIRED PARAMETER)                              22775000
                                                                        22780000
devicespec (DEVICE)   A list of parameters giving the physical          22785000
                      description of the file.  This consists of the    22790000
                      REC, DEV, ENV, DEN, DISC, CODE, RIO, NORIO,       22795000
                      STD, MSG, and CIR parameters.                     22800000
                                                                        22805000
access (ACCESS)       A list of parameters specifying the type of access22810000
                      granted to a file.                                22815000
                                                                        22820000
disposition (DISP)    Specifies what is to be done with the file after  22825000
                      it is closed. This consists of the DEL, SAVE, and 22830000
                      TEMP parameters.                                  22835000
                                                                        22840000
Enter "PARMS" for information on all the :FILE parameters.              22845000
For information on the subitems NAME, DEVICE, ACCESS or                 22850000
DISP, enter the specific keyword. Carriage return will then             22855000
lead to the next subitem.                                               22860000
                                                                        22865000
\ITEM=PARMS                                                             22870000
\SUBITEM=NAME                                                           22875000
SYNTAX FOR NAMESPEC                                                     22880000
                                                                        22885000
   formaldesignator [= *formaldesignator       ]                        22890000
                    [=$NULL                    ]                        22895000
                    [=$NEWPASS                 ]                        22900000
                    [=$OLDPASS                 ]                        22905000
                    [=$STDIN                   ]                        22910000
                    [=$STDINX                  ]                        22915000
                    [=$STDLIST                 ]                        22920000
                    [=filereference] [,NEW    ]]                        22925000
                                     [,OLD    ]                         22930000
                                     [,OLDTEMP]                         22935000
                                                                        22940000
                                                                        22945000
NAMESPEC PARAMETERS                                                     22950000
                                                                        22955000
formaldesignator      Formal name specified by program opening the file.22960000
                      Contains from 1 to 8 alphanumeric characters      22965000
                      in each field, beginning with a letter.  formal-  22970000
                      designator is used as the file name when file-    22975000
                      reference is not specified.  The format is:       22980000
                                                                        22985000
                        filename[.groupname[.accountname]]              22990000
                           (Lockwords for fields may be supplied.)      22995000
                                                                        23000000
                                                                        23005000
$NULL                 SYSTEM-DEFINED FILE THAT IS ALWAYS EMPTY.         23010000
                                                                        23015000
$NEWPASS              SYSTEM-DEFINED JOB TEMPORARY FILE.  OPENING       23020000
                      $NEWPASS purges any previous temporary file. When 23025000
                      $NEWPASS is closed, it is referenced by the name  23030000
                      $OLDPASS.                                         23035000
                                                                        23040000
$OLDPASS              SYSTEM-DEFINED NAME OF THE LAST TEMPORARY FILE    23045000
                      closed as $NEWPASS.                               23050000
                                                                        23055000
$STDIN                SYSTEM DEFINED NAME OF THE STANDARD JOB INPUT     23060000
                      device. A colon as the first character read on    23065000
                      this file indicates end-of-data.                  23070000
                                                                        23075000
$STDINX               EQUIVALENT TO $STDIN EXCEPT COLON CAN BE READ AS  23080000
                      the first character and received as data (:JOB,   23085000
                      :DATA, :EOJ, and :EOD can not be read as data,    23090000
                      however).                                         23095000
                                                                        23100000
$STDLIST              SYSTEM DEFINED NAME FOR STANDARD JOB/SESSION LIST 23105000
                      device.                                           23110000
                                                                        23115000
filereference         Actual name of file, in the following format:     23120000
                                                                        23125000
                        filename[/lockword][.groupname[.accountname]]   23130000
                                                                        23135000
                      Each field may contain from 1 to 8 alphanumeric   23140000
                      characters, beginning with a letter. Omission of  23145000
                      <lockword> causes MPE to ask for it when the file 23150000
                      is opened, if one is present.  Default <groupname>23155000
                      and <accountname> are the logon group and account.23160000
                                                                        23165000
NEW                   Specification that the file is a new file.        23170000
                                                                        23175000
OLD                   Previously-existing permanent file saved in       23180000
                      system file domain.  File continues to exist      23185000
                      after current session/job terminates.             23190000
                                                                        23195000
OLDTEMP               Previously-existing temporary file in session/    23200000
                      job temporary file domain.  File is deleted       23205000
                      at end of current session/job.                    23210000
                                                                        23215000
                                             NOTE                       23220000
                                                                        23225000
                         NEW, OLD, and OLDTEMP specify the file domain  23230000
                         indicating where the file exists.  If all are  23235000
                         omitted, the domain specified in FOPEN         23240000
                         intrinsic takes effect.                        23245000
                                                                        23250000
                                                                        23255000
\SUBITEM=DEVICE                                                         23260000
SYNTAX FOR DEVICESPEC                                                   23265000
                                                                        23270000
   [;REC= [recsize] [,[blockfactor] [,[F] [,BINARY]]]]                  23275000
                                      [U] [,ASCII ]                     23280000
                                      [V]                               23285000
                                                                        23290000
   [;DEV= [[dsdevice]#] [device][,[outpriority][,numcopies]]]           23295000
                                                                        23300000
   [;ENV= [environment]]                                                23305000
                                                                        23310000
   [;DEN= [density]]                                                    23315000
                                                                        23320000
   [;DISC= [numrec] [,[numextents] [,initalloc]]]                       23325000
                                                                        23330000
   [;CODE= [filecode]]                                                  23335000
   [;RIO]                                                               23340000
                                                                        23345000
   [;NORIO]                                                             23350000
                                                                        23355000
   [;STD]                                                               23360000
                                                                        23365000
   [;MSG]                                                               23370000
                                                                        23375000
   [;CIR]                                                               23380000
                                                                        23385000
These parameters can be used for new files only. An exception is that   23390000
REC can be specified for system-defined files.                          23395000
                                                                        23400000
                                                                        23405000
DEVICESPEC PARAMETERS                                                   23410000
                                                                        23415000
recsize       Record size.  A positive number indicates words while     23420000
              negative indicates bytes. For fixed-length files, this is 23425000
              the logical record size. For undefined-length this is the 23430000
              maximum record size.  For variable length files this is   23435000
              the maximum physical record size.                         23440000
                                                                        23445000
              For either ASCII or binary files with fixed or            23450000
              undefined length records, the recored size is             23455000
              rounded up to the nearest word boundary. For ex-          23460000
              ample, a recsize specified as -106 for an ASCII           23465000
              file is 106 characters (53 words) in length. A            23470000
              recsize of -113 for a binary file is 114 charac-          23475000
              ters (57 words) in length. The rounded sizes              23480000
              should be used in computations for blockfactor            23485000
              or block size.                                            23490000
              Default:  The default value is the configured             23495000
              physical record width of the associated device.           23500000
                                                                        23505000
blockfactor   Number of logical records per physcical block. Default is 23510000
              calculated by dividing the specified <recsize> into the   23515000
              configured <blocksize>; this value is rounded downward to 23520000
              an integer that is never less than 1.                     23525000
                                                                        23530000
F, U, V       File contains fixed (F), undefined (U) or variable (V)    23535000
              length records. Default is <F> for disc and magnetic tape 23540000
              files, <U> for all others.                                23545000
                                                                        23550000
BINARY        File contains binary-coded records. Default.              23555000
                                                                        23560000
ASCII         File contains ASCII-coded records.  Default is BINARY.    23565000
                                                                        23570000
device        Contains a string of ASCII characters terminating with    23575000
              any non-alphanumeric character except a slash or period,  23580000
              designating the device on which the file is to reside.    23585000
              This parameter may be specified in one of the following   23590000
              forms:                                                    23595000
                                                                        23600000
              devclass                                                  23605000
              ldn                                                       23610000
                                                                        23615000
              The devclass form represents a device class name of up to 23620000
              eight alphanumeric characters beginning with a letter, as 23625000
              for example, DISC or TAPE.  If devclass is specified, the 23630000
              file is allocated to any available device in that class.  23635000
              If you are opening a file which is to reside on a private 23640000
              volume, you must specify device class DISC; the file then 23645000
              is allocated to any of the home volume set's volumes that 23650000
              fall within that device class.                            23655000
                                                                        23660000
              The logical device number (ldn) consists of a three-byte  23665000
              numeric string specifying a particular device.  If you are23670000
              opening a file which is to reside on a private volume, you23675000
              must specify a disc drive on which one of the volumes in  23680000
              the home volume set resides.                              23685000
                                                                        23690000
              Default is DISC.                                          23695000
                                                                        23700000
dsdevice      Any of the forms may be used to reference files on        23705000
              a remote computer by preceding the device or volume       23710000
              specification with <dsdevice> #.                          23715000
                                                                        23720000
outpriority   The output priority for spooled device files.  This is a  23725000
              value between 1 (lowest priority) and 13 (highest         23730000
              priority).  Default is 8 when logging is enabled, or 13 if23735000
              logging is disabled.                                      23740000
                                                                        23745000
numcopies     Number of copies of file for spooled output device files. 23750000
              Maximum is 127.  Default is 1.                            23755000
                                                                        23760000
environment   [;ENV= [*formaldesignator] ]                              23765000
                     [filereference    ]                                23770000
                                                                        23775000
              A compiled disc file containing the specifications        23780000
              for a printed page which are not part of the data.        23785000
              These specifications may include the page size, the       23790000
              character font, forms, and other printed requirements     23795000
              to be used in conjunction with the HP 2680A Laser         23800000
              Printing System.  Refer to the manuals for IDS/3000       23805000
              and IFS/3000 for further information.                     23810000
                                                                        23815000
              For example:                                              23820000
                 Create a file for a travel form via IDS/3000 and       23825000
                 IFS/3000.                                              23830000
                    :FILE TRAVEL=TRADMIN.HPENV.HP2680A                  23835000
                    :FILE LP;DEV=LP;ENV=[TRADMIN.HPENV.HP2680A]         23840000
                                        [*TRAVEL              ]         23845000
                                                                        23850000
              The ;ENV parameter in :FILE commands has precedence       23855000
              over environments specified in an FOPEN.                  23860000
                                                                        23865000
              If the environment keyword is specified and the           23870000
              <*formaldesignator> or <filereference> is omitted,        23875000
              any environment from FOPEN is ignored.                    23880000
                                                                        23885000
                     [ 800]                                             23890000
density       [;DEN= [6250] ]                                           23895000
                     [1600]                                             23900000
                                                                        23905000
              Corresponds to tape densities in BPI, bits per inch.      23910000
              This parameter is only applicable when writing to a       23915000
              tape mounted on a variable density tape drive.  The       23920000
              following HP tape drives support variable density:        23925000
                                                                        23930000
                    HP7976 supports 6250 bpi and 1600 bpi,              23935000
                    HP7978 supports 6250 bpi and 1600 bpi, and          23940000
                    HP7974 supports 1600 bpi and 800 bpi.               23945000
                                                                        23950000
              The density value from a file equation takes precedence   23955000
              over the density specified in a call to FOPEN.  For       23960000
              details on the operation of density selection, see        23965000
              the Intrinsics Manual, Section II.                        23970000
                                                                        23975000
numrec        Maximum number of logical records.  For fixed             23980000
              and undefined length files the maximum value              23985000
              allowed for this field is 2,147,483,647.  For             23990000
              variable length files this value is dependent             23995000
              upon input record size and blocksize.  The file           24000000
              system uses these values to compute other                 24005000
              characteristics of the file as well.  Therefore           24010000
              the values (or default values) specified on the           24015000
              :FILE command may be valid within their respec-           24020000
              tive fields, but may cause overflow errors in             24025000
              the computation of internally needed file                 24030000
              specifications.  Default is a value of 1023.              24035000
                                                                        24040000
                                                                        24045000
numextents    Maximum number of disc extents. This is a value from 1 to 24050000
              32.  Default is 8.                                        24055000
                                                                        24060000
initalloc     Number of extents to be initially allocated to the file   24065000
              at the time is it opened. This is a value from 1 to 32.   24070000
              Default is 1.                                             24075000
                                                                        24080000
filecode      Code indicating a specially-formatted file. This code is  24085000
              recorded in the file label and is available to processes  24090000
              accessing the file through the FGETINFO intrinsic.  For   24095000
              this parameter, any user can specify a positive integer   24100000
              ranging from 0 to 1023.  Certain integers have HP-        24105000
              defined meanings, as follows:                             24110000
                                                                        24115000
              Mnemonic   Integer       Meaning                          24120000
              USL        1024      USL file.                            24125000
              BASD       1025      BASIC data file.                     24130000
              BASP       1026      BASIC program file.                  24135000
              BASFP      1027      BASIC fast program file.             24140000
              RL         1028      RL file.                             24145000
              PROG       1029      Program file.                        24150000
              SL         1031      SL file.                             24155000
              VFORM      1035      V/3000 FORMS file.                   24160000
              VFAST      1036      V/3000 FAST FORMS file.              24165000
              VREF       1037      V/3000 reformat file.                24170000
              XLSAV      1040      Cross-Loader ASCII file (SAVE).      24175000
              XLBIN      1041      Cross-Loader relocated binary file.  24180000
              XLDSP      1042      Cross-Loader ASCII file (DISPLAY).   24185000
              EDITQ      1050      Edit KEEPQ file (non-COBOL).         24190000
              EDTCQ      1051      Edit KEEPQ file (COBOL).             24195000
              EDTCT      1052      Edit TEXT file (COBOL).              24200000
              TDPDT      1054      TDP/3000 Diary keep file             24205000
              TDPQM      1055      TDP/3000 Standard Q-Mark             24210000
              TDPP       1056      TDP/3000 Standard P-Mark             24215000
              TDPCP      1057      TDP/3000 Cobol P-Mark                24220000
              TDPQ       1058      TDP/3000 Work File                   24225000
              TDPCQ      1059      TDP/3000 Work File                   24230000
              RJEPN      1060      RJE punch file.                      24235000
              QPROC      1070      QUERY procedure file.                24240000
                         1071      QUERY work file.                     24245000
                         1072      QUERY work file.                     24250000
              KSAMK      1080      KSAM key file.                       24255000
              GRAPH      1083      GRAPH specification file.            24260000
              SD         1084      Self-Describing file.                24265000
              LOG        1090      User logging file.                   24270000
              WDOC       1100      HP Word Document                     24275000
              WDICT      1101      HP Word Hyphenation Dictionary       24280000
              WCONF      1102      HP Word Configuration file           24285000
              W2601      1103      HP 2601 Environment file             24290000
              PCELL      1110      IDS/3000 character set file.         24295000
              PFORM      1111      IDS/3000 form file.                  24300000
              P2680      1112      IFS/3000 environment file.           24305000
              PCCMP      1113      IFS/3000 Compiled Char cell file     24310000
              RASTR      1114      Graphics Image in RASTR format       24315000
              OPTLF      1130      On-Line Performance Tool file.       24320000
              TEPES      1131      TEPE/3000 Script file                24325000
              TEPEL      1132      TEPE/3000 Log file                   24330000
              SAMPL      1133      APS/3000 Log file                    24335000
              MPEDL      1139      MPEDCP/DRP Log file                  24340000
              TSR        1140      TOOLSET Root file                    24345000
              TSD        1141      TOOLSET Data file                    24350000
              DRAW       1145      Drawing file for HP Draw             24355000
              FIG        1146      Figure file for HP Draw              24360000
              DSTOR      1156      Store file for RAPID/3000 DICTDBU    24365000
              TCODE      1157      Code file for TRANSACT/3000          24370000
              RCODE      1158      Code file for REPORT/3000            24375000
              ICODE      1159      Code file for INFORM/3000            24380000
              MDIST      1166      HPMAIL Distribution list             24385000
              MTEXT      1167      HPMAIL text                          24390000
              NCONF      1192      Network Configuration file           24395000
              NTRAC      1193      Network Trace file                   24400000
              NLOG       1194      Network Log file                     24405000
              The default is 0.                                         24410000
                                                                        24415000
                                                                        24420000
RIO           If RIO is specified, a relative I/O file is               24425000
              created.  The record length parameter will                24430000
              implicitly be changed to fixed record length.             24435000
              RIO is a special file access method supported             24440000
              by Cobol II.                                              24445000
                                                                        24450000
              The default is NORIO.                                     24455000
                                                                        24460000
              Note that "RIO" and "NORIO" specifications                24465000
              affect only the physical characteristics of               24470000
              the file.  If "NOBUF" is specified in the                 24475000
              :FILE command, the file will be accessed in               24480000
              NON-RIO mode; otherwise RIO access is used with           24485000
              RIO files.  Note that "NOBUF" access is provided          24490000
              for special operations on RIO files such as               24495000
              replicating an RIO file.  "NOBUF" is not                  24500000
              normally used by the RIO user.                            24505000
                                                                        24510000
                                                                        24515000
NORIO         A non-relative I/O file is created.                       24520000
                                                                        24525000
STD           A standard MPE Disc file.                                 24530000
                                                                        24535000
MSG           Specification for a MSG (Message) file allows             24540000
              communication between any set of processes.  Acts like    24545000
              a FIFO (First In, First Out) queue where records are      24550000
              read from the start of the file and logically deleted     24555000
              and/or are appended to the end of the file.               24560000
                                                                        24565000
CIR           Acts like a normal sequential file until full.  When      24570000
              full, the first physical block will be deleted when       24575000
              the next record is written, and remaining blocks will     24580000
              be logically shifted to the front of the file.  Cannot    24585000
              be simultaneously accessed by readers and writers.        24590000
                                                                        24595000
\SUBITEM=ACCESS                                                         24600000
SYNTAX FOR ACCESS                                                       24605000
                                                                        24610000
   [;NOCCTL]                [;NOMULTI]                                  24615000
   [;CCTL  ]                [;MULTI  ]                                  24620000
                            [;GMULTI ]                                  24625000
                                                                        24630000
   [;ACC= {IN     }]        [;NOMR]                                     24635000
          {OUT    }         [;MR  ]                                     24640000
          {UPDATE }                                                     24645000
          {OUTKEEP}                                                     24650000
          {APPEND }         [;WAIT  ]                                   24655000
          {INOUT  }         [;NOWAIT]                                   24660000
                                                                        24665000
   [;BUF= [numbuffers]]                                                 24670000
   [;NOBUF            ]                                                 24675000
                                                                        24680000
   [;EXC]                                                               24685000
   [;SHR]                                                               24690000
   [;EAR]                                                               24695000
   [;SEMI]                                                              24700000
                                                                        24705000
   [;NOLABEL]                                                           24710000
              volid                                                     24715000
   [;LABEL[=[       ][,[type][,[expdate][,[seq]]]]]]                    24720000
             "volid"                                                    24725000
                                                                        24730000
   [;FORMS=formsmsg]                                                    24735000
                                                                        24740000
   [;NOLOCK]                                                            24745000
   [;LOCK]                                                              24750000
                                                                        24755000
   [;STD]                                                               24760000
   [;MSG]                                                               24765000
   [;CIR]                                                               24770000
                                                                        24775000
   [;COPY]                                                              24780000
   [;NOCOPY]                                                            24785000
                                                                        24790000
                                                                        24795000
ACCESS PARAMETERS                                                       24800000
                                                                        24805000
NOCCTL       Indicates that carriage control characters are not being   24810000
             specified in writes to the file.  Default.                 24815000
                                                                        24820000
CCTL         Indicates that carriage control characters are being       24825000
             supplied in writes to the file.  Default is NOCCTL.        24830000
                                                                        24835000
IN           Read-access only permitted to the file. If the ACC= group  24840000
             is omitted, <IN> is the default. with the exception of     24845000
             device files that are output-only.                         24850000
                                                                        24855000
OUT          Write-access only permitted to the file.  Default is       24860000
             read-access only.                                          24865000
                                                                        24870000
OUTKEEP      Write-access only permitted to file, except that previous  24875000
             data is not deleted.  Default is read-access only.         24880000
                                                                        24885000
APPEND       Append-access only permitted to the file.  Default is      24890000
             read-access only.                                          24895000
                                                                        24900000
UPDATE       Any type of access is permitted to the file. Default is    24905000
             read-access only.                                          24910000
                                                                        24915000
INOUT        File permits input/output access.  (Any file intrinsic     24920000
             except FUPDATE can be issued against the file.)  Default is24925000
             read-access only.                                          24930000
                                                                        24935000
numbuffers   Number of buffers to be allocated for the file. This is an 24940000
             integer from 1 to 16. <numbuffers> is ignored for          24945000
             terminals.  Default is 2.                                  24950000
                                                                        24955000
NOBUF        Specifies that no buffers are allocated for the file.      24960000
                                                                        24965000
EXC          Exclusive access.  After the file is opened no other       24970000
             accessors are permitted.  When any access other than ACC=IN24975000
             is specified, this is the default.                         24980000
                                                                        24985000
SHR          Share access.  After file is opened other accessors are    24990000
             permitted.  When access ACC=IN is specified, this is the   24995000
             default.                                                   25000000
                                                                        25005000
EAR          Exclusive, allow read access.  After the file is opened    25010000
             concurrent read access is permitted other accessors,       25015000
             except for message files, where no other readers are       25020000
             allowed.                                                   25025000
                                                                        25030000
SEMI         Semi-exclusive access for message files.  Allows multiple  25035000
             readers only.                                              25040000
                                                                        25045000
NOMULTI      Prohibits sharing files in MULTI mode.  Default.           25050000
                                                                        25055000
MULTI        Concurrent accessors of the file may regard the file as if 25060000
             no buffering is taking place.  Access-control information  25065000
             is shared by the accessors within the same job or session. 25070000
                                                                        25075000
GMULTI       Concurrent global accessors of the file may regard the     25080000
             file as if no buffering is taking place.  Access-control   25085000
             information is shared by all accessors, not restricted to  25090000
             job or session tree.                                       25095000
                                                                        25100000
NOMR         Multi-record access to file is not permitted. Default.     25105000
                                                                        25110000
MR           Multi-record access to file is permitted.  Default is NOMR.25115000
                                                                        25120000
WAIT         I/O requests to the file must be complete before control is25125000
             returned to the program.  Default                          25130000
                                                                        25135000
NOWAIT       Control is returned to the program as soon as I/O requests 25140000
             are queued by MPE.  The program does not have to wait for  25145000
             the physical I/O to be complete before resuming execution. 25150000
             Default is WAIT.                                           25155000
                                                                        25160000
NOLABEL      Specifies that this is not a labeled tape.  Default.       25165000
                                                                        25170000
LABEL        Specifies that this is a labeled tape. Default             25175000
             is NOLABEL.                                                25180000
                                                                        25185000
"volid"      Up to six characters identifying a labeled magnetic tape   25190000
 volid       volume.  Optional when file opened for output; volid for   25195000
             at least first volume must be specified when file opened   25200000
             for input.                                                 25205000
                                                                        25210000
             In the unquoted form, the volume id can only contain       25215000
             alphanumeric characters.  In the quoted form, it can       25220000
             contain any printable character.  To use a quotation       25225000
             mark (") in the volid, it must be entered twice.           25230000
                                                                        25235000
type         Three characters that specify label type information, as   25240000
             follows:                                                   25245000
                                                                        25250000
             ANS - ANSI-standard label.                                 25255000
             IBM - IBM-standard label.                                  25260000
                                                                        25265000
             Default is ANS.                                            25270000
                                                                        25275000
expdate      Month/day/year, written in the format mm/dd/yy.  This      25280000
             specifies the expiration date of the file, or the date     25285000
             after which information contained in the file is no longer 25290000
             useful.  The file can be overwritten after this date.      25295000
                                                                        25300000
                                                                        25305000
             immediately.                                               25310000
                                                                        25315000
seq          Up to four numeric characters that specify the position of 25320000
             the file relative to other files on the tape, or one of the25325000
             following:                                                 25330000
                                                                        25335000
             0     - Causes a search of all volumes until the file is   25340000
                     found.                                             25345000
                                                                        25350000
             ADDF  - The tape will be positioned so as to add a new file25355000
                     on the end of the volume (or last volume in a      25360000
                     multi-volume set).  Not to be used for the first   25365000
                     file on a volume set.                              25370000
                                                                        25375000
             NEXT  - Tape will be positioned at next file on the tape.  25380000
                     If this is the first open for the file, then NEXT  25385000
                     will position the file as the first file on the    25390000
                     tape.  If this is not the first open for the file  25395000
                     and rewind occurred on the previous close, then the25400000
                     position will remain at the beginning of the       25405000
                     previous file.                                     25410000
                                                                        25415000
                     Default is NEXT.                                   25420000
                                                                        25425000
formsmsg     A forms message that can be used for such purposes as      25430000
             telling the Console Operator what type of paper to use in  25435000
             the line printer.  This message will be displayed on the   25440000
             console and must be verified by the operator before the    25445000
             user can access the file.  The message itself is a string  25450000
             of not more than 49 characters terminated with a period.   25455000
             Default is no message.                                     25460000
                                                                        25465000
NOLOCK       Unlocks a locked file.  Does not allow the file to         25470000
             be locked programmatically.  Default.                      25475000
                                                                        25480000
LOCK         Dynamically locks a file.  Permits the file to be locked   25485000
             programmatically.  Default is NOLOCK.                      25490000
                                                                        25495000
STD          Specifies a standard file type (not KSAM, RIO, MSG, or     25500000
             circular type file.)                                       25505000
                                                                        25510000
MSG          Specifies a message file type.  This allows esta-          25515000
             blishment of unidirectional, FIFO oriented files which     25520000
             allow processes to communicate with one another.           25525000
                                                                        25530000
CIR          Specifies a circular file type.  This establishes a file   25535000
             which behaves like a sequential file until it is full,     25540000
             after which writing of the next record causes the oldest   25545000
             block to be deleted.                                       25550000
                                                                        25555000
COPY         Specifies that the file, while being of non-STD type, will 25560000
             be treated as a file system sequential file.  This allows  25565000
             for nondestructive copying and replication.                25570000
                                                                        25575000
NOCOPY       This denies COPY access to a file.                         25580000
                                                                        25585000
\SUBITEM=DISP                                                           25590000
SYNTAX FOR DISPOSITION                                                  25595000
                                                                        25600000
   [;DEL ]                                                              25605000
   [;TEMP]                                                              25610000
   [;SAVE]                                                              25615000
                                                                        25620000
If none of these parameters are supplied, the disposition of the file is25625000
as it was when opened, or as specified by the close.                    25630000
                                                                        25635000
DISPOSITION PARAMETERS                                                  25640000
                                                                        25645000
DEL    The file is deleted when closed.                                 25650000
                                                                        25655000
SAVE   The file is saved in the permanent file domain when closed.      25660000
                                                                        25665000
TEMP   The file is saved in the job/session temporary domain when       25670000
       closed.                                                          25675000
                                                                        25680000
\ITEM=OPERATION                                                         25685000
OPERATION                                                               25690000
                                                                        25695000
Specifies the attributes for a file.  Used to override the              25700000
specifications given to FOPEN by a program.  The attributes of an       25705000
existing disc file or physical devices constraints cannot be overridden.25710000
The :FILE command remains in effect for entire job/session.  It is put  25715000
to use when a program or subsystem opens a file using the               25720000
<formaldesignator> specified by the :FILE command. The :FILE command can25725000
be revoked by :RESET or superceded by another :FILE command.            25730000
                                                                        25735000
\ITEM=EXAMPLE                                                           25740000
EXAMPLE                                                                 25745000
                                                                        25750000
A program references two files by the file names (<formaldesignators>)  25755000
SOURCE and DEST, but you wish to use two existing disc files INX and    25760000
OUTX as the actual files for the program.  This is done by:             25765000
                                                                        25770000
   :FILE SOURCE=INX                                                     25775000
   :FILE DEST=OUTX                                                      25780000
   :RUN MYPROG                                                          25785000
                                                                        25790000
Now you wish to run the program using input from a card reader which has25795000
80-byte records and has the device class name CARD:                     25800000
                                                                        25805000
   :FILE SOURCE,OLD;REC=-80;DEV=CARD                                    25810000
                                                                        25815000
Output is to be sent to a new file FILEX with 64-word fixed-length      25820000
records, blocked two records per block in ASCII code.  FILEX is limited 25825000
to 800 records among 10 extents, two of which are to be immediately     25830000
allocated.  The file is to be permanently saved when MYPROG closes it.  25835000
Enter:                                                                  25840000
                                                                        25845000
   :FILE DEST=FILEX,NEW;REC=64,2,F,ASCII;DISC=800,10,2;SAVE             25850000
   :RUN MYPROG                                                          25855000
                                                                        25860000
                                                                        25865000
                                                                        25870000
                                                                        25875000
\ENTRY=FOREIGN,PARMS,OPERATION,EXAMPLE                                  25880000
    :FOREIGN                                                            25885000
                                                                        25890000
Informs the system that a particular disc volume is a foreign           25895000
disc.                                                                   25900000
                                                                        25905000
SYNTAX                                                                  25910000
                                                                        25915000
   :FOREIGN ldn                                                         25920000
                                                                        25925000
\ITEM=PARMS                                                             25930000
PARAMETERS                                                              25935000
                                                                        25940000
ldn          Logical device that foreign disc volume is mounted         25945000
             on.                                                        25950000
\ITEM=OPERATION                                                         25955000
OPERATION                                                               25960000
                                                                        25965000
Forces the system to treat the volume currently mounted on              25970000
device ldn as a foreign disc volume. The ldn must be in a               25975000
foreign class, and the volume must not be in use.                       25980000
                                                                        25985000
                             NOTE                                       25990000
                                                                        25995000
                                                                        26000000
                                                                        26005000
      If a foreign disc is to be FOPENed by logical device              26010000
      number, it is necessary for the volume to be mounted              26015000
      BEFORE the FOPEN takes place.  Otherwise FOPEN will               26020000
      assume a serial disc is to be mounted by defasult.                26025000
      This problem may be avoided by opening the disc by                26030000
      class name.                                                       26035000
                                                                        26040000
\ITEM=EXAMPLE                                                           26045000
EXAMPLE                                                                 26050000
                                                                        26055000
To force the system to treat logical device 3 as a foreign              26060000
disc volume, enter:                                                     26065000
                                                                        26070000
     :FOREIGN 3                                                         26075000
                                                                        26080000
\ENTRY=FORTGO,PARMS,OPERATION,EXAMPLE                                   26085000
    :FORTGO                                                             26090000
                                                                        26095000
Compiles, prepares, and executes a FORTRAN program.                     26100000
                                                                        26105000
SYNTAX                                                                  26110000
                                                                        26115000
   :FORTGO [textfile][,[listfile][,[masterfile][,[newfile]]]]           26120000
           [;INFO=quotedstring]                                         26125000
                                                                        26130000
\ITEM=PARMS                                                             26135000
PARAMETERS                                                              26140000
                                                                        26145000
textfile     Actual designator of input file from which source program  26150000
             is read.  Can be any ASCII input file.  Formal designator  26155000
             is FTNTEXT.  Default is $STDIN.                            26160000
                                                                        26165000
listfile     Actual designator of file on which program listing is      26170000
             written.  Can be any ASCII output file. Formal designator  26175000
             is FTNLIST.  Default is $STDLIST.                          26180000
                                                                        26185000
masterfile   Actual designator of master file which is merged against   26190000
             <textfile> to produce composite source. Can be any ASCII   26195000
             input file.  Formal designator is FTNMAST.  Default is for 26200000
             no file to be read, input is read from <textfile>.         26205000
                                                                        26210000
newfile      Actual designator of merged <textfile> and <masterfile>.   26215000
             Can be any ASCII output file.  Formal designator is FTNNEW.26220000
             Default is for no file to be written.                      26225000
                                                                        26230000
quotedstring A string of ASCII characters delimited by a pair of single 26235000
             or double quotation marks.  If the delimiting character is 26240000
             to be used within the string, it can be doubled.  This     26245000
             feature is used for specifying compiler options if the     26250000
             options start with a "$".  Otherwise, the compiler will    26255000
             ignore the string.  The string, if recognized, will appear 26260000
             at the beginning of the source.  Refer to the FORTRAN      26265000
             reference manual for further information.                  26270000
                                                                        26275000
                             NOTE                                       26280000
                                                                        26285000
      The formal file designators used in this command                  26290000
      (FTNTEXT, FTNLIST, FTNMAST, FTNNEW)                               26295000
      cannot be back referenced as actual file designators              26300000
      in the command parameter list.  For further information,          26305000
      see the discussion of implied :FILE commands in                   26310000
      Section VII of the MPE Commands Reference Manual.                 26315000
                                                                        26320000
\ITEM=OPERATION                                                         26325000
OPERATION                                                               26330000
                                                                        26335000
Compiles, prepares, and allocates/executes a FORTRAN program.  If you do26340000
not specify a source file, MPE expects your input from your standard    26345000
job/session input device.  If you do not specify <listfile>, MPE writes 26350000
your listing to your standard job/session list device.  This command    26355000
creates a temporary user subprogram library (USL) file ($NEWPASS) that  26360000
cannot be accessed, and a temporary program file that can be accessed   26365000
under the name $OLDPASS.                                                26370000
                                                                        26375000
\ITEM=EXAMPLE                                                           26380000
EXAMPLE                                                                 26385000
                                                                        26390000
To compile, prepare, and execute a FORTRAN program entered from your    26395000
standard input device, with the program listing transmitted to your     26400000
standard list device, enter:                                            26405000
                                                                        26410000
    :FORTGO                                                             26415000
                                                                        26420000
To compile, prepare, and execute a FORTRAN program entered from the disc26425000
file SOURCE and transmit the resulting program listing to the disc file 26430000
LISTFL, enter:                                                          26435000
                                                                        26440000
    :FORTGO SOURCE,LISTFL                                               26445000
                                                                        26450000
                                                                        26455000
\ENTRY=FORTPREP,PARMS,OPERATION,EXAMPLE                                 26460000
    :FORTPREP                                                           26465000
                                                                        26470000
Compiles and prepares a FORTRAN program.                                26475000
                                                                        26480000
SYNTAX                                                                  26485000
                                                                        26490000
 :FORTPREP [textfile][,[progfile][,[listfile][,[masterfile][,newfile]]]]26495000
           [;INFO=quotedstring]                                         26500000
                                                                        26505000
\ITEM=PARMS                                                             26510000
PARAMETERS                                                              26515000
                                                                        26520000
textfile            Actual designator of input file from which source   26525000
                    program is read.  Can be any ASCII input file.      26530000
                    Formal designator is FTNTEXT.  Default is $STDIN.   26535000
                                                                        26540000
progfile            Actual designator of program file on which prepared 26545000
                    program segments are written.  Can be any binary    26550000
                    output file with file code of PROG or 1029.  If     26555000
                    entered, this parameter must indicate a file created26560000
                    in one of two ways:                                 26565000
                                                                        26570000
                    1.  With the MPE :BUILD command using a <filecode>  26575000
                        parameter of PROG or 1029.                      26580000
                                                                        26585000
                                     NOTE                               26590000
                                                                        26595000
                    A program file is limited to only one extent. Thus, 26600000
                    the <numextents> parameter of the :BUILD command    26605000
                    must be 1.                                          26610000
                                                                        26615000
                    2.  By specifying a non-existent file in the        26620000
                        <progfile> parameter, in which case a job/      26625000
                        session temporary file of the correct size and  26630000
                        type is created.                                26635000
                                                                        26640000
                    If no <uslfile> parameter is supplied, the USL file 26645000
                    is saved to the temporary file, $OLDPASS.           26650000
                                                                        26655000
listfile            Actual designator of file on which program listing  26660000
                    is written.  Can be any ASCII output file.  Formal  26665000
                    designator is FTNLIST. Default is $STDLIST.         26670000
                                                                        26675000
masterfile          Actual designator of master file which is merged    26680000
                    against <textfile> to produce composite source.  Can26685000
                    be any ASCII input file. Formal designator is       26690000
                    FTNMAST.  Default is master file is not read, input 26695000
                    is read from <textfile>.                            26700000
                                                                        26705000
newfile             Actual designator of merged <textfile> and          26710000
                    <masterfile>.  Can be any ASCII output file. Formal 26715000
                    designator is FTNNEW.  Default is no file is        26720000
                    written.                                            26725000
                                                                        26730000
quotedstring       A string of ASCII characters delimited by a pair of  26735000
                   single or double quotation marks.  If the delimiting 26740000
                   character is desired within the string it can be     26745000
                   doubled.  This feature is used for specifying        26750000
                   compiler options if the options start with a "$".    26755000
                   Otherwize, if recognized, will appear at the         26760000
                   beginning of the source.  Refer to the FORTRAN       26765000
                   reference manual for further information.            26770000
                                                                        26775000
                             NOTE                                       26780000
                                                                        26785000
      The formal file designators used in this command                  26790000
      (FTNTEXT, FTNPROG, FTNLIST, FTNMAST, FTNNEW)                      26795000
      cannot be back referenced as actual file designators              26800000
      in the command parameter list.  For further information,          26805000
      see the discussion of implied :FILE commands in                   26810000
      Section VII of the MPE Commands Reference Manual.                 26815000
                                                                        26820000
\ITEM=OPERATION                                                         26825000
OPERATION                                                               26830000
                                                                        26835000
Compiles and prepares a FORTRAN program onto a program file on disc. If 26840000
you do not specify a source file, MPE expects your input from your      26845000
current job/session input device.  If you create the program file prior 26850000
to compilation, you must assign a <filecode> of PROG or 1029.  If you do26855000
not specify <listfile>, MPE sends the output to your current list       26860000
device.  The user subprogram library (USL) file created during compil-  26865000
ation is a temporary file passed directly to the preparation mechanism; 26870000
you can access it under the name $OLDPASS only if the program file is   26875000
not $NEWPASS.  The program file also is opened as a temporary file.     26880000
                                                                        26885000
\ITEM=EXAMPLE                                                           26890000
EXAMPLE                                                                 26895000
                                                                        26900000
To compile and prepare a FORTRAN program entered through the current    26905000
input device, onto the file $NEWPASS, with the listing printed on the   26910000
current list device, enter:                                             26915000
                                                                        26920000
    :FORTPREP                                                           26925000
                                                                        26930000
If the next command is one to execute the program, the file $NEWPASS is 26935000
referenced in the execute command under the name $OLDPASS.              26940000
                                                                        26945000
To compile and prepare a FORTRAN source program from a source file named26950000
SFILE into a program file named MYPROG, with the resulting listing sent 26955000
to the current list device, enter:                                      26960000
                                                                        26965000
    :FORTPREP SFILE,MYPROG                                              26970000
                                                                        26975000
                                                                        26980000
\ENTRY=FORTRAN,PARMS,OPERATION,EXAMPLE                                  26985000
    :FORTRAN                                                            26990000
                                                                        26995000
Compiles a FORTRAN program.                                             27000000
                                                                        27005000
SYNTAX                                                                  27010000
                                                                        27015000
 :FORTRAN [textfile][,[uslfile][,[listfile][,[masterfile][,newfile]]]]  27020000
          [;INFO=quotedstring]                                          27025000
                                                                        27030000
\ITEM=PARMS                                                             27035000
PARAMETERS                                                              27040000
                                                                        27045000
textfile           Actual designator of input file from which source    27050000
                   program is read.  Can be any ASCII input file. Formal27055000
                   designator is FTNTEXT.  Default is $STDIN.           27060000
                                                                        27065000
uslfile            Actual designator of user subprogram library (USL)   27070000
                   file on which object program is written. Can be any  27075000
                   binary output file with <filecode> of USL or 1024.   27080000
                   Formal designator is FTNUSL.  If entered, this       27085000
                   parameter must indicate a file created previously in 27090000
                   one of four ways:                                    27095000
                                                                        27100000
                   1.  By saving a USL file (with the MPE :SAVE command)27105000
                       created by a previous compilation where the      27110000
                       default value was used for the <uslfile>         27115000
                       parameter.                                       27120000
                                                                        27125000
                   2.  By building the USL with the Segmenter -BUILDUSL 27130000
                       command.  (See the MPE Segmenter Reference       27135000
                       Manual.)                                         27140000
                                                                        27145000
                   3.  By creating a new USL file with the MPE :BUILD   27150000
                       command with a <filecode> of USL or 1024.        27155000
                                                                        27160000
                   4.  By specifying a non-existent <uslfile> parameter,27165000
                       thereby creating a permanent file of the correct 27170000
                       size and type.                                   27175000
                                                                        27180000
                    If no <uslfile> parameter is supplied, the USL file 27185000
                    is saved to the temporary file, $OLDPASS.           27190000
                                                                        27195000
listfile           Actual designator of file on which program listing is27200000
                   written.  Can be any ASCII output file.  Formal      27205000
                   designator is FTNLIST.  Default is $STDLIST.         27210000
                                                                        27215000
masterfile         Actual designator of master file which is merged     27220000
                   against <textfile> to produce composite source. Can  27225000
                   be any ASCII input file.  Formal designator is       27230000
                   FTNMAST.  Default is master file is not read, input  27235000
                   is read from <textfile>.                             27240000
                                                                        27245000
newfile            Actual designator of merged <textfile> and           27250000
                   <masterfile>.  Can be any ASCII output file. Formal  27255000
                   designator is FTNNEW.  Default is no file is written.27260000
                                                                        27265000
quotedstring       A string of ASCII characters delimited by a pair of  27270000
                   single or double quotation marks.  If the delimiting 27275000
                   character is desired within the string it can be     27280000
                   doubled.  This feature is used for specifying        27285000
                   compiler options if the options start with a "$".    27290000
                   Otherwize, if recognized, will appear at the         27295000
                   beginning of the source.  Refer to the FORTRAN       27300000
                   reference manual for further information.            27305000
                                                                        27310000
                             NOTE                                       27315000
                                                                        27320000
      The formal file designators used in this command                  27325000
      (FTNTEXT, FTNUSL, FTNLIST, FTNMAST, FTNNEW)                       27330000
      cannot be back referenced as actual file designators              27335000
      in the command parameter list.  For further information,          27340000
      see the discussion of implied :FILE commands in                   27345000
      Section VII of the MPE Commands Reference Manual.                 27350000
                                                                        27355000
\ITEM=OPERATION                                                         27360000
OPERATION                                                               27365000
                                                                        27370000
Compiles FORTRAN program onto a USL file on disc.  If you do not specify27375000
<textfile>, MPE expects your input from your current input device.  If  27380000
you create the USL prior to compilation, you must assign a <filecode> of27385000
USL or 1024.  If you do not specify <listfile>, MPE sends the listing to27390000
the current list device.                                                27395000
                                                                        27400000
\ITEM=EXAMPLE                                                           27405000
EXAMPLE                                                                 27410000
                                                                        27415000
To compile a FORTRAN program entered from your current input device into27420000
an object program in the USL file $NEWPASS, and write the listing to    27425000
your current list device, enter:                                        27430000
                                                                        27435000
    :FORTRAN                                                            27440000
                                                                        27445000
If the next command is one to prepare an object program, $NEWPASS can be27450000
passed to that command as an input file named $OLDPASS.                 27455000
                                                                        27460000
To compile a FORTRAN program residing on the disc file SOURCE into an   27465000
object program on the USL file OBJECT, with the program listing sent to 27470000
the disc file LISTFL, enter:                                            27475000
                                                                        27480000
    :BUILD OBJECT;CODE=USL                                              27485000
    :FORTRAN SOURCE,OBJECT,LISTFL                                       27490000
                                                                        27495000
                                                                        27500000
\ENTRY=FREERIN,PARMS,OPERATION,EXAMPLE                                  27505000
    :FREERIN                                                            27510000
                                                                        27515000
Releases a global Resource Identification Number (RIN).                 27520000
                                                                        27525000
SYNTAX                                                                  27530000
                                                                        27535000
    :FREERIN rin                                                        27540000
                                                                        27545000
\ITEM=PARMS                                                             27550000
PARAMETERS                                                              27555000
                                                                        27560000
rin            The RIN to be released.  Must be a number from 1 to 1024.27565000
               (REQUIRED PARAMETER)                                     27570000
                                                                        27575000
\ITEM=OPERATION                                                         27580000
OPERATION                                                               27585000
                                                                        27590000
If you have acquired a RIN with the :GETRIN command, you can release it 27595000
with the :FREERIN command.  This returns the RIN to the RIN pool managed27600000
by MPE.  (A RIN is used to manage a resource shared between two or more 27605000
jobs/sessions so that only one job/session at a time can access that    27610000
resource.)                                                              27615000
                                                                        27620000
                               NOTE                                     27625000
                                                                        27630000
    To free a RIN, you must be the original owner of that RIN --        27635000
    the user who actually issued the :GETRIN command that               27640000
    allocated the RIN and assigned it a password.                       27645000
                                                                        27650000
\ITEM=EXAMPLE                                                           27655000
EXAMPLE                                                                 27660000
                                                                        27665000
To release RIN 1, enter:                                                27670000
                                                                        27675000
    :FREERIN 1                                                          27680000
                                                                        27685000
\ENTRY=FULLBACKUP,PARMS,OPERATION,EXAMPLE                               27685010
    :FULLBACKUP (System Supervisor capability required)                 27685020
                                                                        27685030
Creates a backup of MPE and all files currently on the system and       27685040
updates the date of the last full backup (the date is used in           27685050
conjunction with the PARTBACKUP command).                               27685060
                                                                        27685070
SYNTAX                                                                  27685080
                                                                        27685090
    :FULLBACKUP [dumpfile][,auxlistfile]                                27685100
                                                                        27685110
\ITEM=PARMS                                                             27685120
PARAMETERS                                                              27685130
                                                                        27685140
dumpfile        If specified, a back reference to a previous :FILE      27685150
                command that defines the file on which the modified or  27685160
                duplicate system is to be written.  This back reference 27685170
                must indicate a magnetic tape file.  Formal designator  27685180
                is DUMPTAPE.  Use the following file statement form:    27685190
                                                                        27685200
                    FILE dumpfile[=filereference][;DEV=device]          27685210
                         [;REC=recordsize][;BUF  ]                      27685220
                                           ;NOBUF                       27685230
                                                                        27685240
                       REC      Specifies the tape record size.  May    27685250
                                be any number which is a multiple of    27685260
                                256 words between 256 and 8192 words.   27685270
                                The default for non-programmatic calls  27685280
                                to FULLBACKUP is 4096 words.  For pro-  27685290
                                grammatic calls the default is 1024     27685300
                                words.                                  27685310
                                                                        27685320
                       BUF      User specification on whether buffered  27685330
                                I/O is used to do the store.  For serial27685340
                                disc it is recommended that NOBUF is    27685350
                                used because the system automatically   27685360
                                buffers the transfer.  For tape trans-  27685370
                                fers the default of BUF should be used. 27685380
                                                                        27685390
 Note: If [dumpfile] is not specified, then the default will be used.   27685400
       The default is one of the two following:                         27685410
       If the user has a file equation with the formal file designator  27685420
       of DUMPTAPE, then it will be used.  Otherwise a file equation    27685430
       of the form FILE DUMPTAPE;DEV=TAPE will be used.                 27685440
                                                                        27685450
                                                                        27685460
                                                                        27685470
auxlistfile     Actual file designator of the output file (device) to   27685480
                which all listings requested during the execution       27685490
                of the backup process are written.  The formal file     27685500
                designator used by the :FULLBACKUP command executor for 27685510
                this file is SYSLIST; the formal file designator used by27685520
                the MPE Segmenter (when it is invoked to add or replace 27685530
                SL segments) for this file is SEGLIST.  Default is      27685540
                $STDLIST.                                               27685550
                                                                        27685560
\ITEM=OPERATION                                                         27685570
OPERATION                                                               27685580
                                                                        27685590
(System Supervisor capability required)                                 27685600
This command starts the backup process and copies MPE and all files     27685610
on the system to magnetic tape.  This is equivalent to a :SYSDUMP       27685620
with a dumpdate of 0 (zero) and a file subset of @.@.@.                 27685630
                                                                        27685640
In addition to the names of the files to be used for <dumpfile> and     27685650
<auxlistfile> output, you may specify what types of devices these files 27685660
are to reside on.  You do this by preceding the :FULLBACKUP command with27685670
MPE :FILE commands defining each of the two files.  Then, in the        27685680
:FULLBACKUP command, you precede each <filename> with an asterisk (*) to27685690
indicate a back reference to the definitions in the :FILE commands.     27685700
                                                                        27685710
\ITEM=EXAMPLE                                                           27685720
EXAMPLE                                                                 27685730
                                                                        27685740
To begin execution of the backup process, the :FULLBACKUP command is    27685750
entered.  There is no dialog, and the MPE configuration and all files   27685760
copied to the file named DUMP.  Any listings requested during the       27685770
backup are output to the file named LIST.  The first :FILE command      27685780
specifies that DUMP is a magnetic tape file; the second :FILE command   27685790
defines LIST as a line printer.  (In the :FILE commands, the TAPE and LP27685800
parameters are device class names arbitrarily defined by a user during  27685810
the previous configuration.)                                            27685820
                                                                        27685830
    :FILE DUMP;DEV=TAPE                                                 27685840
    :FILE LIST;DEV=LP                                                   27685850
    :FULLBACKUP *DUMP,*LIST                                             27685860
                                                                        27685870
The console will look like:                                             27685880
?11:08/#S278/89/LDEV# FOR "DUMP" ON TAPE (NUM)?                         27685890
                                                                        27685900
If a file equation with the formal file designator of DUMPTAPE was      27685910
previously entered during the session (ex. FILE DUMPTAPE;DEV=SYSTAPE)   27685920
then the user may omit the first parameter and the backup will go       27685930
to device class SYSTAPE.                                                27685940
                                                                        27685950
     :FULLBACKUP ,*LIST                                                 27685960
                                                                        27685970
And the console request will look like:                                 27685980
?11:08/#S278/89/LDEV# FOR "DUMPTAPE" ON SYSTAPE (NUM)?                  27685990
                                                                        27686000
If dumpfile is not specified and there is no file equation for          27686010
DUMPTAPE, then a temporary file equation (FILE DUMPTAPE;DEV=TAPE)       27686020
will be used.                                                           27686030
                                                                        27686040
     :FULLBACKUP                                                        27686050
                                                                        27686060
In this event, the console request will look like:                      27686070
?11:08/#S278/89/LDEV# FOR "DUMPTAPE" ON TAPE (LDEV)?                    27686080
                                                                        27686090
                                                                        27690000
\ENTRY=GETLOG,PARMS,OPERATION,EXAMPLE                                   27695000
:GETLOG                                                                 27700000
                                                                        27705000
Establishes a logging identifier on the system.                         27710000
                                                                        27715000
SYNTAX                                                                  27720000
                                                                        27725000
                                 ,DISC                                  27730000
     :GETLOG logid; LOG=logfile {     }[;PASS=password]                 27735000
                                 ,TAPE                                  27740000
\ITEM=PARMS                                                             27745000
PARAMETERS                                                              27750000
logid     The logging identifier to be established.  Contains           27755000
          from 1 to 8 alphanumeric characters, beginning with           27760000
          a letter. (REQUIRED PARAMETER)                                27765000
                                                                        27770000
logfile   The name of the file to receive data from the logging         27775000
          procedure.  Must be specified as residing on DISC or          27780000
          TAPE.  Contains from 1 to 8 alphanumeric characters           27785000
          beginning with a letter.  (For disc files the                 27790000
          user can specify the fully qualified file name.)              27795000
          (REQUIRED PARAMETER).                                         27800000
                                                                        27805000
password  Logging identifier password, optionally assigned by           27810000
          the creator for protection against illegal use of             27815000
          of his identifier.  Contains from 1 to 8 alphanumeric         27820000
          characters, beginning with a letter.                          27825000
                                                                        27830000
\ITEM=OPERATION                                                         27835000
OPERATION                                                               27840000
                                                                        27845000
Establishes a logging identifier on the system by entering the logid,   27850000
and the other information specified in the command, into the            27855000
directory of logging identifiers.  To access the logging system         27860000
with this identifier, the OPENLOG intrinsic must supply the             27865000
identifier and the password.  There cannot be two logid's               27870000
on the system with the same name at the same time.  The                 27875000
LISTLOG command can be used to find out what logid's                    27880000
currently exist.                                                        27885000
                                                                        27890000
\ITEM=EXAMPLE                                                           27895000
EXAMPLE                                                                 27900000
To create the logging identifier FINANCE and associate it with          27905000
the tape destination file NEWDATE, enter:                               27910000
                                                                        27915000
          :GETLOG FINANCE;LOG=NEWDATA, TAPE                             27920000
\ENTRY=GETRIN,PARMS,OPERATION,EXAMPLE                                   27925000
    :GETRIN                                                             27930000
                                                                        27935000
Acquires global Resource Identification Number (RIN) and assigns        27940000
password to it.                                                         27945000
                                                                        27950000
SYNTAX                                                                  27955000
                                                                        27960000
    :GETRIN rinpassword                                                 27965000
                                                                        27970000
\ITEM=PARMS                                                             27975000
PARAMETERS                                                              27980000
                                                                        27985000
rinpassword          Password required in the intrinsic that locks the  27990000
                     RIN.  This is a string of up to eight alphanumeric 27995000
                     characters, beginning with a letter.               28000000
                     (REQUIRED PARAMETER)                               28005000
                                                                        28010000
\ITEM=OPERATION                                                         28015000
OPERATION                                                               28020000
                                                                        28025000
Acquires a global RIN.  (A RIN is used in managing a resource shared    28030000
between two or more jobs/sessions so that only one job/session at a time28035000
can access this resource.)                                              28040000
                                                                        28045000
MPE displays the RIN on your current list device as follows:            28050000
                                                                        28055000
    RIN: <rin>                                                          28060000
                                                                        28065000
where <rin> is the RIN acquired and is a number ranging from 1 to 1024. 28070000
                                                                        28075000
Users who know the RIN and its password can use the RIN in jobs until   28080000
the user who acquired the RIN releases it with the :FREERIN command.    28085000
The RIN acquired always is a positive integer unique within MPE.  The   28090000
total number of RIN's that MPE can allocate is specified when the system28095000
is configured, and in no case can exceed 1024.                          28100000
                                                                        28105000
\ITEM=EXAMPLE                                                           28110000
EXAMPLE                                                                 28115000
                                                                        28120000
To acquire a global RIN and assign to it the password MYRIN, enter:     28125000
                                                                        28130000
    :GETRIN MYRIN                                                       28135000
                                                                        28140000
MPE responds with the RIN number assigned, as for example:              28145000
                                                                        28150000
    RIN: 1                                                              28155000
                                                                        28160000
                                                                        28165000
\ENTRY=GIVE,PARMS,OPERATION,EXAMPLE                                     28170000
     :GIVE                                                              28175000
                                                                        28180000
Assigns a :DOWNed device to diagnostics.                                28185000
                                                                        28190000
SYNTAX                                                                  28195000
                                                                        28200000
     :GIVE ldn                                                          28205000
                                                                        28210000
\ITEM=PARMS                                                             28215000
PARAMETERS                                                              28220000
                                                                        28225000
ldn          The logical device number.                                 28230000
                                                                        28235000
\ITEM=OPERATION                                                         28240000
OPERATION                                                               28245000
                                                                        28250000
This command is currently not required by the HP 3000 diagnostics       28255000
operating under MPE IV.                                                 28260000
                                                                        28265000
\ITEM=EXAMPLE                                                           28270000
EXAMPLES                                                                28275000
                                                                        28280000
To assign a :DOWNed device with logical device number 35 to diag-       28285000
nostics enter:                                                          28290000
                                                                        28295000
     :DOWN 35                                                           28300000
     :GIVE 35                                                           28305000
     :UP 35                                                             28310000
     11:20/3/LDEV#35 IN USE BY DIAGNOSTICS                              28315000
                                                                        28320000
To assign a spooled job-accepting card reader to diagnostics enter:     28325000
                                                                        28330000
     :STOPSPOOL 5                                                       28335000
     11:16/31/SP#5/STOPPED                                              28340000
     11:16/31/LDEV#5 NOT READY                                          28345000
     :REFUSE 5                                                          28350000
     :ABORTIO 5                                                         28355000
     11:16/3/LDEV#5 NO I/O PENDING                                      28360000
     :DOWN 5                                                            28365000
     :GIVE 5                                                            28370000
     :UP 5                                                              28375000
     11:16/3/LDEV#5 IN USE BY DIAGNOSTICS                               28380000
                                                                        28385000
\ENTRY=HEADOFF,PARMS,OPERATION,EXAMPLE                                  28390000
     :HEADOFF                                                           28395000
                                                                        28400000
Stops HEADER/TRAILER output to a device.                                28405000
                                                                        28410000
SYNTAX                                                                  28415000
                                                                        28420000
     :HEADOFF ldn                                                       28425000
                                                                        28430000
\ITEM=PARMS                                                             28435000
PARAMETERS                                                              28440000
                                                                        28445000
ldn          The logical device number.                                 28450000
                                                                        28455000
\ITEM=OPERATION                                                         28460000
OPERATION                                                               28465000
                                                                        28470000
If the device is in use and a HEADER has already printed, the request   28475000
will be satisfied after the associated TRAILER is printed.              28480000
                                                                        28485000
\ITEM=EXAMPLE                                                           28490000
EXAMPLES                                                                28495000
                                                                        28500000
To stop HEADER/TRAILER output to logical device 6, enter:               28505000
                                                                        28510000
     :HEADOFF 6                                                         28515000
                                                                        28520000
\ENTRY=HEADON,PARMS,OPERATION,EXAMPLE                                   28525000
     :HEADON                                                            28530000
                                                                        28535000
Resumes HEADER/TRAILER output to device.                                28540000
                                                                        28545000
SYNTAX                                                                  28550000
                                                                        28555000
     :HEADON ldn                                                        28560000
                                                                        28565000
\ITEM=PARMS                                                             28570000
PARAMETERS                                                              28575000
                                                                        28580000
ldn          The logical device number.                                 28585000
                                                                        28590000
\ITEM=OPERATION                                                         28595000
OPERATION                                                               28600000
                                                                        28605000
If the device is in use, the request will be satisfied after the        28610000
current output is completed.  HEADON is enabled on all cold loads.      28615000
                                                                        28620000
When the header/trailer facility is enabled, and output is directed     28625000
to a card punch, MPE automatically punches a header card and a          28630000
trailer card identifying the job that produced the file; if output      28635000
is directed to a line printer, MPE automatically prints header and      28640000
trailer pages identifying the job that produced the file.               28645000
                                                                        28650000
\ITEM=EXAMPLE                                                           28655000
EXAMPLES                                                                28660000
                                                                        28665000
To resume HEADER/TRAILER output to logical device number 6, enter:      28670000
                                                                        28675000
     :HEADON 6                                                          28680000
                                                                        28685000
\ENTRY=HELLO,PARMS,OPERATION,EXAMPLE                                    28690000
    :HELLO                                                              28695000
                                                                        28700000
Initiates an interactive session.                                       28705000
                                                                        28710000
SYNTAX                                                                  28715000
                                                                        28720000
    :HELLO [sessionname,]username[/userpass].acctname[/acctpass]        28725000
           [,groupname[/grouppass]]                                     28730000
                                                                        28735000
           [;TERM=termtype]                                             28740000
           [;TIME=cpusecs]                                              28745000
                                                                        28750000
                   BS                                                   28755000
                   CS                                                   28760000
           [;PRI={    }]                                                28765000
                   DS                                                   28770000
                   ES                                                   28775000
                                                                        28780000
            ;INPRI=inputpriority                                        28785000
           [                     ]                                      28790000
            ;HIPRI                                                      28795000
                                                                        28800000
\ITEM=PARMS                                                             28805000
PARAMETERS                                                              28810000
                                                                        28815000
sessionname         Arbitrary name used in conjunction with <username>  28820000
                    and <acctname> parameters to form a session         28825000
                    identity.  Contains from 1 to 8 alphanumeric        28830000
                    characters, beginning with a letter.  Default is no 28835000
                    session name is assigned.                           28840000
                                                                        28845000
username            A user name, established by Account Manager, that   28850000
                    allows you to log on under this account. Contains   28855000
                    from 1 to 8 alphanumeric characters, beginning with 28860000
                    a letter.  (REQUIRED PARAMETER)                     28865000
                                                                        28870000
userpass            User password, optionally assigned by Account       28875000
                    Manager.  Contains from 1 to 8 alphanumeric         28880000
                    characters, beginning with a letter.                28885000
                                                                        28890000
acctname            Name of account, as established by Account Manager. 28895000
                    Contains from 1 to 8 alphanumeric characters,       28900000
                    beginning with a letter.  The <acctname> parameter  28905000
                    must be preceded by a period. (REQUIRED PARAMETER)  28910000
                                                                        28915000
acctpass            Account password, optionally assigned by System     28920000
                    Manger.  Contains from 1 to 8 alphanumeric          28925000
                    characters, beginning with a letter.                28930000
                                                                        28935000
groupname           Name of group to be used for local file domain and  28940000
                    CPU time charges.  Established by Account Manager.  28945000
                    Contains from 1 to 8 alphanumeric characters,       28950000
                    beginning with a letter.  Default is your home group28955000
                    if you are assigned one by Account Manager.         28960000
                    (Optional if you have a home group, required if home28965000
                    group not assigned.)                                28970000
                                                                        28975000
grouppass           (Required if assigned and you are logging on under  28980000
                     other than home group.  Not required if logging on 28985000
                     under home group.)                                 28990000
                                                                        28995000
                    Group password, optionally assigned by Account      29000000
                    Manager.  Contains from 1 to 8 alphanumeric         29005000
                    characters, beginning with a letter.                29010000
                                                                        29015000
 termtype           Type of terminal used for input.  MPE uses this     29020000
                    parameter to determine device-dependent             29025000
                    characteristics such as delay factors for carriage  29030000
                    returns.  Must be a number from 0 to 15, as follows:29035000
                                                                        29040000
                    0   HP 2749B EIA-compatible HP 2749B (10 characters 29045000
                        per second (cps)).                              29050000
                                                                        29055000
                    1   ASR 37 EIA compatible (10 cps).                 29060000
                                                                        29065000
                    2   ASR 35 EIA compatible (10 cps).                 29070000
                                                                        29075000
                    3   Execuport 300 Data Communication Transceiver    29080000
                        Terminal (10, 15, 30 cps).                      29085000
                                                                        29090000
                    4   HP 2600A or Datapoint 3300 (10-240 cps).        29095000
                                                                        29100000
                    5   Memorex 1240 (10, 15, 30, 60 cps).              29105000
                                                                        29110000
                    6   GE Terminet 300 or 1200, or Data Communication  29115000
                        Terminal, Model B (10, 15, 30, or 120 cps).     29120000
                                                                        29125000
                    9   HP 2615A (Beehive MiniBee) (10-240 cps).        29130000
                                                                        29135000
                   10   HP 2640A/B, HP 2641A, HP 2644A, or HP 2645A.    29140000
                        Character mode or full program control of block 29145000
                        mode transmission (10-240 cps).                 29150000
                                                                        29155000
                   11   HP 2640A/B, HP 2641A, HP 2644A, or HP 2645A.    29160000
                        Allows user to use block mode without program   29165000
                        control of block mode transmission.  Requires   29170000
                        user to position cursor before pressing ENTER.  29175000
                        Recommended for speeds exceeding 30 cps when    29180000
                        you expect to switch between character mode and 29185000
                        block/line mode.  May not be used in block/page 29190000
                        mode (10-240 cps).                              29195000
                                                                        29200000
                   12   HP 2645K  Katakana/Roman Data Terminal.         29205000
                                                                        29210000
                   13   Message switching network or other computer.    29215000
                                                                        29220000
                   14   Multi-Point Terminal.                           29225000
                                                                        29230000
                   15   HP 2635A Printing Terminal.  8-bit protocol     29235000
                        (for second character set).                     29240000
                                                                        29245000
                   16   HP 2635A Printing Terminal.  7-bit protocol     29250000
                        (standard character set).                       29255000
                                                                        29260000
                   Default:  For hardwired terminals, determined by     29265000
                   System Supervisor during system configuration.  No   29270000
                   default for terminals that are not hard wired.       29275000
                                                                        29280000
                   Required parameter to insure correct listings if your29285000
                   terminal is not hardwired or if your terminal is not 29290000
                   the default termtype.                                29295000
                                       NOTE                             29300000
                                                                        29305000
                   On Series 33, only term types 4, 6, 9, 10, 11        29310000
                   12, 15, and 16 may be used.  Any attempt to use      29315000
                   terminal types other than the above may result       29320000
                   in system failure.                                   29325000
                                                                        29330000
                                                                        29335000
cpusecs            Maximum CPU time that session can use, entered in    29340000
                   seconds.  When limit is reached, session is aborted. 29345000
                   Must be a value from 1 to 32767.  To specify no      29350000
                   limit, enter question mark (?) or UNLIM, or omit     29355000
                   parameter.  Default is no limit.                     29360000
                                                                        29365000
BS, CS, DS, ES     Execution priority class. BS is highest priority, ES 29370000
                   is lowest. If you specify a priority that exceeds the29375000
                   highest permitted for your account or user name by   29380000
                   the system, MPE assigns the highest priority possible29385000
                   below BS.  Default is CS.                            29390000
                                                                        29395000
                                       NOTE                             29400000
                                                                        29405000
                   DS and ES are used primarily for batch jobs; their   29410000
                   use for sessions is discouraged.                     29415000
                                                                        29420000
inputpriority      Relative input priority used in checking against     29425000
                   access restrictions imposed by the <jobfence>, if one29430000
                   exists.  Takes effect at logon time.  Must be a      29435000
                   value from 1 (lowest priority) to 13 (highest        29440000
                   priority).  If a value is specified that is less than29445000
                   or equal to current <jobfence> set by Console        29450000
                   Operator, session is denied access. Default is 8.    29455000
                                                                        29460000
HIPRI              Request for maximum session-selection input priority,29465000
                   causing session to be scheduled regardless of current29470000
                   <jobfence> or execution limit for sessions.  This    29475000
                   parameter can be specified only by users with System 29480000
                   Manager or System Supervisor capability.  Default is 29485000
                   the current <jobfence> and execution limit.          29490000
                                                                        29495000
\ITEM=OPERATION                                                         29500000
OPERATION                                                               29505000
                                                                        29510000
Initiates an interactive session.  MPE prompts with colon when it is    29515000
ready to accept commands.  :HELLO command must be entered from a        29520000
terminal, no other device can be used for this command.                 29525000
                                                                        29530000
If passwords are omitted, MPE prompts for each one individually.        29535000
When MPE initiates the session, it displays HP3000, the MPE             29540000
version, and the date and time, then prompts for commands with          29545000
a colon as follows:                                                     29550000
                                                                        29555000
     :HELLO ED.MPE                                                      29560000
     HP3000 / MPE IV C.00.00.  TUE, APR 10, 1979, 12:15 PM              29565000
                                                                        29570000
                                                                        29575000
\ITEM=EXAMPLE                                                           29580000
EXAMPLE                                                                 29585000
                                                                        29590000
To start a session named ALPHA, with the username MAC, accountname      29595000
TECHPUBS, group XGROUP, grouppass XPASS, enter:                         29600000
                                                                        29605000
    :HELLO ALPHA,MAC.TECHPUBS,XGROUP/XPASS                              29610000
                                                                        29615000
    HP3000 / MPE IV C.00.00.  FRI, APR  6, 1979,  9:11 AM               29620000
                                                                        29625000
    :    (MPE displays colon to prompt for command)                     29630000
                                                                        29635000
                                                                        29640000
                       NOTE                                             29645000
When the :HELLO command is issued from a session it will not            29650000
start another session if:                                               29655000
1)  Spaces precede the command.                                         29660000
2)  The command is executed using a :REDO command.                      29665000
3)  The command is issued in a user defined command (UDC).              29670000
                                                                        29675000
                                                                        29680000
\ENTRY=HELP,PARMS,OPERATION,EXAMPLE                                     29685000
    :HELP                                                               29690000
                                                                        29695000
Accesses the Help subsystem.                                            29700000
                                                                        29705000
SYNTAX                                                                  29710000
                                                                        29715000
    :HELP [HELP              ]                                          29720000
          [tablecontents     ]                                          29725000
          [command[,keyword] ]                                          29730000
          [ALL               ]                                          29735000
          [EXIT              ]                                          29740000
                                                                        29745000
\ITEM=PARMS                                                             29750000
PARAMETERS                                                              29755000
                                                                        29760000
HELP            Displays information for the HELP command.  Treated     29765000
                the same as entering :HELP with any other command       29770000
                (because HELP is a command).                            29775000
                                                                        29780000
tablecontents   Any of several items for which information may be       29785000
                obtained.  These items are:                             29790000
                                                                        29795000
                  SESSIONS                                              29800000
                  JOBS                                                  29805000
                  PROGRAMS                                              29810000
                  FILES                                                 29815000
                  MANAGE                                                29820000
                  OPERATOR                                              29825000
                  SPOOLER                                               29830000
                  UTILITY                                               29835000
                                                                        29840000
                Thus, if you want information on running sessions, you  29845000
                would enter:                                            29850000
                                                                        29855000
                  :HELP SESSIONS                                        29860000
                                                                        29865000
command         Any MPE command.  MPE displays the command name and     29870000
                syntax.  In addition, a list of keywords for that       29875000
                command is displayed.  Keywords for all commands except 29880000
                the :FILE command are:                                  29885000
                                                                        29890000
                  PARMS                                                 29895000
                  OPERATION                                             29900000
                  EXAMPLE                                               29905000
                                                                        29910000
                where                                                   29915000
                                                                        29920000
                  PARMS       lists all parameters of the specified     29925000
                              command.                                  29930000
                                                                        29935000
                  OPERATION   describes the use of the specified        29940000
                              command.                                  29945000
                                                                        29950000
                  EXAMPLE     displays an example showing usage of the  29955000
                              specified command.                        29960000
                                                                        29965000
                  The :FILE command has the additional keywords:        29970000
                                                                        29975000
                  NAME                                                  29980000
                  DEVICE                                                29985000
                  ACCESS                                                29990000
                  DISP                                                  29995000
                                                                        30000000
                  Entering :HELP command,ALL causes MPE to display all  30005000
                  information for that command (syntax, parameters,     30010000
                  operation, and example).                              30015000
                                                                        30020000
keyword           One of the keywords described under the command       30025000
                  parameter.  The keyword parameter can be entered      30030000
                  with a command, as in :HELP HELLO,PARMS.  In this     30035000
                  case, PARMS is a keyword and must be separated from   30040000
                  the command with a comma.  The keyword parameter also 30045000
                  can be entered alone if you are running the Help      30050000
                  subsystem in "subsystem" mode and have accessed       30055000
                  a command, then received the prompt (>) from Help.    30060000
                                                                        30065000
                  For example,                                          30070000
                                                                        30075000
                  :HELP DEBUG                                           30080000
                                                                        30085000
                      :DEBUG (Privileged Mode capability required)      30090000
                                                                        30095000
                  Invokes the Debug facility.                           30100000
                                                                        30105000
                  SYNTAX                                                30110000
                                                                        30115000
                     :DEBUG                                             30120000
                                                                        30125000
                  KEYWORDS: PARMS, OPERATION                            30130000
                                                                        30135000
                  >PARMS  (keyword entered by itself in response to     30140000
                           prompt)                                      30145000
                                                                        30150000
                                                                        30155000
ALL               Displays entire table of contents for :HELP command.  30160000
                  If entered with a command, as in                      30165000
                                                                        30170000
                      :HELP SPL,ALL                                     30175000
                                                                        30180000
                  displays all information for that command.            30185000
                                                                        30190000
EXIT              Exits Help subsystem.                                 30195000
                                                                        30200000
\ITEM=OPERATION                                                         30205000
OPERATION                                                               30210000
                                                                        30215000
The :HELP command accesses the Help subsystem.  If entered with no      30220000
parameters, as in                                                       30225000
                                                                        30230000
    :HELP                                                               30235000
                                                                        30240000
Help enters the "subsystem" mode, displays a table of contents, a       30245000
"greater than" (>) prompt, and awaits your input.  Entering any table   30250000
of contents item such as SESSIONS produces a listing of all the commands30255000
used in running sessions.  Entering any command name produces the syntax30260000
for that command and a list of keywords.  Entering a keyword, such as   30265000
PARMS produces a listing of all items for that keyword (all parameters  30270000
in this case).  Entering EXIT or pressing the BREAK key terminates the  30275000
Help subsystem.  Entering Control Y stops the display.  Entering Control30280000
S stops the display and entering Control Q resumes the display (useful  30285000
if the screen is full if using a CRT terminal).                         30290000
                                                                        30295000
Entering carriage return in "subsystem" mode causes MPE to display      30300000
information up to the next keyword or command.  For example, after      30305000
entering STORE, MPE displays STORE syntax, the leyword list (PARMS,     30310000
OPERATION, EXAMPLE) and prompts (>).  Entering carriage return again    30315000
causes MPE to display all PARMS information for the :STORE command.     30320000
Entering carriage return once more (after the prompt) causes MPE to     30325000
display all OPERATION information for the :STORE command, and so on.    30330000
(This is similar to page turning through a manual.)                     30335000
                                                                        30340000
Entering :HELP with a parameter causes Help to enter the "immediate"    30345000
mode.  Information pertaining to that parameter is displayed            30350000
immediately.  For example,                                              30355000
                                                                        30360000
    :HELP DEBUG                                                         30365000
                                                                        30370000
causes Help to display:                                                 30375000
                                                                        30380000
    :DEBUG (Privileged Mode capability required)                        30385000
                                                                        30390000
Invokes the MPE Debug facility.                                         30395000
                                                                        30400000
SYNTAX                                                                  30405000
                                                                        30410000
    :DEBUG                                                              30415000
                                                                        30420000
KEYWORDS: PARMS, OPERATION                                              30425000
                                                                        30430000
\ITEM=EXAMPLE                                                           30435000
EXAMPLE                                                                 30440000
                                                                        30445000
To obtain information concerning MPE utility functions, enter:          30450000
                                                                        30455000
    :HELP UTILITY                                                       30460000
                                                                        30465000
\ENTRY=IF,PARMS,OPERATION,EXAMPLE                                       30470000
    :IF                                                                 30475000
                                                                        30480000
Used to control the execution sequence of a job.                        30485000
                                                                        30490000
SYNTAX                                                                  30495000
                                                                        30500000
    :IF [(]logexpr[)] THEN                                              30505000
         .                                                              30510000
         .                                                              30515000
         .                                                              30520000
    ELSE                                                                30525000
         .                                                              30530000
         .                                                              30535000
         .                                                              30540000
    ENDIF                                                               30545000
                                                                        30550000
\ITEM=PARMS                                                             30555000
PARAMETERS                                                              30560000
                                                                        30565000
logexpr       Logical expression, consisting of relational operators or 30570000
              combinations of relational operators.  The relational     30575000
              operators allowed are:                                    30580000
                                                                        30585000
               >   greater than                                         30590000
               <   less than                                            30595000
               >=  greater than or equal                                30600000
               <=  less than or equal                                   30605000
               =   equal                                                30610000
               <>  not equal                                            30615000
                                                                        30620000
               Compound logical expressions can be formed using the AND,30625000
               OR, and NOT logical operators and nesting with           30630000
               parentheses.                                             30635000
                                                                        30640000
               The allowed operands are JCW or CIERROR; any Job Control 30645000
               Word values saved in a name with the :SETJCW command; OK,30650000
               WARN, FATAL, or SYSTEM (as defined under the :SETJCW     30655000
               command); or integer constants.                          30660000
                                                                        30665000
\ITEM=OPERATION                                                         30670000
OPERATION                                                               30675000
                                                                        30680000
This statement is a block IF, used with an :ENDIF statement and,        30685000
optionally, an :ELSE statement to control the execution of a job.  An IF30690000
block consists of all the commands after the IF up to, but not          30695000
including, the next :ELSE or :ENDIF statement that has the same nesting 30700000
level as the IF statement.  Another similar block can follow the :ELSE  30705000
statement.  Nesting of blocks is allowed to any level.  The :ENDIF      30710000
statement ends the IF block.                                            30715000
                                                                        30720000
The logical expression is evaluated and, if true, the IF block is       30725000
executed; if false, the ELSE block (if one exists) is executed.         30730000
                                                                        30735000
\ITEM=EXAMPLE                                                           30740000
EXAMPLE                                                                 30745000
                                                                        30750000
    :RUN UPDATE1               (Run first data base update)             30755000
    :IF JCW<WARN THEN          (Continue if OK so far)                  30760000
    :  SETJCW UPDATE1JCW:=JCW  (Save that return code)                  30765000
    :  RUN UPDATE2             (Run second data base update)            30770000
    :  IF JCW<WARN THEN        (Continue if still OK)                   30775000
    :    SETJCW UPDATE2JCW:=JCW    (Save the second return code)        30780000
    :    RUN DBSTATUS              (Report current status of DB)        30785000
    :    IF (UPDATE1JCW < 50) AND (UPDATE2JCW < 50) THEN                30790000
    :      RUN DAILYRPT                                                 30795000
    :    ENDIF                                                          30800000
    :    IF ((UPDATE1JCW = 1) OR (UPDATE2JCW =1)) THEN                  30805000
    :      RUN WEEKLYRPT                                                30810000
    :    ENDIF                                                          30815000
    :  ELSE           (Second update program failed)                    30820000
    :    RUN FIXUP    (Repair data base and report)                     30825000
    :  ENDIF                                                            30830000
    :ENDIF                                                              30835000
\ENTRY=IMF,PARMS,OPERATION,EXAMPLE                                      30840000
    :IMF                                                                30845000
                                                                        30850000
A terminal user to whom the IMF manager has allowed access              30855000
in the configuration file can use this command to start the             30860000
IMF Pass - Thru Mode (PTM).                                             30865000
                                                                        30870000
SYNTAX                                                                  30875000
                   {0}                                                  30880000
                   {1}                       {1}                        30885000
    IMF [E[NHANCE]={2}][;B[LANKS]][;F[ORMAT]={2}]                       30890000
                   {3}                       {3}                        30895000
                                             {4}                        30900000
        [;P[RIORITY]={ 1}]                                              30905000
                     { 2}                                               30910000
                     { 3}                                               30915000
                     { 4}                                               30920000
                     { 5}                                               30925000
                     { 6}                                               30930000
                     { 7}                                               30935000
                     { 8}                                               30940000
                     { 9}                                               30945000
                     {10}                                               30950000
                     {11}                                               30955000
                     {12}                                               30960000
                     {13}                                               30965000
                                                                        30970000
\ITEM=PARMS                                                             30975000
PARAMETERS                                                              30980000
                                                                        30985000
ENHANCE            This parameter is optional.  If not provided,        30990000
                   HP 264x terminal will display 3270 normal            30995000
                   intensity characters as 264x half-bright             31000000
                   characters, and 3270 enhanced characters as          31005000
                   264x full-bright (normal) characters.  Taking        31010000
                   option "0" will bring the same result as not         31015000
                   using ENHANCE at all.                                31020000
                   The 2626A terminal does not support the              31025000
                   half-bright feature.                                 31030000
                                                                        31035000
                   This table shows the display enhancements            31040000
                   provided by options 0,1,2, and 3:                    31045000
                                                                        31050000
                                                                        31055000
                   Option         3270 Normal         3270 High         31060000
                                   Intensity          Intensity         31065000
                                                                        31070000
                     0            264X/262X Half      264X/262X         31075000
                                  Bright or 2626A     Normal            31080000
                                  Normal                                31085000
                                                                        31090000
                     1            264X/262X Normal    264X/262X         31095000
                                                      Underline         31100000
                                                                        31105000
                     2            264X/262X Normal    264X/262X         31110000
                                                      Normal            31115000
                                                                        31120000
                     3            264X/262X Inverse   264X/262X         31125000
                                  Video               Normal            31130000
                                                                        31135000
                                                                        31140000
BLANKS             This parameter is optional.  If not provided,        31145000
                   PTM will convert leading blank input                 31150000
                   characters  in an unprotected field into             31155000
                   "nulls". If the parameter is provided, PTM           31160000
                   will not convert leading blanks into "nulls"         31165000
                   thus transmitting the field to the host with         31170000
                   leading blanks undisturbed.  This parameter          31175000
                   may be used to right-justify numeric input           31180000
                   data.  Embedded blanks are always treated as blanks  31185000
                   and trailing blanks are always treated as nulls.     31190000
FORMAT             This parameter is optional. Parameter                31195000
                   controls the format used for the PRINT               31200000
                   key (f7). The values mean:                           31205000
                                                                        31210000
                     1 -  print the internal screen image               31215000
                          in debug format whenever the                  31220000
                          PRINT (f7) key is pressed.                    31225000
                                                                        31230000
                     2 -  print the internal screen image               31235000
                          in clean format (*local print*)               31240000
                          when the PRINT key is pressed.                31245000
                          This is the default value.                    31250000
                                                                        31255000
                     3 -  do a continuous print of the                  31260000
                          internal screen image in debug                31265000
                          format. This print is started when            31270000
                          the print key is pressed and then             31275000
                          continues automatically until the             31280000
                          Pass Thru Sessions is ended. The              31285000
                          internal screen image is printed              31290000
                          each time Pass Thru Mode issues               31295000
                          a TRAN3270 or RECV3270 for this               31300000
                          terminal.                                     31305000
                                                                        31310000
                     4 -  do a continous print in clean                 31315000
                          format (local print), printing                31320000
                          once for every TRAN3270 or RECV 3270          31325000
                          issued by Pass Thru Mode for this             31330000
                          terminal. This printout is started            31335000
                          by pressing the PRINT key and                 31340000
                          continues until Pass Thru ends on             31345000
                          this terminal.                                31350000
                                                                        31355000
                     The debug format prints 2 screen images            31360000
                     per page to the spool file LOGIMF.                 31365000
                     Debug format includes a border labeling            31370000
                     the rows and the columns, overprints to            31375000
                     indicate attribute characters and distin-          31380000
                     guishes nulls from blanks by the use of            31385000
                     a ~ character. The clean (local print)             31390000
                     format prints one screen image per page,           31395000
                     without borders and prints the screen              31400000
                     exactly as the user sees it at the                 31405000
                     terminal.                                          31410000
                                                                        31415000
PRIORITY             This parameter is optional. It indicates           31420000
                     the MPE spool file priority desired for            31425000
                     the PRINT output spool file LOGIMF. The            31430000
                     default value is 8.                                31435000
                                                                        31440000
                                                                        31445000
\ITEM=OPERATION                                                         31450000
OPERATION                                                               31455000
                                                                        31460000
The IMF command is used by the terminal user to start the               31465000
operation of PTM at his terminal.  He responds to IMF prompts           31470000
to name a configuration file and a specific IBM device number for       31475000
emulation.                                                              31480000
                                                                        31485000
\ITEM=EXAMPLE                                                           31490000
EXAMPLE                                                                 31495000
                                                                        31500000
In the following example, the user wishes to have inverse video         31505000
displayed on his 264x terminal for 3270 high intensity characters       31510000
and wants leading blanks to be left as blanks.                          31515000
                                                                        31520000
    :IMF ENHANCE=2; BLANKS                                              31525000
    HP32229A.01.00 DSN/IMF (c) HEWLETT-PACKARD 1981                     31530000
    CONFIGURATION FILE NAME?  REMOTE1.PUB.SYS                           31535000
    DEVICE NUMBER? 26                                                   31540000
                                                                        31545000
REMOTE1 names a configuration file that defines a 3270 control          31550000
unit with attached terminals and printers.  DEVICE NUMBER 26            31555000
specifies which of the devices attached to the 3270 control             31560000
unit the user's terminal should emulate.                                31565000
                                                                        31570000
                                                                        31575000
                                                                        31580000
\ENTRY=IMFCONTROL,PARMS,OPERATION,EXAMPLE                               31585000
    :IMFCONTROL                                                         31590000
                                                                        31595000
                                                                        31600000
This command may be used by the console operator or any user            31605000
empowered thru the MPE ALLOW command to use it.  IMFCONTROL             31610000
is used to initiate IMF interaction with a host system, to shut         31615000
down the DSN/IMF subsystem, and to activate the CS/3000 trace           31620000
facility.                                                               31625000
                                                                        31630000
SYNTAX                                                                  31635000
                                                                        31640000
                                                                        31645000
                  {START configfilename [;TRACE ON [parmlist]] }        31650000
                  {STOP configfilename}                                 31655000
     :IMFCONTROL  {KILL configfilename}                                 31660000
                  {TRACE configfilename ON [parmlist] }                 31665000
                  {TRACE configfilename OFF}                            31670000
                                                                        31675000
     parmlist has the format:                                           31680000
                                                                        31685000
     [,[ALL] [,[mask] [,[numentries] [,[WRAP] [,filename]]]]]           31690000
                                                                        31695000
\ITEM=PARMS                                                             31700000
PARAMETERS                                                              31705000
                                                                        31710000
START              Used to initiate communications to the host          31715000
                   system.                                              31720000
                                                                        31725000
STOP               Used to initiate an orderly subsystem                31730000
                   shutdown.                                            31735000
                                                                        31740000
KILL               Disconnects the HP 3000 from a host system           31745000
                   without an orderly subsystem shutdown.  Normally,    31750000
                   used only in emergencies.                            31755000
                                                                        31760000
TRACE ON           Used to start the CS/3000 Trace troubleshoot-        31765000
                   ing facility.  Normally Trace is used only on        31770000
                   request from an HP representative.                   31775000
                                                                        31780000
TRACE OFF          Used to stop the Trace facility.                     31785000
                                                                        31790000
                   Names a particular IMF configuration file for        31795000
                   subsequent DSN/IMF communication activity.           31800000
                   The file defines the characteristics of the          31805000
                   IBM control unit IMF emulates, plus its              31810000
                   attached display stations and printers.  It          31815000
                   also defines the HP 3000 programs/users,             31820000
                   terminals, and printers that may conduct             31825000
                   DSN/IMF activity.                                    31830000
                                                                        31835000
ALL                generates a record of all line activity.             31840000
                   Within IMF, this parameter is not                    31845000
                   user selectable. IMF will always trace all of        31850000
                   the line activity.                                   31855000
                                                                        31860000
mask               is an octal number preceded by a percent             31865000
                   symbol, that specifices the type of events to        31870000
                   trace (refer to the following table).  The CS        31875000
                   default is %37; the largest recommended mask for     31880000
                   IMF is %277.                                         31885000
                                                                        31890000
                   bit                 meaning when ON                  31895000
                                                                        31900000
                    0 (leftmost)  IMF Control Unit STN entries          31905000
                                  (BSC only)                            31910000
                    1             INP IC entries (interconnect)         31915000
                    2             IMF protocol driver STN entries       31920000
                                  (BSC or SDLC)                         31925000
                    3             OPR entries (default=ON)              31930000
                    4             RCT entries (default=ON)              31935000
                    5             RTX entries (default=ON)              31940000
                    6             SCT,POL,SEL entries                   31945000
                                  (default=ON)                          31950000
                    7 (rightmost) STX entries (default=ON)              31955000
                                                                        31960000
                   not used by IMF, and value input will be             31965000
                   ignored.  IMF will produce 14 or 15 entries          31970000
                   per trace record.                                    31975000
                                                                        31980000
WRAP               causes trace entries that overflow the trace         31985000
                   record (greater than numentries) to overlay          31990000
                   the prior trace entries.  If omitted, overflow       31995000
                   entries are discarded. WRAP is recommended for       32000000
                   IMF.  This parameter refers to each record but       32005000
                   not to the file itself.  If the file                 32010000
                   overflows, CS will automatically start at the        32015000
                   beginning of the file and all previous data          32020000
                   will be lost.                                        32025000
                                                                        32030000
filename           is the name of the file where the trace              32035000
                   records are stored.  If omitted, the facility        32040000
                   will create a file in PUB.SYS with the name          32045000
                   CSTRACE.   If you specify a file within a            32050000
                   group and account other than PUB.SYS then that       32055000
                   file must already exist in order for the CS          32060000
                   trace facility to be able to open that file.         32065000
                                                                        32070000
                                                                        32075000
\ITEM=OPERATION                                                         32080000
OPERATION                                                               32085000
                                                                        32090000
This command may be used by the console operator or any user            32095000
empowered thru the MPE ALLOW command to use it. IMFCONTROL              32100000
is used to initiate IMF interaction with a host system, to shut         32105000
down the DSN/IMF subsystem, and to activate the CS/3000 trace           32110000
facility.                                                               32115000
                                                                        32120000
\ITEM=EXAMPLE                                                           32125000
EXAMPLE                                                                 32130000
                                                                        32135000
IMFCONTROL START MARKET.PUB.SYS;TRACE ON,,%245,,WRAP                    32140000
                                                                        32145000
In this example, IMF communication with the host is being               32150000
initiated using configuration file MARKET in the PUB group              32155000
of the SYS account.  The Trace facility has been turned on              32160000
with a mask of %245 and the instruction to overlay overflow             32165000
records on previous records.  The trace results will be                 32170000
written to the default file CSTRACE.PUB.SYS.                            32175000
                                                                        32180000
\ENTRY=IMFMGR,PARMS,OPERATION,EXAMPLE                                   32185000
    :IMFMGR (Requires OP capability.)                                   32190000
                                                                        32195000
Starts the interactive IMF Manager's Program.                           32200000
                                                                        32205000
SYNTAX                                                                  32210000
                                                                        32215000
    :IMFMGR                                                             32220000
                                                                        32225000
\ITEM=PARMS                                                             32230000
PARAMETERS                                                              32235000
                                                                        32240000
None.                                                                   32245000
                                                                        32250000
\ITEM=OPERATION                                                         32255000
OPERATION                                                               32260000
                                                                        32265000
(OP capability required.)                                               32270000
                                                                        32275000
This command starts the IMF Manager's Program, which                    32280000
makes available the IMF command that are used to                        32285000
verify IMF configuration files, display the names of IMF                32290000
configuration files and devices in use, start and stop the              32295000
Pass Thru Mode (PTM) on selected HP3000 terminals and                   32300000
printers, start and stop communications with one or more host           32305000
systems, and turn the CS/3000 Trace utility on and off.                 32310000
                                                                        32315000
After you type IMFMGR, you will be prompted with a ">" (rivet).         32320000
You may then type HELP to receive information about specific            32325000
manager commands.                                                       32330000
                                                                        32335000
\ITEM=EXAMPLE                                                           32340000
EXAMPLE                                                                 32345000
                                                                        32350000
To initiate the IMF Manager's Program, type:                            32355000
:IMFMGR                                                                 32360000
\ENTRY=IML                                                              32365000
                                                                        32370000
   The IML command has been replaced with the IMF command.              32375000
                                                                        32380000
\ENTRY=IMLCONTROL                                                       32385000
                                                                        32390000
   The IMLCONTROL command has been replaced with the IMFCONTROL         32395000
   command.                                                             32400000
                                                                        32405000
\ENTRY=IMLMGR                                                           32410000
                                                                        32415000
   The IMLMGR command has been replaced with the IMFMGR command.        32420000
                                                                        32425000
\ENTRY=JOB,PARMS,OPERATION,EXAMPLE                                      32430000
    :JOB                                                                32435000
                                                                        32440000
Initiates a batch job.                                                  32445000
                                                                        32450000
SYNTAX                                                                  32455000
                                                                        32460000
    :JOB  [jobname,]username[/userpass].acctname[/acctpass]             32465000
          [,groupname[/grouppass]]                                      32470000
                                                                        32475000
          [;TIME=cpusecs]                                               32480000
                                                                        32485000
                  BS                                                    32490000
                  CS                                                    32495000
          [;PRI={    }]                                                 32500000
                  DS                                                    32505000
                  ES                                                    32510000
                                                                        32515000
           ;INPRI=inputpriority                                         32520000
          [                     ]                                       32525000
           ;HIPRI                                                       32530000
                                                                        32535000
          [;RESTART]                                                    32540000
          [;OUTCLASS=[device][,outputpriority][,numcopies]]]            32545000
                                                                        32550000
\ITEM=PARMS                                                             32555000
PARAMETERS                                                              32560000
                                                                        32565000
jobname            Arbitrary name used with <username> and <acctname>   32570000
                   parameters to form a job identity. Contains from 1   32575000
                   to 8 alphanumeric characters, beginning with a       32580000
                   letter.  Default is no job name is assigned.         32585000
                                                                        32590000
username           User name, established by the Account Manager.       32595000
                   Contains from 1 to 8 alphanumeric characters,        32600000
                   beginning with a letter.  (REQUIRED PARAMETER)       32605000
                                                                        32610000
userpass           User password, optionally assigned by Account        32615000
                   Manager.  Contains from 1 to 8 alphanumeric          32620000
                   characters, beginning with a letter.                 32625000
                                                                        32630000
acctname           Account name, established by System Manager.         32635000
                   Contains from 1 to 8 alphanumeric characters,        32640000
                   beginning with a letter.  The <acctname> parameter   32645000
                   must be preceded by a period. (REQUIRED PARAMETER)   32650000
                                                                        32655000
acctpass           Account password, optionally assigned by System      32660000
                   Manager.  Contains from 1 to 8 alphanumeric          32665000
                   characters, beginning with a letter.                 32670000
                                                                        32675000
groupname          (Optional if home group assigned, required if not.)  32680000
                                                                        32685000
                   Name of group used for local file domain and for CPU 32690000
                   time charges, as established by Account Manager.     32695000
                   Contains from 1 to 8 alphanumeric characters,        32700000
                   beginning with a letter.  Default is home group if   32705000
                   one is assigned.                                     32710000
                                                                        32715000
grouppass          (Optional parameter if accessing MPE under home      32720000
                    group; required parameter if assigned and accessing 32725000
                    MPE under other than home group)                    32730000
                                                                        32735000
                   Group password, optionally assigned by Account       32740000
                   Manager.  Contains from 1 to 8 alphanumeric          32745000
                   characters, beginning with a letter.                 32750000
                                                                        32755000
cpusecs            Maximum CPU time allowed job, in seconds.  When this 32760000
                   limit is reached, job is aborted.  Must be value from32765000
                   1 to 32767.  To specify no limit, enter question mark32770000
                   or omit this limit. Default is no limit.             32775000
                                                                        32780000
BS,CS,DS,ES        Execution priority class. BS is highest priority, ES 32785000
                   is lowest. If a priority is specified that exceeds   32790000
                   the highest permitted for the account or user name by32795000
                   the system, MPE assigns the highest priority possible32800000
                   below BS.  Default is DS, unless CS is specified by  32805000
                   System Supervisor with the :JOBPRI command.          32810000
                                                                        32815000
inputpriority      Relative input priority used in checking against     32820000
                   access restrictions imposed by <jobfence> (if one    32825000
                   exists).  Takes effect when job is entered.  Must be 32830000
                   value from 1 (lowest priority) to 13 (highest        32835000
                   priority).  If value is less than or equal to        32840000
                   <jobfence> set by Console Operator, job is deferred. 32845000
                   Default is 8.                                        32850000
                                                                        32855000
HIPRI              Request for maximum input priority, causing job to be32860000
                   scheduled regardless of current <jobfence> or        32865000
                   execution limit for jobs.  Over rides                32870000
                   <inputpriority>.  You can specify this parameter only32875000
                   if you have System Manager or System Supervisor      32880000
                   capability.  Default is 8 or <inputpriority> if this 32885000
                   parameter is specified.                              32890000
                                                                        32895000
RESTART            Request to restart a spooled job interrupted by      32900000
                   system termination/restart.  Takes effect            32905000
                   automatically when system is subsequently restarted  32910000
                   with the WARMSTART option.                           32915000
                                                                        32920000
                   This parameter applies only to jobs initiated on     32925000
                   spooled input devices, and is ignored for other jobs.32930000
                   Default is spooled jobs are not restarted after      32935000
                   system termination/restart.                          32940000
                                                                        32945000
device             Class name or logical device number of device to     32950000
                   receive listing output.  Cannot specify a magnetic   32955000
                   tape unit.  Default is $STDLIST.                     32960000
                                                                        32965000
                                       NOTE                             32970000
                                                                        32975000
                   Non-sharable device (ND) file access attribute       32980000
                   is required in order to use this parameter.          32985000
                                                                        32990000
outputpriority     Output priority for job list file, if destined for   32995000
                   spooled line printer or card punch.  Used to select  33000000
                   next spooled devicefile (on disc) for output, among  33005000
                   all those contending for a specific printer or punch.33010000
                   Must be a value from 1 (lowest priority) to 13       33015000
                   (highest priority).  Note that when <outputpriority> 33020000
                   is 1, output always is deferred. Thus, you should use33025000
                   an <outputpriority> of 2 or greater if you wish      33030000
                   output written from disc.                            33035000
                                                                        33040000
                   This parameter applies only to output destined for   33045000
                   spooled output devices, and is ignored for other     33050000
                   output.  Default is 8 if logging enabled, 13 if      33055000
                   logging disabled.                                    33060000
                                                                        33065000
numcopies          Number of copies of job listing to be produced. This 33070000
                   parameter applies only when listing is directed to a 33075000
                   spooled device, and is ignored in other cases.  Must 33080000
                   be a value from 1 to 255. Default is 1.              33085000
                                                                        33090000
\ITEM=OPERATION                                                         33095000
OPERATION                                                               33100000
                                                                        33105000
Initiates a batch job by establishing contact with MPE.  When MPE begins33110000
the job, it displays the following information on the list device:      33115000
                                                                        33120000
    PRIORITY - (BS, CS, DS, or ES)                                      33125000
    INPRI                                                               33130000
    JOB NUMBER - as assigned by MPE to identify job.                    33135000
    date and time                                                       33140000
    HP3000 and the MPE Version level, in the form HP3000 / MPE IV       33145000
    v.uu.ff, where v is the version level (a letter), uu is the         33150000
    update level (a number), and ff is the fix level (a number).        33155000
                                                                        33160000
\ITEM=EXAMPLE                                                           33165000
EXAMPLE                                                                 33170000
                                                                        33175000
To start a job named BETA, username MAC, accountname TECHPUBS, groupname33180000
XGROUP, and grouppas XPASS, enter:                                      33185000
                                                                        33190000
    :JOB BETA,MAC.TECHPUBS,XGROUP/XPASS                                 33195000
                                                                        33200000
     PRIORITY=ES;  INPRI=8                                              33205000
     JOB NUMBER= #J1                                                    33210000
     WED, DEC 28, 1977, 1:59 PM                                         33215000
     HP3000 / MPE IV C.00.00                                            33220000
                                                                        33225000
Note that subsequent MPE commands must begin with a colon (:), entered  33230000
in column 1 of the input record.                                        33235000
                                                                        33240000
                                                                        33245000
\ENTRY=JOBFENCE,PARMS,OPERATION,EXAMPLE                                 33250000
    :JOBFENCE                                                           33255000
                                                                        33260000
Defines acceptable input priorities.                                    33265000
                                                                        33270000
SYNTAX                                                                  33275000
                                                                        33280000
     :JOBFENCE priorityfence                                            33285000
                                                                        33290000
\ITEM=PARMS                                                             33295000
PARAMETERS                                                              33300000
                                                                        33305000
priorityfence           A number between 0 and 14, inclusive            33310000
                        (large is more limiting).                       33315000
                                                                        33320000
\ITEM=OPERATION                                                         33325000
OPERATION                                                               33330000
                                                                        33335000
Jobs/sessions with inputpriority less than or equal to the              33340000
priority fence will not be considered for dispatching until             33345000
their input priority is raised (see :ALTJOB command) or the             33350000
jobfence is lowered.  The exception is the use of HIPRI by              33355000
System Managers and System Supervisors in JOB or HELLO                  33360000
commands.  HIPRI overrides any JOBFENCE setting.                        33365000
                                                                        33370000
\ITEM=EXAMPLE                                                           33375000
EXAMPLES                                                                33380000
                                                                        33385000
To set the jobfence to 14 (to defer all non-HIPRI jobs and              33390000
session), then return the jobfence to 0 (to allow the waiting           33395000
jobs to log on), enter:                                                 33400000
      :JOBFENCE 14                                                      33405000
       16:17/#S26/26/LOGON FOR:  MANAGER.SYS ON LDEV #20                33410000
       16:18/#J7/34/DEFERRED JOB INTRODUCED ON LDEV #10                 33415000
       16:18/#J8/35/DEFERRED JOB INTRODUCED ON LDEV #10                 33420000
      :SHOWJOB                                                          33425000
                                                                        33430000
 JOBNUM STATE IPRI  JIN  JLIST  INTRODUCED  JOB NAME                    33435000
                                                                        33440000
  #S26   EXEC       20    20    THU 4:17P   MANAGER.SYS                 33445000
  #J7    WAIT  D 8  10S   12    THU 4:18P   JOB1,FIELD SUPPORT          33450000
  #J8    WAIT  D 8  10S   12    THU 4:18P   JOB2,FIELD.SUPPORT          33455000
                                                                        33460000
  3 JOBS:                                                               33465000
      0 INTRO                                                           33470000
      2 WAIT; INCL 2 DEFERRED                                           33475000
      1 EXEC; INCL 1 SESSIONS                                           33480000
      0 SUSP                                                            33485000
  JOBFENCE= 14; JLIMIT= 5; SLMIT=16                                     33490000
                                                                        33495000
  :JOBFENCE 0                                                           33500000
  16:21/#J7/34/LOGON FOR:  JOB1,FIELD.SUPPORT ON LDEV#10                33505000
  16:21/#J8/35/LOGON FOR:  JOB2,FIELD.SUPPORT ON LDEV#l0                33510000
                                                                        33515000
                                                                        33520000
\ENTRY=JOBPRI,PARMS,OPERATION,EXAMPLE                                   33525000
    :JOBPRI (System Supervisor capability required)                     33530000
                                                                        33535000
Sets or changes the default execution priority for batch jobs and sets a33540000
maximum execution priority for both jobs and sessions.                  33545000
                                                                        33550000
SYNTAX                                                                  33555000
                                                                        33560000
    :JOBPRI [maxsubqueue][,defaultsubqueue]                             33565000
                                                                        33570000
\ITEM=PARMS                                                             33575000
PARAMETERS                                                              33580000
                                                                        33585000
maxsubqueue            The maximum priority at which batch jobs will be 33590000
                       allowed to run.  This is in spite of any job     33595000
                       priority a user may have requested on his :JOB   33600000
                       command.  This parameter may be ES, DS, CS, or 0.33605000
                       If 0 is specified, no limit is imposed on batch  33610000
                       jobs.  Default is DS.                            33615000
                                                                        33620000
defaultsubqueue        The default execution priority for batch jobs,   33625000
                       which may be ES, DS, or CS.  This takes effect if33630000
                       a user does not specify an execution priority on 33635000
                       his :JOB command.  Default is no change in       33640000
                       execution default.                               33645000
                                                                        33650000
\ITEM=OPERATION                                                         33655000
OPERATION                                                               33660000
                                                                        33665000
(System Supervisor capability required)                                 33670000
This command changes the default execution priority for batch jobs and  33675000
sets a maximum execution priority for both jobs and sessions.  The      33680000
<maxsubqueue> parameter takes precedence over the <defaultsubqueue>     33685000
parameter.  That is, if the default parameter is greater than the       33690000
maximum priority parameter, jobs will be initiated with the maximum     33695000
priority parameter.                                                     33700000
                                                                        33705000
\ITEM=EXAMPLE                                                           33710000
EXAMPLE                                                                 33715000
                                                                        33720000
To raise the maximum execution priority so that batch jobs can run in   33725000
any subqueue requested, enter:                                          33730000
                                                                        33735000
    :JOBPRI 0                                                           33740000
                                                                        33745000
                                                                        33750000
                                                                        33755000
\ENTRY=JOBSECURITY,PARMS,OPERATION,EXAMPLE                              33760000
     :JOBSECURITY                                                       33765000
                                                                        33770000
Controls jobs being run and the resources they require.                 33775000
                                                                        33780000
SYNTAX                                                                  33785000
                                                                        33790000
                  {HIGH}                                                33795000
     :JOBSECURITY {    }                                                33800000
                  {LOW }                                                33805000
                                                                        33810000
\ITEM=PARMS                                                             33815000
PARAMETERS                                                              33820000
                                                                        33825000
HIGH          Provides only the master operator with access to job      33830000
              control commands.                                         33835000
                                                                        33840000
LOW           Allows individual users to exercise control of            33845000
              their own jobs.                                           33850000
                                                                        33855000
\ITEM=OPERATION                                                         33860000
OPERATION                                                               33865000
                                                                        33870000
The HIGH parameter controls the security level by not allowing          33875000
the user to use the :ABORTJOB, :ALTJOB, :BREAKJOB, or :RESUMEJOB        33880000
commands on his own job; while the LOW parameter controls the           33885000
security level by allowing the user to use these commands on his        33890000
own or other's jobs with the appropriate capability.                    33895000
                                                                        33900000
The user's own jobs are jobs which match the user and account           33905000
names unless the user has account manager (AM) capability, in           33910000
which case only the account names must be the same.                     33915000
                                                                        33920000
\ITEM=EXAMPLE                                                           33925000
EXAMPLES                                                                33930000
                                                                        33935000
To give a user the capability to abort, alter, break, or resume         33940000
a job, enter:                                                           33945000
                                                                        33950000
     :JOBSECURITY LOW                                                   33955000
                                                                        33960000
\ENTRY=LDISMOUNT,PARMS,OPERATION,EXAMPLE                                33965000
     :LDISMOUNT                                                         33970000
                                                                        33975000
Logically dismounts a private volume set or class, thus making          33980000
it inaccessible to users.                                               33985000
                                                                        33990000
SYNTAX                                                                  33995000
                                                                        34000000
                {*      }                                               34005000
     :LDISMOUNT {       }.group.account                                 34010000
                {vcsname}                                               34015000
                                                                        34020000
\ITEM=PARMS                                                             34025000
PARAMETERS                                                              34030000
                                                                        34035000
*                 Specifies that the home volume set of the named       34040000
                  group and account is to be dismounted.                34045000
                                                                        34050000
vcsname           Volume class/set name, requests dismount of the       34055000
                  named private volume set.                             34060000
                                                                        34065000
group.account     Specifies the group and account under which the       34070000
                  volume set was created.                               34075000
                                                                        34080000
\ITEM=OPERATION                                                         34085000
OPERATION                                                               34090000
                                                                        34095000
Only discs in the non-system domain can be dismounted.                  34100000
                                                                        34105000
The command tells MPE that the specified set or class is no longer      34110000
needed and that member volumes should be logically dismounted, as       34115000
a unit, from the drive (or drives) on which they reside.                34120000
                                                                        34125000
If users are accessing files on the specified volume set/class,         34130000
your command remains in the pending state until after the last          34135000
user closes the file; then it executes.                                 34140000
                                                                        34145000
If the volume set/class specified in the command was not previously     34150000
mounted with a corresponding :LMOUNT command, you receive an            34155000
error message.                                                          34160000
                                                                        34165000
\ITEM=EXAMPLE                                                           34170000
EXAMPLES                                                                34175000
                                                                        34180000
To dismount a private volume set named DATABASE which was created in    34185000
the PAYROLL group of the ACCTNG account, enter:                         34190000
                                                                        34195000
     :LDISMOUNT DATABASE.PAYROLL.ACCTNG                                 34200000
                                                                        34205000
                                                                        34210000
                                                                        34215000
\ENTRY=LIMIT,PARMS,OPERATION,EXAMPLE                                    34220000
     :LIMIT                                                             34225000
                                                                        34230000
Limits the number of concurrently running jobs/sessions.                34235000
                                                                        34240000
SYNTAX                                                                  34245000
                                                                        34250000
             :LIMIT {[numberjobs] [numbersessions]}                     34255000
                                                                        34260000
                                                                        34265000
\ITEM=PARMS                                                             34270000
PARAMETERS                                                              34275000
                                                                        34280000
numberjobs         The number of jobs.                                  34285000
                                                                        34290000
numbersessions     The number of sessions.                              34295000
                                                                        34300000
\ITEM=OPERATION                                                         34305000
OPERATION                                                               34310000
                                                                        34315000
No new jobs or sessions (except HIPRI ones, specified by System         34320000
Managers and System Supervisors only) will be dispatched that would     34325000
cause either of these limits to be exceeded.  Note that jobs/sessions   34330000
can still be introduced when the limit is achieved, although only       34335000
HIPRI jobs/sessions can enter the executing state.  Note also that      34340000
the specified limits may be exceeded at the time the command is         34345000
issued.  Jobs/sessions executing at the time the command is issued      34350000
will continue to execute; however, no new jobs/sessions will be         34355000
allowed to enter the executing state.                                   34360000
                                                                        34365000
At least one parameter must be included in the :LIMIT command.          34370000
Omission of the other parameter (either numberjobs or numbersessions)   34375000
leaves the corresponding current limit unchanged.  These limits are     34380000
established initially as system creation.  The latest limits are        34385000
retained for WARMSTART but the values established at system creation    34390000
take effect for all other cold loads.                                   34395000
                                                                        34400000
\ITEM=EXAMPLE                                                           34405000
EXAMPLES                                                                34410000
                                                                        34415000
To limit the number of jobs to 2 and the number of sessions to 15,      34420000
enter:                                                                  34425000
                                                                        34430000
     :LIMIT 2,15                                                        34435000
     :SHOWJOB                                                           34440000
     NO SUCH JOB(S)                                                     34445000
     JOBFENCE=  0;  JLIMIT= 2;  SLIMIT= 15                              34450000
                                                                        34455000
                                                                        34460000
\ENTRY=LINKCONTROL,PARMS,OPERATION,EXAMPLE                              34465000
LINKCONTROL linkname ; TRACE=ON [trace options]                         34470000
                       TRACE=OFF                                        34475000
                                                                        34480000
trace options  ::=  [,[ALL][,[mask][,[numentries][,[WRAP]               34485000
                             [,filename]]]]]                            34490000
                                                                        34495000
                                                                        34500000
                                                                        34505000
This command will activate or deactivate link level tracing on a        34510000
specified communications line.  The link must already have been         34515000
started by a data communications subsystem prior to using this          34520000
command.                                                                34525000
                                                                        34530000
                                                                        34535000
\ITEM=PARMS                                                             34540000
PARAMETERS                                                              34545000
                                                                        34550000
linkname            An ASCII symbolic name up to eight bytes in         34555000
                    length specifying the link configuration            34560000
                    entry of an active data communications line.        34565000
                    This name must start with an alphabetic and         34570000
                    contain only alphanumeric characters.               34575000
                                                                        34580000
TRACE=ON            Activates the TRACE facility to provide a           34585000
                    record of communications activities.                34590000
                                                                        34595000
mask                An octal number preceded by a percent sign          34600000
                    (%nn). Used to select type of trace entries         34605000
                    generated.  Refer to Communications Handbook        34610000
                    for an explanation of the mask bits.                34615000
                    Default: %37 (all except PSTN).                     34620000
                                                                        34625000
WRAP                If used, any trace entries that overflow the        34630000
                    internal trace buffering will overlay prior         34635000
                    entries at the beginning of the buffer.  WRAP       34640000
                    is supported as a feature which is dependent        34645000
                    on a specific communications device and has         34650000
                    no relation to the "wrapping" of data onto a        34655000
                    disc file.  Default: Any overflow entries are       34660000
                    discarded.                                          34665000
                                                                        34670000
filename            A MPE file name to hold the trace output that       34675000
                    must conform to standard MPE file conventions.      34680000
                    Default: LINKTxxx.PUB.SYS. ( xxx is the             34685000
                    logical device number of the link dev.)             34690000
                                                                        34695000
ALL                 If used, trace records are generated for all        34700000
                    line activity.  Default: Records are written        34705000
                    only for transmission errors.                       34710000
                                                                        34715000
numentries          Decimal integer for the maximum number of           34720000
                    entries in a trace record, not greater than         34725000
                    255.  This parameter will be converted to the       34730000
                    next highest multiple of 8 if not a multiple.       34735000
                    Default: 24 entries per record.                     34740000
                                                                        34745000
TRACE=OFF           Deactivates the TRACE facility so that no           34750000
                    records are kept of link actions, states,           34755000
                    and events.  Also closes the trace file.            34760000
                                                                        34765000
                                                                        34770000
\ITEM=OPERATION                                                         34775000
OPERATION                                                               34780000
                                                                        34785000
Unless LINKCONTROL is issued from the system master console, this       34790000
command requires the user to have NM capability.  In addition, no       34795000
user except for one at the system console may use the LINKCONTROL       34800000
command unless access has also been granted via an ALLOW command.       34805000
                                                                        34810000
When the trace facility is activated, the trace file opened will        34815000
default to LINKTxxx.PUB.SYS, unless otherwise specified via the         34820000
FILENAME option of the trace options.  The trace file resides in        34825000
PUB.SYS if specified but not qualified.  If the file previously         34830000
exists and the old trace entries per record are not equal to the        34835000
requested trace entries per record, the old file is purged and a        34840000
new, permanent file with the same record limit and maximum number       34845000
of extents as the old file is created.  If the NUMENTRIES option        34850000
is not specified, the file will be created to contain 24 trace          34855000
entries per record.                                                     34860000
                                                                        34865000
If the contents of a trace file need to be retained, they must be       34870000
copied to a new file, or the file must be renamed prior to the          34875000
reactivation of link trace when the same filename is to be used.        34880000
                                                                        34885000
                                                                        34890000
\ITEM=EXAMPLE                                                           34895000
EXAMPLE                                                                 34900000
                                                                        34905000
To activate trace on a link named DATALINK that will trace all          34910000
line activity, write records to TRACEDAT.PUB.SYS and wrap trace         34915000
entries to the beginning of the internal trace buffer on the            34920000
communications device should an overflow occur, enter:                  34925000
                                                                        34930000
:LINKCONTROL DATALINK;TRACE=ON,ALL,,,WRAP,TRACEDAT.PUB.SYS              34935000
                                                                        34940000
                                                                        34945000
To deactivate trace on a link named PHONELNK, enter:                    34950000
                                                                        34955000
:LINKCONTROL PHONELNK;TRACE=OFF                                         34960000
                                                                        34965000
\ENTRY=LISTACCT,PARMS,OPERATION,EXAMPLE                                 34970000
    :LISTACCT (System Manager or Account Manager capability required)   34975000
                                                                        34980000
Lists the attributes for one account (Account Manager capability) or all34985000
accounts (System Manager capability).                                   34990000
                                                                        34995000
SYNTAX                                                                  35000000
                                                                        35005000
    :LISTACCT [acctset][,listfile]                                      35010000
                                                                        35015000
\ITEM=PARMS                                                             35020000
PARAMETERS                                                              35025000
                                                                        35030000
acctset        Specifies the set of accounts to be listed.  This        35035000
               parameter can be entered in one of the following         35040000
               formats:                                                 35045000
                                                                        35050000
acctdesig      (Required parameter for Account Managers, optional       35055000
                parameter for System Manager)                           35060000
                                                                        35065000
               The name of the account whose attributes are to be       35070000
               listed.  Account Managers can specify only their own     35075000
               account.  Default is attributes of all accounts are      35080000
               listed.                                                  35085000
                                                                        35090000
                                    NOTE                                35095000
                                                                        35100000
               The characters @, #, and ? can be used as "wild card"    35105000
               characters in the acctset parameter.  These wild card    35110000
               characters have the following meanings:                  35115000
                                                                        35120000
               @ -- specifies zero or more alphanumeric characters.     35125000
                                                                        35130000
               # -- specifies one numeric character.                    35135000
                                                                        35140000
               ? -- specifies one alphanumeric character.               35145000
                                                                        35150000
               The characters can be used as follows:                   35155000
                                                                        35160000
               n@      List all accounts starting with the character n. 35165000
                                                                        35170000
               @n      List all accounts ending with the character n.   35175000
                                                                        35180000
               n@x     List all accounts starting with the character n  35185000
                       and ending with the character x.                 35190000
                                                                        35195000
               n##..#  List all accounts starting with the character n  35200000
                       followed by up to seven digits.                  35205000
                                                                        35210000
               ?n@     List all accounts whose second character is n.   35215000
                                                                        35220000
               n?      List all two-character accounts starting with    35225000
                       the character n.                                 35230000
                                                                        35235000
               ?n      List all two-character accounts ending with the  35240000
                       character n.                                     35245000
                                                                        35250000
listfile       Actual designator of file on which the attribute listing 35255000
               is produced.  This file is closed with SAVE disposition. 35260000
               Default is $STDLIST.                                     35265000
                                                                        35270000
\ITEM=OPERATION                                                         35275000
OPERATION                                                               35280000
                                                                        35285000
(Account Manager or System Manager capability required)                 35290000
This command lists the attributes for one account (Account Manager      35295000
capability) or all accounts (System Manager capability).  Private volume35300000
information (volume set names) also is listed.  The volume sets need not35305000
be mounted for this information to be listed.                           35310000
                                                                        35315000
\ITEM=EXAMPLE                                                           35320000
EXAMPLE                                                                 35325000
                                                                        35330000
To list the attributes of his own account, the Account Manager user     35335000
enters:                                                                 35340000
                                                                        35345000
    :LISTACCT MYACCT                                                    35350000
                                                                        35355000
                                                                        35360000
\ENTRY=LISTEQ,PARMS,OPERATION,EXAMPLE                                   35365000
:LISTEQ                                                                 35370000
                                                                        35375000
Displays file equations created with the :FILE command.                 35380000
                                                                        35385000
SYNTAX                                                                  35390000
                                                                        35395000
     :LISTEQ [listfile]                                                 35400000
                                                                        35405000
\ITEM=PARMS                                                             35410000
PARAMETERS                                                              35415000
                                                                        35420000
listfile    Name of an output file to which the file equations are      35425000
            written.  When specified, a new ASCII file with variable    35430000
            length records closed in permement domain, user-supplied    35435000
            carriage control (CCTL), OUT access mode, and EXC (exclusive35440000
            access) option.                                             35445000
            back-referenced file.  Default is $STDLIST.                 35450000
                                                                        35455000
            This parameter may also be a back-referenced file.          35460000
                                                                        35465000
            Default is $STDLIST.                                        35470000
                                                                        35475000
\ITEM=OPERATION                                                         35480000
OPERATION                                                               35485000
                                                                        35490000
Displays the descriptions of all file equations active in a job or      35495000
session.                                                                35500000
                                                                        35505000
The :LISTEQ command allows the user to specify a listfile to which the  35510000
the output is written.  The listfile may by specified fully qualified , 35515000
or it may be back-referenced.                                           35520000
                                                                        35525000
\ITEM=EXAMPLE                                                           35530000
EXAMPLE                                                                 35535000
                                                                        35540000
To list all of the file equations thus-far created, enter:              35545000
                                                                        35550000
        :LISTEQ                                                         35555000
                                                                        35560000
                                                                        35565000
To list all of the file equations thus-far created to a file, enter:    35570000
                                                                        35575000
        :LISTEQ FEQFILE                                                 35580000
                                                                        35585000
              or                                                        35590000
                                                                        35595000
        :FILE LP1;DEV=6                                                 35600000
        :LISTEQ *LP1                                                    35605000
                                                                        35610000
\ENTRY=LISTF,PARMS,OPERATION,EXAMPLE                                    35615000
    :LISTF                                                              35620000
                                                                        35625000
Lists descriptions of one or more permanent disc files.                 35630000
                                                                        35635000
SYNTAX                                                                  35640000
                                                                        35645000
                      0                                                 35650000
                      1                                                 35655000
    :LISTF [fileset][,  ][;listfile]                                    35660000
                      2                                                 35665000
                     -1                                                 35670000
                                                                        35675000
\ITEM=PARMS                                                             35680000
PARAMETERS                                                              35685000
                                                                        35690000
fileset                Specifies the set of files to be listed.  Default35695000
                       is @.  This parameter is of the form:            35700000
                                                                        35705000
         filedesignator[.groupdesignator[.acctdesignator]]              35710000
                                                                        35715000
                       Fileset can be entered in any of the             35720000
                       following formats and may use wild card          35725000
                       characters, in any order, as replacements.       35730000
                                                                        35735000
file.group.account     List file named in specified group and account.  35740000
                                                                        35745000
file.group             List file named in specified group.              35750000
                                                                        35755000
file                   List file named.                                 35760000
                                                                        35765000
@.group.account        List all files in specified group and account.   35770000
                                                                        35775000
@.@.account            List all files in all groups in specified        35780000
                       account.                                         35785000
                                                                        35790000
@.@.@                  List all files in system.                        35795000
                                                                        35800000
@.@                    List all files in all groups in logon account.   35805000
                                                                        35810000
@                      List all files in logon group.  Default.         35815000
                                                                        35820000
@.group                List all files in specified group.               35825000
                                                                        35830000
file.@.account         List specified file in any group of              35835000
                       specified account.                               35840000
                                                                        35845000
                                           NOTE                         35850000
                                                                        35855000
              The characters @, #, and ? can be used as "wild card"     35860000
              characters in the fileset parameter.  These wild card     35865000
              characters have the following meanings:                   35870000
                                                                        35875000
              @ -- specifies zero or more alphanumeric characters.      35880000
                                                                        35885000
              # -- specifies one numeric character.                     35890000
                                                                        35895000
              ? -- specifies one alphanumeric character.                35900000
                                                                        35905000
              The characters can be used as follows:                    35910000
                                                                        35915000
              n@      List all files starting with the character n.     35920000
                                                                        35925000
              @n      List all files ending with the character n.       35930000
                                                                        35935000
              n@x     List all files starting with the character n      35940000
                      and ending with the character x.                  35945000
                                                                        35950000
              n##..#  List all files starting with the character n      35955000
                      followed by up to seven digits (useful for        35960000
                      listing all EDIT/3000 temporary files).           35965000
                                                                        35970000
              ?n@     List all files whose second character is n.       35975000
                                                                        35980000
              n?      List all two-character files starting with the    35985000
                      character n.                                      35990000
                                                                        35995000
              ?n      List all two-character files ending with the      36000000
                      character n.                                      36005000
                                                                        36010000
0                      Display file name only.  Default.                36015000
                                                                        36020000
1                      Display file name, plus file code, record size (W36025000
                       indicates words, B indicates bytes), record      36030000
                       format (F, U, or V), whether ASCII (A) or binary 36035000
                       (B) records, R for relative I/O files,           36040000
                       whether carriage-control option is taken         36045000
                       (c if so), current end-of-file location, and     36050000
                       maximum number of records allowed in file.       36055000
                       Default is 0.                                    36060000
                                                                        36065000
2                      Display file name, file code, record size (W     36070000
                       indicates words, B indicates bytes), record      36075000
                       format (F, U, or V), whether ASCII (A) or binary 36080000
                       (B) records, whether carr- iage-control option is36085000
                       taken (C if so), current end-of-file location,   36090000
                       maximum number of records allowed in file,       36095000
                       blocking factor, number of disc sectors in use   36100000
                       (including those in use for file label and user  36105000
                       headers), number of extents currently allocated, 36110000
                       and maximum number of extents allowed.  Default  36115000
                       is 0.                                            36120000
                                                                        36125000
-1                     Display octal listing of file label.  This option36130000
                       can be requested only by users with System       36135000
                       Manager capability (all files) or Account Manager36140000
                       capability (all files in own account).  Default  36145000
                       is 0.  The first line of the listing is the      36150000
                       directory entry for the file being listed.       36155000
                       The remainder of the listing is the file         36160000
                       label.                                           36165000
                                                                        36170000
listfile               Name of output file on which descriptions are    36175000
                       written.  Automatically specified as new ASCII   36180000
                       file with variable-length records, user-supplied 36185000
                       carriage-control characters (CCTL), OUT access   36190000
                       mode, and EXC (exclusive access) option.  All    36195000
                       other characteristics are same as :FILE command  36200000
                       default specifications. Default is $STDLIST.     36205000
                                                                        36210000
                                         NOTE                           36215000
                                                                        36220000
                       If you specify the -1 option and direct          36225000
                       listing output to a non-spooled device           36230000
                       (such as a magnetic tape unit) that enters       36235000
                       the NOT READY state, the System Directory        36240000
                       will be locked down and the system may hang      36245000
                       up.  Avoid this combination of                   36250000
                       specifications if possible.                      36255000
                                                                        36260000
\ITEM=OPERATION                                                         36265000
OPERATION                                                               36270000
                                                                        36275000
Lists descriptions of one or more disc files at level of detail you     36280000
select.  You need not have access to a file to list a description of it,36285000
however, a file description will not be listed unless the file's home   36290000
volume set is mounted.  A standard user may list level 0, 1, and 2      36295000
information for any file in the system.  A user with Account Manager    36300000
capability may list level -1 data for files in his own account.  A user 36305000
with System Manager capability may list -1 data for any file in the     36310000
system.                                                                 36315000
                                                                        36320000
Note that this command applies only to permanent disc files in the      36325000
system file domain.                                                     36330000
                                                                        36335000
\ITEM=EXAMPLE                                                           36340000
EXAMPLE                                                                 36345000
                                                                        36350000
To list the names of all files in your logon group, enter:              36355000
                                                                        36360000
    :LISTF                                                              36365000
                                                                        36370000
To list the name, file code, record format, ASCII vs. binary code       36375000
information, carriage-control option, end-of-file location, and maximum 36380000
number of records for the file named BASE in the group USERGP in your   36385000
logon account, enter:                                                   36390000
                                                                        36395000
    :LISTF BASE.USERGP,1                                                36400000
                                                                        36405000
To list the names of all files in all groups in your logon account,     36410000
enter:                                                                  36415000
                                                                        36420000
    :LISTF @.@                                                          36425000
                                                                        36430000
                                                                        36435000
\ENTRY=LISTFTEMP,PARMS,OPERATION,EXAMPLE                                36440000
    :LISTFTEMP                                                          36445000
                                                                        36450000
Displays descriptions of one or more temporary disc files created       36455000
during a job or session.                                                36460000
                                                                        36465000
SYNTAX                                                                  36470000
                                                                        36475000
    :LISTFTEMP [fileset][,listlevel][;listfile]                         36480000
                                                                        36485000
\ITEM=PARMS                                                             36490000
PARAMETERS                                                              36495000
                                                                        36500000
fileset                Specifies the set of temporary files to be       36505000
                       displayed.  The default is @.  This parameter    36510000
                       is of the form:                                  36515000
                                                                        36520000
         filedesignator[.groupdesignator[.acctdesignator]]              36525000
                                                                        36530000
                       Fileset can be entered in any of the             36535000
                       following formats and may use wild card          36540000
                       characters, in any order, as replacements.       36545000
                                                                        36550000
file.group.account     Display file qualified by the specified group    36555000
                       and account.                                     36560000
                                                                        36565000
file.group             Display file qualified by the specified group    36570000
                       within the user's logon account.                 36575000
                                                                        36580000
file                   Display file qualified by the user's logon       36585000
                       group and account.                               36590000
                                                                        36595000
@.group.account        Display all files qualified by the specified     36600000
                       group and account.                               36605000
                                                                        36610000
@.@.account            Display all files qualified by all groups        36615000
                       and the specified account.                       36620000
                                                                        36625000
@.@.@                  Display all files qualified by all groups and    36630000
                       accounts (i.e. all the temporary files).         36635000
                                                                        36640000
@.@                    Display all files qualified by all groups within 36645000
                       the user's logon account.                        36650000
                                                                        36655000
@                      Display all files qualified by the user's logon  36660000
                       group and account.                               36665000
                                                                        36670000
@.group                Display all files qualified by the specified     36675000
                       group and logon account.                         36680000
                                                                        36685000
file.@.account         Display the specific file qualified by any       36690000
                       group in the specified account.                  36695000
                                                                        36700000
                                           NOTE                         36705000
                                                                        36710000
              The characters @, #, and ? can be used as "wild card"     36715000
              characters in the fileset parameter.  These wild card     36720000
              characters have the following meanings:                   36725000
                                                                        36730000
              @ -- specifies zero or more alphanumeric characters.      36735000
                                                                        36740000
              # -- specifies one numeric character.                     36745000
                                                                        36750000
              ? -- specifies one alphanumeric character.                36755000
                                                                        36760000
              The characters can be used as follows:                    36765000
                                                                        36770000
              n@       Display all files starting with the character n. 36775000
                                                                        36780000
              @n       Display all files ending with the character n.   36785000
                                                                        36790000
              n@x      Display all files starting with the character n  36795000
                       and ending with the character x.                 36800000
                                                                        36805000
              n##..#   Display all files starting with the character n  36810000
                       followed by up to seven digits.                  36815000
                                                                        36820000
              ?n@      Display all files whose second character is n.   36825000
                                                                        36830000
              n?       Display all two-character files starting with the36835000
                       character n.                                     36840000
                                                                        36845000
              ?n       Display all two-character files ending with the  36850000
                       character n.                                     36855000
                                                                        36860000
listlevel              Indicates the display format.  The listlevel may 36865000
                       be -1, 0, 1, or 2.  The default is 0.  Each      36870000
                       listlevel is of the form:                        36875000
                                                                        36880000
0                      Display fully qualified file name only.  Default.36885000
                                                                        36890000
1                      Display file name, plus file code, record size (W36895000
                       indicates words, B indicates bytes), record      36900000
                       format (F, U, or V), whether ASCII (A) or binary 36905000
                       (B) records, R for relative I/O files,           36910000
                       whether carriage-control option is taken         36915000
                       (c if so), current end-of-file location, and     36920000
                       maximum number of records allowed in file.       36925000
                                                                        36930000
2                      Display file name, file code, record size (W     36935000
                       indicates words, B indicates bytes), record      36940000
                       format (F, U, or V), whether ASCII (A) or binary 36945000
                       (B) records, whether carr- iage-control option is36950000
                       taken (C if so), current end-of-file location,   36955000
                       maximum number of records allowed in file,       36960000
                       blocking factor, number of disc sectors in use   36965000
                       (including those in use for file label and user  36970000
                       headers), number of extents currently allocated, 36975000
                       and maximum number of extents allowed.           36980000
                                                                        36985000
-1                     Display octal listing of file label.  This option36990000
                       can be requested only by users with System       36995000
                       Manager capability or Account Manager            37000000
                       capability.                                      37005000
                       The first line of the listing is the             37010000
                       directory entry for the file being listed.       37015000
                       The remainder of the listing is the file         37020000
                       label.                                           37025000
                                                                        37030000
listfile               Name of output file on which descriptions are    37035000
                       written.  Automatically specified as new ASCII   37040000
                       file with variable-length records, user-supplied 37045000
                       carriage-control characters (CCTL), OUT access   37050000
                       mode, and EXC (exclusive access) option.  All    37055000
                       other characteristics are same as :FILE command  37060000
                       default specifications. Default is $STDLIST.     37065000
                                                                        37070000
                                         NOTE                           37075000
                                                                        37080000
                       If you specify the -1 option and direct          37085000
                       listing output to a non-spooled device           37090000
                       (such as a magnetic tape unit) that enters       37095000
                       the NOT READY state, the System Directory        37100000
                       will be locked down and the system may hang      37105000
                       up.  Avoid this combination of                   37110000
                       specifications if possible.                      37115000
                                                                        37120000
\ITEM=OPERATION                                                         37125000
OPERATION                                                               37130000
                                                                        37135000
Lists descriptions of one or more temporary disc files created          37140000
during a job or session.  Temporary files are fully qualified by        37145000
group and account.  A user may have temporary files fully qualified     37150000
by any group and account combination on the system.  Since temporary    37155000
files are under job and session management, they go away at the         37160000
termination of a job or session.  Users have access to their temporary  37165000
files only.                                                             37170000
 A standard user may use listlevel 0, 1, and 2.  A user with Account    37175000
Manager capability or System Manager capability may use listlevel -1.   37180000
                                                                        37185000
A description of the temprorary file $OLDPASS will be displayed under   37190000
the following two conditions:                                           37195000
                                                                        37200000
         1.  $OLDPASS is created.                                       37205000
         2.  The parameter filespec is of a form requesting that all    37210000
             files qualified by logon group and account be displayed.   37215000
             (i.e. the default filespec is used, or @)                  37220000
                                                                        37225000
Note that this command applies only to temporary disc files in the      37230000
the user's job or session domain.                                       37235000
                                                                        37240000
\ITEM=EXAMPLE                                                           37245000
EXAMPLE                                                                 37250000
                                                                        37255000
To list the names of all temporary files qualified by your logon        37260000
group and account, enter either:                                        37265000
                                                                        37270000
    :LISTFTEMP                                                          37275000
                                                                        37280000
       or                                                               37285000
                                                                        37290000
    :LISTFTEMP @                                                        37295000
                                                                        37300000
NNote that if the temporary file $OLDPASS were created, $OLDPASS would  37305000
be displayed.                                                           37310000
                                                                        37315000
To list the name, file code, record format, ASCII vs. binary code       37320000
information, carriage-control option, end-of-file location, and maximum 37325000
number of records for a set of files where the last four letters of the 37330000
files' name are PASS, and are qualified by the user's logon group and   37335000
account.                                                                37340000
                                                                        37345000
    :LISTFTEMP  @PASS, 1                                                37350000
                                                                        37355000
Note that if the temporary file $OLDPASS were created, it would not be  37360000
displayed.                                                              37365000
                                                                        37370000
To display the names of all files qualified by groups with the user's   37375000
logon account enter:                                                    37380000
                                                                        37385000
    :LISTFTEMP @.@                                                      37390000
                                                                        37395000
       or                                                               37400000
                                                                        37405000
    :LISTFTEMP @.@, 0                                                   37410000
                                                                        37415000
                                                                        37420000
\ENTRY=LISTGROUP,PARMS,OPERATION,EXAMPLE                                37425000
    :LISTGROUP (System Manager or Account Manager capability required)  37430000
                                                                        37435000
Prints a list of attributes for groups.                                 37440000
                                                                        37445000
SYNTAX                                                                  37450000
                                                                        37455000
    :LISTGROUP [groupset][,listfile]                                    37460000
                                                                        37465000
\ITEM=PARMS                                                             37470000
PARAMETERS                                                              37475000
                                                                        37480000
groupset               Specifies the set of groups to be listed.        37485000
                       Default is @. This parameter can be entered in   37490000
                       one of the following formats:                    37495000
                                                                        37500000
groupdesig.acctdesig   Specifies the group and account. If an Account   37505000
                       Manager specifies an account, it must be his own.37510000
                                                                        37515000
groupdesig             Specifies the group (in the logon account).      37520000
                                                                        37525000
@.acctdesig            All groups in the specified account.  If an      37530000
                       Account Manager specifies an account, it must be 37535000
                       his own.                                         37540000
                                                                        37545000
@                      All groups in the logon account.  Default.       37550000
                                                                        37555000
@.@                    All groups in all accounts. Only System Managers 37560000
                       may specify this option.                         37565000
                                                                        37570000
                                     NOTE                               37575000
                                                                        37580000
               The characters @, #, and ? can be used as "wild card"    37585000
               characters in the groupset parameter.  These wild card   37590000
               characters have the following meanings:                  37595000
                                                                        37600000
               @ -- specifies zero or more alphanumeric characters.     37605000
                                                                        37610000
               # -- specifies one numeric character.                    37615000
                                                                        37620000
               ? -- specifies one alphanumeric character.               37625000
                                                                        37630000
               The characters can be used as follows:                   37635000
                                                                        37640000
               n@      List all groups starting with the character n.   37645000
                                                                        37650000
               @n      List all groups ending with the character n.     37655000
                                                                        37660000
               n@x     List all groups starting with the character n    37665000
                       and ending with the character x.                 37670000
                                                                        37675000
               n##..#  List all groups starting with the character n    37680000
                       followed by up to seven digits.                  37685000
                                                                        37690000
               ?n@     List all groups whose second character is n.     37695000
                                                                        37700000
               n?      List all two-character groups starting with      37705000
                       the character n.                                 37710000
                                                                        37715000
               ?n      List all two-character groups ending with the    37720000
                       character n.                                     37725000
                                                                        37730000
listfile               Actual designator of file on which attribute     37735000
                       listing is produced.  This file is closed with   37740000
                       SAVE disposition.  Default is $STDLIST.          37745000
                                                                        37750000
\ITEM=OPERATION                                                         37755000
OPERATION                                                               37760000
                                                                        37765000
(System Manager or Account Manager capability required)                 37770000
This command lists attributes for groups.  An Account Manager may       37775000
specify only his own group; the System Manager may specify all groups in37780000
all accounts on the system.  Private volume information (volume set     37785000
names) also is listed.  The volume sets need not be mounted for this    37790000
information to be listed.                                               37795000
                                                                        37800000
\ITEM=EXAMPLE                                                           37805000
EXAMPLE                                                                 37810000
                                                                        37815000
To list the attributes of all groups in the account named ACCT1, enter: 37820000
                                                                        37825000
    :LISTGROUP @.ACCT1                                                  37830000
                                                                        37835000
                                                                        37840000
\ENTRY=LISTLOG,PARMS,OPERATION,EXAMPLE                                  37845000
:LISTLOG                                                                37850000
                                                                        37855000
Lists the currently active logging identifiers on the system.           37860000
SYNTAX                                                                  37865000
                                                                        37870000
          LISTLOG [logid[;PASS]]                                        37875000
                                                                        37880000
\item=parms                                                             37885000
PARAMETERS                                                              37890000
                                                                        37895000
logid   The specific logging identifier to be listed.  Default          37900000
        is to list currently active logging identifiers on the system.  37905000
                                                                        37910000
PASS    Causes the password associated with the logging                 37915000
        identifier to be displayed.  Can be used only by the            37920000
        creator of the logging identifier.                              37925000
                                                                        37930000
\item=operation                                                         37935000
OPERATION                                                               37940000
                                                                        37945000
Lists the logging identifier specified with its associated              37950000
creator and destination file.  If the logid parameter is not entered,   37955000
all logging identifiers on the system are displayed with their          37960000
creators and logfiles.  The PASS parameter, which can be used           37965000
only by the creator of the logging identifier specified, causes         37970000
the password associated with the logging identifier to be listed.       37975000
                                                                        37980000
\item=example                                                           37985000
EXAMPLE                                                                 37990000
To list all logging identifiers on the system, enter:                   37995000
                                                                        38000000
        :LISTLOG                                                        38005000
                                                                        38010000
        LOGID       CREATOR            LOGFILE                          38015000
                                                                        38020000
        FINANCE     DATABASE.FINANCE   NEWDATA                          38025000
        INLOG       TOM.LAB            TEMP.TOM.LAB (disc file)         38030000
        ERRORS      TOM.LAB            OTHERLG      (tape file)         38035000
\ENTRY=LISTUSER,PARMS,OPERATION,EXAMPLE                                 38040000
    :LISTUSER (System Manager or Account Manager capability required)   38045000
                                                                        38050000
Lists attributes currently assigned to users.                           38055000
                                                                        38060000
SYNTAX                                                                  38065000
                                                                        38070000
    :LISTUSER [userset][,listfile]                                      38075000
                                                                        38080000
\ITEM=PARMS                                                             38085000
PARAMETERS                                                              38090000
                                                                        38095000
userset              Specifies the set of users to be listed.  Default  38100000
                     is @. This parameter is written in one of the      38105000
                     following formats:                                 38110000
                                                                        38115000
userdesig.acctdesig  The specified user in the spec- ified account.  If 38120000
                     Account Manager users specify acctdesig, it must be38125000
                     their own account.                                 38130000
                                                                        38135000
userdesig            The specified user in the logon account.           38140000
                                                                        38145000
@.acctdesig          All users in the specified account. Account        38150000
                     Managers may specify their own account only.       38155000
                                                                        38160000
@                    All users in the logon account.  Default.          38165000
                                                                        38170000
@.@                  All users in all accounts.  (The attributes of the 38175000
                     accounts also are listed.)  This option can only be38180000
                     specified by System Manager.                       38185000
                                                                        38190000
                                     NOTE                               38195000
                                                                        38200000
                The characters @, #, and ? can be used as "wild card"   38205000
                characters in the userset parameter.  These wild card   38210000
                characters have the following meanings:                 38215000
                                                                        38220000
                @ -- specifies zero or more alphanumeric characters.    38225000
                                                                        38230000
                # -- specifies one numeric character.                   38235000
                                                                        38240000
                ? -- specifies one alphanumeric character.              38245000
                                                                        38250000
                The characters can be used as follows:                  38255000
                                                                        38260000
                n@      List all users starting with the character n.   38265000
                                                                        38270000
                @n      List all users ending with the character n.     38275000
                                                                        38280000
                n@x     List all users starting with the character n    38285000
                        and ending with the character x.                38290000
                                                                        38295000
                n##..#  List all users starting with the character n    38300000
                        followed by up to seven digits.                 38305000
                                                                        38310000
                ?n@     List all users whose second character is n.     38315000
                                                                        38320000
                n?      List all two-character users starting with      38325000
                        the character n.                                38330000
                                                                        38335000
                ?n      List all two-character users ending with the    38340000
                        character n.                                    38345000
                                                                        38350000
listfile             Actual designator of file on which attribute       38355000
                     listing is produced.  This file is closed with SAVE38360000
                     disposition. Default is $STDLIST.                  38365000
                                                                        38370000
\ITEM=OPERATION                                                         38375000
OPERATION                                                               38380000
                                                                        38385000
(System Manager or Account Manager capability required)                 38390000
This command lists the attributes currently assigned to users.  An      38395000
Account Manager may list all users in his account only; the System      38400000
Manager may list all users in all accounts.  Private volume information 38405000
(volume set names) also is listed.  The volume sets need not be mounted 38410000
for this information to be listed.                                      38415000
                                                                        38420000
\ITEM=EXAMPLE                                                           38425000
EXAMPLE                                                                 38430000
                                                                        38435000
To list the attributes of the user named CLANCY in the account named    38440000
MGT, enter:                                                             38445000
                                                                        38450000
    :LISTUSER CLANCY.MGT                                                38455000
                                                                        38460000
Note that if the command is entered by an Account Manager, MGT must be  38465000
his own account.                                                        38470000
                                                                        38475000
                                                                        38480000
\ENTRY=LISTVS,PARMS,OPERATION,EXAMPLE                                   38485000
    :LISTVS                                                             38490000
                                                                        38495000
Produces a formatted listing of volume set definition information.      38500000
                                                                        38505000
SYNTAX                                                                  38510000
                                                                        38515000
                      0                                                 38520000
    :LISTVS [vslist][,1  ][;listfile]                                   38525000
                      2                                                 38530000
                                                                        38535000
\ITEM=PARMS                                                             38540000
PARAMETERS                                                              38545000
                                                                        38550000
vslist                 Specifies the volume set definitions to be       38555000
                       listed.  Default is @.  This parameter is of     38560000
                       the form:                                        38565000
                                                                        38570000
                       vsdesig[.groupdesig[.acctdesig]]                 38575000
                                                                        38580000
                       VSLIST can be entered in any of the              38585000
                       following formats and may use wild card          38590000
                       characters, in any order, as replacements.       38595000
                                                                        38600000
vsname.group.account   List information for volume set <vsname> in the  38605000
                       specified group and account.                     38610000
                                                                        38615000
@.group.account        List all home volume set definitions in the      38620000
                       specified group and account.                     38625000
                                                                        38630000
@.@.account            List all home volume set definitions for all     38635000
                       groups in the specified account.                 38640000
                                                                        38645000
@                      List all home volume set definitions in          38650000
                       logon group and account.                         38655000
                                                                        38660000
@.@                    List all home volume set definitions for all     38665000
                       groups in logon account.                         38670000
                                                                        38675000
@.@.@                  List all home volume set definitions in system.  38680000
                                                                        38685000
vsname.@.account       List information for volume set vsname           38690000
                       in any group of specified account.               38695000
                                                                        38700000
                               NOTE                                     38705000
                                                                        38710000
      The characters @, #, and ? can be used as "wild card"             38715000
      characters in the vslist parameter.  These wild card              38720000
      characters have the following meanings:                           38725000
                                                                        38730000
      @ -- specifies zero or more alphanumeric characters.              38735000
                                                                        38740000
      # -- specifies one numeric character.                             38745000
                                                                        38750000
      ? -- specifies one alphanumeric character.                        38755000
                                                                        38760000
      The characters can be used as follows:                            38765000
                                                                        38770000
      n@      List all volume set definitions starting with the         38775000
              character n.                                              38780000
                                                                        38785000
      @n      List all volume set definitions ending with the           38790000
              character n.                                              38795000
                                                                        38800000
      n@x     List all volume set definitions starting with the         38805000
              character n and ending with the character x.              38810000
                                                                        38815000
      n##..#  List all volume set definitions starting with the         38820000
              character n followed by up to seven digits.               38825000
                                                                        38830000
      ?n@     List all volume set definitions whose second character    38835000
              is n.                                                     38840000
                                                                        38845000
      n?      List all two-character volume set definitions starting    38850000
              with the character n.                                     38855000
                                                                        38860000
      ?n      List all two-character volume set definitions ending      38865000
              with the character n.                                     38870000
                                                                        38875000
                                                                        38880000
0     Display volume set name.                                          38885000
                                                                        38890000
1     Display volume set name, members, and types.                      38895000
                                                                        38900000
2     Display volume set names, members, types, logical device numbers  38905000
      of the devices on which the volumes are mounted, and the status   38910000
      of the volume set.                                                38915000
                                                                        38920000
      Default is 0.                                                     38925000
                                                                        38930000
listfile               Actual designator of output file to receive      38935000
                       listings.  This file must be named in a :FILE    38940000
                       command and back referenced as in the            38945000
                       following example:                               38950000
                                                                        38955000
                       :FILE LIST;DEV=LP                                38960000
                       :LISTVS @,1;*LIST                                38965000
                                                                        38970000
                       Default is $STDLIST.                             38975000
                                                                        38980000
\ITEM=OPERATION                                                         38985000
OPERATION                                                               38990000
                                                                        38995000
The :LISTV command produces a formatted listing of volume set definition39000000
information.  The listing can be sent to a device other than the        39005000
standard list device.                                                   39010000
                                                                        39015000
     :LISTVS @.PUB.SYS,1                                                39020000
     :LISTVS PVOL1.PDISC.SUPPORT,2                                      39025000
     :LISTVS PVOL2.PDISC.@                                              39030000
     :LISTVS @.PUB.SUPPORT,0;*LIST                                      39035000
                                                                        39040000
\ITEM=EXAMPLE                                                           39045000
EXAMPLE                                                                 39050000
                                                                        39055000
To display volume set definition information for volume sets in your    39060000
logon group and account, with the listing sent to a line printer,       39065000
enter:                                                                  39070000
                                                                        39075000
\ENTRY=LMOUNT,PARMS,OPERATION,EXAMPLE                                   39080000
     :LMOUNT                                                            39085000
                                                                        39090000
Logically mounts a private volume set.                                  39095000
                                                                        39100000
SYNTAX                                                                  39105000
                                                                        39110000
             {*      }.group.account [GEN=genindex]                     39115000
     :LMOUNT {vcsname}                                                  39120000
                                                                        39125000
\ITEM=PARMS                                                             39130000
PARAMETERS                                                              39135000
                                                                        39140000
*                 Specifies mounting of the home volume set belonging   39145000
                  to the named group and account.                       39150000
                                                                        39155000
vcsname           Volume class/set name specifies the mounting of a     39160000
                  previously-defined volume class name or volume set    39165000
                  name.                                                 39170000
                                                                        39175000
group.account     Specifies the group and account under which the       39180000
                  volume set was created.                               39185000
                                                                        39190000
genindex          A value from -1 to 32767 specifying which generation  39195000
                  of the volume set is to be mounted (-1 allows any     39200000
                  generation to be mounted).  If omitted, the system    39205000
                  does not check the generation version of the          39210000
                  specified volume set.                                 39215000
                                                                        39220000
\ITEM=OPERATION                                                         39225000
OPERATION                                                               39230000
                                                                        39235000
When a mount command executes, all disc devices containing members      39240000
of the specified volume set become ASSIGNED devices.  The specified     39245000
volume set becomes logically attached to the devices until a            39250000
subsequent :LDISMOUNT command, at which time the devices become         39255000
AVAILABLE.                                                              39260000
                                                                        39265000
System users issue mount requests implicitly through their programs     39270000
or explicitly with a user :MOUNT command.  User-initiates mount         39275000
requests cause the specified volume set to be linked into the           39280000
system's accounting structure at the group level.  This is called       39285000
"binding".  With the console command, no such binding occurs.           39290000
                                                                        39295000
After a volume set has been mounted by a user-initiated request,        39300000
you can issue a console :LMOUNT command to cause the same volume        39305000
set to remain mounted, even after the last requesting user has          39310000
relinquished the set.  In this way, a volume set remains mounted        39315000
from one job or session to the next.  (Note that if you want to         39320000
prohibit further user-initiated mounts for a currently mounted          39325000
volume set, :DOWN the device where the set's master volume is           39330000
physically mounted.)                                                    39335000
                                                                        39340000
If the Private Volumes Facility was enabled with :VMOUNT ON,AUTO,       39345000
then MPE automatically attempts to stisfy your mount request.  If       39350000
the specified volume set/class is physically present, it is             39355000
logically mounted.  If the specified volume set is not physically       39360000
present, the system looks for available drives of the types required    39365000
to satisfy the request.  If sufficient drives are available, the        39370000
system reserves them and prints a message for you to mount the          39375000
volume set on one or more ldn's and reply YES or NO.  If sufficient     39380000
drives are not available, the system reserves those which will          39385000
satisfy part of your request and prints a message with the type         39390000
and number of drives it requires.  If you can free the required         39395000
drive(s), reply YES after the drive is AVAILABLE.  A NO reply           39400000
cancels the original :LMOUNT request.                                   39405000
                                                                        39410000
\ITEM=EXAMPLE                                                           39415000
EXAMPLES                                                                39420000
                                                                        39425000
To mount a private volume set named DATABASE in the PAYROLL group       39430000
of the ACCTNG account, enter:                                           39435000
                                                                        39440000
     :LMOUNT DATABASE.PAYROLL.ACCTNG;GEN=8                              39445000
                                                                        39450000
                                                                        39455000
                                                                        39460000
\ENTRY=LOG,PARMS,OPERATION,EXAMPLE                                      39465000
     :LOG                                                               39470000
                                                                        39475000
Starts, restarts, or stops user logging.                                39480000
                                                                        39485000
SYNTAX                                                                  39490000
                                                                        39495000
                {,START  }                                              39500000
     :LOG logid {,RESTART}                                              39505000
                {,STOP   }                                              39510000
                                                                        39515000
\ITEM=PARMS                                                             39520000
PARAMETERS                                                              39525000
                                                                        39530000
logid          Identifies the User Logging Process.                     39535000
                                                                        39540000
START          Initiates a logging process.                             39545000
                                                                        39550000
RESTART        Restarts a logging process.                              39555000
                                                                        39560000
STOP           Terminates a logging process.                            39565000
                                                                        39570000
\ITEM=OPERATION                                                         39575000
OPERATION                                                               39580000
                                                                        39585000
None.                                                                   39590000
                                                                        39595000
\ITEM=EXAMPLE                                                           39600000
EXAMPLE                                                                 39605000
                                                                        39610000
To turn on the logging process identified by logid LOGPROCX,            39615000
enter:                                                                  39620000
                                                                        39625000
       :LOG LOGPROCX,START                                              39630000
                                                                        39635000
\ENTRY=MOUNT,PARMS,OPERATION,EXAMPLE                                    39640000
    :MOUNT                                                              39645000
                                                                        39650000
Requests the Console Operator to mount a volume set.                    39655000
                                                                        39660000
SYNTAX                                                                  39665000
                                                                        39670000
               *                                                        39675000
    :MOUNT {         }[.groupname[.acctname]]                           39680000
             vcsname                                                    39685000
                                                                        39690000
           [;GEN=[genindex]]                                            39695000
                                                                        39700000
\ITEM=PARMS                                                             39705000
PARAMETERS                                                              39710000
                                                                        39715000
*                    Specifies the home volume set for the group and    39720000
                     account specified, or the logon group and account  39725000
                     if <groupname.acctname> are not specified. Default.39730000
                                                                        39735000
vcsname              Volume class/set name, specifying a previously-    39740000
                     defined volume class name or volume set name.      39745000
                     Default is *.                                      39750000
                                                                        39755000
groupname.acctname   Specify the group and account under which the      39760000
                     volume set was created.  Default is logon group    39765000
                     and account.                                       39770000
                                                                        39775000
genindex             A value from 0 to 65535 specifying which generation39780000
                     of the home volume set is to be mounted.  If       39785000
                     omitted, the system will ignore the generation     39790000
                     when attempting to satisfy the :MOUNT request.     39795000
                                                                        39800000
\ITEM=OPERATION                                                         39805000
OPERATION                                                               39810000
                                                                        39815000
The :MOUNT command allows you to become attached to a                   39820000
specific volume set.  In addition, this command allows you to specify   39825000
that the volume set is to be treated as a home volume set and therefore 39830000
it is to be bound to the system's accounting structure with respect to a39835000
particular group.  The :MOUNT command is rejected if there is an        39840000
operator-initiated :LDISMOUNT command pending for the specified volume  39845000
set.  The requesting job is suspended until the mount is completed or   39850000
rejected.                                                               39855000
                                                                        39860000
\ITEM=EXAMPLE                                                           39865000
EXAMPLE                                                                 39870000
                                                                        39875000
To request the Console Operator to mount volume set MYSET, generation   39880000
index 43, enter:                                                        39885000
                                                                        39890000
    :MOUNT MYSET;GEN=43                                                 39895000
                                                                        39900000
\ENTRY=MPLINE,PARMS,OPERATION,EXAMPLE                                   39905000
     :MPLINE                                                            39910000
Controls execution of the Multipoint Terminal Software                  39915000
(MTS/3000) Subsystem.                                                   39920000
                                                                        39925000
SYNTAX                                                                  39930000
                                                                        39935000
                 { OPEN [,filename]                          }          39940000
                 { UP, upentry                               }          39945000
                 { DOWN, downentry                           }          39950000
   :MPLINE ldn,  { SHUT [,NOW]                               }          39955000
                 { MESSAGES, {ON|OFF}                        }          39960000
                 { TRACE,  ON [,[ALL][,[mask][,[numentries]             39965000
                                [,[WRAP][,filename]]]]]      }          39970000
                 { TRACE, OFF                                }          39975000
                                                                        39980000
\ITEM=PARMS                                                             39985000
PARAMETERS                                                              39990000
                                                                        39995000
ldn         The logical device number of the multipoint super-          40000000
            visor that is associated with the line you want to          40005000
            open, close, trace, etc.  Required parameter.               40010000
                                                                        40015000
OPEN        Initiates MTS/3000 execution, opens the communication       40020000
            line, and starts multipoint terminal activity.              40025000
                                                                        40030000
filename    Names an MTS configuration file in the PUB.SYS              40035000
            account.  Default: the line is opened with the line         40040000
            characteristics established by MPE configuration.           40045000
                                                                        40050000
UP          Activates the terminal(s) specified in the upentry.         40055000
            This places the terminal(s) logically online for MTS        40060000
            activity.                                                   40065000
                                                                        40070000
DOWN        Deactivates the terminal(s) specified in the down-          40075000
            entry parameter.  This places the device(s) logically       40080000
            offline and makes them unavailable for MTS activity.        40085000
                                                                        40090000
upentry     Up entries and down entries can be one of the               40095000
downentry   following:                                                  40100000
                                                                        40105000
            1.  The logical device number of a multipoint termi-        40110000
                nal as configured into MPE.                             40115000
            2.  A terminal ID, consisting of two letters that           40120000
                specify the group and device ID of a particular         40125000
                multipoint terminal.  (A terminal ID corresponds        40130000
                to the unit number assigned during MPE                  40135000
                configuration.)                                         40140000
            3.  The word GROUP followed by a space and one letter       40145000
                designating a particular group.  All terminals          40150000
                configured under MPE as members of the group will       40155000
                be activated or deactivated.                            40160000
                                                                        40165000
SHUT        Initiates an orderly MTS line closing procedure.  If        40170000
            multipoint terminals are currently in use, the line         40175000
            remains open and MTS execution continues.  The line         40180000
            will be closed when all users have finished.                40185000
                                                                        40190000
NOW         Immediately terminates MTS/3000 execution and closes        40195000
            the line without waiting for sessions to log off and        40200000
            applications to close the terminals they are using.         40205000
                                                                        40210000
MESSAGES    Controls the printing of MTS messages on the system         40215000
            console.                                                    40220000
                                                                        40225000
            ON  causes the messages that result from MTS commu-         40230000
                nication activity to be displayed. ON is default.       40235000
                                                                        40240000
            OFF stops the messages associated with MTS line             40245000
                activity from being displayed.  If OFF is speci-        40250000
                fied and system console logging is enabled, the         40255000
                messages will still be recorded in the log file.        40260000
                                                                        40265000
            Command Interpreter messages (for example, those gen-       40270000
            erated by syntax errors) are displayed regardless of        40275000
            whether MESSAGES is ON or OFF.                              40280000
                                                                        40285000
                                                                        40290000
TRACE,ON    Activates CS Trace.                                         40295000
                                                                        40300000
ALL         Generates trace records for all activity.  Default:         40305000
            trace records are written only when an error occurs.        40310000
                                                                        40315000
mask        An octal number preceded by a percent sign (%nn) to         40320000
            specify the type of trace entries.  Default: %37.           40325000
                                                                        40330000
numentries  An integer, a multiple of eight, not greater than           40335000
            248 (INP maximum is 24). Designates the maximum             40340000
            number of entries in a trace record.  If num-               40345000
            entries is not a multiple of eight, the system              40350000
            rounds your entry to comply.                                40355000
            If no trace file exists when you turn on the trace          40360000
            facility and you do not specify numentries, the             40365000
            system creates a file that will hold 24 entries.            40370000
            If the trace file already exists, and the record            40375000
            size is not compatible with the requested record            40380000
            size (based on the requested numentries), the old           40385000
            file is purged before a new, permanent file (with           40390000
            the old file's file limit and maximum number of             40395000
            entries) is created.  To change numentries, simply          40400000
            turn trace off and then turn it on again with the           40405000
            new number of entries.                                      40410000
                                                                        40415000
WRAP        Causes trace entries that overflow the trace record         40420000
            (greater than numentries) to overlay the prior trace        40425000
            entries.  Default: overflow entries are discarded.          40430000
                                                                        40435000
filename    The trace filename.  Default:  CSTRACE.PUB.SYS              40440000
                                                                        40445000
TRACE,OFF   Deactivates the CS trace facility.                          40450000
                                                                        40455000
\ITEM=OPERATION                                                         40460000
OPERATION                                                               40465000
                                                                        40470000
An MPLINE ldn,OPEN command opens a line, starts MTS/3000 execu-         40475000
tion, and initiates terminal polling.  If a configuration file          40480000
name is omitted from the command, the line is opened with the           40485000
characteristics established by MPE configuration, and individual        40490000
or group polling occurs as determined by each terminal's MPE sub-       40495000
type number.                                                            40500000
                                                                        40505000
You cannot initiate MTS activity if the line is already in use by       40510000
another data communications subsystem (such as DS/3000 or               40515000
MRJE/3000).  Thus it may be necessary to close the line for             40520000
another subsystem before you can open it for MTS.                       40525000
                                                                        40530000
If the filename parameter is included in an MPLINE command              40535000
(MPLINE ldn,OPEN,filename), the line is opened with the char-           40540000
acteristics established in the MTS configuration file and polling       40545000
begins only on the terminals specified in that file.                    40550000
                                                                        40555000
While the line is open, you can name a configuration file or            40560000
switch to a different file (if one is already being used) by            40565000
issuing another OPEN command.  That is, you need not close a line       40570000
when switching configuration files; MTS will automatically close        40575000
the line before reopening it.  When MTS reopens the line, the           40580000
system normally makes the line connection with no action on your        40585000
part.  Only with dialup modems will you need to dial a telephone        40590000
number, listen for the carrier tone, press the modem DATA button,       40595000
and respond at the console to make the connection.                      40600000
                                                                        40605000
The UP and DOWN parameters of the MPLINE command are used to con-       40610000
trol activity on specific MTS terminals.                                40615000
                                                                        40620000
When you DOWN a multipoint terminal, MTS refuses to write data to       40625000
it.  If the terminal is individually polled or is the only ter-         40630000
minal in its group, it is actually removed from the poll list.          40635000
If the terminal is a part of a group, it is deactivated and any         40640000
data received from it is saved until the terminal is reactivated.       40645000
                                                                        40650000
Conversely, when you UP a multipoint terminal, its address is           40655000
restored to the poll list at the same point where the address           40660000
existed previously, or it is reactivated, as the case may be.           40665000
                                                                        40670000
Any terminal you activate or deactivate must be properly con-           40675000
figured under MPE.                                                      40680000
                                                                        40685000
You can designate multipoint terminals to be UP or DOWN only            40690000
while the MTS line is open.  Note, however, that MTS auto-              40695000
matically closes and reopens the line each time you issue one of        40700000
these commands.  In a leased-line environment, this may tempo-          40705000
rarily delay communication with the other terminals on the line         40710000
but will not interfere significantly.  If a dialup line is in           40715000
use, the connection will be be broken and must be reestablished.        40720000
                                                                        40725000
The SHUT parameter initiates an orderly MTS line closing pro-           40730000
cedure.  If no sessions or applications are using the line when         40735000
you shut it, disconnection occurs immediately and MTS/3000 exe-         40740000
cution terminates.  Otherwise, the line remains connected, and          40745000
the following happens:                                                  40750000
                                                                        40755000
o  No new sessions may be initiated on HP 264x multipoint               40760000
   terminals.                                                           40765000
                                                                        40770000
o  No additional multipoint terminals may be opened by applica-         40775000
   tion programs.                                                       40780000
                                                                        40785000
o  Sessions on 264x multipoint terminals continue until users log       40790000
   off or the sessions are aborted by the console operator.             40795000
                                                                        40800000
o  Applications with open multipoint terminals continue until           40805000
   they terminate normally or are aborted by the operator.              40810000
                                                                        40815000
o  After all sessions end and all applications close all multi-         40820000
   point terminals, the line is automatically disconnected, and         40825000
   MTS/3000 execution terminates.                                       40830000
                                                                        40835000
The MPLINE ldn,SHUT,NOW command disconnects the line immediately        40840000
without waiting for sessions to log off and applications to close       40845000
their multipoint terminals.  Because the system automatically           40850000
aborts the sessions and closes the files, data may be lost              40855000
because of this command.                                                40860000
                                                                        40865000
\ITEM=EXAMPLE                                                           40870000
EXAMPLE                                                                 40875000
                                                                        40880000
To open the line for MTS activity and use a file named CONFIGA,         40885000
enter the following:                                                    40890000
                                                                        40895000
     :MPLINE 54,OPEN,CONFIGA                                            40900000
                                                                        40905000
To trace activity on the open line, enter the following:                40910000
                                                                        40915000
     :MPLINE 54,TRACE,ON,,,,,MYFILE                                     40920000
                                                                        40925000
                                                                        40930000
\ENTRY=MRJE,PARMS,OPERATION,EXAMPLE                                     40935000
    :MRJE                                                               40940000
                                                                        40945000
Initiates execution of the Multileaving Remote Job Entry (MRJE)         40950000
facility.                                                               40955000
                                                                        40960000
SYNTAX                                                                  40965000
                                                                        40970000
    :MRJE                                                               40975000
                                                                        40980000
\ITEM=PARMS                                                             40985000
PARAMETERS                                                              40990000
                                                                        40995000
None                                                                    41000000
                                                                        41005000
\ITEM=OPERATION                                                         41010000
OPERATION                                                               41015000
                                                                        41020000
The :MRJE command is used to initiate execution of the MRJE facility    41025000
for submitting jobs to, and retrieving output from, a host computer.    41030000
The host computer may be using either a HASP Version 3.1, HASP-II       41035000
Version 4.0 or later, JES2, JES3, or ASP job entry subsystem.           41040000
                                                                        41045000
\ITEM=EXAMPLE                                                           41050000
EXAMPLE                                                                 41055000
                                                                        41060000
    :MRJE                                                               41065000
                                                                        41070000
                                                                        41075000
\ENTRY=MRJECONTROL                                                      41080000
     :MRJECONTROL                                                       41085000
                                                                        41090000
Used to open and close the MRJE/3000 communications link                41095000
with one or more hosts, to change the number of error                   41100000
transmission retries, to turn on or off the CS/3000 TRACE diag-         41105000
nostic, and to check the internal fix level compatibility               41110000
of the MRJE modules.  Replaces the =MRJE console command.               41115000
                                                                        41120000
               {START   [,hostid] [;trace function] }                   41125000
               {SIGNOFF [,hostid] }                                     41130000
               {KILL    [,hostid] }                                     41135000
:MRJECONTROL   {RETRIES ,[hostid],retrynum }                            41140000
               {TRACE   ,[hostid], ON [trace options] }                 41145000
               {TRACE   ,[hostid], OFF }                                41150000
               {CHECK }                                                 41155000
                                                                        41160000
trace function  ::= {TRACE, ON [trace options] }                        41165000
                    {TRACE, OFF }                                       41170000
                                                                        41175000
trace options   ::= [,[ALL][,[mask][,[numentries]                       41180000
                      [,WRAP][,filename]]]]]                            41185000
                                                                        41190000
\ITEM=PARMS                                                             41195000
                                                                        41200000
                                                                        41205000
hostid              An alphanumeric name which identifies a host        41210000
                    machine.  MRJE uses only the first character        41215000
                    of the name in its message to users.                41220000
                                                                        41225000
START               Used to open the communications line to a host.     41230000
                                                                        41235000
SIGNOFF             Used to close the communications line in a          41240000
                    orderly fashion.                                    41245000
                                                                        41250000
KILL                Immediately disconnects the link to the host        41255000
                    system.  Should be used in emergencies only,        41260000
                    as error-free recovery is not certain.              41265000
                                                                        41270000
RETRIES             Used to regulate the number of times MRJE will      41275000
                    repeat a failed attempt to receive a block of       41280000
                    data from the host.                                 41285000
                                                                        41290000
retrynum            An integer 1 to 255, inclusive. Used by the         41295000
                    RETRIES command.                                    41300000
                                                                        41305000
CHECK               Prints a matrix of all MRJE modules and their       41310000
                    internal fix levels.                                41315000
                                                                        41320000
TRACE, ON           Activates the CS/3000 TRACE facility to provide     41325000
                    a record of communications activity.                41330000
                                                                        41335000
ALL                 Generate trace records for all line activity.       41340000
                    Default:  Records are written only for trans-       41345000
                    mission errors.                                     41350000
                                                                        41355000
mask                An octal number preceded by a percent sign (%nn).   41360000
                    Used to select type of trace entries generated.     41365000
                    Refer to MRJE/3000 Reference Manual for an ex-      41370000
                    planation of the mask bits.  Default:  %37, (all    41375000
                    except STN).                                        41380000
                                                                        41385000
numentries          Decimal integer for the maximum number of entries   41390000
                    in a trace record, maximum of 248.  Default: 24.    41395000
                                                                        41400000
WRAP                Causes trace entries that overflow the trace        41405000
                    record (that exceed "numentries") to overlay        41410000
                    the first entries written to that record.           41415000
                                                                        41420000
filename            Name of file where trace records are to be          41425000
                    written.  Default:  MRJETRCh.PUB.SYS, where "h"     41430000
                    is the first character of "hostid".                 41435000
                                                                        41440000
TRACE, OFF          Deactivates TRACE facility.                         41445000
                                                                        41450000
                                                                        41455000
\ITEM=OPERATION                                                         41460000
                                                                        41465000
Unless :MRJECONTROL is issued from the master console, users are        41470000
granted access only if they are ALLOWed to use the command.             41475000
                                                                        41480000
A user can open and close the MRJE/3000 communications link with        41485000
one or more hosts, change the number of transmission error retries,     41490000
turn on the CS/3000 TRACE diagnostic, and check the internal fix        41495000
levels of all the MRJE modules.                                         41500000
                                                                        41505000
                                                                        41510000
                                                                        41515000
\ITEM=EXAMPLE                                                           41520000
                                                                        41525000
  :MRJECONTROL START, B; TRACE, ON                                      41530000
                                                                        41535000
In this example, the MRJE line is being opened to the host spec-        41540000
ified by the hostid "B".  The TRACE facility has been activated         41545000
and will only trace transmission errors.  The trace records will        41550000
be written to the file MRJETRCB.PUB.SYS.                                41555000
                                                                        41560000
  :MRJECONTROL SIGNOFF                                                  41565000
                                                                        41570000
Here, a request is made to close down the MRJE line to the default      41575000
host as soon as all current activity is finished.                       41580000
                                                                        41585000
                                                                        41590000
                                                                        41595000
\ENTRY=NEWACCT,PARMS,OPERATION,EXAMPLE                                  41600000
    :NEWACCT (System Manager capability required)                       41605000
                                                                        41610000
Creates a new account and an associated Account Manager and Public      41615000
Group.                                                                  41620000
                                                                        41625000
SYNTAX                                                                  41630000
                                                                        41635000
    :NEWACCT acctname,mgrname                                           41640000
             [;PASS=[password]]                                         41645000
             [;FILES=[filespace]]                                       41650000
             [;CPU=[cpu]]                                               41655000
             [;CONNECT=[connect]]                                       41660000
             [;CAP=[capabilitylist]]                                    41665000
             [;ACCESS=[fileaccess]]                                     41670000
             [;MAXPRI=[subqueuename]]                                   41675000
             [;LOCATTR=[localattribute]]                                41680000
             [;VS=volset:SPAN]                                          41685000
                                                                        41690000
\ITEM=PARMS                                                             41695000
PARAMETERS                                                              41700000
                                                                        41705000
acctname         Name to be assigned to the new account. (REQUIRED      41710000
                 PARAMETER)                                             41715000
                                                                        41720000
mgrname          Name of the account manager; this is always the first  41725000
                 user created under the account.  He receives the       41730000
                 following attributes:                                  41735000
                                                                        41740000
                 User password                 No password.             41745000
                                                                        41750000
                 Capability list               Same as account's        41755000
                                               capabilities.            41760000
                                                                        41765000
                 Scheduling priority           Same as account's maximum41770000
                                               priority.                41775000
                                                                        41780000
                 Local attribute               Same as account's.       41785000
                                                                        41790000
                 Home group                    PUB.                     41795000
                                                                        41800000
                 The attributes of an Account Manager may be changed    41805000
                 later with the :ALTUSER command.  In no case, however, 41810000
                 is this user granted effective attributes greater than 41815000
                 those of the account.  (REQUIRED PARAMETER)            41820000
                                                                        41825000
password         Account password, used for verifying logon access      41830000
                 only.  Default is no password assigned.                41835000
                                                                        41840000
filespace        Disc storage limit, in sectors, for the permanent files41845000
                 of the account.  The maximum value permitted is a      41850000
                 2,147,483,647 sectors.  Default is unlimited filespace.41855000
                                                                        41860000
cpu              Limit on total cpu time, in seconds, for this account. 41865000
                 This limit is checked only when a job/session is       41870000
                 initiated -- thus, the limit never causes a job/session41875000
                 to abort.  The maximum value permitted is 2,147,483,64741880000
                 seconds.  Default is no limit is assigned.             41885000
                                                                        41890000
connect          Limit on total session connect time, in minutes,       41895000
                 allowed the account.  This limit is checked only at    41900000
                 logon time. The maximum value allowed is 2,147,483,647 41905000
                 minutes.  Default is no limit is assigned.             41910000
                                                                        41915000
capabilitylist   List of capabilities, mutually separated by commas,    41920000
                 permitted this account.  Each capability is denoted by 41925000
                 a two-letter mnemonic, as follows:                     41930000
                                                                        41935000
                 System Manager          = SM                           41940000
                 Account Manager         = AM                           41945000
                 Account Librarian       = AL                           41950000
                 Group Librarian         = GL                           41955000
                 Diagnostician           = DI                           41960000
                 System Supervisor       = OP                           41965000
                 Network Administrator   = NA                           41970000
                 Node Manager            = NM                           41975000
                                                                        41980000
                 Permanent Files         = SF                           41985000
                 Access of non-sharable                                 41990000
                 I/O devices             = ND                           41995000
                 Create Volumes          = CV                           42000000
                 Use Volumes             = UV                           42005000
                 Use Communications                                     42010000
                 Subsystems              = CS                           42015000
                 Create                                                 42016000
                 Programmatic Sessions   = PS                           42017000
                                                                        42020000
                 Process Handling        = PH                           42025000
                 Extra Data Segments     = DS                           42030000
                 Multiple RINS           = MR                           42035000
                 Privileged Mode         = PM                           42040000
                 Interactive Access      = IA                           42045000
                 Local Batch Access      = BA                           42050000
                 User Logging            = LG                           42055000
                                                                        42060000
                 Default is AM, AL, GL, SF, ND, IA, BA.                 42065000
                                                                        42070000
fileaccess           File security specifications, entered as follows:  42075000
                                                                        42080000
                      R                                                 42085000
                      L     ANY                                         42090000
                     {A} : {   }                                        42095000
                      W     AC                                          42100000
                      X                                                 42105000
                                                                        42110000
                     where R, L, A, W, X specify modes of access by     42115000
                     types of users (ANY, AC) as follows:               42120000
                                                                        42125000
                     R = Read                                           42130000
                     L = Lock (allows exclusive access to file)         42135000
                     A = Append (implicitly specifies L also)           42140000
                     W = Write (implicitly specifies A and L also)      42145000
                     X = Execute                                        42150000
                                                                        42155000
                     Two or more modes may be specified if they are     42160000
                     separated by commas.                               42165000
                                                                        42170000
                     The user types are specified as follows:           42175000
                                                                        42180000
                     ANY = Any user                                     42185000
                     AC  = Member of this account only                  42190000
                                                                        42195000
                     Two or more user types may be specified if they are42200000
                     separated by commas.                               42205000
                                                                        42210000
                     The default is:                                    42215000
                        R, L, A, W, X: AC  (All accounts except SYS)    42220000
                        R, X: ANY; L, A, W: AC  (SYS account only)      42225000
                                                                        42230000
subqueuename     The name of the subqueue of highest priority that can  42235000
                 be requested by any process of any job in the account, 42240000
                 specified as xS, where x is A, B, C, D, or E.  Default 42245000
                 is CS.                                                 42250000
                                                                        42255000
localattribute   The local attribute of the user, as defined at the     42260000
                 installation site.  This is a double-word of arbitrary 42265000
                 meaning which might be used to further classify users. 42270000
                 Default is double-word 0.                              42275000
                                                                        42280000
volset:SPAN      Volset is a volume set or class reference which,       42285000
                 when fully qualified, is in the form                   42290000
                                                                        42295000
                 vcsid.groupname.acctname                               42300000
                                                                        42305000
                 where vcsid refers to a previously-defined volume      42310000
                 set or class definition.                               42315000
                                                                        42320000
                 SPAN indicates that the acctname is to be inserted     42325000
                 in the accounting directory of the specified volume    42330000
                 set (volset).  The specified volume set must have      42335000
                 been previously mounted (via a MOUNT command) for      42340000
                 the SPAN operation to succeed.                         42345000
                                                                        42350000
                 Note that the associated Account Manager and PUBLIC    42355000
                 group are not created in the accounting directory      42360000
                 of the specified volume set.                           42365000
                                                                        42370000
\ITEM=OPERATION                                                         42375000
OPERATION                                                               42380000
                                                                        42385000
(System Manager capability required)                                    42390000
This command creates a new account and an associated Account Manager and42395000
Public Group.                                                           42400000
                                                                        42405000
Default parameters are assigned to this command as follows:             42410000
                                                                        42415000
1.  When a keyword is included but its corresponding keyword parameter  42420000
    is omitted (as in ;PASS=).                                          42425000
                                                                        42430000
2.  When an entire keyword parameter grouping (such as ;PASS=password)  42435000
    is omitted.                                                         42440000
                                                                        42445000
After the System Manager enters the :NEWACCT command, the new Account   42450000
Manager then can redefine his own attributes, the Public Group, and new 42455000
users and groups.  Note that the Account Manager may only define groups 42460000
and users within the set of parameters assigned by the System Manager at42465000
account creation time.                                                  42470000
                                                                        42475000
The Public Group initially is assigned no password and the same         42480000
capability class attributes, permanent file space limit, cpu time limit,42485000
and connect time limit as the account.  Its initial security allows     42490000
reading and program-execute access to all users who can pass the        42495000
account's security, and appending, locking, and saving access to account42500000
librarian and group users only.  (These access provisions are R, X: ANY;42505000
A, W, L, S: AL, GU.)                                                    42510000
                                                                        42515000
\ITEM=EXAMPLE                                                           42520000
EXAMPLE                                                                 42525000
                                                                        42530000
To create an account with the account name ACI and the Account Manager  42535000
name SMYTHE, enter:                                                     42540000
                                                                        42545000
    :NEWACCT ACI,SMYTHE                                                 42550000
                                                                        42555000
All other parameters are assigned by default.                           42560000
\ENTRY=NEWGROUP,PARMS,OPERATION,EXAMPLE                                 42565000
    :NEWGROUP (Account Manager capability required)                     42570000
                                                                        42575000
Creates a new group within an account.                                  42580000
                                                                        42585000
SYNTAX                                                                  42590000
                                                                        42595000
    :NEWGROUP groupname                                                 42600000
              [;PASS=[password]]                                        42605000
              [;CAP=[capabilitylist]]                                   42610000
              [;FILES=[filespace]]                                      42615000
              [;CPU=[cpu]]                                              42620000
              [;CONNECT=[connect]]                                      42625000
              [;ACCESS=[fileaccess]]                                    42630000
              [;VS=[volset[:SPAN]]]                                     42635000
                                                                        42640000
\ITEM=PARMS                                                             42645000
PARAMETERS                                                              42650000
                                                                        42655000
groupname         The name of the new group, composed of up to eight    42660000
                  alphanumeric characters, beginning with a letter.     42665000
                  (REQUIRED PARAMETER)                                  42670000
                                                                        42675000
password          Group password, used for verifying logon access only. 42680000
                  Default is no password is assigned.                   42685000
                                                                        42690000
capabilitylist    A list of capability-class attributes, consisting of  42695000
                  any or all of the following:  IA, BA, PM, MR, DS, or  42700000
                  PH.                                                   42705000
                                                                        42710000
                  This list imposes a limit on program files belonging  42715000
                  to the group.  A capability cannot be defined if it is42720000
                  not presently possessed by the group's account.       42725000
                  Default is IA, BA.                                    42730000
                                                                        42735000
filespace         Disc storage limit, in sectors, for the permanent     42740000
                  files of the group.  A group's <filespace> cannot be  42745000
                  specified as greater than the corresponding limits    42750000
                  currently defined for the group's account. However, an42755000
                  account's <filespace> can be changed later so that    42760000
                  some of its groups are left with limits that exceed   42765000
                  the new account limits. Default is same as account's  42770000
                  filespace.                                            42775000
                                                                        42780000
cpu               Limit on total cpu time, in seconds, for the group.   42785000
                  This limit is checked only when a job/session is      42790000
                  initiated -- thus, the limit never causes a           42795000
                  job/session to abort. The maximum value permitted is  42800000
                  2,147,483,647 seconds.  A group's cpu limit cannot be 42805000
                  specified as greater than the corresponding limit     42810000
                  currently defined for the group's account.  However,  42815000
                  an account's cpu limit can be changed later so that   42820000
                  some of its groups are left with a limit that exceeds 42825000
                  the new account limits.  Default is account's cpu     42830000
                  limit.                                                42835000
                                                                        42840000
connect           Limit on total session connect time, in minutes,      42845000
                  allowed the group.  This limit is checked only at     42850000
                  logon time.  The maximum value allowed is             42855000
                  2,147,483,647 minutes.  A group's connect limit cannot42860000
                  be specified as greater than the corresponding limit  42865000
                  currently defined for the group's account.  However,  42870000
                  an account's connect can be changed later so that some42875000
                  of its groups can be left with a limit that exceeds   42880000
                  the new account limits.  Default is the account's     42885000
                  connect limit.                                        42890000
                                                                        42895000
fileaccess       File security specifications, entered as follows:      42900000
                                                                        42905000
                  R     ANY                                             42910000
                  L     AC                                              42915000
                 {A} : {GU }                                            42920000
                  W     AL                                              42925000
                  X     GL                                              42930000
                  S                                                     42935000
                                                                        42940000
                 where R, L, A, W, X, S specify modes of access by types42945000
                 of users (ANY, AC, GU, AL, GL) as follows:             42950000
                                                                        42955000
                 R = Read                                               42960000
                 L = Lock (allows exclusive access to file)             42965000
                 A = Append (implicitly specifies L also)               42970000
                 W = Write (implicitly specifies A and L also)          42975000
                 X = Execute                                            42980000
                 S = Save                                               42985000
                                                                        42990000
                 Two or more modes may be specified if they are         42995000
                 separated by commas.                                   43000000
                                                                        43005000
                 The user types are specified as follows:               43010000
                                                                        43015000
                 ANY = Any user                                         43020000
                 AC  = Member of this account only                      43025000
                 GU  = Member of this group only                        43030000
                 AL  = Account librarian user only                      43035000
                 GL  = Group librarian user only                        43040000
                                                                        43045000
                 Two or more user types may be specified if they are    43050000
                 separated by commas.                                   43055000
                                                                        43060000
                 Default is R, A, W, L, X, S : GU (all groups except    43065000
                 PUB); or R, X : ANY; A, W, L, S : AL, GU (PUB group    43070000
                 only).                                                 43075000
                                                                        43080000
volset:SPAN      Volset is a volume set or class reference which, when  43085000
                 fully qualified, is in the form                        43090000
                                                                        43095000
                 vcsid.groupname.acctname                               43100000
                                                                        43105000
                 where vcsid refers to a previously-defined volume set  43110000
                 or class definition.                                   43115000
                                                                        43120000
                 SPAN indicates that groupname is to be inserted in     43125000
                 the accounting directory of the specified volume       43130000
                 set (volset).  The specified volume set must have      43135000
                 been previously mounted (via the MOUNT command) for    43140000
                 the span operation to succeed.                         43145000
                                                                        43150000
                 If volset is omitted from the VS= parameter, the group 43155000
                 will be assigned to the system volume set.  If volset  43160000
                 is specified and the SPAN keyword is omitted, the      43165000
                 group's home volume set will be the one specified by   43170000
                 the command, but an entry will not be made into its    43175000
                 accounting directory.   (This is useful when the       43180000
                 volume set is being transported from another system    43185000
                 to your system, and the group does not exist in the    43190000
                 system accounting directory but does exist in the      43195000
                 volume set's accounting directory.)                    43200000
                                                                        43205000
\ITEM=OPERATION                                                         43210000
OPERATION                                                               43215000
                                                                        43220000
(Account Manager capability required)                                   43225000
This command creates a new group within an account.                     43230000
                                                                        43235000
When a keyword parameter (such as ;PASS=) or keyword parameter group    43240000
(such as ;PASS=<password>) is omitted from the :NEWGROUP command, the   43245000
corresponding default value takes effect.                               43250000
                                                                        43255000
\ITEM=EXAMPLE                                                           43260000
EXAMPLE                                                                 43265000
                                                                        43270000
To create a new group named GROUP1, enter:                              43275000
                                                                        43280000
    :NEWGROUP GROUP1                                                    43285000
                                                                        43290000
Default values are taken for all parameters.                            43295000
\ENTRY=NEWUSER,PARMS,OPERATION,EXAMPLE                                  43300000
    :NEWUSER (Account Manager capability required)                      43305000
                                                                        43310000
Defines a new user.                                                     43315000
                                                                        43320000
SYNTAX                                                                  43325000
                                                                        43330000
    :NEWUSER username                                                   43335000
             [;PASS=[password]]                                         43340000
             [;CAP=[capabilitylist]]                                    43345000
             [;MAXPRI=[subqueuename]]                                   43350000
             [;LOCATTR=[localattribute]]                                43355000
             [;HOME=[homegroupname]]                                    43360000
                                                                        43365000
                                                                        43370000
\ITEM=PARMS                                                             43375000
PARAMETERS                                                              43380000
                                                                        43385000
username             The name of the user, composed of up to eight      43390000
                     alphanumeric characters, beginning with a letter.  43395000
                     (REQUIRED PARAMETER)                               43400000
                                                                        43405000
password             User password.  (This password is used for         43410000
                     verifying logon access only.)  Default is no       43415000
                     password is assigned.                              43420000
                                                                        43425000
capabilitylist       List of capabilities, mutually separated by commas,43430000
                     permitted this account.  Each capability is denoted43435000
                     by a two-letter mnemonic, as follows:              43440000
                                                                        43445000
                     System Manager          = SM                       43450000
                     Account Manager         = AM                       43455000
                     Account Librarian       = AL                       43460000
                     Group Librarian         = GL                       43465000
                     Diagnostician           = DI                       43470000
                     System Supervisor       = OP                       43475000
                     Network Administration  = NA                       43480000
                     Node Manager            = NM                       43485000
                                                                        43490000
                     Permanent Files         = SF                       43495000
                     Access of non-sharable                             43500000
                     I/O devices             = ND                       43505000
                     Create Volumes          = CV                       43510000
                     Use Volumes             = UV                       43515000
                     Use Communications                                 43516000
                     Subsystems              = CS                       43517000
                     Create                                             43518000
                     Programmatic Sessions   = PS                       43519000
                                                                        43520000
                     Process Handling        = PH                       43525000
                     Extra Data Segments     = DS                       43530000
                     Multiple RINS           = MR                       43535000
                     Privileged Mode         = PM                       43540000
                     Interactive Access      = IA                       43545000
                     Local Batch Access      = BA                       43550000
                     User Logging            = LG                       43555000
                                                                        43560000
                     This parameter cannot specify capabilities that are43565000
                     not assigned to the user's account.  Default is    43570000
                     SF, ND, IA, BA.                                    43575000
                                                                        43580000
subqueuename         Name of the subqueue of highest priority that can  43585000
                     be requested by any process of any job/session in  43590000
                     the account, specified as "xS," where x is A, B, C,43595000
                     D, or E.  The priority specified in :NEWUSER cannot43600000
                     be greater than that specified in :NEWACCT or      43605000
                     :ALTACCT.  If the user's account is changed later, 43610000
                     however, the user may be left with excessive       43615000
                     limits.  The <subqueuename> defined for the user is43620000
                     checked against the <subqueuename> defined for his 43625000
                     account at logon time, and the lower priority of   43630000
                     the two is used as the maximum priority restricting43635000
                     all processes of the job/session.  Also, the       43640000
                     priority requested by the user when he logs on is  43645000
                     checked against the <subqueuename> defined for him,43650000
                     and he is granted the lower of these two values.   43655000
                     Default is CS.                                     43660000
                                                                        43665000
localattribute       The local attribute of the user, as defined at the 43670000
                     installation site.  This is a double-word of       43675000
                     arbitrary meaning which might be used to further   43680000
                     classify users.  Default is double-word 0.         43685000
                                                                        43690000
homegroupname        The name of an existing group to be assigned as the43695000
                     homegroup for this user. If no homegroup is        43700000
                     assigned, the user must always specify a group when43705000
                     logging on.  Default is no homegroup is assigned.  43710000
                                                                        43715000
\ITEM=OPERATION                                                         43720000
OPERATION                                                               43725000
                                                                        43730000
(Account Manager capability required)                                   43735000
This command defines a new user.                                        43740000
                                                                        43745000
\ITEM=EXAMPLE                                                           43750000
EXAMPLE                                                                 43755000
                                                                        43760000
To define a new user named LHSMITH, assign a password of SMITTY, and a  43765000
homegroup of HOMEGPX, enter:                                            43770000
                                                                        43775000
    :NEWUSER LHSMITH;PASS=SMITTY;HOME=HOMEGPX                           43780000
                                                                        43785000
\ENTRY=NEWVSET,PARMS,OPERATION,EXAMPLE                                  43790000
    :NEWVSET                                                            43795000
                                                                        43800000
(System Manager, or Account Manager with Volume Set Creation (CV)       43805000
capability required)                                                    43810000
                                                                        43815000
Defines private volume sets and classes.                                43820000
                                                                        43825000
SYNTAX                                                                  43830000
                                                                        43835000
    :NEWVSET vsname                                                     43840000
             [;MEMBERS=vname:type[,vname:type,...[vname:type]]          43845000
             [;CLASS=vcname:vname[,vname,...[,vname]]                   43850000
                                                                        43855000
\ITEM=PARMS                                                             43860000
PARAMETERS                                                              43865000
                                                                        43870000
vsname            Volume set name, consisting of from one to eight      43875000
                  alphanumeric characters, beginning with a letter.     43880000
                  This name is also given to the master volume of the   43885000
                  set.                                                  43890000
                  MPE will implicitly reference <vsname> as             43895000
                  <vsname.groupname.acctname>, where <groupname> and    43900000
                  <acctname> are the logon group and account. (REQUIRED 43905000
                  PARAMETER)                                            43910000
                                                                        43915000
vname:type        Names of members of the volume set and the types of   43920000
                  devices on which the members will reside.  A maximum  43925000
                  of eight volume names may be specified.  The list     43930000
                  of volumes names must include the master volume       43935000
                  set name.  The <type>                                 43940000
                  must be specified with each volume member to define   43945000
                  the type of disc required to accomodate the volume.   43950000
                  Types of discs that may be specified are HP7905,      43955000
                  HP7906, HP7920, HP7925, HP7933, and HP7935.           43960000
                                                                        43965000
                                                                        43970000
                                                                        43975000
                                                                        43980000
vcname:vname      Volume class name, consisting of from one to eight    43985000
                  alphanumeric characters, beginning with a letter. Each43990000
                  volume class consists of a volume class name and an   43995000
                  associated list of volume names <vname>.  The list of 44000000
                  volume names must be a subset of the volumes          44005000
                  comprising the volume set, and one of the volume names44010000
                  must be that of the volume set's master volume.       44015000
                                                                        44020000
\ITEM=OPERATION                                                         44025000
OPERATION                                                               44030000
                                                                        44035000
(System Manager, or Account Manager with Volume Set Creation (CV)       44040000
capability required)                                                    44045000
The :NEWVSET command creates private volume sets and classes.           44050000
Once a volume set or volume class is defined, its                       44055000
definition is kept on disc in a volume set definition entry.  A physical44060000
volume set is not created at the time the volume set is defined, only   44065000
the members of the volume set and the corresponding storage types are   44070000
defined to MPE.                                                         44075000
                                                                        44080000
\ITEM=EXAMPLE                                                           44085000
EXAMPLE                                                                 44090000
                                                                        44095000
To define a volume set with <vsname> USERSET; with members USERSET      44100000
(master volume), MEM1, and <type> HP 7920; and class <vcname:vname>     44105000
CLASS1:USERSET,MEM1, enter:                                             44110000
                                                                        44115000
    :NEWVSET USERSET;MEMBERS=USERSET:HP7920,MEM1:HP7920&                44120000
    : ;CLASS=CLASS1:USERSET,MEM1                                        44125000
                                                                        44130000
                                                                        44135000
\ENTRY=NRJE,PARMS,OPERATION,EXAMPLE                                     44140000
           :NRJE                                                        44145000
                                                                        44150000
This command invokes the NRJE subsystem, providing batch communi-       44155000
cations across SNA networks.                                            44160000
                                                                        44165000
SYNTAX                                                                  44170000
                                                                        44175000
           :NRJE [workstation]                                          44180000
                                                                        44185000
\ITEM=PARMS                                                             44190000
PARAMETERS                                                              44195000
                                                                        44200000
workstation    Identifies the particular workstation the user wishes    44205000
               to access.  The workstation parameter is an alphanu-     44210000
               meric name beginning with a letter and containing one    44215000
               to eight characters.  A workstation parameter is asso-   44220000
               ciated with a host remote.                               44225000
                                                                        44230000
\ITEM=OPERATION                                                         44235000
OPERATION                                                               44240000
The NRJE command invokes the NRJE subsystem, which supports batch com-  44245000
munications across SNA networks.  After an MPE user enters the NRJE     44250000
command, the NRJE subsystem will print a banner line, initiate neces-   44255000
sary error recovery, optionally print a welcome message, and prompt     44260000
for a command.  The user can specify the workstation he or she wishes   44265000
to access in the NRJE command, or select the workstation in subsequent  44270000
subsystem commands.  The subsystem HELP command provides additional     44275000
information about NRJE operation.                                       44280000
                                                                        44285000
\ITEM=EXAMPLE                                                           44290000
EXAMPLES                                                                44295000
                                                                        44300000
          :NRJE baedp                                                   44305000
                                                                        44310000
After entering this command, the MPE user will enter the NRJE subsys-   44315000
tem.  Subsequent subsystem commands will access the workstation,        44320000
baedp, by default.                                                      44325000
                                                                        44330000
                                                                        44335000
          :NRJE                                                         44340000
                                                                        44345000
After entering this command, the MPE user will enter the NRJE subsys-   44350000
tem.  The user must select a workstation in subsequent subsystem com-   44355000
mands.                                                                  44360000
\ENTRY=NRJECONTROL,PARMS,OPERATION,EXAMPLE                              44365000
        :NRJECONTROL                                                    44370000
                                                                        44375000
The NRJECONTROL command is available to the MPE user with NM            44380000
capability to start or stop an NRJE workstation and LUs, or to          44385000
start or stop tracing associated with a workstation.                    44390000
                                                                        44395000
SYNTAX                                                                  44400000
                                                                        44405000
NRJECONTROL START;WSID=wsid[;CHAINSIZE=numrus]                          44410000
                [;LU=LUname,LUname,...]                                 44415000
                [;TRACE=[type[,[type][,[file][,[dev][,size]]]]]]        44420000
                                                                        44425000
NRJECONTROL STOP;WSID=wsid;[LU=LUname,LUname,...]                       44430000
                                                                        44435000
NRJECONTROL HALT;WSID=wsid;[LU=LUname,LUname,...]                       44440000
                                                                        44445000
NRJECONTROL TRACEON;WSID=wsid                                           44450000
            [;TRACE=type[,[type][,[file][,[dev][,size]]]]]              44455000
                                                                        44460000
NRJECONTROL TRACEOFF;WSID=wsid                                          44465000
            [;TRACE=type[,type]]                                        44470000
                                                                        44475000
\ITEMS=PARMS                                                            44480000
PARAMETERS                                                              44485000
                                                                        44490000
START       Indicates that either a workstation is to be started, or,   44495000
            if the named workstation is already started, that the in-   44500000
            dicated LUs are to be initiated.  If no LUnames are pro-    44505000
            vided, the workstation must be inactive, and whatever LUs   44510000
            are configured for automatic initiation will be activated.  44515000
            When the workstation is started, NRJE streams the NRJE      44520000
            monitor which runs as an MPE job.                           44525000
                                                                        44530000
STOP        Indicates that the named workstation is to be stopped, or,  44535000
            if specific LUs are named, that these LUs only are to be    44540000
            stopped.                                                    44545000
                                                                        44550000
HALT        Indicates that the named workstation is to be aborted, or,  44555000
            if specific LUs are named, that these LUs only are to be    44560000
            aborted.                                                    44565000
                                                                        44570000
TRACEON     Indicates that the specified traces are to be initiated     44575000
            for a workstation.                                          44580000
                                                                        44585000
TRACEOFF    Indicates that the specified traces are to be stopped for   44590000
            a workstation.                                              44595000
                                                                        44600000
wsid        One to eight character workstation identifier.              44605000
                                                                        44610000
numrus      Specifies the number of request units to send to the re-    44615000
            mote host before requesting a definite response.  The       44620000
            valid range is 1 through 99.  This value defaults to a      44625000
            configured number.                                          44630000
                                                                        44635000
LUname      One to eight character LU name.  A maximum of five LUs      44640000
            can be identified.  The LUs to initiate defaults to a       44645000
            list of LUs configured to be automatically started  for     44650000
            the workstation.                                            44655000
                                                                        44660000
type        A keyword identifying the type of trace to be started.      44665000
            The possible types are INTERNAL and USER.  To store data    44670000
            generated by different traces in the same file, multiple    44675000
            trace types can be indicated after the TRACEON keyword.     44680000
                                                                        44685000
file        An actual file designator of a disk or tape file which      44690000
            will hold the trace data.  The default is the file          44695000
            NMTCxxxx.  xxxx is a number which is incremented each time  44700000
            a default file is created.                                  44705000
                                                                        44710000
dev         Either of the keywords DISK or TAPE, identifying the de-    44715000
            vice type of the trace file.  The default is DISK.          44720000
                                                                        44725000
size        The number of 128 word logical records stored in the        44730000
            trace file.  The default for disk files is the Network      44735000
            Management default.  The size of a tape file is one tape    44740000
            volume, regardless of the size specified in the NRJECON-    44745000
            TROL command.                                               44750000
                                                                        44755000
\ITEM=OPERATION                                                         44760000
OPERATION                                                               44765000
                                                                        44770000
When the MPE user executes the NRJECONTROL command and specifies the    44775000
START parameter, NRJE will initiate the workstation, LUs, and tracing   44780000
indicated.  Default LU names and chainsize value will be obtained       44785000
from NRJE configuration, if necessary.  If the workstation indicated    44790000
is already active, NRJE will only initiate the specified LUs and        44795000
traces.                                                                 44800000
                                                                        44805000
When the MPE user executes the NRJECONTROL command and specifies the    44810000
TRACEON parameter, NRJE will start recording the indicated trace infor- 44815000
mation in the specified file.  If no file is indicated, the trace will  44820000
be written to the Network Management default file.  If no traces are    44825000
specified, NRJE will start user and internal traces.                    44830000
                                                                        44835000
When the MPE user executes the NRJECONTROL command and specifies the    44840000
TRACEOFF parameter, NRJE will stop the traces indicated.  If no         44845000
traces are specified, all tracing of the indicated workstation will     44850000
be terminated.                                                          44855000
                                                                        44860000
When the MPE user executes the NRJECONTROL command and specifies the    44865000
STOP parameter, NRJE will stop the specified LUs.  If no LUs are in-    44870000
dicated, NRJE will stop all the LUs of the workstation.                 44875000
                                                                        44880000
When the MPE user executes the NRJECONTROL command and specifies the    44885000
HALT parameter, NRJE will abort the specified LUs.  If no LUs are in-   44890000
dicated, NRJE will abort all the LUs of the workstation.                44895000
                                                                        44900000
\ITEM=EXAMPLE                                                           44905000
EXAMPLES                                                                44910000
                                                                        44915000
        :NRJECONTROL START;WSID=baedp;CHAINSIZE=15                      44920000
                                                                        44925000
This command initiates the workstation "baedp" with those LUs that      44930000
have been configured for automatic initiation.  These LUs will trans-   44935000
mit with a chain size of 15.                                            44940000
                                                                        44945000
        :NRJECONTROL START;WSID=BAEDP;LU=BLUE;CHAINSIZE=21              44950000
                                                                        44955000
This command initiates the LU "blue" at the workstation "baedp"         44960000
(whether or not that workstation is already active).  The command       44965000
also specifies that "blue" will transmit with a  chain size of 21.      44970000
                                                                        44975000
        :NRJECONTROL TRACEON;WSID=BAEDP;TRACE=USER                      44980000
                                                                        44985000
This initiates USER tracing on "baedp" to the default trace file.  A    44990000
message will be returned indicating the name of the trace file.         44995000
                                                                        45000000
        :NRJECONTROL HALT;WSID=baedp;LU=blue                            45005000
                                                                        45010000
The LU "blue" is now aborted.  The LU process is terminated and a       45015000
protocol shutdown sequence is not executed.                             45020000
                                                                        45025000
        :NRJECONTROL TRACEOFF;WSID=baedp                                45030000
                                                                        45035000
Tracing for the workstation is now turned off.                          45040000
                                                                        45045000
        :NRJECONTROL STOP;WSID=baedp                                    45050000
                                                                        45055000
The "baedp" workstation is now stopped; all LUs will go inactive.       45060000
                                                                        45065000
                                                                        45070000
\ENTRY=OPENQ,PARMS,OPERATION,EXAMPLE                                    45075000
     :OPENQ                                                             45080000
                                                                        45085000
Opens a spool queue.                                                    45090000
                                                                        45095000
SYNTAX                                                                  45100000
                                                                        45105000
:OPENQ [ldn]                                                            45110000
       [devclass]                                                       45115000
                                                                        45120000
                                                                        45125000
\ITEM=PARMS                                                             45130000
                                                                        45135000
PARAMETERS                                                              45140000
                                                                        45145000
ldn          The logical device number of an output spoolable device.   45150000
                                                                        45155000
devclass     A device class containing at least one output spoolable    45160000
             device.                                                    45165000
                                                                        45170000
\ITEM=OPERATION                                                         45175000
                                                                        45180000
OPERATION                                                               45185000
                                                                        45190000
The :OPENQ command opens the spool queue for the specified logical      45195000
device or device class.                                                 45200000
                                                                        45205000
\ITEM=EXAMPLE                                                           45210000
                                                                        45215000
EXAMPLE                                                                 45220000
                                                                        45225000
To open the spool queue for logical device 6, enter:                    45230000
                                                                        45235000
      :OPENQ 6                                                          45240000
                                                                        45245000
To open the spool queue for device class LP, enter:                     45250000
                                                                        45255000
      :OPENQ LP                                                         45260000
                                                                        45265000
\ENTRY=OUTFENCE,PARMS,OPERATION,EXAMPLE                                 45270000
     :OUTFENCE                                                          45275000
                                                                        45280000
Defines acceptable priorities for output spooled files.                 45285000
                                                                        45290000
SYNTAX                                                                  45295000
                                                                        45300000
     :OUTFENCE outputpriority [;ldev=ldn]                               45305000
                                                                        45310000
\ITEM=PARMS                                                             45315000
PARAMETERS                                                              45320000
                                                                        45325000
outputpriority      A number between 1 and 14, inclusive (large is      45330000
                    more limiting).                                     45335000
                                                                        45340000
ldn                 Logical device number of an output device.          45345000
                    (Optional parameter.)                               45350000
\ITEM=OPERATION                                                         45355000
OPERATION                                                               45360000
                                                                        45365000
In order to enable deferred output spooled devicefiles to be processed  45370000
by a spooler, their outputpriority must be raised above the output      45375000
fence, or the output fence must be lowered.                             45380000
                                                                        45385000
\ITEM=EXAMPLE                                                           45390000
EXAMPLES                                                                45395000
                                                                        45400000
To set the global outfence to 14 and the outfence of ldev               45405000
6 to 8, enter:                                                          45410000
                                                                        45415000
     :OUTFENCE 14                                                       45420000
     :OUTFENCE 8;LDEV=6                                                 45425000
     :SHOWOUT                                                           45430000
                                                                        45435000
DEV/CL    DFID    JOBNUM  FNAME    STATE FRM SPACE  RANK PRI  #C        45440000
LP        #O999   #J19    $SDTLIST OPENED       512       I    1        45445000
LP        #O1030  #S77    EDTLIST  OPENED       512       8    1        45450000
SLOWLP    #O1029  #S'1153 OUT      READY        232   1   8    1        45455000
20        #O1001  #S60    $STDLIST OPENED                               45460000
47        #O1028  #S78    $STDLIST OPENED                               45465000
52        #O1019  #S72    $STDLIST OPENED                               45470000
54        #O1023  #S74    $STDLIST OPENED                               45475000
80        #O1026  #S76    $STDLIST OPENED                               45480000
101       #O1027  #S77    $STDLIST OPENED                               45485000
103       #O1025  #S75    $STDLIST OPENED                               45490000
11        #O1022  #S33    GALLIST  ACTIVE       768   1   8    1        45495000
                                                                        45500000
11 FILES:                                                               45505000
    1 ACTIVE                                                            45510000
    1 READY; INCLUDING 1 SPOOFLES, 0 DEFERRED                           45515000
    9 OPENED; INCLUDING 2 SPOOFLES                                      45520000
    0 LOCKED; INCLUDING 0 SPOOFLES                                      45525000
    4 SPOOFLES;  2024 SECTORS                                           45530000
OUTFENCE = 14                                                           45535000
OUTFENCE = 8 FOR LDEV 6                                                 45540000
                                                                        45545000
This will defer all output spooled files, except those                  45550000
going to ldev 6. To reset the outfence for all output                   45555000
devices to 4, enter:                                                    45560000
                                                                        45565000
                                                                        45570000
                                                                        45575000
\ENTRY=PASCAL,PARMS,EXAMPLE,OPERATION                                   45580000
    :PASCAL                                                             45585000
                                                                        45590000
Compiles a PASCAL program.                                              45595000
                                                                        45600000
SYNTAX                                                                  45605000
                                                                        45610000
 :PASCAL [textfile][,[uslfile][,[listfile]]][;INFO=quotedstring]        45615000
                                                                        45620000
\ITEM=PARMS                                                             45625000
PARAMETERS                                                              45630000
                                                                        45635000
textfile            Actual designator of input file from which source   45640000
                    program is read.  Can be any ASCII input file.      45645000
                    Formal designator is PASTEXT. Default is $STDIN.    45650000
                                                                        45655000
uslfile             Actual designator of user subprogram library (USL)  45660000
                    file on which object program is written. Can be     45665000
                    any binary output file with file code if USL (or    45670000
                    1024).  Formal designator is PASUSL.  If entered,   45675000
                    this parameter must indicate a file created in      45680000
                    one of four ways:                                   45685000
                                                                        45690000
                    1.  By saving a USL file (with the :SAVE command)   45695000
                        created by a previous compilation where the     45700000
                        default value was used for the <uslfile>        45705000
                        parameter.                                      45710000
                                                                        45715000
                    2.  By building the USL with the Segmenter command  45720000
                        -BUILDUSL.                                      45725000
                                                                        45730000
                    3.  By creating a new USL file with the MPE :BUILD  45735000
                        command and a <filecode> parameter of USL or    45740000
                        1024.                                           45745000
                                                                        45750000
                    4.  By specifying a non-exsistent <uslfile>         45755000
                        parameter, thereby creating a permanent file    45760000
                        of the correct size and type.                   45765000
                                                                        45770000
                    If no <uslfile> parameter is supplied, the USL file 45775000
                    is saved to the temporary file, $OLDPASS.           45780000
                                                                        45785000
listfile            Actual designator of file on which program listing  45790000
                    is written.  Can be any ASCII output file.  Formal  45795000
                    designator is PASLIST. Default is $STDLIST.         45800000
                                                                        45805000
quotedstring       A string of ASCII characters delimited by a matching 45810000
                    set of either 's or "s.  If the delimiting character45815000
                    is desired within the string it can be doubled as in45820000
                    most programming languages. This feature is used    45825000
                    for specifying compiler options, which will appear  45830000
                    in front of the source listing.                     45835000
                                                                        45840000
                            NOTE                                        45845000
                                                                        45850000
     The formal file designators used in this command                   45855000
     (PASTEXT, PASUSL, PASLIST) cannot be back                          45860000
     referenced as actual file designators in the command               45865000
     parameter list.  For futher information , see the disscusion       45870000
     of implied :FILE commands in Section I of the MPE                  45875000
     Commands Reference Manual.                                         45880000
                                                                        45885000
\ITEM=OPERATION                                                         45890000
OPERATION                                                               45895000
                                                                        45900000
Compiles PASCAL program onto USL file on disc.  If you do not specify a 45905000
source text file, MPE expects input from your standard input device.  If45910000
you create the USL prior to compilation, you must specify a <filecode>  45915000
of USL or 1024.  If you do not specify a <listfile>, MPE sends the      45920000
program listing to the current list device.                             45925000
                                                                        45930000
\ITEM=EXAMPLE                                                           45935000
EXAMPLE                                                                 45940000
                                                                        45945000
To compile a PASCAL program that you enter from your current input      45950000
device into an object program in the USL fiel $NEWPASS, and write the   45955000
listing to your current list device, enter:                             45960000
                                                                        45965000
    :PASCAL                                                             45970000
                                                                        45975000
If the next command is one to prepare an object program, $NEWPASS can be45980000
passed to that command by specifying $OLDPASS for the <uslfile>         45985000
parameter.                                                              45990000
                                                                        45995000
To compile a PASCAL program residing on the disc file PASCSRC into      46000000
an object program on the USL file PASCOBJ, with the program listing     46005000
to be sent to the disc file LISTFILE, enter:                            46010000
                                                                        46015000
    :BUILD PASCOBJ;CODE=USL                                             46020000
    :PASCAL PASCSRC,PASCOBJ,LISTFILE                                    46025000
                                                                        46030000
                                                                        46035000
\ENTRY PASCALGO=PARMS,OPERATION,EXAMPLE                                 46040000
     :PASCALGO                                                          46045000
                                                                        46050000
Compiles, prepares, and executes a PASCAL program.                      46055000
                                                                        46060000
SYNTAX                                                                  46065000
                                                                        46070000
    :PASCALGO [textfile][,[listfile]][;INFO=quotedstring]               46075000
                                                                        46080000
\ITEM=PARMS                                                             46085000
PARAMETERS                                                              46090000
                                                                        46095000
textfile            Actual designator of input file from which source   46100000
                    program is read.  Can be any ASCII input file.      46105000
                    Formal designator is PASTEXT. Default is $STDIN.    46110000
                                                                        46115000
listfile            Actual designator of file on which program listing  46120000
                    is written.  Can be any ASCII output file.  Formal  46125000
                    designator is PASTEXT.  Default is $STDLIST.        46130000
                                                                        46135000
quotedstring        A string of ASCII characters delimited by a matching46140000
                    set of either 's or "s.  If the delimiting character46145000
                    is desired within the string it can be doubled as in46150000
                    most programming languages. This feature is used    46155000
                    for specifying compiler options, which will appear  46160000
                    in front of the source listing.                     46165000
                                                                        46170000
                              NOTE                                      46175000
                                                                        46180000
      The formal file designators used in this command                  46185000
      (PASTEXT, PASLIST) cannot be back referenced as                   46190000
      actual file designators in the command parameter                  46195000
      list.  For futher information, see the disscusion                 46200000
      of the implied :FILE commands in Section I of the                 46205000
      MPE Commands Reference Manual.                                    46210000
                                                                        46215000
\ITEM=OPERATION                                                         46220000
OPERATION                                                               46225000
                                                                        46230000
Compiles, prepares, and executes a PASCAL program. If you do            46235000
not specify <textfile>, MPE expects input from your current             46240000
input device.  If you do not specify <listfile>, MPE writes the         46245000
listing to the current list device.  This command creates a             46250000
temporary USL file ($NEWPASS) that cannot be accessed, and a            46255000
temporary program file that can accessed under the name $OLDPASS.       46260000
                                                                        46265000
\ITEM=EXAMPLE                                                           46270000
EXAMPLE                                                                 46275000
                                                                        46280000
To compile, prepare, and execute a PASCAL program entered from          46285000
your current input device, with the program listing going to            46290000
the current list device, enter:                                         46295000
                                                                        46300000
    :PASCALGO                                                           46305000
                                                                        46310000
To compile, prepare, and execute a PASCAL program from the disc         46315000
file PASCSRC and send the program listing to the file LISTFILE          46320000
enter:                                                                  46325000
                                                                        46330000
    :PASCALGO PASCSRC,LISTFILE                                          46335000
                                                                        46340000
                                                                        46345000
\ENTRY=PASCALPREP,PARMS,OPERATION,EXAMPLE                               46350000
     :PASCALPREP                                                        46355000
                                                                        46360000
Compiles and prepares a PASCAL program.                                 46365000
                                                                        46370000
SYNTAX                                                                  46375000
                                                                        46380000
:PASCALPREP [textfile][,[progfile][,[listfile]]][;INFO=quotedstring]    46385000
                                                                        46390000
\ITEM=PARMS                                                             46395000
PARAMETERS                                                              46400000
                                                                        46405000
textfile            Actual designator of input file from which source   46410000
                    source program is read.  Can be any ASCII input     46415000
                    file.  Formal designator is PASTEXT. Default is     46420000
                    $STDIN.                                             46425000
                                                                        46430000
progfile            Actual designator of program file on which          46435000
                    prepared program segments are written.  Can be      46440000
                    any binary output file with <filecode> of PROG      46445000
                    or 1029.  If parameter is specified, it must        46450000
                    indicate a file created in one of two ways:         46455000
                                                                        46460000
                    1.  With  the MPE command :BUILD, specifying a      46465000
                        <filecode> of PROG or 1029 and a                46470000
                        <numextents> parameter value of 1.              46475000
                                                                        46480000
                    2.  By specifying a non-existent file in the        46485000
                        <progfile> parameter in which case a job        46490000
                        temporary file of the correct size and type     46495000
                        is created.                                     46500000
                                                                        46505000
                    If no <uslfile> parameter is supplied, the USL file 46510000
                    is saved to the temporary file, $OLDPASS.           46515000
                                                                        46520000
listfile            Actual designator of file on which program          46525000
                    listing is written.  Can be any ASCII output        46530000
                    file.  Formal designator is PASLIST. Default is     46535000
                    $STDLIST.                                           46540000
                                                                        46545000
quotedstring        A string of ASCII characters delimited by a matching46550000
                    set of either 's or "s.  If the delimiting character46555000
                    is desired within the string it can be doubled as in46560000
                    most programming languages. This feature is used    46565000
                    for specifying compiler options, which will appear  46570000
                    in front of the source listing.                     46575000
                                                                        46580000
                          NOTE                                          46585000
      The formal file designators used in this command                  46590000
      (PASTEXT, PASPROG, PASLIST) cannot be back referenced             46595000
      as actual file designators in the command parameter               46600000
      list.  For further information, see the discussion of             46605000
      implied :FILE commands in  Section I of the MPE                   46610000
      Commands Reference Manual.                                        46615000
                                                                        46620000
\ITEM=OPERATION                                                         46625000
OPERATION                                                               46630000
                                                                        46635000
Compiles and prepares a PASCAL program onto a program file on disc.     46640000
If you do not specify <textfile>, MPE expects input from the current    46645000
input device.  If you create the program file prior to compilation,     46650000
you must use the <filecode> parameter of PROG or 1029a and a            46655000
<numextents> parameter value of 1 on your :BUILD command. If you do     46660000
not specify <listfile>, MPE sends the listing output to your current    46665000
list device.  The USL file created during compilation is a temporary    46670000
file passed directly to the preparation mechanism.                      46675000
                                                                        46680000
\ITEM=EXAMPLE                                                           46685000
EXAMPLE                                                                 46690000
                                                                        46695000
To compile and prepare a PASCAL program entered through the curent      46700000
input device, onto the file $NEWPASS, with the listing printed on       46705000
the current list device, enter:                                         46710000
                                                                        46715000
    :PASCALPREP                                                         46720000
If the next command is one to execute a program, the file $NEWPASS      46725000
is referenced in the execute command under the name $OLDPASS.           46730000
                                                                        46735000
To compile and prepare a PASCAL source program from a source file       46740000
named PASCSRC into a program file named PASCPROG, with the resulting    46745000
listing sent to the current list device, enter:                         46750000
                                                                        46755000
    :PASCALPREP PASCSRC,PASCPROG                                        46760000
    :OUTFENCE 4                                                         46765000
                                                                        46770000
\ENTRY=PARTBACKUP,PARMS,OPERATION,EXAMPLE                               46770010
    :PARTBACKUP (System Supervisor capability required)                 46770020
                                                                        46770030
Creates a backup of MPE and all files been modified since the last      46770040
:FULLBACKUP or the last :SYSDUMP with a file subset of @.@.@.           46770050
                                                                        46770060
SYNTAX                                                                  46770070
                                                                        46770080
    :PARTBACKUP [dumpfile][,auxlistfile]                                46770090
                                                                        46770100
\ITEM=PARMS                                                             46770110
PARAMETERS                                                              46770120
                                                                        46770130
dumpfile        If specified, a back reference to a previous :FILE      46770140
                command that defines the file on which the modified or  46770150
                duplicate system is to be written.  This back reference 46770160
                must indicate a magnetic tape file.  Formal designator  46770170
                is DUMPTAPE.  Use the following file statement form:    46770180
                                                                        46770190
                    FILE dumpfile[=filereference][;DEV=device]          46770200
                         [;REC=recordsize][;BUF  ]                      46770210
                                           ;NOBUF                       46770220
                                                                        46770230
                       REC      Specifies the tape record size.  May    46770240
                                be any number which is a multiple of    46770250
                                256 words between 256 and 8192 words.   46770260
                                The default for non-programmatic calls  46770270
                                to PARTBACKUP is 4096 words.  For pro-  46770280
                                grammatic calls the default is 1024     46770290
                                words.                                  46770300
                                                                        46770310
                       BUF      User specification on whether buffered  46770320
                                I/O is used to do the store.  For serial46770330
                                disc it is recommended that NOBUF is    46770340
                                used because the system automatically   46770350
                                buffers the transfer.  For tape trans-  46770360
                                fers the default of BUF should be used. 46770370
                                                                        46770380
 Note: If [dumpfile] is not specified, then the default will be used.   46770390
       The default is one of the two following:                         46770400
       If the user has a file equation with the formal file designator  46770410
       of DUMPTAPE, then it will be used.  Otherwise a file equation    46770420
       of the form FILE DUMPTAPE;DEV=TAPE will be used.                 46770430
                                                                        46770440
                                                                        46770450
                                                                        46770460
auxlistfile     Actual file designator of the output file (device) to   46770470
                which all listings requested during the execution       46770480
                of the backup process are written.  The formal file     46770490
                designator used by the :PARTBACKUP command executor for 46770500
                this file is SYSLIST; the formal file designator used by46770510
                the MPE Segmenter (when it is invoked to add or replace 46770520
                SL segments) for this file is SEGLIST.  Default is      46770530
                $STDLIST.                                               46770540
                                                                        46770550
\ITEM=OPERATION                                                         46770560
OPERATION                                                               46770570
                                                                        46770580
(System Supervisor capability required)                                 46770590
This command starts the backup process and copies MPE and all files     46770600
modified since the last full system backup to magnetic tape.            46770610
                                                                        46770620
In addition to the names of the files to be used for <dumpfile> and     46770630
<auxlistfile> output, you may specify what types of devices these files 46770640
are to reside on.  You do this by preceding the :PARTBACKUP command with46770650
MPE :FILE commands defining each of the two files.  Then, in the        46770660
:PARTBACKUP command, you precede each <filename> with an asterisk (*) to46770670
indicate a back reference to the definitions in the :FILE commands.     46770680
                                                                        46770690
\ITEM=EXAMPLE                                                           46770700
EXAMPLE                                                                 46770710
                                                                        46770720
To begin execution of the backup process, the :PARTBACKUP command is    46770730
entered.  There is no dialog, and the MPE configuration and all files   46770740
copied to the file named DUMP.  Any listings requested during the       46770750
backup are output to the file named LIST.  The first :FILE command      46770760
specifies that DUMP is a magnetic tape file; the second :FILE command   46770770
defines LIST as a line printer.  (In the :FILE commands, the TAPE and LP46770780
parameters are device class names arbitrarily defined by a user during  46770790
the previous configuration.)                                            46770800
                                                                        46770810
    :FILE DUMP;DEV=TAPE                                                 46770820
    :FILE LIST;DEV=LP                                                   46770830
    :PARTBACKUP *DUMP,*LIST                                             46770840
                                                                        46770850
The console will look like:                                             46770860
?11:08/#S278/89/LDEV# FOR "DUMP" ON TAPE (NUM)?                         46770870
                                                                        46770880
If a file equation with the formal file designator of DUMPTAPE was      46770890
previously entered during the session (ex. FILE DUMPTAPE;DEV=SYSTAPE)   46770900
then the user may omit the first parameter and the backup will go       46770910
to device class SYSTAPE.                                                46770920
                                                                        46770930
     :PARTBACKUP ,*LIST                                                 46770940
                                                                        46770950
And the console request will look like:                                 46770960
?11:08/#S278/89/LDEV# FOR "DUMPTAPE" ON SYSTAPE (NUM)?                  46770970
                                                                        46770980
If dumpfile is not specified and there is no file equation for          46770990
DUMPTAPE, then a temporary file equation (FILE DUMPTAPE;DEV=TAPE)       46771000
will be used.                                                           46771010
                                                                        46771020
     :PARTBACKUP                                                        46771030
                                                                        46771040
In this event, the console request will look like:                      46771050
?11:08/#S278/89/LDEV# FOR "DUMPTAPE" ON TAPE (LDEV)?                    46771060
                                                                        46771070
                                                                        46775000
\ENTRY=PREP,PARMS,OPERATION,EXAMPLE                                     46780000
    :PREP                                                               46785000
                                                                        46790000
Prepares program from a User Subprogram Library (USL) file onto a       46795000
program file.                                                           46800000
                                                                        46805000
SYNTAX                                                                  46810000
                                                                        46815000
    :PREP uslfile,progfile                                              46820000
          [;ZERODB]                                                     46825000
          [;PMAP]                                                       46830000
          [;MAXDATA=segsize]                                            46835000
          [;STACK=stacksize]                                            46840000
          [;DL=dlsize]                                                  46845000
          [;CAP=caplist]                                                46850000
          [;RL=filename]                                                46855000
          [;NOSYM]                                                      46860000
          [;FPMAP]                                                      46865000
                                                                        46870000
\ITEM=PARMS                                                             46875000
PARAMETERS                                                              46880000
                                                                        46885000
uslfile              Actual designator of USL file on which program has 46890000
                     been compiled.  (REQUIRED PARAMETER)               46895000
                                                                        46900000
progfile             Actual designator of program file on which prepared46905000
                     program segments are written.  Can be any binary   46910000
                     output file.  This program file must be created in 46915000
                     one of two ways:                                   46920000
                                                                        46925000
                     1.  By creating a new file with the MPE :BUILD     46930000
                         command with a <filecode> of PROG or 1029, and 46935000
                         a numextents parameter value of 1.             46940000
                                                                        46945000
                     2.  By specifying a non-existent file in the       46950000
                         <progfile> parameter, in which case a file of  46955000
                         the correct size and type is created. This file46960000
                         is a job temporary file. (REQUIRED PARAMETER)  46965000
                                                                        46970000
ZERODB               Request to initialize to zero the initially-       46975000
                     defined, user-managed (DL-DB) area, and unitialized46980000
                     portions of the DB-Q (initial).  Default is these  46985000
                     areas are not affected.                            46990000
                                                                        46995000
PMAP                 Request to produce a descriptive listing of the    47000000
                     prepared program on file whose formal designator is47005000
                     SEGLIST.  If no :FILE command is found referencing 47010000
                     SEGLIST, listing is produced on $STDLIST.  Default 47015000
                     is no listing.                                     47020000
                                                                        47025000
segsize              Maximum stack area (Z-DL) size permitted, in words.47030000
                     This parameter is included when it is expected that47035000
                     the size of DL-DB or Z-DB areas will be changed    47040000
                     during program execution. Default is that MPE      47045000
                     assumes that these areas will not change.          47050000
                                                                        47055000
stacksize            Size of initial local data area (Z-Q initial) in   47060000
                     stack, in words.  (This value, if specified, must  47065000
                     exceed 511 words.)  This parameter over rides      47070000
                     <stacksize> estimated by Segmenter. Default is     47075000
                     estimated by MPE Segmenter.                        47080000
                                                                        47085000
dlsize               DL-DB area to be initially assigned to stack. This 47090000
                     area is of interest mainly in programmatic         47095000
                     applications.  In all cases, the DL-DB area is     47100000
                     rounded upward so that the distance from the       47105000
                     beginning of the stack data segment to the DB-     47110000
                     address is a multiple of 128 words.  Default is    47115000
                     estimated by the MPE Segmenter.                    47120000
                                                                        47125000
caplist              Capability-class attributes associated with        47130000
                     program, specified as two-character mnemonics. If  47135000
                     more than one mnemonic is specified, each must be  47140000
                     separated from its neighbor by a comma.            47145000
                                                                        47150000
                     The mnemonics are:                                 47155000
                                                                        47160000
                     IA    Interactive access                           47165000
                     BA    Local batch access                           47170000
                     PH    Process handling                             47175000
                     DS    Data segment management                      47180000
                     MR    Multiple resource management                 47185000
                     PM    Privileged mode                              47190000
                                                                        47195000
                     Note that you can specify only those capabilities  47200000
                     that you possess (through assignment by the System 47205000
                     Manager or Account Manager). Default is IA, BA (if 47210000
                     you possess these capabilities).                   47215000
                                                                        47220000
filename             Actual designator of RL file to be searched to     47225000
                     satisfy external references during preparation.    47230000
                     This can be any permanent binary file of type RL.  47235000
                     It need not belong to logon group, nor have a      47240000
                     reserved, local name.  This file yields a single   47245000
                     segment that is incorporated into the segments of  47250000
                     the program file. See the MPE Segmenter Reference  47255000
                     Manual for a discussion of RL files. Default is no 47260000
                     library is searched.                               47265000
                                                                        47270000
NOSYM                Request to suppress Symbolic Item header informa-  47275000
                     tion and PMAP information from the resulting       47280000
                     program file.  This option is used in conjunction  47285000
                     with the HPTOOLSET Symbolic Item debugging option  47290000
                     Specifying this option can save file space but you 47295000
                     will not be able to do symbolic item debugging of  47300000
                     the program file created by the PREP.              47305000
                                                                        47310000
FPMAP                Request PMAP information be generated in the pro-  47315000
                     file created by the PREP.                          47320000
                                                                        47325000
\ITEM=OPERATION                                                         47330000
OPERATION                                                               47335000
                                                                        47340000
Prepares a compiled program onto a program file.  Unless this file is   47345000
explicitly created before issuing the :PREP command, a program file will47350000
be created by the command as a job/session temporary file.              47355000
                                                                        47360000
This command permits searching of a relocatable library (RL) to satisfy 47365000
references to external procedures required by the program.  When the    47370000
program is prepared, such procedures are linked to the program in the   47375000
resulting program file.                                                 47380000
                                                                        47385000
\ITEM=EXAMPLE                                                           47390000
EXAMPLE                                                                 47395000
                                                                        47400000
To prepare a program from the USL file named USEFILE and store it in a  47405000
program file named PROGFILE, enter:                                     47410000
                                                                        47415000
    :PREP USEFILE,PROGFILE                                              47420000
                                                                        47425000
To prepare a program from the USL file named USEFILE and store it in a  47430000
program file named PROGFILE, list the prepared program, assign a        47435000
stacksixe of 500 words, and assign batch-access capability only for the 47440000
program, enter:                                                         47445000
                                                                        47450000
    :PREP USEFILE,PROGFILE;PMAP;STACK=500;CAP=BA                        47455000
                                                                        47460000
                                                                        47465000
\ENTRY=PREPRUN,PARMS,OPERATION,EXAMPLE                                  47470000
    :PREPRUN                                                            47475000
                                                                        47480000
Prepares and executes a compiled program.                               47485000
                                                                        47490000
SYNTAX                                                                  47495000
                                                                        47500000
    :PREPRUN uslfile[,entrypoint]                                       47505000
             [;NOPRIV]                                                  47510000
             [;PMAP]                                                    47515000
             [;DEBUG]                                                   47520000
             [;LMAP]                                                    47525000
             [;ZERODB]                                                  47530000
             [;MAXDATA=segzixe]                                         47535000
             [;PARM=parameternum]                                       47540000
             [;STACK=stacksize]                                         47545000
             [;DL=dlsize]                                               47550000
                                                                        47555000
                     G                                                  47560000
             [;LIB= {P}]                                                47565000
                     S                                                  47570000
                                                                        47575000
             [;CAP=caplist]                                             47580000
             [;RL=filename]                                             47585000
             [;NOCB]                                                    47590000
                                                                        47595000
\ITEM=PARMS                                                             47600000
PARAMETERS                                                              47605000
                                                                        47610000
uslfile             Actual designator of USL file on which program has  47615000
                    been compiled.  (REQUIRED PARAMETER)                47620000
                                                                        47625000
entrypoint          Program entry point where execution is to begin. May47630000
                    be primary entry point of program, or any secondary 47635000
                    entry point in program's outer block. Default is    47640000
                    primary entry point.                                47645000
                                                                        47650000
NOPRIV              Declaration that program segments will be placed in 47655000
                    non-privileged (user) mode.  This parameter is      47660000
                    intended for programs prepared with privileged mode 47665000
                    capability.  Normally, program segments containing  47670000
                    privileged instructions are executed in privileged  47675000
                    mode only if program was prepared with privileged   47680000
                    mode (PM) capability class.  (A program containing  47685000
                    legally compiled privileged code, placed in         47690000
                    non-privileged mode, may abort when an atttempt is  47695000
                    made to execute it.)  If NOPRIV is specified, all   47700000
                    segments are placed in non-privileged mode. (Library47705000
                    segments are not affected because their mode is     47710000
                    determined independently.)  Default is segments of  47715000
                    privileged mode program will remain in privileged   47720000
                    mode.                                               47725000
                                                                        47730000
PMAP                Request to produce a descriptive listing of the     47735000
                    prepared program on file whose formal designator is 47740000
                    SEGLIST.  If no :FILE command referencing SEGLIST is47745000
                    found, listing is produced on current list device.  47750000
                    Default is no listing.                              47755000
                                                                        47760000
DEBUG               A request to set a breakpoint on the first          47765000
                    executable instruction of the program. Default is no47770000
                    breakpoint is set.                                  47775000
                                                                        47780000
LMAP                Request to produce a descriptive listing of the     47785000
                    allocated (loaded) program on file whose formal     47790000
                    designator is LOADLIST.  If no :FILE command        47795000
                    referencing LOADLIST is found, listing is produced  47800000
                    on $STDLIST.  Default is no listing.                47805000
                                                                        47810000
ZERODB              Request to initialize of zero initially-defined,    47815000
                    user-managed (DL-DB) area, and unitialized portions 47820000
                    of the DB-Q (initial) area.  Default is these areas 47825000
                    are not affected.                                   47830000
                                                                        47835000
segsize             Maximum stack area (Z-DL) area permitted, in words. 47840000
                    This parameter is included if it is expected that   47845000
                    sizes of DL-DB or Z-DB areas will be changed during 47850000
                    program execution. Default is MPE assumes that these47855000
                    areas will not be changed.                          47860000
                                                                        47865000
parameternum        Value that can be passed to program for             47870000
                    control or other purposes.  When program is         47875000
                    executed, this value can be retrieved from address  47880000
                    Q(initial)-4, where Q(initial) is Q- address for    47885000
                    outer block of program.  Value can be octal number  47890000
                    or signed or unsigned decimal number.  Default is   47895000
                    Q(initial)0-4 address is filled with zeros.         47900000
                                                                        47905000
stacksize           Size of local data area (Z-Q(initial)) in stack, in 47910000
                    words.  If specified, this value must exceed 511    47915000
                    words.  This parameter overrides <stacksize>        47920000
                    estimated by MPE Segmenter.  Default is estimated by47925000
                    MPE Segmenter.                                      47930000
                                                                        47935000
dlsize              DL-DB area to be initially assigned to stack. This  47940000
                    area is of interest mainly to programmatic          47945000
                    applications.  In all cases, the DL-DB area is      47950000
                    rounded upward so that the distance from the        47955000
                    beginning of the stack data segment to the DB-      47960000
                    address is a multiple of 128 words.  Default is     47965000
                    estimated by MPE Segmenter.                         47970000
                                                                        47975000
G                   Search segmented procedure libraries in the         47980000
                    following order:  group library, account library,   47985000
                    system library.  Default is S.                      47990000
                                                                        47995000
P                   Search segmented procedure libraries in the         48000000
                    following order:  account library, system library.  48005000
                    Default is S.                                       48010000
                                                                        48015000
S                   Search system library for external references to    48020000
                    segmented procedures.  Default.                     48025000
                                                                        48030000
caplist             Capability-class attributes associated with the     48035000
                    program, specified as two-character mnemonics. If   48040000
                    more than one mnemonic is specified, each must be   48045000
                    separated from its neighbor by a comma.             48050000
                                                                        48055000
                    The mnemonics are:                                  48060000
                                                                        48065000
                    IA    Interactive access                            48070000
                    BA    Local batch access                            48075000
                    PH    Process handling                              48080000
                    DS    Data segment management                       48085000
                    MR    Multiple resource management                  48090000
                    PM    Privileged mode                               48095000
                                                                        48100000
                    You can only specify those attributes that you      48105000
                    possess through assignment by the Account Manager or48110000
                    the System Manager.  Default is IA and BA (if you   48115000
                    possess these capabilities).                        48120000
                                                                        48125000
filename            Actual designator of RL file to be searched to      48130000
                    satisfy external references during preparation of   48135000
                    the program.  This can be any permanent file of type48140000
                    RL.  It need not belong to logon group nor does it  48145000
                    require a reserved, local name.  This file yields a 48150000
                    single segment that is incorporated into the        48155000
                    segments of the program file.  See the MPE Segmenter48160000
                    Reference Manual for a description of RL files.     48165000
                    Default is no library is searched.                  48170000
                                                                        48175000
NOCB                Request that file system not use stack segment      48180000
                    (PCBX) for its control blocks, even if sufficient   48185000
                    space is available.  This will permit you to expand 48190000
                    your stack (via the DLSIZE or ZSIZE intrinsics) to  48195000
                    the maximum possible limit at a later time, but will48200000
                    cause the File Management System to operate more    48205000
                    slowly for this program.                            48210000
                                                                        48215000
\ITEM=OPERATION                                                         48220000
OPERATION                                                               48225000
                                                                        48230000
Prepares and executes a program compiled in a User Subprogram Library   48235000
(USL).  Command prepares a temporary program file and then executes the 48240000
program in that file.  This command permits searching both relocatable  48245000
(RL) and segmented (SL) libraries to satisfy external references.       48250000
                                                                        48255000
\ITEM=EXAMPLE                                                           48260000
EXAMPLE                                                                 48265000
                                                                        48270000
To prepare and execute a program on the USL file USEF, with no special  48275000
parameters declared, enter:                                             48280000
                                                                        48285000
    :PREPRUN USEF                                                       48290000
                                                                        48295000
To prepare and execute a program on the USL file UBASE, beginning       48300000
execution at the entry point RESTART, declaring a stacksize of 800      48305000
words, and specifying that the library LIBA will be searched to satisfy 48310000
external references, enter:                                             48315000
                                                                        48320000
    :PREPRUN UBASE,RESTART:STACK=800;RL=LIBA                            48325000
                                                                        48330000
                                                                        48335000
\ENTRY=PTAPE,PARMS,OPERATION,EXAMPLE                                    48340000
    :PTAPE                                                              48345000
                                                                        48350000
Reads paper tape without X-OFF control.                                 48355000
                                                                        48360000
SYNTAX                                                                  48365000
                                                                        48370000
    :PTAPE filename                                                     48375000
                                                                        48380000
\ITEM=PARMS                                                             48385000
PARAMETERS                                                              48390000
                                                                        48395000
filename            Name of existing ASCII file on disc, to which input 48400000
                    data is to be written from a paper tape. Normally,  48405000
                    this is a file with variable-length records; the    48410000
                    record size specified must be large enough to       48415000
                    contain the longest paper tape record. (REQUIRED    48420000
                    PARAMETER)                                          48425000
                                                                        48430000
\ITEM=OPERATION                                                         48435000
OPERATION                                                               48440000
                                                                        48445000
Permits programs to read input originating from a terminal coupled to a 48450000
paper tape reader/punch, when the tape does not include the X-OFF       48455000
control character punched on the tape.  (The X-OFF character, when      48460000
encountered on a tape, turns the tape-reading mechanism off.  This      48465000
character normally appears following the carriage-return/line-feed      48470000
character combination used to delimit each record.)  The :PTAPE command 48475000
transfers all data from the tape to an ASCII file (named in the         48480000
<filename> parameter) on disc.  This operation stores all records onto  48485000
the disc file in the order read from the tape, but deletes all          48490000
carriage-return and line-feed characters.  (If the tape contains X-OFF  48495000
characters, the operation also deletes these.  The X-OFF characters are 48500000
not ignored by the tape reader, however, and so you must restart the    48505000
reader after each X-OFF is read.)  The input terminates when the CONTROL48510000
Y character is encountered on the tape or entered from the terminal,    48515000
returning control to the keyboard.  The input data now can be read from 48520000
the disc file by any program.                                           48525000
Note that the :PTAPE command is required ONLY for input from HP tape    48530000
readers associated with terminal keyboards.                             48535000
                                                                        48540000
You cannot use the :PTAPE command to copy tapes containing more than    48545000
32767 bytes of information.  If this is attempted, MPE reads only the   48550000
first 32767 bytes on the tape and then terminates the operation.        48555000
                                                                        48560000
\ITEM=EXAMPLE                                                           48565000
EXAMPLE                                                                 48570000
                                                                        48575000
To copy input from a paper tape onto a disc file named TAPEFILE, create 48580000
an appropriate file (with the MPE :BUILD command) and then enter the    48585000
following :PTAPE command:                                               48590000
                                                                        48595000
    :BUILD TAPEFILE;REC=-80,3,V,ASCII                                   48600000
    :PTAPE TAPEFILE                                                     48605000
                                                                        48610000
                                                                        48615000
\ENTRY=PURGE,PARMS,OPERATION,EXAMPLE                                    48620000
    :PURGE                                                              48625000
                                                                        48630000
Deletes file from system.                                               48635000
                                                                        48640000
SYNTAX                                                                  48645000
                                                                        48650000
    :PURGE filereference[,TEMP]                                         48655000
                                                                        48660000
\ITEM=PARMS                                                             48665000
PARAMETERS                                                              48670000
                                                                        48675000
filereference        Actual file designator of file to be deleted, in   48680000
                     this format:                                       48685000
                                                                        48690000
                     filename[/lockword][.groupname][.acctname]         48695000
                                                                        48700000
                     To delete the file, you must have write (W) access 48705000
                     to it.  (REQUIRED PARAMETER)                       48710000
                                                                        48715000
TEMP                 Indicates that the file is a temporary file in the 48720000
                     job/session temporary file domain.  You must enter 48725000
                     this parameter to delete a temporary file,         48730000
                     otherwise the appropriate domain is not searched   48735000
                     for the file. Default is permanent file is assumed.48740000
                                                                        48745000
\ITEM=OPERATION                                                         48750000
OPERATION                                                               48755000
                                                                        48760000
Deletes a disc file from the system.  Applies only to files on disc.    48765000
If the volume set on which the file resides is not mounted, this command48770000
will generate an implicit mount request.                                48775000
                                                                        48780000
If the file does not exist in the domain specified (temporary or        48785000
permanent (permanent is default)), the following message is displayed:  48790000
                                                                        48795000
    FILE <filename> NOT FOUND                                           48800000
                                                                        48805000
\ITEM=EXAMPLE                                                           48810000
EXAMPLE                                                                 48815000
                                                                        48820000
To delete the permanent file PFILE, enter:                              48825000
                                                                        48830000
    :PURGE PFILE                                                        48835000
                                                                        48840000
To delete the temporary file TFILE, enter:                              48845000
                                                                        48850000
    :PURGE TFILE,TEMP                                                   48855000
                                                                        48860000
                                                                        48865000
\ENTRY=PURGEACCT,PARMS,OPERATION,EXAMPLE                                48870000
    :PURGEACCT (System Manager capability required)                     48875000
                                                                        48880000
Removes an account and its groups (files) and users from the system's   48885000
or the specified volume set's directory.                                48890000
                                                                        48895000
SYNTAX                                                                  48900000
                                                                        48905000
    :PURGEACCT acctname[;VS=volset]                                     48910000
                                                                        48915000
\ITEM=PARMS                                                             48920000
PARAMETERS                                                              48925000
                                                                        48930000
acctname       Name of the account to be deleted.  (REQUIRED PARAMETER) 48935000
                                                                        48940000
volset         Volume set or class reference which, when fully          48945000
               qualified, is in the form                                48950000
                                                                        48955000
               vcsid.groupname.acctname                                 48960000
                                                                        48965000
               where vcsid refers to a previously-defined volume set    48970000
               or volume class definition.                              48975000
                                                                        48980000
               The volume set specified by volset must have been        48985000
               previously mounted (via the MOUNT command) or this       48990000
               command will fail.                                       48995000
                                                                        49000000
\ITEM=OPERATION                                                         49005000
OPERATION                                                               49010000
                                                                        49015000
(System Manager capability required)                                    49020000
This command removes an account (and its groups (files) and users) from 49025000
the system's or the specified volume set's directory.                   49030000
                                                                        49035000
When the :PURGEACCT command is entered in a session, MPE displays a     49040000
verification request.  This aids is ensuring that the wrong account is  49045000
not deleted accidentally.  The format of the verification request is:   49050000
                                                                        49055000
    ACCT <acctname> TO BE PURGED?                                       49060000
                                                                        49065000
Response is YES or NO.                                                  49070000
                                                                        49075000
No verification message is printed when the :PURGEACCT is entered in a  49080000
job.                                                                    49085000
                                                                        49090000
The :PURGEACCT command removes every user not currently logged on and   49095000
every group not in use, along with the files and volume set definitions 49100000
belonging to each group.  This could leave the account (containing      49105000
residual elements only) still in the system.  In such a case, if all    49110000
users were purged, the account would exist but would be inaccessible for49115000
log on.  To completely purge such an account, the :PURGEACCT command    49120000
must be entered when the account is inactive.  It is possible that the  49125000
system would require a restart in order to close files which were left  49130000
open.                                                                   49135000
                                                                        49140000
The system account, SYS, cannot be purged.  If such a command is        49145000
entered, however, all groups except PUB will be purged.  All users      49150000
except the System Manager user are purged and all files which are not   49155000
system files or not currently opened in the PUB group are purged.       49160000
                                                                        49165000
\ITEM=EXAMPLE                                                           49170000
EXAMPLE                                                                 49175000
                                                                        49180000
To remove an account named ACCT1, the following dialog occurs:          49185000
                                                                        49190000
    :PURGEACCT ACCT1                                                    49195000
    ACCT ACCT1 TO BE PURGED? YES                                        49200000
                                                                        49205000
                                                                        49210000
\ENTRY=PURGEGROUP,PARMS,OPERATION,EXAMPLE                               49215000
    :PURGEGROUP (Account Manager capability required)                   49220000
                                                                        49225000
Removes a group (and all files belonging to it) from the system's       49230000
or the specified volume set's directory.                                49235000
                                                                        49240000
SYNTAX                                                                  49245000
                                                                        49250000
    :PURGEGROUP groupname[;VS=volset]                                   49255000
                                                                        49260000
\ITEM=PARMS                                                             49265000
PARAMETERS                                                              49270000
                                                                        49275000
groupname    Name of group to be removed.  (REQUIRED PARAMETER)         49280000
                                                                        49285000
volset         Volume set or class reference which, when fully          49290000
               qualified, is in the form                                49295000
                                                                        49300000
               vcsid.groupname.acctname                                 49305000
                                                                        49310000
               where vcsid refers to a previously-defined volume set    49315000
               or volume class definition.                              49320000
                                                                        49325000
               The volume set specified by volset must have been        49330000
               previously mounted (via the MOUNT command) or this       49335000
               command will fail.                                       49340000
                                                                        49345000
\ITEM=OPERATION                                                         49350000
OPERATION                                                               49355000
                                                                        49360000
(Account Manager capability required)                                   49365000
This command removes a group (and all its files) from the appropriate   49370000
directory.                                                              49375000
                                                                        49380000
When this command is entered in a session, MPE prints the message:      49385000
                                                                        49390000
    GROUP <groupname> TO BE PURGED?                                     49395000
                                                                        49400000
Response is YES or NO.                                                  49405000
                                                                        49410000
No verification message is printed if the :PURGEGROUP command is entered49415000
in a job.  For this command to succeed, the group's home volume set must49420000
be mounted.                                                             49425000
                                                                        49430000
If no files in the group are in use, and the group itself is not in use,49435000
:PURGEGROUP removes the entire group.  Otherwise, :PURGEGROUP removes   49440000
every file not in use.  In such a case, the :PURGEGROUP command must be 49445000
entered again when neither the group nor any of its files are in use in 49450000
order to completely purge the group.  It is possible that the system    49455000
would require a restart in order to close files which were left open.   49460000
                                                                        49465000
The public group of the system account, PUB.SYS, cannot be purged. If   49470000
the command is entered, however, all files which are not system files   49475000
are purged.                                                             49480000
                                                                        49485000
\ITEM=EXAMPLE                                                           49490000
EXAMPLE                                                                 49495000
                                                                        49500000
To purge a group named GROUP1, the following dialog occurs:             49505000
                                                                        49510000
    :PURGEGROUP GROUP1                                                  49515000
    GROUP GROUP1 TO BE PURGED? YES                                      49520000
                                                                        49525000
                                                                        49530000
\ENTRY=PURGEUSER,PARMS,OPERATION,EXAMPLE                                49535000
    :PURGEUSER (Account Manager capability required)                    49540000
                                                                        49545000
Removes a user from an account.                                         49550000
                                                                        49555000
SYNTAX                                                                  49560000
                                                                        49565000
    :PURGEUSER username                                                 49570000
                                                                        49575000
\ITEM=PARMS                                                             49580000
PARAMETERS                                                              49585000
                                                                        49590000
username    Name of the user to be deleted.  (REQUIRED PARAMETER)       49595000
                                                                        49600000
\ITEM=OPERATION                                                         49605000
OPERATION                                                               49610000
                                                                        49615000
(Account Manager capability required)                                   49620000
This command purges a user from the account.                            49625000
                                                                        49630000
When :PURGEUSER is entered in a session, MPE displays the following     49635000
message:                                                                49640000
                                                                        49645000
    USER <username> TO BE PURGED?                                       49650000
                                                                        49655000
Response is YES or NO.                                                  49660000
                                                                        49665000
If entered from a job, the message is not displayed.                    49670000
                                                                        49675000
If the :PURGEUSER command references a user currently logged onto the   49680000
system, that user is not purged and a message is output indicating this 49685000
fact.                                                                   49690000
                                                                        49695000
The original system manager, MANAGER.SYS, cannot be purged.             49700000
                                                                        49705000
Purging a user may leave some files in an account without their         49710000
creators.  However, the Account Manager can access these files and      49715000
purge them.                                                             49720000
                                                                        49725000
\ITEM=EXAMPLE                                                           49730000
EXAMPLE                                                                 49735000
                                                                        49740000
To remove a user named USER1, the following dialog occurs:              49745000
                                                                        49750000
    :PURGEUSER USER1                                                    49755000
    USER USER1 TO BE PURGED? YES                                        49760000
                                                                        49765000
                                                                        49770000
\ENTRY=PURGEVSET,PARMS,OPERATION,EXAMPLE                                49775000
            users.                                                      49780000
    :PURGEVSET                                                          49785000
                                                                        49790000
(System Manager, or Account Manager with Volume Set Creation (CV)       49795000
capability required)                                                    49800000
                                                                        49805000
Deletes an existing volume set.                                         49810000
                                                                        49815000
SYNTAX                                                                  49820000
                                                                        49825000
    :PURGEVSET vsname                                                   49830000
                                                                        49835000
\ITEM=PARMS                                                             49840000
PARAMETERS                                                              49845000
                                                                        49850000
vsname        Volume set name of an existing volume set.                49855000
                                                                        49860000
\ITEM=OPERATION                                                         49865000
OPERATION                                                               49870000
                                                                        49875000
(System Manager, or Account Manager with Volume Set Creation (CV)       49880000
capability required)                                                    49885000
                                                                        49890000
The :PURGEVSET command deletes a previously-defined volume set.  A      49895000
volume set will not be purged if the volume set is currently in use     49900000
(a MOUNT, either explicit or implicit, has been issued for the          49905000
volume set definition).                                                 49910000
                                                                        49915000
When :PURGEVSET is entered during a session, MPE displays the following 49920000
message:                                                                49925000
                                                                        49930000
    :VOLUME SET/CLASS DEFINITION vsname TO BE PURGED?                   49935000
                                                                        49940000
\ITEM=EXAMPLE                                                           49945000
EXAMPLE                                                                 49950000
                                                                        49955000
To purge volume set USERSET, enter:                                     49960000
                                                                        49965000
    :PURGEVSET USERSET                                                  49970000
                                                                        49975000
                                                                        49980000
\ENTRY=QUANTUM                                                          49985000
    :QUANTUM (System Supervisor capability required)                    49990000
                                                                        49995000
This command has been replaced by the :TUNE command.                    50000000
                                                                        50005000
\ENTRY=RECALL,PARMS,EXAMPLE                                             50010000
     :RECALL                                                            50015000
                                                                        50020000
Displays all pending console messages.                                  50025000
                                                                        50030000
SYNTAX                                                                  50035000
                                                                        50040000
          :RECALL                                                       50045000
                                                                        50050000
\ITEM=PARMS                                                             50055000
PARAMETERS                                                              50060000
                                                                        50065000
None.                                                                   50070000
                                                                        50075000
\ITEM=EXAMPLE                                                           50080000
EXAMPLES                                                                50085000
                                                                        50090000
To display all pending console messages which require a :REPLY          50095000
response from you, enter:                                               50100000
                                                                        50105000
     :RECALL                                                            50110000
     REPLY(S) PENDING:                                                  50115000
     ?10:05/#J9/15/LDEV# FOR "LOO576" ON TAPE1600 (NUM)?                50120000
                                                                        50125000
If there are REPLYs pending, the text of the request(s) will appear     50130000
at the console, as shown above.  If there are no REPLYs pending the     50135000
following message will appear at the console:                           50140000
                                                                        50145000
     :RECALL                                                            50150000
     NO REPLIES PENDING                                                 50155000
                                                                        50160000
\ENTRY=REDO,PARMS,OPERATION,EXAMPLE                                     50165000
    :REDO                                                               50170000
                                                                        50175000
Allows you to edit a command entry.                                     50180000
                                                                        50185000
SYNTAX                                                                  50190000
                                                                        50195000
    :REDO                                                               50200000
                                                                        50205000
\ITEM=PARMS                                                             50210000
PARAMETERS                                                              50215000
                                                                        50220000
None                                                                    50225000
                                                                        50230000
\ITEM=OPERATION                                                         50235000
OPERATION                                                               50240000
                                                                        50245000
The :REDO command allows you to correct certain kinds of errors in an   50250000
incorrect command entry or to change a correct command entry.  The :REDO50255000
command only applies to the last command entered.  When the :REDO       50260000
command is entered, MPE enters a mode similar to the Editor and displays50265000
the command to be modified.  Pressing the BREAK key aborts              50270000
the REDO operation.                                                     50275000
                                                                        50280000
To modify the command output by MPE, position the cursor (using the     50285000
space bar on the terminal) under the character(s) to be modified, then  50290000
enter one of the following sub-commands:                                50295000
                                                                        50300000
D  -  Delete.  Deletes the character above the cursor.  If D is         50305000
      repeated, each character above each D is deleted.                 50310000
                                                                        50315000
I  -  Insert.  Inserts one or more characters immediately preceding the 50320000
      character above the cursor.  The D and I sub-commands can be used 50325000
      in conjunction to delete characters, then insert new characters.  50330000
                                                                        50335000
R  -  Replace.  Replaces the characters above the cursor with new       50340000
      characters.  If one character is entered, the character above the 50345000
      cursor is replaced; if two characters are entered, two characters,50350000
      (the character above the cursor and the character to the right)   50355000
      are replaced; and so forth for additional characters.  R is the   50360000
      default sub-command.                                              50365000
                                                                        50370000
U  -  Undo.  Cancels the effect of the previous D, I, or R sub-command. 50375000
      Entering a U, carriage return, then another U cancels all previous50380000
      sub-commands for this :REDO command and restores the line being   50385000
      corrected to its original form.                                   50390000
                                                                        50395000
\ITEM=EXAMPLE                                                           50400000
EXAMPLE                                                                 50405000
                                                                        50410000
    :FILE A;REC=..G;DISC=10000,16,1;SAVE                                50415000
                  ^                                                     50420000
    :ERR nnn EXPECTED F, V, OR U                                        50425000
    :REDO                        (Request to enter command string)      50430000
    :FILE A;REC=,,G;DISC=10000,16,1;SAVE  (MPE displays command)        50435000
                  RF                      (Replace G with F)            50440000
    :FILE A;REC=,,F;DISC=10000,16,1;SAVE  (Corrected command displayed) 50445000
                                                                        50450000
Note that the letter F can be entered without the sub-command R,        50455000
because R is the default sub-command.  For example,                     50460000
                                                                        50465000
    :FILE A;REC=,,G;DISC=10000,16,1;SAVE                                50470000
                  F                       (Replace G with F)            50475000
    :FILE A;REC=,,F;DISC=10000,16,1;SAVE  (Corrected command displayed) 50480000
                                                                        50485000
                                                                        50490000
\ENTRY=REFUSE,PARMS,OPERATION,EXAMPLE                                   50495000
     :REFUSE                                                            50500000
                                                                        50505000
Disallows jobs/sessions and/or data on a designated device.             50510000
                                                                        50515000
SYNTAX                                                                  50520000
                                                                        50525000
              [JOBS, ]                                                  50530000
     :REFUSE  [      ] ldn                                              50535000
              [DATA  ]                                                  50540000
                                                                        50545000
\ITEM=PARMS                                                             50550000
PARAMETERS                                                              50555000
                                                                        50560000
JOBS                    Disallows the :JOB (or :HELLO) command from     50565000
                        the designated device.                          50570000
                                                                        50575000
DATA                    Disallows the :DATA command from the desig-     50580000
                        nated device.                                   50585000
                                                                        50590000
ldn                     The logical device number of the device for     50595000
                        which :JOB (or :HELLO) and :DATA commands       50600000
                        are refused.                                    50605000
                                                                        50610000
\ITEM=OPERATION                                                         50615000
OPERATION                                                               50620000
                                                                        50625000
The parameter JOBS, in this command, refers to both jobs and sessions.  50630000
If the first parameter is omitted both :JOB (or :HELLO) and :DATA       50635000
commands are refused.                                                   50640000
                                                                        50645000
\ITEM=EXAMPLE                                                           50650000
EXAMPLES                                                                50655000
                                                                        50660000
To refuse data recognition from logical device number 35, enter:        50665000
                                                                        50670000
     :REFUSE DATA,35                                                    50675000
     :SHOWDEV 35                                                        50680000
     LDEV    AVAIL        OWNERSHIP      VOLID                          50685000
                                                                        50690000
      35  J  AVAIL                                                      50695000
                                                                        50700000
                                                                        50705000
To refuse jobs and data recognition from logical device number 35,      50710000
enter:                                                                  50715000
                                                                        50720000
     :REFUSE 35                                                         50725000
     :SHOWDEV 35                                                        50730000
     LDEV    AVAIL        OWNERSHIP      VOLID                          50735000
                                                                        50740000
      35     AVAIL                                                      50745000
                                                                        50750000
\ENTRY=RELEASE,PARMS,OPERATION,EXAMPLE                                  50755000
    :RELEASE                                                            50760000
                                                                        50765000
Temporarily suspends all security provisions for a file.                50770000
                                                                        50775000
SYNTAX                                                                  50780000
                                                                        50785000
    :RELEASE filereference                                              50790000
                                                                        50795000
\ITEM=PARMS                                                             50800000
PARAMETERS                                                              50805000
                                                                        50810000
filereference        Actual designator of file whose security provisions50815000
                     are to be suspended, written in this format:       50820000
                                                                        50825000
                     filename[/lockword][.groupname][.acctname]         50830000
                                                                        50835000
                     If the file has a lockword, it must be specified.  50840000
                     (REQUIRED PARAMETER)                               50845000
                                                                        50850000
\ITEM=OPERATION                                                         50855000
OPERATION                                                               50860000
                                                                        50865000
Temporarily suspends security provisions for file at all (file, group,  50870000
and account) levels, allowing any user in system unlimited access to the50875000
file.  Suspension remains in effect until a :SECURE command is entered  50880000
for this file to restore its previous security provisions.  Suspension  50885000
remains valid after job termination, or system failure followed by      50890000
coldload or reload.  (It can be negated, however, if system is reloaded 50895000
from a :SYSDUMP tape created before :RELEASE command was entered.)      50900000
Note that this command can be used only for permanent files on disc     50905000
whose labels identify you as the creator of the file.  In addition, the 50910000
:RELEASE command will fail if the group's home volume set is not        50915000
mounted.  When the normal (default) MPE security provisions are in      50920000
effect, the file must be in your logon account and must belong to your  50925000
logon or home group.                                                    50930000
                                                                        50935000
This command will not cause a volume set to be mounted.  If the file's  50940000
home volume set is not mounted at the time this command is issued, the  50945000
file will not be found and thus cannot be released.                     50950000
                                                                        50955000
The :RELEASE command does not affect the file's lockword, if any.       50960000
                                                                        50965000
\ITEM=EXAMPLE                                                           50970000
EXAMPLE                                                                 50975000
                                                                        50980000
To release all security provisions for the file named FILE1, enter:     50985000
                                                                        50990000
    :RELEASE FILE1                                                      50995000
                                                                        51000000
\ENTRY=RELLOG,PARMS,OPERATION,EXAMPLE                                   51005000
     :RELLOG                                                            51010000
                                                                        51015000
Removes a logging identifier from the system.                           51020000
                                                                        51025000
SYNTAX                                                                  51030000
                                                                        51035000
     :RELLOG logid                                                      51040000
                                                                        51045000
\ITEM=PARMS                                                             51050000
PARAMETERS                                                              51055000
                                                                        51060000
logid                 The logging identifier to be removed              51065000
                        from the system.  (REQUIRED PARAMETER)          51070000
                                                                        51075000
\ITEM=OPERATION                                                         51080000
OPERATION                                                               51085000
                                                                        51090000
The :RELLOG command removes a logging identifier from the system        51095000
by deleting it from the directory of logging identifiers.  This         51100000
command may be issued only by the user who created the logging          51105000
identifier specified in the logid parameter.                            51110000
                                                                        51115000
\ITEM=EXAMPLE                                                           51120000
EXAMPLE                                                                 51125000
                                                                        51130000
     :RELLOG DATALOG                                                    51135000
                                                                        51140000
\ENTRY=REMOTE,PARMS,OPERATION,EXAMPLE                                   51145000
    :REMOTE/:REMOTE HELLO                                               51150000
                                                                        51155000
Switches control to the Command Intrepreter of the remote               51160000
system, when a DS line has previously been opened.                      51165000
                                                                        51170000
SYNTAX                                                                  51175000
                                                                        51180000
    :REMOTE                                                             51185000
                                                                        51190000
System responds with a '#' prompt.  Remote commands are now             51195000
allowed.  Exit from the Remote system back to the local with            51200000
the ':' input.                                                          51205000
                                                                        51210000
                                                                        51215000
Establishes communication between a local computer and a remote         51220000
computer.                                                               51225000
                                                                        51230000
                                                                        51235000
SYNTAX                                                                  51240000
                                                                        51245000
    :REMOTE HELLO [sessionname,]username[/userpass].acctname[/acctpass] 51250000
                  [,groupname[/grouppass]]                              51255000
                                                                        51260000
                  [;TERM=termtype]                                      51265000
                  [;TIME=cpusecs]                                       51270000
                                                                        51275000
                  [;PRI={BS}]                                           51280000
                         CS                                             51285000
                         DS                                             51290000
                         ES                                             51295000
                                                                        51300000
                   [;INPRI=inputpriority]                               51305000
                   [;HIPRI]                                             51310000
                   [;DSLINE=dsdevice]                                   51315000
                                                                        51320000
\ITEM=PARMS                                                             51325000
PARAMETERS                                                              51330000
                                                                        51335000
sessionname         Arbitrary name used in conjunction with username    51340000
                    and acctname parameters to form a session           51345000
                    identity.  Contains from 1 to 8 alphanumeric        51350000
                    characters, beginning with a letter.  Default is    51355000
                    no session name is assigned.                        51360000
                                                                        51365000
username            A user name, established by Account Manager, that   51370000
                    allows you to log on under this account. Contains   51375000
                    from 1 to 8 alphanumeric characters, beginning      51380000
                    with a letter.  (REQUIRED PARAMETER)                51385000
                                                                        51390000
userpass            User password, optionally assigned by Account       51395000
                    Manager.  Contains from 1 to 8 alphanumeric         51400000
                    characters, beginning with a letter.                51405000
                                                                        51410000
acctname            Name of account, as established by Account Manager. 51415000
                    Contains from 1 to 8 alphanumeric characters,       51420000
                    beginning with a letter.  The acctname parameter    51425000
                    must be preceded by a period. (REQUIRED PARAMETER)  51430000
                                                                        51435000
acctpass            Account password, optionally assigned by System     51440000
                    Manager.  Contains from 1 to 8 alphanumeric         51445000
                    characters, beginning with a letter.                51450000
                                                                        51455000
groupname           Name of group to be used for local file domain and  51460000
                    CPU time charges.  Established by Account Manager.  51465000
                    Contains from 1 to 8 alphanumeric characters,       51470000
                    beginning with a letter.  Default is your home group51475000
                    if you are assigned one by Account Manager.         51480000
                    (Optional if you have a home group, required if home51485000
                    group not assigned.)                                51490000
                                                                        51495000
grouppass           (Required if assigned and you are logging on under  51500000
                     other than home group.  Not required if logging on 51505000
                     under home group.)                                 51510000
                                                                        51515000
                    Group password, optionally assigned by Account      51520000
                    Manager.  Contains from 1 to 8 alphanumeric         51525000
                    characters, beginning with a letter.                51530000
                                                                        51535000
 termtype           The term type for the local system is deter-        51540000
                    mined by the local logon ('HELLO U.A,G').           51545000
                    The remote system talks to the local terminal       51550000
                    through the MPE system and the ATC.  Thus, the      51555000
                    terminal type has no significance in the 'REMOTE    51560000
                    HELLO' command.                                     51565000
                                                                        51570000
cpusecs            Maximum CPU time that session can use, entered in    51575000
                   seconds.  When limit is reached, session is aborted. 51580000
                   Must be a value from 1 to 32767.  To specify no      51585000
                   limit, enter question mark (?) or UNLIM, or omit     51590000
                   parameter.  Default is no limit.                     51595000
                                                                        51600000
BS, CS, DS, ES     Execution priority class. BS is highest priority,    51605000
                   ES is lowest. If you specify a priority that exceeds 51610000
                   highest permitted for your account or user name by   51615000
                   the system, MPE assigns the highest priority         51620000
                   possible below BS.  Default is CS.                   51625000
                                                                        51630000
                                                                        51635000
                                       NOTE                             51640000
                                                                        51645000
                   DS and ES are used primarily for batch jobs; their   51650000
                   use for sessions is discouraged.                     51655000
                                                                        51660000
                                                                        51665000
inputpriority      Relative input priority used in checking against     51670000
                   access restrictions imposed by the jobfence, if one  51675000
                   exists.  Takes effect at logon time.  Must be a      51680000
                   value from 1 (lowest priority) to 13 (highest        51685000
                   priority).  If a value is specified that is less     51690000
                   than or equal to current jobfence set by Console     51695000
                   Operator, session is denied access. Default is 8.    51700000
                                                                        51705000
HIPRI             Request for maximum session-selection input prior-    51710000
                  ity, causing session to be seheduled regardless of    51715000
                  current jobfence or execution limit for session.s     51720000
                  This parameter can be specified only by users with    51725000
                  System Manager or System Supervisor capability.       51730000
                  Default is:  the current jobfence and execution       51735000
                  limit.                                                51740000
                                                                        51745000
dsdevice            The device class name or logical device number      51750000
                    assigned to the DS/3000 communications driver       51755000
                    IODS0 during system configuration.  This            51760000
                    parameter specifies what physical line you wish     51765000
                    to use.  Optional parameter if a line already is    51770000
                    open; otherwise it is required.                     51775000
                                                                        51780000
\ITEM=OPERATION                                                         51785000
OPERATION                                                               51790000
                                                                        51795000
The :REMOTE HELLO command is used with the :DSLINE command to obtain    51800000
access to a physical communications line and establish the              51805000
communications link to a remote HP 3000, or by itself (using the        51810000
DSLINE parameter) to perform the same functions.                        51815000
                                                                        51820000
\ITEM=EXAMPLE                                                           51825000
EXAMPLE                                                                 51830000
                                                                        51835000
To establish the communications line HDS2 and log on to System B from   51840000
System A, you could enter:                                              51845000
                                                                        51850000
    :HELLO USER.X                                                       51855000
    :REMOTE HELLO USER.X;DSLINE=HDS2                                    51860000
                                                                        51865000
                                                                        51870000
\ENTRY=RENAME,PARMS,OPERATION,EXAMPLE                                   51875000
    :RENAME                                                             51880000
                                                                        51885000
Changes identity (file name, lockword, and/or group name) of disc file. 51890000
                                                                        51895000
SYNTAX                                                                  51900000
                                                                        51905000
    :RENAME oldfilereference,newfilereference[,TEMP]                    51910000
                                                                        51915000
\ITEM=PARMS                                                             51920000
PARAMETERS                                                              51925000
                                                                        51930000
oldfilereference         Current name of file, written in the following 51935000
                         format:                                        51940000
                                                                        51945000
                     filename[/lockword][.groupname][.acctname]         51950000
                                                                        51955000
                         If <acctname> is specified, it must be that of 51960000
                         your logon account.  (REQUIRED PARAMETER)      51965000
                                                                        51970000
newfilereference         New name of file, in the same format as        51975000
                         <oldfilereference>.  If <acctname> is          51980000
                         specified, it must be that of your logon       51985000
                         account. If <groupname> is specified, it must  51990000
                         be one to which you have SAVE access. If       51995000
                         <acctname> and/or <groupname> are omitted, the 52000000
                         logon account and/or group are assumed.        52005000
                         (REQUIRED PARAMETER)                           52010000
                                                                        52015000
TEMP                     Indicates that old file was, and new file will 52020000
                         be, in temporary job/session file domain.      52025000
                         Default is permanent file is assumed.          52030000
                                                                        52035000
\ITEM=OPERATION                                                         52040000
OPERATION                                                               52045000
                                                                        52050000
Changes system file identification for permanent or temporary disc file.52055000
Effectively removes file with old name from system and creates another  52060000
file with identical contents and new name.  This command can be used to 52065000
change the name of a file, to move a file from one group to another (by 52070000
specifying a different <groupname> in the <newfilereference> parameter),52075000
or to change the lockword.                                              52080000
                                                                        52085000
The volume set must be mounted for the group in which this file is to   52090000
be renamed or this command will fail.  In addition, renaming is         52095000
confined to a volume set (i.e., a file cannot be renamed across         52100000
volume sets).                                                           52105000
                                                                        52110000
Note that this command can be used only for a file that you have        52115000
created.                                                                52120000
                                                                        52125000
\ITEM=EXAMPLE                                                           52130000
EXAMPLE                                                                 52135000
                                                                        52140000
To change the name of a temporary file from OLDFILE to NEWFILE, moving  52145000
it from your logon group to the group named NEWG, enter:                52150000
                                                                        52155000
    :RENAME OLDFILE,NEWFILE.NEWG,TEMP                                   52160000
                                                                        52165000
To change the lockword of the permanent file FILE2 from LOCKA to LOCKB, 52170000
enter:                                                                  52175000
                                                                        52180000
    :RENAME FILE2/LOCKA,FILE2/LOCKB                                     52185000
                                                                        52190000
                                                                        52195000
\ENTRY=REPLY,PARMS,OPERATION,EXAMPLE                                    52200000
     :REPLY                                                             52205000
                                                                        52210000
Replies to pending requests.                                            52215000
                                                                        52220000
SYNTAX                                                                  52225000
                                                                        52230000
     :REPLY PIN,reply [,param]                                          52235000
                                                                        52240000
\ITEM=PARMS                                                             52245000
PARAMETERS                                                              52250000
                                                                        52255000
PIN               The process identification number of the message      52260000
                  sender.  It is part of the message to which the       52265000
                  sender is REPLYing, such as,                          52270000
                                                                        52275000
                                                                        52280000
                  ?16:15/#S25/43/LDEV# FOR "CARDS" ON CARD (NUM)?       52285000
                               ^                                        52290000
                             PIN                                        52295000
                  (Required parameter.)                                 52300000
                                                                        52305000
reply             The reply type specified in the message, defined      52310000
                  by:                                                   52315000
                                                                        52320000
                  (NUM) - reply must be a logical device number         52325000
                                                                        52330000
                  (Y/N) - reply must be YES (or Y), or NO (or N)        52335000
                                                                        52340000
                  (Sxx) - reply must be a string not to exceed          52345000
                          xx characters in length                       52350000
                                                                        52355000
                  (YN#) - reply must be YES (or Y), NO (or N),          52360000
                          or a logical device number                    52365000
                                                                        52370000
param             The same as the reply parameter, excluding type       52375000
                  (YN#)                                                 52380000
                                                                        52385000
\ITEM=OPERATION                                                         52390000
OPERATION                                                               52395000
                                                                        52400000
User's programs that are WAITING for your REPLY remain suspended        52405000
indefinitely.  If for any reason you cannot reply as requested (for     52410000
example, a particular device is non-existent or a special form is       52415000
unavailable), then reply by assigning logical device number (ldn) 0.    52420000
This causes an immediate program failure.                               52425000
                                                                        52430000
                                                                        52435000
\ITEM=EXAMPLE                                                           52440000
EXAMPLES                                                                52445000
                                                                        52450000
To reply to a message from the MPE SYSTEM, enter:                       52455000
                                                                        52460000
     ?10:05/#J19/15/LDEV# FOR "NAS" ON TAPE1600 (NUM)?                  52465000
     :REPLY 15,7                                                        52470000
                                                                        52475000
\ENTRY=REPORT,PARMS,OPERATION,EXAMPLE                                   52480000
    :REPORT                                                             52485000
                                                                        52490000
Displays accounting information for specified groups and accounts.      52495000
                                                                        52500000
SYNTAX                                                                  52505000
                                                                        52510000
    :REPORT [groupset][,listfile][;VS=volset]                           52515000
                                                                        52520000
\ITEM=PARMS                                                             52525000
PARAMETERS                                                              52530000
                                                                        52535000
groupset       Specifies the accounts and groups for which information  52540000
               is to be listed.  The permissible entries and the        52545000
               capability required (shown in parentheses) are as        52550000
               follows:  Account Manager is shown as AM; System Manager 52555000
               is shown as SM.                                          52560000
                                                                        52565000
groupname      Reports on the specified group in the log-on account.    52570000
               Standard user can only specify his log-on group.         52575000
                                                                        52580000
@              Reports on all groups in the log-on account (AM or SM).  52585000
                                                                        52590000
groupname.     Reports on the specified group in the specified          52595000
acctname       account (SM).                                            52600000
                                                                        52605000
@.acctname     Reports on all groups in the specified account           52610000
               (AM or SM).                                              52615000
                                                                        52620000
@.@            Reports on all groups in all accounts (SM).              52625000
                                                                        52630000
groupname.@    Reports on specified group in any account (SM).          52635000
                                                                        52640000
               Default:                                                 52645000
                  For standard user:    his log-on group.               52650000
                  For Account Manager:  all groups in his own account.  52655000
                  For System Manager:   all groups in all accounts.     52660000
                                                                        52665000
                                       NOTE                             52670000
                                                                        52675000
               The characters @, #, and ? can be used as "wild          52680000
               card" characters, in any order, in the groupset          52685000
               parameter. These wild card characters have the           52690000
               following message.                                       52695000
                                                                        52700000
               @ -- specifies zero or more alphanumeric characters.     52705000
                                                                        52710000
               # -- specifies one numeric character.                    52715000
                                                                        52720000
               ? -- specifies one alphanumeric character.               52725000
                                                                        52730000
               The characters can be used as follows:                   52735000
                                                                        52740000
               n@      Report on all groups starting with the           52745000
                       character n.                                     52750000
                                                                        52755000
               @n      Report on all groups ending with the character   52760000
                       n.                                               52765000
                                                                        52770000
               n@x     Report on all groups starting with the character 52775000
                       n and ending with the character x.               52780000
                                                                        52785000
               n##..#  Report on all groups starting with the character 52790000
                       n followed by up to seven digits.                52795000
                                                                        52800000
               ?n@     Report on all groups whose second character      52805000
                       is n.                                            52810000
                                                                        52815000
               n?      Report on all two-character groups starting      52820000
                       with the character n.                            52825000
                                                                        52830000
               ?n      Report on all two-character groups ending with   52835000
                       the character n.                                 52840000
                                                                        52845000
listfile       Actual file designator of output file to which           52850000
               information is to be written.  Output may be             52855000
               redirected with a :FILE back reference as follows:       52860000
                                                                        52865000
               :FILE LIST1;DEV=LP                                       52870000
               :REPORT ,*LIST1                                          52875000
                                                                        52880000
               Default is $STDLIST.                                     52885000
                                                                        52890000
volset         Directs the reporting of accounting information from     52895000
               the specified volume set.                                52900000
                                                                        52905000
\ITEM=OPERATION                                                         52910000
OPERATION                                                               52915000
                                                                        52920000
Outputs total accounting information logged against groups and accounts.52925000
For the standard user, this information covers his own group only; an   52930000
Account Manager may specify all groups in his account; and the System   52935000
Manager may specify all groups in all accounts.                         52940000
                                                                        52945000
The information includes usage counts and limits for permanent file     52950000
space (in sectors), cpu time (in seconds), and session connect time (in 52955000
minutes).  The file space usage count reflects file space used as of the52960000
present time, but the cpu time and connect time usage reflects these    52965000
counts as they were immediately prior to the start of the current job.  52970000
                                                                        52975000
When <volset> is used to specify a private volume set, the only         52980000
valid information contained in the report is the filespace counts       52985000
and limits.                                                             52990000
                                                                        52995000
The type of output written to <listfile> depends on the type of file    53000000
(ASCII or binary) specified or implied.  If <listfile> is an ASCII file,53005000
a standard ASCII listing is produced; on this listing, an unlimited     53010000
quantity is denoted by a double asterisk (**).  If <listfile> is a      53015000
binary file (typically used to help in automatic processing of the      53020000
report data), a 17-word record is written for each account/group.       53025000
                                                                        53030000
On both ASCII and binary listfiles, the entry for each account is       53035000
followed immediately by the entries for all of its groups.              53040000
                                                                        53045000
\ITEM=EXAMPLE                                                           53050000
EXAMPLE                                                                 53055000
                                                                        53060000
To obtain accounting information for your group, enter the :REPORT      53065000
command, as follows:                                                    53070000
                                                                        53075000
    :REPORT                                                             53080000
\ENTRY=RESET,PARMS,OPERATION,EXAMPLE                                    53085000
    :RESET                                                              53090000
                                                                        53095000
Cancels :FILE command.                                                  53100000
                                                                        53105000
SYNTAX                                                                  53110000
                                                                        53115000
            formaldesignator                                            53120000
    :RESET {                }                                           53125000
             @                                                          53130000
                                                                        53135000
\ITEM=PARMS                                                             53140000
PARAMETERS                                                              53145000
                                                                        53150000
formaldesignator          Formal file name of file on which :FILE       53155000
                          command will be cancelled.                    53160000
                                                                        53165000
@                         Directive to reset all formal file designators53170000
                          noted in all :FILE commands previously        53175000
                          encountered in this job session.              53180000
                                                                        53185000
\ITEM=OPERATION                                                         53190000
OPERATION                                                               53195000
                                                                        53200000
Resets the formal designator for a file to its original meaning,        53205000
negating the effect of any :FILE command that has referenced this formal53210000
designator up to this point in the job.  Applies to files on any device.53215000
                                                                        53220000
\ITEM=EXAMPLE                                                           53225000
EXAMPLE                                                                 53230000
                                                                        53235000
To cancel the effects of a previous :FILE command that specified        53240000
characteristics for a file programmatically referred to as ALPHA, enter:53245000
                                                                        53250000
    :RESET ALPHA                                                        53255000
                                                                        53260000
                                                                        53265000
\ENTRY=RESETACCT,PARMS,OPERATION,EXAMPLE                                53270000
    :RESETACCT (System Manager capability required)                     53275000
                                                                        53280000
Resets to zero the running counts of cpu time or connect time accum-    53285000
ulated by an account, and all groups within that account.               53290000
                                                                        53295000
SYNTAX                                                                  53300000
                                                                        53305000
                 @           ,CPU                                       53310000
    :RESETACCT [          ][          ]                                 53315000
                 acctname    ,CONNECT                                   53320000
                                                                        53325000
\ITEM=PARMS                                                             53330000
PARAMETERS                                                              53335000
                                                                        53340000
@            Specifies that counters for all accounts/groups are to be  53345000
             reset.  Default.                                           53350000
                                                                        53355000
acctname     Specifies the name of a particular account and group.      53360000
             Default is @.                                              53365000
                                                                        53370000
CPU          Specifies that only the cpu usage counter is to be reset.  53375000
             Default is both the cpu and connect time counters are      53380000
             reset.                                                     53385000
                                                                        53390000
CONNECT      Specifies that only the connect time usage counter is to be53395000
             reset.  Default is both the cpu and connect time usage     53400000
             counters are reset.                                        53405000
                                                                        53410000
\ITEM=OPERATION                                                         53415000
OPERATION                                                               53420000
                                                                        53425000
(System Manager capability required)                                    53430000
This command resets to zero the running counts of cpu or connect time   53435000
accumulated by an account, and all groups within that account.          53440000
                                                                        53445000
If all parameters are omitted, all counters for all accounts and their  53450000
groups are reset.                                                       53455000
                                                                        53460000
\ITEM=EXAMPLE                                                           53465000
EXAMPLE                                                                 53470000
                                                                        53475000
To reset the cpu use counter for all accounts in the system, enter:     53480000
                                                                        53485000
    :RESETACCT @,CPU                                                    53490000
                                                                        53495000
                                                                        53500000
\ENTRY=RESETDUMP,PARMS,OPERATION,EXAMPLE                                53505000
    :RESETDUMP                                                          53510000
                                                                        53515000
Disables Stackdump facility.                                            53520000
                                                                        53525000
SYNTAX                                                                  53530000
                                                                        53535000
    :RESETDUMP                                                          53540000
                                                                        53545000
\ITEM=PARMS                                                             53550000
PARAMETERS                                                              53555000
                                                                        53560000
None                                                                    53565000
                                                                        53570000
\ITEM=OPERATION                                                         53575000
OPERATION                                                               53580000
                                                                        53585000
Disarms MPE Stackdump facility (armed by :SETDUMP command), described in53590000
the MPE Debug/Stackdump Reference Manual.  When entered in BREAK, does  53595000
not modify state of processes already created.  If Stackdump facility is53600000
not enabled, :RESETDUMP command has no effect.                          53605000
                                                                        53610000
\ITEM=EXAMPLE                                                           53615000
EXAMPLE                                                                 53620000
                                                                        53625000
To disable the Stackdump facility, enter:                               53630000
                                                                        53635000
    :RESETDUMP                                                          53640000
                                                                        53645000
                                                                        53650000
\ENTRY=RESTORE,PARMS,OPERATION,EXAMPLE                                  53655000
    :RESTORE                                                            53660000
                                                                        53665000
Returns files (stored on magnetic tape or serial disc) to system.       53670000
                                                                        53675000
SYNTAX                                                                  53680000
                                                                        53685000
    :RESTORE [restorefile] [;[{fileset [-fileset]}] [;option [;...]]]   53690000
                              {indirectfile      }                      53695000
                                                                        53700000
             where option is                                            53705000
                   [;DEV=device]                                        53710000
                   [;SHOW=[showoption[,showoption[,...]]]]              53715000
                   [;FILES=maxfiles]                                    53720000
                   [; { LOCAL }                                         53725000
                      {  {GROUP=groupname}                              53730000
                         {ACC[OUN]T=accountname}                        53735000
                         [;...] } ]                                     53740000
                            {GROUP  }                                   53745000
                   [;CREATE={ACCT   } [,...]]                           53750000
                            {CREATOR}                                   53755000
                   [;CREATOR[=username]]                                53760000
                   [;{KEEP}                                             53765000
                     {NOKEEP}]                                          53770000
                   [;{OLDDATE}                                          53775000
                     {NEWDATE}]                                         53780000
                   [;ONERR[OR]={QUIT}                                   53785000
                               {SKIP}]                                  53790000
                                                                        53795000
                                                                        53800000
\ITEM=PARMS                                                             53805000
PARAMETERS                                                              53810000
                                                                        53815000
restorefile           Name of magnetic tape or serial disc file on      53820000
                      which files to be restored exist.  This file must 53825000
                      be referenced in the back-reference format by     53830000
                      using an asterisk.  (This format references a     53835000
                      previous :FILE command that has defined the       53840000
                      file as a magnetic tape or serial disc file.)     53845000
                                                                        53850000
                      A message is output on the system console         53855000
                      requesting the Console Operator to mount the      53860000
                      tape or serial disc platter identified by the     53865000
                      restorefile parameter, and allocate the device.   53870000
                                                                        53875000
                      If none is given, then a default filename is used.53880000
                      The default filename is the user's username.      53885000
                                                                        53890000
fileset               Sets of files to be restored.  This parameter     53895000
                      is of the form:                                   53900000
                                                                        53905000
                      filedesig[.groupdesig[.acctdesig]]                53910000
                                                                        53915000
                      Fileset can be entered in any of the following    53920000
                      formats and may use wild card characters,         53925000
                      any order, as replacements:                       53930000
                                                                        53935000
file.groupdesig       Restore the specified file in the specified group 53940000
.acctdesig                                                              53945000
                      and account.                                      53950000
                                                                        53955000
filedesig.groupdesig  Restore specified file in specified group.        53960000
                                                                        53965000
filedesig             Restores the specified file.                      53970000
                                                                        53975000
@.group.account       Restore all files in specified group and account. 53980000
                                                                        53985000
@.group               Restore all files in specified group.             53990000
                                                                        53995000
@.@.account           Restore all files in all groups in specified      54000000
                      account.                                          54005000
                                                                        54010000
@                     Restore all files in logon group. Default for     54015000
                      users.                                            54020000
                                                                        54025000
@.@                   Restore all files in all groups in logon account. 54030000
                      Default for account manager.                      54035000
                                                                        54040000
@.@.@                 Restore all files in system. Default for system   54045000
                      manager and system supervisor.                    54050000
                                                                        54055000
file.@.account        Restore specified file in all groups of           54060000
                      specified account.                                54065000
                                                                        54070000
                                       NOTE                             54075000
                                                                        54080000
                      More than one fileset may be used with a single   54085000
                      :RESTORE command.  The number of filesets that may54090000
                      be specified with one :RESTORE command is limited 54095000
                      as follows: up to 10 by account name; up to 15 by 54100000
                      group name and account name; and up to 20 by file 54105000
                      name, group name, and account name.  The fileset  54110000
                      is a positional parameter.                        54115000
                                                                        54120000
                                      NOTE                              54125000
                                                                        54130000
               The characters @, #, and ? can be used as "wild card"    54135000
               characters in the fileset parameter.  These wild card    54140000
               characters have the following meanings:                  54145000
                                                                        54150000
               @ -- specifies zero or more alphanumeric characters.     54155000
                                                                        54160000
               # -- specifies one numeric character.                    54165000
                                                                        54170000
               ? -- specifies one alphanumeric character.               54175000
                                                                        54180000
               The characters can be used as follows:                   54185000
                                                                        54190000
               n@      Restore all files starting with the character n. 54195000
                                                                        54200000
               @n      Restore all files ending with the character n.   54205000
                                                                        54210000
               n@x     Restore all files starting with the character    54215000
                       n and ending with the character x.               54220000
                                                                        54225000
               n##..#  Restore all files starting with the character    54230000
                       n followed by up to seven digits (useful for     54235000
                       restoring all EDIT/3000 temporary files).        54240000
                                                                        54245000
               ?n@     Restore all files whose second character is n.   54250000
               n?      Restore all two-character files starting with    54255000
                       the character n.                                 54260000
                                                                        54265000
               ?n      Restore all two-character files ending with      54270000
                       the character n.                                 54275000
                                                                        54280000
                                                                        54285000
-fileset              This construct may be used only with the fileset  54290000
                      construct as described above.  The syntax is the  54295000
                      same as the fileset.  The addition of a -fileset  54300000
                      allows the elimination of a particular fileset or 54305000
                      subfile set. (e.g. @.@.@ - @.PUB.SYS)             54310000
                                                                        54315000
indirectfile          The name of a file may be used here to specify    54320000
                      file sets and options.  The syntax is as follows: 54325000
                                                                        54330000
                                !<indirectfile>                         54335000
                                                                        54340000
                      Within this file, each line can contain both file 54345000
                      sets and options, but only options can appear     54350000
                      after the first semicolon (;) on each line.       54355000
                                                                        54360000
                                                                        54365000
device                Specifies the device on which the file is to      54370000
                      reside, entered in one of the following forms:    54375000
                                                                        54380000
                      devclass                                          54385000
                      ldn                                               54390000
                                                                        54395000
                      The device class <devclass> specifies the type of 54400000
                      device.  If devclass is specified, the file is    54405000
                      allocated to any of the home volume set's volumes 54410000
                      that fall within that device class.               54415000
                                                                        54420000
                      The logical device number (ldn) specifies a       54425000
                      specific device.  If ldn is specified, the file   54430000
                      will be allocated to that device only if one of   54435000
                      volumes in the home volume set currently occupies 54440000
                      the device.                                       54445000
                                                                        54450000
                      Default:  MPE attempts to restore the file on a   54455000
                      logical device compatible with the type/sub-type  54460000
                      specified in the file's file label and the type/  54465000
                      sub-type of the mounted home volume set.  If this 54470000
                      fails, an attempt is made to restore the file on  54475000
                      the same device class as specified in the file's  54480000
                      file label and that of the mounted home volume    54485000
                      set.  If this fails, an attempt is made to restore54490000
                      the file on any member of the home volume set. If 54495000
                      this fails, the file is not restored.             54500000
                                                                        54505000
SHOW                  Request to list names of restored files. Default: 54510000
                      Only total number of files restored, list of files54515000
                      not restored, (and the reason each was not        54520000
                      restored), and the count of files not restored are54525000
                      listed.  The listing is sent to $STDLIST          54530000
                      (formal designator SYSLIST) unless a :FILE        54535000
                      command is entered to send the listing to some    54540000
                      other device.  For example,                       54545000
                                                                        54550000
                          :FILE SYSLIST;DEV=LP                          54555000
                                                                        54560000
                      entered before the :RESTORE command would send    54565000
                      the listing to a line printer.                    54570000
                                                                        54575000
showoption            An optional parameter used with the SHOW construct54580000
                      as described above.  The following are available: 54585000
                                                                        54590000
                      SHORT - The file, group, and acoount names, the   54595000
                              logical device number, the reel numbers,  54600000
                              the file size (sectors) and the file code 54605000
                              are printed for each file restored.  This 54610000
                              information is listed to the user's       54615000
                              terminal (default).                       54620000
                                                                        54625000
                      LONG  - Displays same information as SHORT plus   54630000
                              the record size, file type, EOF, file     54635000
                              record limit, blocking factor, extents    54640000
                              allocated and maximum number of extents   54645000
                              allocated for all files restored.  If the 54650000
                              list device for SHOW has a record size    54655000
                              than 100 characters, this option is       54660000
                              selected automatically.                   54665000
                                                                        54670000
                      DATES - Caused SHOW to display the creation date  54675000
                              last access date, and last modification   54680000
                              date.                                     54685000
                                                                        54690000
                      SECURITY - Causes SHOW to display the creator and 54695000
                                 the file access matrix of all files    54700000
                                 restored.                              54705000
                                                                        54710000
                      OFFLINE -  Causes SHOW output to be sent to system54715000
                                 line printer as well as to the user's  54720000
                                 terminal.  Output may be redirected to 54725000
                                 another output device by using a :FILE 54730000
                                 command.  (Formal designator is        54735000
                                 OFFLINE.)                              54740000
                                                                        54745000
maxfiles              Maximum number of files that may be restored.     54750000
                      Default is 4000.                                  54755000
                                                                        54760000
LOCAL                 If specified, files would be restored regardless  54765000
                      of the system's directory structure.  The files   54770000
                      would be stored under the user's logon group and  54775000
                      account.  The user must have read access to the   54780000
                      tape to use this construct.                       54785000
                                                                        54790000
GROUP                 When specified with groupname all files that are  54795000
                      restored will have their groups changed to the    54800000
                      that groupname.                                   54805000
                                                                        54810000
groupname             An existing groupname that restored files may be  54815000
                      assigned to.  Used with the GROUP construct.      54820000
                                                                        54825000
ACC[OUN]T             When specified with accountname, all files that   54830000
                      are restored will have their accounts changed to  54835000
                      that accountname.                                 54840000
                                                                        54845000
accountname           An existing accountname that restored files may   54850000
                      be assigned to.  Used with the ACC[OUN]T          54855000
                      construct.                                        54860000
                                                                        54865000
                                           NOTE                         54870000
                         When LOCAL option is used, neither the GROUP   54875000
                         nor the ACC[OUN]T options may be used.         54880000
                                                                        54885000
CREATE                Allows the user to restore files whose group,     54890000
                      account, or creator does not exist in the         54895000
                      system's directory.  CREATE uses the GROUP,       54900000
                      ACCOUNT, and CREATOR options described below.     54905000
                                                                        54910000
GROUP                 If specified, RESTORE will create the groups      54915000
                      necessary to restore the files.  The user must    54920000
                      have Account Manager Capability (AM).             54925000
                                                                        54930000
ACCOUNT               If specified, RESTORE will create the accounts    54935000
                      necessary to restore the files.  The user must    54940000
                      have System Manager Capability (SM).              54945000
                                                                        54950000
CREATOR               If specified, RESTORE will create the users       54955000
                      necessary to restore the files.  The user must    54960000
                      have the appropriate capabilities.                54965000
                                                                        54970000
                                           NOTE                         54975000
                         If CREATE is specified with no options, the    54980000
                         necessary directory structures are created     54985000
                         as long as the user has appropriate            54990000
                         capabilities.                                  54995000
                                                                        55000000
CREATOR               This option may or may not be used with a         55005000
                      supplied username.  If username is supplied,      55010000
                      the username must exist somewhere in the system   55015000
                      directory structure and all restored files'       55020000
                      creator names are changed to this username and    55025000
                      restored.  If the supplied username does not      55030000
                      exist on the system directory, then the files     55035000
                      are not restored.  If a username is not specified,55040000
                      then if the file's creator name exists somewhere  55045000
                      on the system as a user name, then the file is    55050000
                      restored to that user.                            55055000
                                                                        55060000
                                                                        55065000
KEEP                  Specifies that if a file referenced in the        55070000
                      :RESTORE command currently exists on disc, the    55075000
                      file on disc is kept and the corresponding tape   55080000
                      or serial disc                                    55085000
                      file is not copied into the system. Default:  If  55090000
                      an identically-named file exists in the system,   55095000
                      that file is replaced with the one on tape or     55100000
                      serial disc.  If                                  55105000
                      the identically-named file on disc is busy,       55110000
                      however, the disc file is kept and the tape or    55115000
                      serial disc file is not restored.                 55120000
                                                                        55125000
NOKEEP                Specifies that the file residing on disc is       55130000
                      purged and the corresponding tape or serial disc  55135000
                      file is restored.                                 55140000
                                                                        55145000
                                                                        55150000
OLDDATE               If specified, the modification date and the last  55155000
                      access date are set to the dates that were in the 55160000
                      file label when the file was stored.              55165000
                                                                        55170000
NEWDATE               Specifies that the creation date, the modification55175000
                      date, the last access date, and the allocation    55180000
                      date are given the date and time that the RESTORE 55185000
                      takes place.                                      55190000
                                                                        55195000
ONERR[OR]             A construct that allows tape-error recovery.      55200000
                      ONERR[OR] is specified with either QUIT or SKIP as55205000
                      described below.  If ONERR[OR] is not specified,  55210000
                      the default is SKIP for labeled tapes and QUIT for55215000
                      unlabeled tapes.  ONERR[OR]=SKIP may not be       55220000
                      specified with labeled tapes.                     55225000
                                                                        55230000
QUIT                  Used with ONERR[OR].  If specified, the :RESTORE  55235000
                      operation aborts upon sensing an error.           55240000
                                                                        55245000
SKIP                  Used with ONERR[OR].  If specified, the :RESTORE  55250000
                      operation will do a file-skip-forward past a tape 55255000
                      error, resynchronize, and begin reading again from55260000
                      the tape.                                         55265000
                                                                        55270000
                                                                        55275000
\ITEM=OPERATION                                                         55280000
OPERATION                                                               55285000
                                                                        55290000
Reads back into system, on disc, a file or files stored offline by      55295000
:STORE or :SYSDUMP commands.  If you have System Manager or System      55300000
Supervisor capability, you can restore any file from a :STORE tape      55305000
or serial disc,                                                         55310000
assuming the account and group to which the file belongs and the user   55315000
who created the file are defined in the system.  If you have Account    55320000
Manager capability, you can restore any file in your account (but cannot55325000
restore those with negative file codes unless you also have Privileged  55330000
Mode capability.  If you have standard user capability only, you can    55335000
restore any file in your logon account if you have SAVE access to the   55340000
group to which the file belongs; you cannot, however, restore those with55345000
negative file codes unless you have Privileged Mode capability.  If the 55350000
file to be restored is protected by a lockword, you must supply the     55355000
lockword unless you have System Manager, System Supervisor,             55360000
or Account Manager (and you are restoring within your own account)      55365000
capability.  If you are logged on in an interactive session, MPE prompts55370000
you for omitted lockwords.  However, if you are a System Manager,       55375000
System Supervisor, or Account Manager (restoring within your own        55380000
account), you are not required to provide lockwords.  Any file belonging55385000
to a group whose home volume set has not been pre-mounted will not be   55390000
restored.                                                               55395000
                                                                        55400000
The listing output by :RESTORE is sent to a file whose formal designator55405000
is SYSLIST.  If not specified, this file is equated by default to the   55410000
current list device ($STDLIST).                                         55415000
                                                                        55420000
Before entering :RESTORE, you must identify restorefile as a magnetic   55425000
tape or serial disc file with a :FILE command, as follows:              55430000
                                                                        55435000
    :FILE formaldesignator[=filereference};DEV=device[;REC=recsize]     55440000
                                                                        55445000
The device parameter must indicate the device class name or logical     55450000
unit number of a magnetic tape or serial disc unit.  The <recsize>      55455000
parameter needs to be entered if the record size of files being         55460000
:RESTOREd is larger than 4096 for either serial discs or 6250 BPI       55465000
labeled tapes.  All other parameters for the <restorefile> are          55470000
supplied by the :RESTORE command.  If you attempt to supply any of      55475000
of these parameters, MPE will reject the :RESTORE command.              55480000
                                                                        55485000
\ITEM=EXAMPLE                                                           55490000
EXAMPLE                                                                 55495000
                                                                        55500000
To restore all files belonging to your logon group from the restorefile 55505000
named BACKUP, enter:                                                    55510000
                                                                        55515000
    :FILE BACKUP;DEV=TAPE                                               55520000
    :RESTORE *BACKUP;@;KEEP;SHOW                                        55525000
                                                                        55530000
In response, the Console Operator receives a request to mount the tape  55535000
identified as BACKUP. If a serial device file satisfying the @          55540000
specification already exists in the system, it is not restored          55545000
because the keep parameter was specified.                               55550000
                                                                        55555000
To restore a file using a default restorefile, enter:                   55560000
                                                                        55565000
    :RESTORE ;FILE                                                      55570000
                                                                        55575000
Note that the console operator receives a request to mount the tape     55580000
identified as the user's username.                                      55585000
                                                                        55590000
To restore all the files to the group and account PUB.SYS except MAKECAT55595000
using an indirect file INDFILE, which contains:                         55600000
                                                                        55605000
    FILE1, FILE2;SHOW                                                   55610000
    FILE3, @.PUB.SYS - MAKECAT.PUB.SYS                                  55615000
    ;DATE>=11/16/83                                                     55620000
                                                                        55625000
enter:                                                                  55630000
                                                                        55635000
    :FILE T;DEV=TAPE                                                    55640000
                                                                        55645000
    :RESTORE *T; !INDFILE                                               55650000
                                                                        55655000
To restore files from another group and account enter                   55660000
                                                                        55665000
    :FILE T;DEV=TAPE                                                    55670000
                                                                        55675000
    :RESTORE *T;@.GROUP.ACCOUNT;LOCAL                                   55680000
                                                                        55685000
To restore files from another group and account (and the group and      55690000
account do not exist in the current directory structure)                55695000
and to display all of the files' characteristics, enter:                55700000
                                                                        55705000
    :FILE T;DEV=TAPE                                                    55710000
                                                                        55715000
    :RESTORE *T;@.GROUP1.ACCOUNT1;GROUP=GRP1;ACCT=ACCT1;SHOW=LONG       55720000
                                                                        55725000
Note that the user needs SM capability inorder for RESTORE to create    55730000
the account ACCT1.                                                      55735000
                                                                        55740000
To restore files to an existing group and account, to purge existing    55745000
files in the group and account and to skip over any tape errors, enter: 55750000
                                                                        55755000
    :FILE T;DEV=TAPE                                                    55760000
                                                                        55765000
    :RESTORE *T;@.GRP1.ACCT1;NOKEEP;ONERR=SKIP                          55770000
\ENTRY=RESUME,PARMS,OPERATION,EXAMPLE                                   55775000
    :RESUME                                                             55780000
                                                                        55785000
Resumes execution of a suspended operation.                             55790000
                                                                        55795000
SYNTAX                                                                  55800000
                                                                        55805000
    :RESUME                                                             55810000
                                                                        55815000
\ITEM=PARMS                                                             55820000
PARAMETERS                                                              55825000
                                                                        55830000
None                                                                    55835000
                                                                        55840000
\ITEM=OPERATION                                                         55845000
OPERATION                                                               55850000
                                                                        55855000
After a program or MPE command operation is suspended by pressing the   55860000
BREAK key or by using the CAUSEBREAK intrinsic, the :RESUME command     55865000
resumes execution of the operation at the point where the execution was 55870000
suspended.                                                              55875000
                                                                        55880000
Note that the :RESUME command is legitimate only during a BREAK.  Many  55885000
MPE commands are aborted rather than suspended by a BREAK, and thus     55890000
cannot be resumed.                                                      55895000
                                                                        55900000
\ITEM=EXAMPLE                                                           55905000
EXAMPLE                                                                 55910000
                                                                        55915000
    :RESUME                                                             55920000
                                                                        55925000
                                                                        55930000
\ENTRY=RESUMEJOB,PARMS,OPERATION,EXAMPLE                                55935000
     :RESUMEJOB                                                         55940000
                                                                        55945000
Resumes a suspended job.                                                55950000
                                                                        55955000
SYNTAX                                                                  55960000
                                                                        55965000
     :RESUMEJOB #Jnnn                                                   55970000
                                                                        55975000
\ITEM=PARMS                                                             55980000
PARAMETERS                                                              55985000
                                                                        55990000
#Jnnn          A job number.                                            55995000
                                                                        56000000
\ITEM=OPERATION                                                         56005000
OPERATION                                                               56010000
                                                                        56015000
                                                                        56020000
When a suspended job is resumed, it will continue execution from        56025000
the point at which it was suspended.  No message is issued when         56030000
a suspended job is resumed.                                             56035000
                                                                        56040000
\ITEM=EXAMPLE                                                           56045000
EXAMPLES                                                                56050000
                                                                        56055000
To resume suspended job number 68, enter:                               56060000
                                                                        56065000
     :RESUMEJOB #J68                                                    56070000
                                                                        56075000
\ENTRY=RESUMELOG,PARMS,OPERATION,EXAMPLE                                56080000
    :RESUMELOG (System Supervisor capability required)                  56085000
                                                                        56090000
Resumes logging following suspension caused by an error.                56095000
                                                                        56100000
SYNTAX                                                                  56105000
                                                                        56110000
    :RESUMELOG                                                          56115000
                                                                        56120000
\ITEM=PARMS                                                             56125000
PARAMETERS                                                              56130000
                                                                        56135000
None                                                                    56140000
                                                                        56145000
\ITEM=OPERATION                                                         56150000
OPERATION                                                               56155000
                                                                        56160000
(System Supervisor capability required)                                 56165000
This command resumes logging following suspension caused by an error.   56170000
                                                                        56175000
When logging resumes, a special Log Record is displayed that denotes the56180000
number of log events (and corresponding records) missed, total records  56185000
missed, total job initiation records missed, and total job session      56190000
termination records missed.                                             56195000
                                                                        56200000
\ITEM=EXAMPLE                                                           56205000
EXAMPLE                                                                 56210000
                                                                        56215000
Assume the system is on line and running with logging enabled.  An error56220000
of a recoverable type occurs, resulting in the following error message  56225000
to the system console:                                                  56230000
                                                                        56235000
    ST/10:43/LOG FILE NUMBER 104 ERROR #46. LOGGING SUSPENDED           56240000
                                                                        56245000
After the error is corrected, :RESUMELOG is entered:                    56250000
                                                                        56255000
    :RESUMELOG                                                          56260000
                                                                        56265000
In response, the following messages are displayed on the system console:56270000
                                                                        56275000
   ST/10:45/LOG FILE NUMBER 104.  LOGGING RESUMED.                      56280000
   ST/10:45/LOG FILE NUMBER 104 ON.                                     56285000
                                                                        56290000
                                                                        56295000
\ENTRY=RESUMENMLOG,PARMS,OPERATION,EXAMPLE                              56300000
    :RESUMENMLOG (Node Manager capability required)                     56305000
                                                                        56310000
Resumes NMlogging following suspension caused by an error.              56315000
                                                                        56320000
SYNTAX                                                                  56325000
                                                                        56330000
    :RESUMENMLOG                                                        56335000
                                                                        56340000
\ITEM=PARMS                                                             56345000
PARAMETERS                                                              56350000
                                                                        56355000
None                                                                    56360000
                                                                        56365000
\ITEM=OPERATION                                                         56370000
OPERATION                                                               56375000
                                                                        56380000
(Node Manager capability required)                                      56385000
This command resumes NMlogging following suspension caused by an error. 56390000
                                                                        56395000
\ITEM=EXAMPLE                                                           56400000
EXAMPLE                                                                 56405000
                                                                        56410000
Assume the system is on line and running with NMlogging enabled.  An    56415000
error of a recoverable type occurs, resulting in the following error    56420000
message to the system console:                                          56425000
                                                                        56430000
    NMLG FILE NUMBER 104 ERROR #46. NM LOGGING SUSPENDED                56435000
                                                                        56440000
After the error is corrected, :RESUMENMLOG is entered:                  56445000
                                                                        56450000
    :RESUMENMLOG                                                        56455000
                                                                        56460000
In response, the following messages are displayed on the system console:56465000
                                                                        56470000
   NMLG FILE NUMBER 104. NM LOGGING RESUMED.                            56475000
   NMLG FILE NUMBER 104 ON.                                             56480000
                                                                        56485000
                                                                        56490000
\ENTRY=RESUMESPOOL,PARMS,OPERATION,EXAMPLE                              56495000
     :RESUMESPOOL                                                       56500000
                                                                        56505000
Initiates resuming a spooled device.                                    56510000
                                                                        56515000
SYNTAX                                                                  56520000
                                                                        56525000
     :RESUMESPOOL ldn [;{BACK     }          nnn FILES    ]             56530000
                      [;{FORWARD  }         {          }  ]             56535000
                      [                      nnn PAGES    ]             56540000
                                                                        56545000
                      [;{BEGINNING}                       ]             56550000
\ITEM=PARMS                                                             56555000
PARAMETERS                                                              56560000
                                                                        56565000
ldn          The logical device number of a spooled device.             56570000
                                                                        56575000
BACK         Allows operator to backspace files or pages.               56580000
                                                                        56585000
FORWARD      Allows operator forward spacing of files or pages.         56590000
                                                                        56595000
BEGINNING    Allows operator to space to beginning of file.             56600000
             (Beginning of file will be the first non-purged            56605000
              extent).                                                  56610000
                                                                        56615000
nnn FILES    Number of files operator wishes to back or forward         56620000
             space.  The number must be between 1 and 256.              56625000
                                                                        56630000
nnn PAGES    Number of pages operator wishes to back or forward         56635000
             space.  The number must be between 1 and 256.              56640000
                                                                        56645000
                                                                        56650000
\ITEM=OPERATION                                                         56655000
OPERATION                                                               56660000
                                                                        56665000
:RESUMESPOOL can be used after :SUSPENDSPOOL has occured.               56670000
                                                                        56675000
                                                                        56680000
\ITEM=EXAMPLE                                                           56685000
EXAMPLES                                                                56690000
                                                                        56695000
                                                                        56700000
To resume spooling on logical device number 6, enter:                   56705000
                                                                        56710000
     :RESUMESPOOL 6                                                     56715000
                                                                        56720000
To resume spooling on logical device number 6, backspacing              56725000
5 pages, enter:                                                         56730000
                                                                        56735000
     :RESUMESPOOL 6;BACK 5 PAGES                                        56740000
                                                                        56745000
                                                                        56750000
\ENTRY=RJE,PARMS,OPERATION,EXAMPLE                                      56755000
    :RJE                                                                56760000
                                                                        56765000
Calls HP 2780/3780 Emulator.                                            56770000
                                                                        56775000
SYNTAX                                                                  56780000
                                                                        56785000
   :RJE [commandfile][,[inputfile][,[listfile][,punchfile]]]            56790000
                                                                        56795000
\ITEM=PARMS                                                             56800000
PARAMETERS                                                              56805000
                                                                        56810000
commandfile         Actual designator of file from which Emulator reads 56815000
                    its directives.  Can be any ASCII input file.       56820000
                    Formal designator is RJECOM.  Default is $STDIN.    56825000
                                                                        56830000
inputfile           Actual designator of file from which Emulator reads 56835000
                    input data to be transmitted to the remote computer.56840000
                    Can be any ASCII input file. Formal designator is   56845000
                    RJEIN.  Default is $STDIN.                          56850000
                                                                        56855000
listfile            Actual designator of file to receive listed output  56860000
                    obtained from remote computer.  Can be any ASCII    56865000
                    output file.  Formal designator is RJELIST.  Because56870000
                    this file usually is a line printer, it is          56875000
                    defined in a :FILE command and back referenced      56880000
                    as follows:                                         56885000
                                                                        56890000
                    :FILE LP;DEV=LP                                     56895000
                    :RJE CFILE,INFILE,*LP                               56900000
                                                                        56905000
                    Default is $STDLIST.                                56910000
                                                                        56915000
punchfile           Actual designator of file to receive punched output 56920000
                    obtained from remote computer.  Can be any output   56925000
                    file.  Formal designator is RJEPUNCH.  Because this 56930000
                    file usually is a non-disc file, it is defined      56935000
                    in a :FILE command and back referenced as follows:  56940000
                                                                        56945000
                    :FILE PUNFILE;DEV=PTPUNCH                           56950000
                    :RJE CFILE,INFILE,,*PUNFILE                         56955000
                                                                        56960000
                    Default is $OLDPASS (if $OLDPASS exists) or $NEWPASS56965000
                    if $OLDPASS does not exist.                         56970000
                                                                        56975000
                                NOTE                                    56980000
                                                                        56985000
      The formal file designators used in this command                  56990000
      (RJECOM, RJEIN, RJELIST, RJEPUNCH)                                56995000
      cannot be back referenced as actual file designators              57000000
      in the command parameter list.  For further information,          57005000
      see the discussion of implied :FILE commands in                   57010000
      Section VII of the MPE Commands Reference Manual.                 57015000
                                                                        57020000
\ITEM=OPERATION                                                         57025000
OPERATION                                                               57030000
                                                                        57035000
Invokes the HP 2780/3780 Emulator.  The Emulator permits transfer of    57040000
data between an HP 3000 Computer System and a variety of remote         57045000
processors in a full multiprogramming environment.  The Emulator makes  57050000
the HP 3000 Computer System appear to a remote processor as either an   57055000
IBM 2780 or 3780 Data Transmission Terminal.                            57060000
                                                                        57065000
\ITEM=EXAMPLE                                                           57070000
EXAMPLE                                                                 57075000
                                                                        57080000
To invoke the Emulator in a session, enter directives to it via your    57085000
current input device, and input data via the disc file MYDATA, with     57090000
listing output directed to a line printer (LISTFL) and punched output to57095000
a card punch (PUNCHFL), enter:                                          57100000
                                                                        57105000
    :FILE LISTFL;DEV=LP                                                 57110000
    :FILE PUNCHFL;DEV=PTPUNCH                                           57115000
    :RJE ,MYDATA,*LISTFL,*PUNCHFL                                       57120000
                                                                        57125000
                                                                        57130000
\ENTRY=RPG,PARMS,OPERATION,EXAMPLE                                      57135000
    :RPG                                                                57140000
                                                                        57145000
Compiles an RPG program.                                                57150000
                                                                        57155000
SYNTAX                                                                  57160000
                                                                        57165000
    :RPG [textfile][,[uslfile][,[listfile][,[masterfile][,newfile]]]]   57170000
         [;INFO=quotedstring]                                           57175000
                                                                        57180000
\ITEM=PARMS                                                             57185000
PARAMETERS                                                              57190000
                                                                        57195000
textfile           Actual designator of input file from which source    57200000
                   program is read.  Can be any ASCII input file. Formal57205000
                   designator is RPGTEXT.  Default is $STDIN.           57210000
                                                                        57215000
uslfile            Actual designator of USL file on which object program57220000
                   is written.  Can be any binary input file with a     57225000
                   filecode of USL or 1024. Formal designator is RPGUSL.57230000
                   If this parameter is specified, it must indicate a   57235000
                   file previously created in one of four ways:         57240000
                                                                        57245000
                   1.  By saving a USL file, with the MPE :SAVE command,57250000
                       created by a previous compilation where the      57255000
                       default value was used for the <uslfile>         57260000
                       parameter.                                       57265000
                                                                        57270000
                   2.  By building the USL with the MPE Segmenter       57275000
                       -BUILDUSL command.  (See the MPE Segmenter       57280000
                       Reference Manual.)                               57285000
                                                                        57290000
                   3.  By creating a new USL file with the MPE :BUILD   57295000
                       command with a <filecode> of USL or 1024.        57300000
                                                                        57305000
                   4.  By specifying a non-existent <uslfile> parameter,57310000
                       thereby creating a permanent file of the correct 57315000
                       size and type.                                   57320000
                                                                        57325000
                   If no <uslfile> parameter is supplied, the USL file  57330000
                   is saved to the temporary file, $OLDPASS.            57335000
                                                                        57340000
listfile           Actual designator of file on which program listing is57345000
                   written.  Can be any ASCII output file.  Formal      57350000
                   designator is RPGLIST.  Default is $STDLIST.         57355000
                                                                        57360000
masterfile         Actual designator of master file to be merged against57365000
                   <textfile> to produce composite source. Can be any   57370000
                   ASCII input file.  Formal designator is RPGMAST.     57375000
                   Default is master file is not read, input is read    57380000
                   from <textfile>.                                     57385000
                                                                        57390000
newfile            Actual designator of merged <textfile> and           57395000
                   <masterfile>.  Can be any ASCII output file. Formal  57400000
                   designator is RPGNEW.  Default is no file is written.57405000
                                                                        57410000
quotedstring       A string of ASCII characters delimited by a pair of  57415000
                   single or double quotation marks.  If the delimiting 57420000
                   character is desired within the string it can be     57425000
                   doubled.                                             57430000
                                                                        57435000
                   RPG does not recognize this string.  It is included  57440000
                   here for completeness only (ie COBOLII, PASCAL, SPL  57445000
                   and FORTRAN commands have the INFO parameter)        57450000
                                                                        57455000
                                 NOTE                                   57460000
                                                                        57465000
      The formal file designators used in this command                  57470000
      (RPGTEXT, RPGUSL, RPGLIST, RPGMAST, RPGNEW)                       57475000
      cannot be back referenced as actual file designators              57480000
      in the command parameter list.  For further information,          57485000
      see the discussion of implied :FILE commands in                   57490000
      Section VII of the MPE Commands Reference Manual.                 57495000
                                                                        57500000
\ITEM=OPERATION                                                         57505000
OPERATION                                                               57510000
                                                                        57515000
Compiles RPG program onto a User Subprogram Library (USL) file on disc. 57520000
If you do not specify <textfile>, MPE expects input from your current   57525000
job input device.  If the USL file is created prior to compilation, it  57530000
must have a <filecode> of USL or 1024.                                  57535000
                                                                        57540000
\ITEM=EXAMPLE                                                           57545000
EXAMPLE                                                                 57550000
                                                                        57555000
To compile an RPG program entered from the current input device into an 57560000
object program in the USL file $NEWPASS, and write the listing to the   57565000
current list device, enter:                                             57570000
                                                                        57575000
    :RPG                                                                57580000
                                                                        57585000
If the next command is one to prepare an object program, $NEWPASS can be57590000
passed to that command by referencing $OLDPASS.                         57595000
                                                                        57600000
To compile an RPG program residing on the disc file SOURCE into an      57605000
object program on the USL file OBJECT, with the program listing sent to 57610000
the disc file LISTFL, enter:                                            57615000
                                                                        57620000
    :BUILD OBJECT;CODE=USL                                              57625000
    :RPG SOURCE,OBJECT,LISTFL                                           57630000
                                                                        57635000
                                                                        57640000
\ENTRY=RPGGO,PARMS,OPERATION,EXAMPLE                                    57645000
    :RPGGO                                                              57650000
                                                                        57655000
Compiles, prepares, and executes an RPG program.                        57660000
                                                                        57665000
SYNTAX                                                                  57670000
                                                                        57675000
    :RPGGO [textfile][,[listfile][,[masterfile][,newfile]]]             57680000
           [;INFO=quotedstring]                                         57685000
                                                                        57690000
\ITEM=PARMS                                                             57695000
PARAMETERS                                                              57700000
                                                                        57705000
textfile           Actual designator of input file from which source    57710000
                   program is read.  Can be any ASCII input file. Formal57715000
                   designator is RPGTEXT.  Default is $STDIN.           57720000
                                                                        57725000
listfile           Actual designator of file on which program listing is57730000
                   written.  Can be any ASCII output file.  Formal      57735000
                   designator is RPGLIST.  Default is $STDLIST.         57740000
                                                                        57745000
masterfile         Actual designator of master file which is merged     57750000
                   against <textfile> to produce composite source. Can  57755000
                   be any ASCII input file. Formal designator is        57760000
                   RPGLIST. If masterfille is not designated,           57765000
                   input is read from textfile.                         57770000
                                                                        57775000
newfile            Actual designator fo merged <textfile> and           57780000
                   <masterfile>.  Can be any ASCII output file. Formal  57785000
                   designator is RPGNEW. Default is that no file        57790000
                   is written.                                          57795000
                                                                        57800000
quotedstring       A string of ASCII characters delimited by a pair of  57805000
                   single or double quotation marks.  If the delimiting 57810000
                   character is desired within the string it can be     57815000
                   doubled.                                             57820000
                                                                        57825000
                   RPGGO does not recognize this string.  It is included57830000
                   here for completeness only (ie COBOLIIGO, PASCALGO,  57835000
                   SPLGO, and FORTGO commands have the INFO parameter). 57840000
                                                                        57845000
                              NOTE                                      57850000
                                                                        57855000
      The formal file designators used in this command                  57860000
      (RPGTEXT, RPGLIST, RPGMAST, RPGNEW)                               57865000
      cannot be back referenced as actual file designators              57870000
      in the command parameter list.  For further information,          57875000
      see the discussion of implied :FILE commands in                   57880000
      Section VII of the MPE Commands Reference Manual.                 57885000
                                                                        57890000
\ITEM=OPERATION                                                         57895000
OPERATION                                                               57900000
                                                                        57905000
Compiles, prepares, and executes an RPG program.  If you do not specify 57910000
a source file, MPE expects input from your current input device.  This  57915000
command creates a temporary User Subprogram Library (USL) file          57920000
($NEWPASS) that you cannot access, and a temporary program file that you57925000
can access under the name $OLDPASS.                                     57930000
                                                                        57935000
\ITEM=EXAMPLE                                                           57940000
EXAMPLE                                                                 57945000
                                                                        57950000
To compile, prepare, and execute an RPG program entered from the current57955000
input device, with the program listing sent to your current list device,57960000
enter:                                                                  57965000
                                                                        57970000
    :RPGGO                                                              57975000
                                                                        57980000
To compile, prepare, and execute an RPG program read from the disc file 57985000
SOURCE and send the resulting program listing to the disc file LISTFL,  57990000
enter:                                                                  57995000
                                                                        58000000
    :RPGGO SOURCE,LISTFL                                                58005000
\ENTRY=RPGPREP,PARMS,OPERATION,EXAMPLE                                  58010000
    :RPGPREP                                                            58015000
                                                                        58020000
Compiles and prepares an RPG program.                                   58025000
                                                                        58030000
SYNTAX                                                                  58035000
                                                                        58040000
 :RPGPREP [textfile][,[progfile][,[listfile][,masterfile][,newfile]]]]  58045000
          [;INFO=quotedstring]                                          58050000
                                                                        58055000
\ITEM=PARMS                                                             58060000
PARAMETERS                                                              58065000
                                                                        58070000
textfile           Actual designator of input file from which source    58075000
                   program is read.  Can be any ASCII input file. Formal58080000
                   designator is RPGTEXT.  Default is $STDIN.           58085000
                                                                        58090000
progfile           Actual designator of program file on which prepared  58095000
                   program segments are written.  Can be any binary     58100000
                   input file with <filecode> of PROG or 1029.  If      58105000
                   entered, this parameter must indicate a file created 58110000
                   in one of two ways:                                  58115000
                                                                        58120000
                   1.  By creating a new program file with the MPE      58125000
                       :BUILD command with a <filecode> of PROG or 1029 58130000
                       and a numextents parameter value of 1.           58135000
                                                                        58140000
                   2.  By specifying a non-existent file in the         58145000
                       <progfile> parameter, in which case a job session58150000
                       temporary file of the correct size and type is   58155000
                       created.                                         58160000
                                                                        58165000
                   If no <uslfile> parameter is supplied, the USL file  58170000
                   is saved to the temporary file, $OLDPASS.            58175000
                                                                        58180000
listfile           Actual designator of file on which program listing is58185000
                   written.  Can be any ASCII output file.  Formal      58190000
                   designator is RPGLIST.  Default is $STDLIST.         58195000
                                                                        58200000
masterfile         Actual designator of master file which is merged     58205000
                   against <textfile> to produce composite source.  Can 58210000
                   be any ASCII input file.  Formal designator is       58215000
                   RPGMAST.  Default is master file is not read, input  58220000
                   is read from <textfile>.                             58225000
                                                                        58230000
newfile            Actual designator of merged <textfile> and           58235000
                   <masterfile>.  Can be any ASCII output file. Formal  58240000
                   designator is RPGNEW.  Default is no file is written.58245000
                                                                        58250000
quotedstring       A string of ASCII characters delimited by a pair of  58255000
                   single or double quotation marks.  If the delimiting 58260000
                   character is desired within the string it can be     58265000
                   doubled.                                             58270000
                                                                        58275000
                   RPGPREP doesn't recognize the string.  It is included58280000
                   here for completeness only (ie COBOLIIPREP,          58285000
                   PASCALPREP, SPLPREP, and FORTPREP commands have the  58290000
                   INFO parameter.                                      58295000
                                                                        58300000
                             NOTE                                       58305000
                                                                        58310000
      The formal file designators used in this command                  58315000
      (RPGTEXT, RPGPROG, RPGLIST, RPGMAST, RPGNEW)                      58320000
      cannot be back referenced as actual file designators              58325000
      in the command parameter list.  For further information,          58330000
      see the discussion of implied :FILE commands in                   58335000
      Section VII of the MPE Commands Reference Manual.                 58340000
                                                                        58345000
\ITEM=OPERATION                                                         58350000
OPERATION                                                               58355000
                                                                        58360000
Compiles and prepares an RPG program onto a program file on disc.  If   58365000
you do not specify a source file, MPE expects input from your current   58370000
input device.  The User Subprogram Library (USL) file created during    58375000
compilation is a temporary file passed to the preparation mechanism; you58380000
can access it with the name $OLDPASS only if the program file is not    58385000
$NEWPASS.                                                               58390000
                                                                        58395000
\ITEM=EXAMPLE                                                           58400000
EXAMPLE                                                                 58405000
                                                                        58410000
To compile and prepare an RPG program entered through the current input 58415000
device, onto the file $NEWPASS, with the listing printed on the current 58420000
list device, enter:                                                     58425000
                                                                        58430000
    :RPGPREP                                                            58435000
                                                                        58440000
If the next command is one to execute the program, the file $NEWPASS is 58445000
referenced in the execute command under the name $OLDPASS.              58450000
                                                                        58455000
To compile and prepare an RPG program input from a source file named    58460000
SFILE into a program file named MYPROG, with the resulting listing sent 58465000
to the current list device, enter:                                      58470000
                                                                        58475000
    :RPGPREP SFILE,MYPROG                                               58480000
    :SAVE MYPROG                                                        58485000
                                                                        58490000
                                                                        58495000
\ENTRY=RUN,PARMS,OPERATION,EXAMPLE                                      58500000
    :RUN                                                                58505000
                                                                        58510000
Executes a prepared program.                                            58515000
                                                                        58520000
SYNTAX                                                                  58525000
                                                                        58530000
    :RUN progfile[,entrypoint]                                          58535000
                                                                        58540000
         [;NOPRIV]                                                      58545000
         [;LMAP]                                                        58550000
         [;DEBUG]                                                       58555000
         [;MAXDATA=segsize]                                             58560000
         [;PARM=parameternum]                                           58565000
         [;STACK=stacksize]                                             58570000
         [;DL=dlsize]                                                   58575000
                                                                        58580000
                 G                                                      58585000
         [;LIB={ P }]                                                   58590000
                 S                                                      58595000
                                                                        58600000
         [;NOCB]                                                        58605000
         [;INFO=quotedstring]                                           58610000
                                                                        58615000
                 [$NULL              ]]                                 58620000
         [;STDIN=[*formaldesignator  ]]                                 58625000
                 [filereference      ]]                                 58630000
                                                                        58635000
                   [$NULL              ]]                               58640000
         [;STDLIST=[*formaldesignator  ]]                               58645000
                   [filereference[,NEW]]]                               58650000
                                                                        58655000
\ITEM=PARMS                                                             58660000
PARAMETERS                                                              58665000
                                                                        58670000
progfile           Actual designator of program file that contains      58675000
                   prepared program.  (REQUIRED PARAMETER)              58680000
                                                                        58685000
entrypoint         Program entry point where execution is to begin. May 58690000
                   be primary entry point of program or any secondary   58695000
                   entry point in program's outer block. Default is     58700000
                   primary entry point.                                 58705000
                                                                        58710000
NOPRIV             Declaration that program segments will be placed in  58715000
                   non-privileged (user) mode.  This parameter is       58720000
                   intended for programs prepared with privileged mode  58725000
                   capability.  Normally, programs containing privileged58730000
                   instructions are executed in privileged mode only if 58735000
                   program was prepared with privileged mode (PM)       58740000
                   capability class.  (A program containing legally     58745000
                   compiled privileged code, placed in non-privileged   58750000
                   mode, may abort when an attempt is made to execute   58755000
                   it.)  If NOPRIV is specified in the :RUN command, all58760000
                   program segments are placed in non-privileged mode.  58765000
                   (Library segments are not affected because their mode58770000
                   is determined independently.)                        58775000
                                                                        58780000
                   Note that NOPRIV produces the same effect as omitting58785000
                   the $OPTION PRIVILEGED and OPTION PRIVILEGED entries 58790000
                   in SPL source input. Default is privileged mode      58795000
                   programs will remain in privileged mode.             58800000
                                                                        58805000
LMAP               Request to produce a descriptive listing of the      58810000
                   allocated (loaded) program on file whose formal      58815000
                   designator is LOADLIST.  If no :FILE command is found58820000
                   that references LOADLIST, listing is sent to         58825000
                   $STDLIST.  Default is no listing.                    58830000
                                                                        58835000
DEBUG              Request to issue a Debug call before the first       58840000
                   executable instruction of the program.  This         58845000
                   parameter is ignored when a non-privileged user runs 58850000
                   a program having privileged mode capability. This    58855000
                   parameter also is ignored if user does not have read 58860000
                   and write access to program file.  Default is debug  58865000
                   call is not issued.                                  58870000
                                                                        58875000
segsize            Maximum stack area (Z-DL) size permitted, in words.  58880000
                   This parameter is included if it is expected that    58885000
                   size of DL-DB or Z-DB areas will be changed during   58890000
                   program execution. Default is MPE assumes areas will 58895000
                   not be changed.                                      58900000
                                                                        58905000
parameternum       Value that can be passed to program as a general     58910000
                   parameter for control or other purposes.  When       58915000
                   program is executed, this value can be retrieved from58920000
                   address Q(initial)-4, where Q(initial) is Q address  58925000
                   for outer block of program.  Value can be octal      58930000
                   number or signed or unsigned decimal number. Default 58935000
                   is Q(initial)-4 address is filled with zeros.        58940000
                                                                        58945000
stacksize          Size of initial local data area (Z-Q(initial)) in    58950000
                   stack.  This value must exceed 511 words, and        58955000
                   overrides <stacksize> estimated by MPE Segmenter.    58960000
                   Default is estimated by Segmenter.                   58965000
                                                                        58970000
dlsize             DL-DB area to be initially assigned to stack. This   58975000
                   area is of interest mainly in programmatic           58980000
                   applications.  In all cases, the DL-DB area is       58985000
                   rounded upward so that the distance from the         58990000
                   beginning of the stack data segment to the DB address58995000
                   is a multiple of 128 words.  Default is estimated by 59000000
                   Segmenter.                                           59005000
                                                                        59010000
G                  Search segmented procedure libraries to satisfy      59015000
                   external references during allocation in the         59020000
                   following order:  group library, account public      59025000
                   library, system library.  Default is S.              59030000
                                                                        59035000
P                  Search segmented procedure libraries to satisfy      59040000
                   external references during allocation in the         59045000
                   following order:   account public                    59050000
                   library, system library.  Default is S.              59055000
                                                                        59060000
S                  Search system library only to satisfy external       59065000
                   references during allocation.  Default.              59070000
                                                                        59075000
NOCB               Request that file system not use stack segment (PCBX)59080000
                   for its control blocks, even if sufficient space is  59085000
                   available.  This permits expansion of the stack (with59090000
                   the DLSIZE and ZSIZE intrinsics) to the maximum      59095000
                   possible limit at a later time, but causes the File  59100000
                   Management System to operate more slowly for this    59105000
                   program.                                             59110000
                                                                        59115000
quotedstring       A string of ASCII characters delimited by a matching 59120000
                   set of either 's or "s.  If the delimiting character 59125000
                   is desired within the string, it can be doubled as   59130000
                   in most programming languages.  This value can be    59135000
                   retrieved from address Q(initial-6) and Q(initial-5),59140000
                   where Q(initial-6) contains the string length and    59145000
                   Q(initial-5) is byte pointer to the string.  Default 59150000
                   is no string passed (Q-6 and Q-5 are equal to zero). 59155000
                                                                        59160000
STDIN              Allow the $STDIN for the created process to be       59165000
                   other than the default of the $STDIN of its father.  59170000
                                                                        59175000
STDLIST            Allow the $STDLIST for the created process to be     59180000
                   other than the default of the $STDLIST of its father.59185000
                                                                        59190000
$NULL              ALLOWS THE SETTING OF $STDIN OR $STDLIST TO BE THE   59195000
                   system designator $NULL.                             59200000
                                                                        59205000
filereference      Allows the setting of $STDIN or $STDLIST             59210000
                   to an old permanent disc file.  If NEW is specified  59215000
                   with STDLIST, then it is set to a job/session        59220000
                   temporary file with system defaults.                 59225000
                                                                        59230000
formaldesignator   Allows the setting of $STDIN or $STDLIST             59235000
                   to the formal file designator for a file previously  59240000
                   specified in a file equation.                        59245000
                                                                        59250000
\ITEM=OPERATION                                                         59255000
OPERATION                                                               59260000
                                                                        59265000
Executes a program prepared in a program file.  This command permits    59270000
searching of segmented libraries (SL's) but not relocatable libraries   59275000
(RL's) to satisfy external references.                                  59280000
                                                                        59285000
If the volume set containing the file to be run is not mounted, this    59290000
command implicitly causes that volume set to be mounted.                59295000
                                                                        59300000
\ITEM=EXAMPLE                                                           59305000
EXAMPLE                                                                 59310000
                                                                        59315000
To run a program stored in the program file PROG3, enter:               59320000
                                                                        59325000
    :RUN PROG3                                                          59330000
                                                                        59335000
To run a program stored in the program file PROG4, beginning at the     59340000
entry point SECLAB, enter:                                              59345000
                                                                        59350000
    :RUN PROG4,SECLAB                                                   59355000
                                                                        59360000
                                                                        59365000
\ENTRY=SAVE,PARMS,OPERATION,EXAMPLE                                     59370000
    :SAVE                                                               59375000
                                                                        59380000
Saves file in system file domain.                                       59385000
                                                                        59390000
SYNTAX                                                                  59395000
                                                                        59400000
            $OLDPASS,newfilereference                                   59405000
    :SAVE {                           }                                 59410000
            tempfilereference                                           59415000
                                                                        59420000
\ITEM=PARMS                                                             59425000
PARAMETERS                                                              59430000
                                                                        59435000
$OLDPASS               FILE CURRENTLY BEING PASSED.  AFTER THIS FILE IS 59440000
                       saved, no file in the job/session temporary file 59445000
                       domain can be referenced by the name $OLDPASS.   59450000
                                                                        59455000
newfilereference       New actual file designator to be assigned        59460000
                       $OLDPASS when it is made permanent, written in   59465000
                       the format:                                      59470000
                                                                        59475000
                       filename[/lockword][.groupname][.acctname]       59480000
                                                                        59485000
                                                                        59490000
                       If <acctname> is used, this must indicate the    59495000
                       logon account.  If <groupname> is used, this     59500000
                       must indicate a group to which you have SAVE     59505000
                       access, as defined by your Account Manager.  If  59510000
                       <groupname> is omitted, logon group is assigned. 59515000
                       <newfilereference> is required as a parameter if 59520000
                       $OLDPASS is used.                                59525000
                                                                        59530000
tempfilereference      Actual designator of temporary file to be made   59535000
                       permanent under the same designator. The file is 59540000
                       deleted from job/session temporary file domain   59545000
                       and entered in system file domain.  This         59550000
                       parameter is written in the format:              59555000
                                                                        59560000
                       filename[/lockword][.groupname][.acctname]       59565000
                                                                        59570000
                       If <acctname> is used, this must indicate the    59575000
                       logon account.  If <groupname> is used, this     59580000
                       must indicate a group to which you have SAVE     59585000
                       access, as defined by your Account Manager.  If  59590000
                       <groupname> is omitted, logon group is assigned. 59595000
                       <newfilereference> is required as a parameter if 59600000
                       $OLDPASS is used.                                59605000
                                                                        59610000
\ITEM=OPERATION                                                         59615000
OPERATION                                                               59620000
                                                                        59625000
Saves temporary file currently in temporary file domain by converting it59630000
to permanent file in system file domain.  Frequently used to save       59635000
temporary $OLDPASS files produced by compilation or preparation.        59640000
                                                                        59645000
The volume set must be mounted for the group in which the file is to be 59650000
saved or this command will fail  (i.e., a file cannot be saved across   59655000
volume sets).                                                           59660000
                                                                        59665000
This command applies only to temporary files on disc.                   59670000
                                                                        59675000
\ITEM=EXAMPLE                                                           59680000
EXAMPLE                                                                 59685000
                                                                        59690000
To save the temporary file $OLDPASS, containing an object program, onto 59695000
the program file PROGFILE, enter:                                       59700000
                                                                        59705000
    :SAVE $OLDPASS,PROGFILE                                             59710000
                                                                        59715000
To save the temporary file TEMPFL as a permanent file of the same name, 59720000
enter:                                                                  59725000
                                                                        59730000
    :SAVE TEMPFL                                                        59735000
                                                                        59740000
                                                                        59745000
\ENTRY=SECURE,PARMS,OPERATION,EXAMPLE                                   59750000
    :SECURE                                                             59755000
                                                                        59760000
Restores security provisions for a file that were suspended by a        59765000
:RELEASE command.                                                       59770000
                                                                        59775000
SYNTAX                                                                  59780000
                                                                        59785000
    :SECURE {filereference}                                             59790000
                                                                        59795000
\ITEM=PARMS                                                             59800000
PARAMETERS                                                              59805000
                                                                        59810000
filereference        Actual designator of the disc file whose security  59815000
                     provisions are to be restored, written in the      59820000
                     format:                                            59825000
                                                                        59830000
                     filename[/lockword][.groupname][.acctname]         59835000
                                                                        59840000
                     (REQUIRED PARAMETER)                               59845000
                                                                        59850000
\ITEM=OPERATION                                                         59855000
OPERATION                                                               59860000
                                                                        59865000
Restores all security provisions for a file that were suspended         59870000
previously by a :RELEASE command in this or another job.                59875000
                                                                        59880000
This command can be used only for a permanent disc file whose file label59885000
identifies the user as the creator of that file.  In addition, the      59890000
:SECURE command will fail if the group's home volume set is not mounted.59895000
When the normal (default) MPE security provisions are in effect, the    59900000
file must belong to the logon account and group.                        59905000
                                                                        59910000
\ITEM=EXAMPLE                                                           59915000
EXAMPLE                                                                 59920000
                                                                        59925000
To restore the security provisions previously in effect for the file    59930000
named FILE1, enter:                                                     59935000
                                                                        59940000
    :SECURE FILE1                                                       59945000
                                                                        59950000
                                                                        59955000
\ENTRY=SEGMENTER,PARMS,OPERATION,EXAMPLE                                59960000
    :SEGMENTER                                                          59965000
                                                                        59970000
Calls MPE Segmenter.                                                    59975000
                                                                        59980000
SYNTAX                                                                  59985000
                                                                        59990000
    :SEGMENTER [listfile]                                               59995000
                                                                        60000000
\ITEM=PARMS                                                             60005000
PARAMETERS                                                              60010000
                                                                        60015000
listfile         Actual designator of file to receive listable output   60020000
                 from Segmenter.  Can be any ASCII output file. Formal  60025000
                 designator is SEGLIST.  Because this file usually is a 60030000
                 line printer, it is defined in a :FILE command and     60035000
                 back referenced as follows:                            60040000
                                                                        60045000
                 :FILE LISTFL;DEV=LP                                    60050000
                 :SEGMENTER *LISTFL                                     60055000
                                                                        60060000
                 Default is $STDLIST.                                   60065000
                                                                        60070000
                                 NOTE                                   60075000
                                                                        60080000
      The formal file designators used in this command                  60085000
      (SEGLIST)                                                         60090000
      cannot be back referenced as actual file designators              60095000
      in the command parameter list.  For further information,          60100000
      see the discussion of implied :FILE commands in                   60105000
      Section VII of the MPE Commands Reference Manual.                 60110000
                                                                        60115000
\ITEM=OPERATION                                                         60120000
OPERATION                                                               60125000
                                                                        60130000
Calls MPE Segmenter.                                                    60135000
                                                                        60140000
\ITEM=EXAMPLE                                                           60145000
EXAMPLE                                                                 60150000
                                                                        60155000
To call the Segmenter from a session and transmit the listable output to60160000
a line printer instead of the current list device, enter:               60165000
                                                                        60170000
    :FILE LISTFL;DEV=LP                                                 60175000
    :SEGMENTER *LISTFL                                                  60180000
                                                                        60185000
                           NOTE                                         60190000
                                                                        60195000
           To use a Relocatable Library (RL) via                        60200000
           the :SEGMENTER command, the user is                          60205000
           required to have READ and LOCK                               60210000
           capability.                                                  60215000
                                                                        60220000
                                                                        60225000
\ENTRY=SET                                                              60230000
    :SET                                                                60235000
                                                                        60240000
Allows a job or a session to manipulate its environment in              60245000
various ways depending on the option specified.                         60250000
                                                                        60255000
SYNTAX                                                                  60260000
                                                                        60265000
    :SET option [; option [; ...]]                                      60270000
                                                                        60275000
         Where option=                                                  60280000
                                                                        60285000
                       STDLIST = {SAVE|DELETE}                          60290000
NOTE                                                                    60295000
                                                                        60300000
Whenever the command string contains multiple commands, the             60305000
commands are parsed and executed left to right, one at a time.          60310000
There is no check for redundancy or commands that will                  60315000
overide those previous.                                                 60320000
                                                                        60325000
\ITEM=PARMS                                                             60330000
PARAMETERS                                                              60335000
                                                                        60340000
                                                                        60345000
option                                                                  60350000
                                                                        60355000
      STDLIST = {SAVE|DELETE}                                           60360000
                                                                        60365000
        where                                                           60370000
                                                                        60375000
            SAVE       Cancels the effect of a previous                 60380000
                       SET STDLIST=DELETE.                              60385000
                                                                        60390000
            DELETE     Flags the job's STDLIST for deletion at          60395000
                       job termination.                                 60400000
                                                                        60405000
\ITEM=STDLIST                                                           60410000
STDLIST OPERATION                                                       60415000
                                                                        60420000
    This option will allow a job to mark its $STDLIST for               60425000
    deletion upon job termination.  Only jobs with a spooled            60430000
    $STDLIST will be allowed to use this option.                        60435000
                                                                        60440000
STDLIST EXAMPLE                                                         60445000
                                                                        60450000
    !JOB EXAMPLE, MARIE.OSE,WESTON                                      60455000
    !CONTINUE                                                           60460000
    !RUN UPDATE.PUB.SYS;PARM=1;MAXDATA=16000                            60465000
    !IF JCW < FATAL THEN                                                60470000
    !  SET STDLIST=DELETE                                               60475000
    !ENDIF                                                              60480000
    !EOJ                                                                60485000
                                                                        60490000
                                                                        60495000
\ENTRY=SETCATALOG,PARMS,OPERATION,EXAMPLE                               60500000
    :SETCATALOG                                                         60505000
                                                                        60510000
Causes the Command Interpreter to search a catalog of user-defined      60515000
commands and to establish a directory entry for each command            60520000
in the catalog.                                                         60525000
                                                                        60530000
SYNTAX                                                                  60535000
                                                                        60540000
    :SETCATALOG [catfilename[,catfilename[,...[,catfilename]]]][;SHOW]  60545000
                [;ACCOUNT] [;SYSTEM] [;USER=targetuser]                 60550000
                                                                        60555000
\ITEM=PARMS                                                             60560000
PARAMETERS                                                              60565000
                                                                        60570000
catfilename      Catalog file name.                                     60575000
                 The file is a standard EDIT/3000 compatible file.      60580000
                 When more than one user-defined command resides in the 60585000
                 catalog file, each command must be separated from its  60590000
                 neighbors by one or more lines and the first character 60595000
                 of each command must be an asterisk (*).               60600000
                                                                        60605000
SHOW             Lists catalogs and UDC's as user-defined commands are  60610000
                 initialized.  This parameter is useful for additional  60615000
                 information if there is an error in UDC initialization.60620000
                 SHOW lists each UDC as it is checked.  If an error     60625000
                 occurs, it is listed after the erroneous UDC.          60630000
                                                                        60635000
ACCOUNT          Specifies that the catalog file being defined or       60640000
                 reset is at the account level.  Requires AM            60645000
                 capability.                                            60650000
                                                                        60655000
SYSTEM           Specifies that the catalog file being defined or       60660000
                 reset is at the system level.  Requires SM             60665000
                 capability.                                            60670000
                                                                        60670100
USER             Identifies an existing user to which the :SETCATALOG   60670200
                 is applied (see OPERATION and EXAMPLE for details).    60670300
                 A targetuser is required.                              60670310
                                                                        60670400
targetuser       Contains the user and account names of a user as       60670500
                 specified by the ;USER= keyword.  It is of the form    60670600
                                                                        60670610
                               username[.acctname].                     60670700
                                                                        60670710
                 If acctname is not specified, the account defaults to  60670800
                 that of the user executing the :SETCATALOG.            60670900
                                                                        60671000
\ITEM=OPERATION                                                         60675000
OPERATION                                                               60680000
                                                                        60685000
The :SETCATALOG command causes the Command Interpreter to search a      60690000
specially-prepared disc file for user-defined commands.  The Command    60695000
Interpreter then establishes a directory entry for each                 60700000
command in the file.                                                    60705000
                                                                        60710000
When the ;USER= keyword is supplied (with the required targetuser), one 60710100
of two paths may be followed.                                           60710200
   1.  If one or more catfilenames are specified, then the user-defined 60710300
       commands specified with these files, will be initialized (at the 60710400
       user-level) for the targetuser upon a subsequent logon of that   60710500
       user.                                                            60710510
   2.  If no catfilenames are specified, then that targetuser's UDCs    60710600
       (at the user-level) are deactivated by the subsequent logon of   60710700
       that user.                                                       60710710
                                                                        60710800
The ;USER= keyword may not be specified with either the ;SYSTEM or the  60710900
;ACCOUNT keywords.                                                      60711000
                                                                        60711200
The user executing the :SETCATALOG command must have SM capability to   60711300
:SETCATALOG to a targetuser outside the user's account; and must have   60711400
AM capability to :SETCATALOG to a targetuser within the user's          60711500
account (except to the user's self).                                    60711600
                                                                        60715000
\ITEM=EXAMPLE                                                           60720000
EXAMPLE                                                                 60725000
                                                                        60730000
To create a user-defined command (UDC) and have the Command Interpreter 60735000
establish a directory entry for it in the file MYCMNDS, enter:          60740000
                                                                        60745000
    :EDITOR                                                             60750000
                                                                        60755000
    /ADD                                                                60760000
        1  S                   (UDC name)                               60765000
        2  SHOWJOB             (MPE command)                            60770000
        3  **                  (Separates UDC's)                        60775000
        4  R                   (UDC name)                               60780000
        5  RESUME              (MPE command)                            60785000
        6  //                                                           60790000
    /KEEP MYCMNDS                                                       60795000
    /END                                                                60800000
                                                                        60805000
    :SETCATALOG MYCMNDS                                                 60810000
                                                                        60815000
Thus, S and R are established as user-defined commands.  If you enter   60820000
S, the :SHOWJOB MPE command will execute; if you enter R, :RESUME will  60825000
execute.                                                                60830000
                                                                        60835000
Example for altering catalog:                                           60840000
                                                                        60845000
    :SETCATALOG         (Closes existing UDC file)                      60850000
    :EDITOR                                                             60855000
                                                                        60860000
     /TEXT MYCMNDS                                                      60865000
     /ADD                                                               60870000
        6  **                                                           60875000
        7  E                                                            60880000
        8  EDITOR                                                       60885000
        9  //                                                           60890000
     /KEEP MYCMNDS                                                      60895000
     /END                                                               60900000
                                                                        60905000
    :SETCATALOG MYCMNDS                                                 60910000
                                                                        60910100
To establish a set of user-defined commands from a file MYCMNDS (at the 60910200
user-level), for another user KEN.OSE, enter:                           60910300
                                                                        60910400
    :SETCATALOG MYCMNDS;USER=KEN.OSE                                    60910500
                                                                        60910510
Note that the user executing this :SETCATALOG from the OSE account must 60910520
have AM capability.  The user executing this :SETCATALOG from an account60910530
other than OSE must have SM capability.                                 60910540
                                                                        60910600
To deactivate all UDCs (at the user lever) from a user within a logon   60911200
account, enter:                                                         60911300
                                                                        60911400
    :SETCATALOG ;USER=LARRY                                             60911500
                                                                        60912500
Note that the user executing this :SETCATALOG must have AM capability.  60913500
                                                                        60915000
                                                                        60920000
\ENTRY=SETDUMP,PARMS,OPERATION,EXAMPLE                                  60925000
    :SETDUMP                                                            60930000
                                                                        60935000
Enables Stackdump facility on abort.                                    60940000
                                                                        60945000
SYNTAX                                                                  60950000
                                                                        60955000
                DB [,ST] [,QS]                                          60960000
    :SETDUMP [{ ST [,DB]       } [;ASCII]]                              60965000
                QS [,DB]                                                60970000
                                                                        60975000
\ITEM=PARMS                                                             60980000
PARAMETERS                                                              60985000
                                                                        60990000
DB            Dump memory from DL to Q(initial) address. Default is     60995000
              settings of all registers at time of abort and stack      61000000
              marker trace are displayed.                               61005000
                                                                        61010000
ST            Dump memory from Q(initial) to S address. Default is      61015000
              settings of all registers at time of abort and stack      61020000
              marker trace are displayed.                               61025000
                                                                        61030000
QS            Dump memory from Q-63 to S address.  This parameter is    61035000
              ignored if ST parameter is used.  Default is settings of  61040000
              all registers at time of abort and stack marker trace are 61045000
              displayed.                                                61050000
                                                                        61055000
ASCII         Display ASCII conversion of octal values requested by DB, 61060000
              ST, or QS parameters (along with octal display).  Default 61065000
              is octal.                                                 61070000
                                                                        61075000
\ITEM=OPERATION                                                         61080000
OPERATION                                                               61085000
                                                                        61090000
Arms Stackdump Facility as described in the MPE Debug/Stackdump         61095000
Reference Manual.                                                       61100000
                                                                        61105000
In an interactive session, all parameters of the :SETDUMP command are   61110000
ignored and the only effect is the arming of the Stackdump Facility in  61115000
order for the process to call Debug if an abort occurs.                 61120000
                                                                        61125000
\ITEM=EXAMPLE                                                           61130000
EXAMPLE                                                                 61135000
                                                                        61140000
To arm the Stackdump Facility to display the memory area from the       61145000
Q(initial) to S address, with accompanying ASCII convers of the octal   61150000
data, enter:                                                            61155000
                                                                        61160000
    :SETDUMP ST;ASCII                                                   61165000
                                                                        61170000
                                                                        61175000
\ENTRY=SETJCW,PARMS,OPERATION,EXAMPLE                                   61180000
    :SETJCW                                                             61185000
                                                                        61190000
Scans JCW table for a specified JCW name and updates the value of this  61195000
JCW.                                                                    61200000
                                                                        61205000
SYNTAX                                                                  61210000
                                                                        61215000
    :SETJCW jcwname char value [ {+|-} value ]                          61220000
                                                                        61225000
\ITEM=PARMS                                                             61230000
PARAMETERS                                                              61235000
                                                                        61240000
jcwname      The name of a Job Control Word (JCW).  If jcwname is that  61245000
             of an existing JCW, the JCW table is scanned for this name.61250000
             If a name matching jcwname is not found in the JCW table,  61255000
             jcwname is added to the table.  Each job/session has       61260000
             two predefined job control words, JCW and CIERROR.         61265000
             A valid jcwname must start with an alphabetic character    61270000
             and cannot be a valid jcwvalue i.e. FATAL4,SYSTEM,OK2345   61275000
             and WARN56 are all examples of jcw values and therefore    61280000
             are not allowed as jcwnames.                               61285000
                                                                        61290000
char         Any special character except % and -, used as a delimeter. 61295000
                                                                        61300000
value        One of the following:                                      61305000
                                                                        61310000
             1.  Octal number between 0 and %177777.                    61315000
                                                                        61320000
             2.  Decimal number between 0 and 65535.                    61325000
                                                                        61330000
             3.  A name which has been defined as being equivalent to   61335000
                 certain numeric values, as follows:                    61340000
                                                                        61345000
                 OK    = 0                                              61350000
                 OK1   = OK + 1 = 1                                     61355000
                 OK100 = OK + 100 = 100 = %144                          61360000
                                                                        61365000
                 WARN    = 16384 = %40000 (= OK16384)                   61370000
                 WARN100 = WARN + 100 = 16484 = %40144                  61375000
                                                                        61380000
                 FATAL   = 32768 = %100000 (= WARN16384 = OK32768)      61385000
                 FATAL85 = FATAL + 85 = 32853 = %100125                 61390000
                                                                        61395000
                 SYSTEM    = 49152 = %140000                            61400000
                 SYSTEM200 = SYSTEM + 200 = 49352 = %140310             61405000
                                                                        61410000
             4.  The name of an existing JCW.                           61415000
                                                                        61420000
\ITEM=OPERATION                                                         61425000
OPERATION                                                               61430000
                                                                        61435000
The :SETJCW command scans the JCW table for a specified jcwname.  If    61440000
found, jcwname is set equal to the value passed with :SETJCW.  If       61445000
jcwname is not found, it is inserted in the JCW table.                  61450000
                                                                        61455000
\ITEM=EXAMPLE                                                           61460000
EXAMPLE                                                                 61465000
                                                                        61470000
To set the Job Control Word CURR1 to                                    61475000
100, enter:                                                             61480000
                                                                        61485000
    :SETJCW CURR1,100                                                   61490000
                                                                        61495000
To set CURR1 to WARN, enter:                                            61500000
                                                                        61505000
    :SETJCW CURR1/WARN                                                  61510000
                                                                        61515000
To set CURR1 to CURR1 plus 512, enter:                                  61520000
                                                                        61525000
    :SETJCW CURR1=CURR1+512                                             61530000
                                                                        61535000
                                                                        61540000
\ENTRY=SETMSG,PARMS,OPERATION,EXAMPLE                                   61545000
    :SETMSG                                                             61550000
                                                                        61555000
Disables or re-enables receipt of user or operator messages at standard 61560000
list device.                                                            61565000
                                                                        61570000
SYNTAX                                                                  61575000
                                                                        61580000
              OFF                                                       61585000
    :SETMSG {     }                                                     61590000
              ON                                                        61595000
                                                                        61600000
\ITEM=PARMS                                                             61605000
PARAMETERS                                                              61610000
                                                                        61615000
OFF        Sets job or session to refuse :TELL command messages from    61620000
           other users.                                                 61625000
                                                                        61630000
ON         Re-enables message operation.                                61635000
                                                                        61640000
\ITEM=OPERATION                                                         61645000
OPERATION                                                               61650000
                                                                        61655000
Allows job or session to run in quiet mode, such that :TELL messages    61660000
from other users are refused. :WARN messages from the Console           61665000
Operator override quiet mode and are accepted.                          61670000
                                                                        61675000
\ITEM=EXAMPLE                                                           61680000
EXAMPLE                                                                 61685000
                                                                        61690000
To prevent messages, enter:                                             61695000
                                                                        61700000
    :SETMSG OFF                                                         61705000
                                                                        61710000
To re-enable message reception, enter:                                  61715000
                                                                        61720000
    :SETMSG ON                                                          61725000
                                                                        61730000
                                                                        61735000
\ENTRY=SHOWALLOW,PARMS,OPERATION,EXAMPLE                                61740000
    :SHOWALLOW                                                          61745000
                                                                        61750000
Shows which operator commands have been ALLOWed to which                61755000
users.  (See also :ALLOW.)                                              61760000
                                                                        61765000
SYNTAX                                                                  61770000
                                                                        61775000
                 username     acctname                                  61780000
    :SHOWALLOW [{        } . {        }]                                61785000
                     @            @                                     61790000
                                                                        61795000
\ITEM=PARMS                                                             61800000
PARAMETERS                                                              61805000
                                                                        61810000
username            a specific user                                     61815000
                                                                        61820000
acctname            a specific account                                  61825000
                                                                        61830000
@                   all users when used to the left of the              61835000
                    period (.); all accounts when used to               61840000
                    the right of the period                             61845000
                                                                        61850000
\ITEM=OPERATION                                                         61855000
                                                                        61860000
OPERATION                                                               61865000
                                                                        61870000
This command will display which operator commands have been             61875000
ALLOWed to specified users. If no parameters are specified,             61880000
then only the logged on user's ALLOWs are listed. Account               61885000
manager capability or system manager capability or master operator      61890000
status is required to specify "@" for user name and system manager      61895000
capability or master operator status is required to specify "@"         61900000
                                                                        61905000
for acctname.                                                           61910000
Additionally, after listing the ALLOWs for the specified                61915000
users, the command lists separately the operator commands               61920000
which have been globally ALLOWed. If used with no parameters,           61925000
only the ALLOWs related to the logged-on user are displayed.            61930000
                                                                        61935000
\ITEM=EXAMPLE                                                           61940000
                                                                        61945000
EXAMPLES                                                                61950000
                                                                        61955000
:SHOWALLOW @.@                                                          61960000
                                                                        61965000
MANAGER.SYS                                                             61970000
     USER HAS THE FOLLOWING COMMANDS ALLOWED:                           61975000
REPLY              ALLOW             CONSOLE                            61980000
                                                                        61985000
LARRY.MPE                                                               61990000
     USER HAS THE FOLLOWING COMMANDS ALLOWED:                           61995000
REPLY              ABORTJOB                                             62000000
                                                                        62005000
DAN.TP                                                                  62010000
     USER HAS THE FOLLOWING COMMANDS ALLOWED:                           62015000
REPLY              ABORTIO                                              62020000
                                                                        62025000
THE FOLLOWING COMMANDS HAVE BEEN GLOBALLY ALLOWED:                      62030000
REPLY                                                                   62035000
                                                                        62040000
                                                                        62045000
\ENTRY=SHOWCACHE,PARM,OPERATION,EXAMPLE                                 62050000
                                                                        62055000
Reports on disc caching status.                                         62060000
                                                                        62065000
                                                                        62070000
SYNTAX                                                                  62075000
                                                                        62080000
    :SHOWCACHE                                                          62085000
                                                                        62090000
                                                                        62095000
                                                                        62100000
\ITEM=PARMS                                                             62105000
PARAMETERS                                                              62110000
PARAMETERS                                                              62115000
                                                                        62120000
None.                                                                   62125000
                                                                        62130000
                                                                        62135000
OPERATION                                                               62140000
\ITEM=OPERATION                                                         62145000
OPERATION                                                               62150000
                                                                        62155000
The :SHOWCACHE command reports the following information pertaining to  62160000
the state of disc caching in the system:                                62165000
                                                                        62170000
   (1) A list of the cached disc ldevs.                                 62175000
                                                                        62180000
   (2) Total number of cache requests. This is really the total         62185000
       number of user I/Os that now become cache requests - i.e.        62190000
EXAMPLE                                                                 62195000
       reads/writes.                                                    62200000
                                                                        62205000
   (3) Percent of cache hits for read/write requests. This is the       62210000
       number of times that an I/O request was satisfied by data        62215000
       contained in a disc domain.                                      62220000
       Disc domains (or cache domains) are a copy of portions           62225000
       of disc currently residing in main memory.                       62230000
                                                                        62235000
   (4) Percentage of the total cache requests that are reads.           62240000
                                                                        62245000
   (5) Number of process stops. This is the total number of times       62250000
       that a process had to block before an I/O to/from a disc         62255000
       domain could complete.                                           62260000
                                                                        62265000
   (6) Amount of memory (in Kbytes) used as disc domains.               62270000
                                                                        62275000
   (7) The total percent of memory used by cache domains.               62280000
                                                                        62285000
   (8) The total number of cache domains.                               62290000
                                                                        62295000
   (9) The percentage of read I/Os that were satisfied by data          62300000
       in a cache domain, and thus eliminating a physical disc          62305000
       I/O. Note that writes still require a physical I/O to post       62310000
       the domain back to disc (although this posting happens in        62315000
       the background).                                                 62320000
            # Read hits / # Cache Requests                              62325000
                                                                        62330000
  (10) The total amount of memory used as overhead to support           62335000
       disc caching.                                                    62340000
                                                                        62345000
            Overhead for all cache domains (1 sector/domain)            62350000
                            +                                           62355000
            Size of the Cache Directory Table                           62360000
                                                                        62365000
                                                                        62370000
  (11) Additionally, the current values of the parameters that          62375000
       can be altered via :CACHECONTROL (Sequential,Random, and         62380000
       Block On Write).                                                 62385000
                                                                        62390000
                                                                        62395000
\ITEM=EXAMPLE                                                           62400000
EXAMPLE                                                                 62405000
                                                                        62410000
    :SHOWCACHE                                                          62415000
                                                                        62420000
                                                                        62425000
DISC   CACHE    READ WRITE        PROCESS               % OF    CACHE   62430000
LDEV  REQUESTS  HIT%  HIT%  READ%  STOPS      K-BYTES  MEMORY  DOMAINS  62435000
----------------------------------------------------------------------  62440000
                                                                        62445000
1     445937     93    89    87   32980       529         8     307     62450000
2     756273     95    83    69   61262       541         8     260     62455000
3     235178     90    93    31   37819       398         6     197     62460000
4     98353      85    46    64   9252        196         3     58      62465000
5     2007       67    94    61   415         0           0     0       62470000
11    271        33    10    85   154         0           0     0       62475000
13    204868     90    50    64   14202       659         10    237     62480000
                                                                        62485000
Total 1742887    93    80    68   156084      2323        38    1059    62490000
                                                                        62495000
63% of user I/Os eliminated.                                            62500000
Data overhead is 274K bytes.                                            62505000
Sequential fetch quantum is 96 sectors.                                 62510000
Random fetch quantum is 16 sectors.                                     62515000
Block on Write = NO.                                                    62520000
                                                                        62525000
\ENTRY=SHOWCATALOG,PARMS,OPERATION,EXAMPLE                              62530000
    :SHOWCATALOG                                                        62535000
                                                                        62540000
Lists user-defined command (UDC) files.                                 62545000
                                                                        62550000
SYNTAX                                                                  62555000
                                                                        62560000
    :SHOWCATALOG [listfile] [;USER=targetuser]                          62565000
                                                                        62570000
\ITEM=PARMS                                                             62575000
PARAMETERS                                                              62580000
                                                                        62585000
listfile         An arbitrary file name, causing the listing to be sent 62590000
                 to a line printer.  Default:  If omitted, the listing  62595000
                 is sent to $STDLIST.  If specified, the listing        62600000
                 is sent to device class LP (line printer) unless       62605000
                 directed elsewhere with a prior :FILE command.         62610000
                                                                        62610100
USER             Identifies an existing user to which the :SHOWCATALOG  62610200
                 is applied (see OPERATION and EXAMPLE for details).    62610300
                 A targetuser is required.                              62610400
                                                                        62610500
targetuser       Contains the user and the account names of a user as   62610600
                 specified by the ;USER= keyword.  It is of the form    62610700
                                                                        62610710
                               username[.acctname].                     62610800
                                                                        62610810
                 If acctname is not specified, the account defaults to  62610900
                 that of the user executing the :SHOWCATALOG.           62611000
                                                                        62615000
\ITEM=OPERATION                                                         62620000
OPERATION                                                               62625000
The :SHOWCATALOG command lists user-defined command (UDC) files         62630000
and specifies at which levels (USER, ACCOUNT, SYSTEM) the               62635000
files have been defined.                                                62640000
                                                                        62640100
When the ;USER= keyword is specified (with the required targetuser),    62640200
the file names of the UDC files for USER, ACCOUNT, and SYSTEM level     62640300
UDC definitions are displayed.                                          62640400
                                                                        62640500
The "@" may be specified for either the username or the acctname.  The  62640600
following list defines the output and the capabilities needed to display62640700
account and system level UDC file names:                                62640800
                                                                        62640810
       ;USER=@          - Account level UDC file names displayed,       62640820
                          AM capability required.                       62640821
       ;USER=@.acctname - Account level UDC file names displayed,       62640830
                          AM capability required.                       62640840
       ;USER=@.@        - System level UDC file names displayed,        62640850
                          AM capability required.                       62640860
                                                                        62640870
The output is of the form:                                              62640900
                                                                        62641000
       USER UDC CATALOG FILE NAMES:                                     62641100
            UCDFILE.CARGNONI.OSE                                        62641200
                                                                        62641300
       ACCOUNT UDC CATALOG FILE NAMES:                                  62641400
            UDCSUBMIT.PUB.OSE                                           62641500
            UDCACCT.PUB.OSE                                             62641600
            MMTELL.PUB.OSE                                              62641700
                                                                        62641800
       SYSTEM UDC CATALOG FILE NAMES:                                   62641900
            SYS0910.UDC.SYS                                             62642000
                                                                        62645000
                                                                        62650000
\ITEM=EXAMPLE                                                           62655000
EXAMPLE                                                                 62660000
                                                                        62665000
To list UDC files and have the listing appear on the                    62670000
standard list device, enter:                                            62675000
                                                                        62680000
    :SHOWCATALOG                                                        62685000
                                                                        62690000
To have the listing sent to the line printer, enter:                    62695000
                                                                        62700000
    :SHOWCATALOG LFILE                                                  62705000
                                                                        62710000
To have the listing sent to a tape device, enter:                       62715000
                                                                        62720000
    :FILE LFILE;DEV=TAPE                                                62725000
    :SHOWCATALOG LFILE                                                  62730000
                                                                        62730100
To display the UDC files in effect for a targetuser within the user's   62730200
logon account (the user must have AM capability) enter:                 62730400
                                                                        62730500
     :SHOWCATALOG ;USER=BRIAN                                           62730600
     USER UDC CATALOG FILE NAMES:                                       62730710
          MYUDC.PERKIN.OSE                                              62730720
                                                                        62730730
To display the account UDC files for an account other than the user's   62730800
logon account (the user must have SM capability) enter:                 62730900
                                                                        62731000
     :SHOWCATALOG ;USER=@.OSE                                           62731100
     ACCOUNT UDC CATALOG FILE NAMES:                                    62731300
          ACCTUDC1.PUB.OSE                                              62731400
          MMTELL.PUB.OSE                                                62731500
                                                                        62735000
\ENTRY=SHOWCOM,PARMS,OPERATION,EXAMPLE                                  62740000
                                                                        62745000
     :SHOWCOM                                                           62750000
                                                                        62755000
Displays the status information about a communication device.           62760000
                                                                        62765000
SYNTAX                                                                  62770000
                                                                        62775000
     :SHOWCOM  ldn  [;ERROR;RESET]                                      62780000
                                                                        62785000
\ITEM=PARMS                                                             62790000
                                                                        62795000
PARAMETERS                                                              62800000
                                                                        62805000
ldn       The logical device number of a communication system           62810000
          device.                                                       62815000
                                                                        62820000
ERROR     A request for the full status list. If it is not              62825000
          specified, and abbreviated list is displayed.                 62830000
                                                                        62835000
RESET     A request to reset all status information to zero             62840000
          after it has been displayed.                                  62845000
                                                                        62850000
\ITEM=OPERATION                                                         62855000
                                                                        62860000
OPERATION                                                               62865000
                                                                        62870000
The status information from this command can be used to                 62875000
determine communication line activity and quality. The                  62880000
status information provided includes the:                               62885000
                                                                        62890000
o   Number of messages sent and received.                               62895000
                                                                        62900000
o   Last recoverable and irrecoverable errors.                          62905000
                                                                        62910000
o   Number of recoverable and irrecoverable errors.                     62915000
                                                                        62920000
o   Number of transmissions, response timeouts, clear to                62925000
    send losses, and underruns.                                         62930000
                                                                        62935000
o   Number of check character (BCC/CRC) errors, receive                 62940000
    timeouts, carrier losses, and overruns.                             62945000
                                                                        62950000
o   Line state (closed, connected or disconnected).                     62955000
                                                                        62960000
                                                                        62965000
                      NOTE                                              62970000
                                                                        62975000
    Clear to send losses and carrier losses will only                   62980000
    be valid for communication lines configured as                      62985000
    full duplex.                                                        62990000
                                                                        62995000
When the line is in the open state, either connected or                 63000000
disconnected, the status information displayed is a                     63005000
duplicate of the statistics generated from the last                     63010000
open of the line to the point in time the SHOWCOM                       63015000
command is invoked. When the line state is closed, the                  63020000
status information obtained at the close of the line                    63025000
reflects the statistics generated over the last                         63030000
open/close sequence.                                                    63035000
                                                                        63040000
\ITEM=EXAMPLE                                                           63045000
                                                                        63050000
EXAMPLES                                                                63055000
                                                                        63060000
To display the status of logical device 55, enter:                      63065000
                                                                        63070000
:SHOWCOM 55                                                             63075000
                                                                        63080000
                                                                        63085000
                                                                        63090000
To display the full status of logical device 55, enter:                 63095000
                                                                        63100000
:SHOWCOM 55;ERRORS                                                      63105000
                                                                        63110000
                                                                        63115000
                                                                        63120000
                      NOTE                                              63125000
                                                                        63130000
       The last irrecoverable and recoverable                           63135000
       error codes are specified in the Data                            63140000
       Communications Handbook.                                         63145000
                                                                        63150000
                                                                        63155000
\ENTRY=SHOWDEV,PARMS,OPERATION,EXAMPLE                                  63160000
    :SHOWDEV                                                            63165000
                                                                        63170000
Reports status of input/output devices.                                 63175000
                                                                        63180000
SYNTAX                                                                  63185000
                                                                        63190000
               ldev                                                     63195000
    :SHOWDEV [           ]                                              63200000
               classname                                                63205000
                                                                        63210000
\ITEM=PARMS                                                             63215000
PARAMETERS                                                              63220000
                                                                        63225000
ldev              Logical device number of device for which status      63230000
                  information is to be displayed.  Unique for each      63235000
                  individual device.  Default is if both <ldev> and     63240000
                  <classname> are omitted, status information for all   63245000
                  devices on the system is displayed.                   63250000
                                                                        63255000
classname         Device class name of device(s) for which status       63260000
                  information is to be displayed.  May apply to several 63265000
                  devices.  Default is if both <ldev> and <classname>   63270000
                  are omitted, status information for all devices on the63275000
                  system is displayed.                                  63280000
                                                                        63285000
\ITEM=OPERATION                                                         63290000
OPERATION                                                               63295000
                                                                        63300000
Displays status information for any input/output device on the system.  63305000
The following items may appear in the listing, always displayed on the  63310000
standard list device:                                                   63315000
                                                                        63320000
Logical device number.                                                  63325000
                                                                        63330000
Input type allowed:                                                     63335000
                                                                        63340000
    J   Accepts jobs.                                                   63345000
                                                                        63350000
    D   Accepts data.                                                   63355000
                                                                        63360000
    A   Accepts jobs and data.                                          63365000
                                                                        63370000
Availability:                                                           63375000
                                                                        63380000
    AVAIL     Available as a real, non-sharable device.                 63385000
                                                                        63390000
    SPOOLED   Available via input or output spooling.                   63395000
                                                                        63400000
    UNAVAIL   Not available (owned by job or session).                  63405000
                                                                        63410000
    DISC      Device is a disc, always available.                       63415000
                                                                        63420000
Device ownership (if applicable):                                       63425000
                                                                        63430000
    SYS           Owned by system.  If #nnn appears, it specifies       63435000
                  Process Identification Number (PIN) of the owning     63440000
                  process (running program).                            63445000
                                                                        63450000
    SPOOLER IN    Input spooling in effect, owned by spooler.           63455000
                                                                        63460000
    SPOOLER OUT   Output spooling in effect, owned by spooler.          63465000
                                                                        63470000
    #Jnnn         Owned by indicated job.                               63475000
                                                                        63480000
    #Snnn         Owned by indicated session.                           63485000
                                                                        63490000
    DIAG          Allocated to diagnostic testing by Console Operator   63495000
                  via :GIVE command.                                    63500000
                                                                        63505000
    nn FILES      Indicates number of extents currently in use on a     63510000
                  disc.                                                 63515000
                                                                        63520000
    DOWN          Device is offline, requested by Console Operator via  63525000
                  :DOWN command.                                        63530000
                                                                        63535000
    DP            Device is being taken offline (:DOWN command operation63540000
                  pending).                                             63545000
                                                                        63550000
Volume identification:                                                  63555000
                                                                        63560000
    IBM          The named magnetic tape volume has a label             63565000
                 written in the IBM format.                             63570000
                                                                        63575000
    ANSI         The named magnetic tape voulme has a label             63580000
                 written in the ANSI format.                            63585000
                                                                        63590000
    NOLABEL      The named magnetic tape volume has no label.           63595000
                                                                        63600000
Density Information (Only for variable density tape drives):            63605000
                                                                        63610000
    6250         Mounted tape has a density of 6250 BPI.                63615000
                                                                        63620000
    1600         Mounted tape either has a density of 1600 BPI          63625000
                 or the density of the tape is unrecognizable.          63630000
                                                                        63635000
Device association (if applicable):                                     63640000
                                                                        63645000
    #Snnn        The indicated session the device is associated         63650000
                 under.                                                 63655000
                                                                        63660000
    deviceclass  The device class the device is asssociated             63665000
                 under.                                                 63670000
                                                                        63675000
\ITEM=EXAMPLE                                                           63680000
EXAMPLE                                                                 63685000
                                                                        63690000
To display the status of the device identified by logical device number 63695000
12, enter:                                                              63700000
                                                                        63705000
    :SHOWDEV 12                                                         63710000
                                                                        63715000
To display the status of all devices of the device class name LP, enter:63720000
                                                                        63725000
    :SHOWDEV LP                                                         63730000
                                                                        63735000
To display the status of all input/output devices on the system, enter: 63740000
                                                                        63745000
    :SHOWDEV                                                            63750000
                                                                        63755000
                                                                        63760000
\ENTRY=SHOWIN,PARMS,OPERATION,EXAMPLE                                   63765000
    :SHOWIN                                                             63770000
                                                                        63775000
Reports status of input devicefiles.                                    63780000
                                                                        63785000
SYNTAX                                                                  63790000
                                                                        63795000
              #Innn                                                     63800000
              STATUS                                                    63805000
    :SHOWIN [                    ]                                      63810000
              SP                                                        63815000
              item[;item[;item]]                                        63820000
                                                                        63825000
\ITEM=PARMS                                                             63830000
PARAMETERS                                                              63835000
                                                                        63840000
#Innn           Identifier of particular input devicefile for which     63845000
                information is to be displayed.  The information appears63850000
                in following format:                                    63855000
                                                                        63860000
DEV/CL  DFID  JOBNUM  FNAME     STATE    FRM  SPACE  RANK  PRI  #C      63865000
                                                                        63870000
45      #I25  #S16    $STDIN    OPENED                                  63875000
                                                                        63880000
                Default is MPE displays information for all input       63885000
                devicefiles used by this job.                           63890000
                                                                        63895000
STATUS          Request to summarize status information for all current 63900000
                input devicefiles.  The information appears in following63905000
                format:                                                 63910000
                                                                        63915000
                8 FILES:                                                63920000
                    0 ACTIVE                                            63925000
                    0 READY; INCL 0 SPOOFLES, 0 DEFERRED                63930000
                    8 OPENED; INCL 0 SPOOFLES                           63935000
                    0 SPOOFLES; O SECTORS                               63940000
                                                                        63945000
                Default is MPE displays information for all input       63950000
                devicefiles used by this job.                           63955000
                                                                        63960000
item            Request to display status of current input devicefiles  63965000
                as identified by the following subparameters:           63970000
                                                                        63975000
                [DEV=ldev]                                              63980000
                                                                        63985000
                        @S                                              63990000
                        @J                                              63995000
                [JOB= { @     }]                                        64000000
                        [#]Snnn                                         64005000
                        [#]Jnnn                                         64010000
                                                                        64015000
                  ACTIVE                                                64020000
                [ READY  ]                                              64025000
                  OPENED                                                64030000
                                                                        64035000
                Each set of brackets, above, defines an item.  You      64040000
                cannot use the same item more than once in the parameter64045000
                list.  The subparameters are:                           64050000
                                                                        64055000
                ldev      Display status of input devicefile residing on64060000
                          device identified by logical device number    64065000
                          ldev.                                         64070000
                                                                        64075000
                @S        Display status of input devicefiles for all   64080000
                          sessions.                                     64085000
                                                                        64090000
                @J        Display status of input devicefiles for all   64095000
                          jobs.                                         64100000
                                                                        64105000
                #Snnn     Display status of all input devicefiles for   64110000
                          session indicated.                            64115000
                                                                        64120000
                #Jnnn     Display status of all input devicefiles for   64125000
                          job indicated.                                64130000
                                                                        64135000
                ACTIVE    Display status of ACTIVE devicefiles.         64140000
                                                                        64145000
                READY     Display status of READY devicefiles.          64150000
                                                                        64155000
                OPENED    Display status of OPENED devicefiles.         64160000
                                                                        64165000
                Do not use duplicate item keywords in this command. That64170000
                is, you can specify :SHOWIN DEV=25;ACTIVE;@J but not    64175000
                :SHOWIN DEV=25;ACTIVE;OPENED.                           64180000
                                                                        64185000
                Default is MPE displays status information for all input64190000
                devicefiles used by this job.                           64195000
                                                                        64200000
\ITEM=OPERATION                                                         64205000
OPERATION                                                               64210000
                                                                        64215000
Displays status information about one or more currently-defined input   64220000
devicefiles.  This information reflects the status at the time the      64225000
command is entered, and always appears on the standard list device. The 64230000
information includes:                                                   64235000
                                                                        64240000
    Logical device number of device.                                    64245000
                                                                        64250000
    Devicefile identification in the form #Innn.                        64255000
                                                                        64260000
    Job/session number (jsnum) of job/session using the devicefile, if  64265000
    not used for READY or ACTIVE data; otherwise, job/session name      64270000
    appears on line following standard device information.              64275000
                                                                        64280000
    Filename associated with the devicefile.                            64285000
                                                                        64290000
    State:                                                              64295000
                                                                        64300000
        ACTIVE    Input being read from spooled device to disc.         64305000
                                                                        64310000
        READY     Input spooling completed, and file is now ready for   64315000
                  use by a program.                                     64320000
                                                                        64325000
        OPENED    File is being accessed by a program.                  64330000
                                                                        64335000
    Approximate disc space currently used (in sectors), for spooled     64340000
    input devicefiles only.                                             64345000
                                                                        64350000
    Rank, indicating the order in which the file is entered in the      64355000
    system with respect to other files.                                 64360000
                                                                        64365000
    Input priority requested by user (1 = lowest, 13 = highest, blank = 64370000
    current default priority).                                          64375000
                                                                        64380000
\ITEM=EXAMPLE                                                           64385000
EXAMPLE                                                                 64390000
                                                                        64395000
To display the status of the input devicefile with the identifier #I796,64400000
enter:                                                                  64405000
                                                                        64410000
    :SHOWIN #I796                                                       64415000
                                                                        64420000
To display the status of all spooled input devicefiles, enter:          64425000
                                                                        64430000
    :SHOWIN SP                                                          64435000
                                                                        64440000
To request summarized information about all input devicefiles, enter:   64445000
                                                                        64450000
    :SHOWIN STATUS                                                      64455000
\ENTRY=SHOWJCW,PARMS,OPERATION,EXAMPLE                                  64460000
    :SHOWJCW                                                            64465000
                                                                        64470000
Displays current state of Job Control Word.                             64475000
                                                                        64480000
SYNTAX                                                                  64485000
                                                                        64490000
    :SHOWJCW [jcwname]                                                  64495000
                                                                        64500000
\ITEM=PARMS                                                             64505000
PARAMETERS                                                              64510000
                                                                        64515000
jcwname      The name of a Job Control Word (JCW).  If omitted, the     64520000
             status of all JCW's is displayed.                          64525000
                                                                        64530000
\ITEM=OPERATION                                                         64535000
OPERATION                                                               64540000
                                                                        64545000
The :SHOWJCW command is used to display the current state of any or     64550000
all Job Control Words.  If no particular JCW is specified, all JCW's    64555000
are shown.                                                              64560000
                                                                        64565000
\ITEM=EXAMPLE                                                           64570000
EXAMPLE                                                                 64575000
                                                                        64580000
To display the current state of JCW named JCW1, enter:                  64585000
                                                                        64590000
    :SHOWJCW JCW1                                                       64595000
                                                                        64600000
                                                                        64605000
\ENTRY=SHOWJOB,PARMS,OPERATION,EXAMPLE                                  64610000
    :SHOWJOB                                                            64615000
                                                                        64620000
Displays status information about jobs/sessions/scheduled               64625000
jobs.                                                                   64630000
                                                                        64635000
                                                                        64640000
SYNTAX                                                                  64645000
                                                                        64650000
               [#]Snnn                                                  64655000
               [#]Jnnn                                                  64660000
    :SHOWJOB [ STATUS     ]                                             64665000
               id[;state]                                               64670000
               state[;id]                                               64675000
                                                                        64680000
\ITEM=PARMS                                                             64685000
PARAMETERS                                                              64690000
                                                                        64695000
#Snnn     The session number (assigned by MPE) of the session for       64700000
          which status information is to be displayed.  The             64705000
          information appears in Type I format, described under         64710000
          OPERATION.  Default is status information for all jobs/       64715000
          sessions/scheduled jobs are displayed.                        64720000
                                                                        64725000
#Jnnn     The job number (assigned by MPE) of the job for which         64730000
          status information is to be displayed.  The information       64735000
          appears in Type I format, described under OPERATION.          64740000
          Default is status information for all jobs/sessions/          64745000
          scheduled jobs is displayed.                                  64750000
                                                                        64755000
STATUS    A request to display a summary of status information          64760000
          for all jobs/sessions/scheduled jobs.  The information        64765000
          is in Type II format, described under OPERATION.  De-         64770000
          fault is status information for all jobs/sessions/sched-      64775000
          uled jobs displayed.                                          64780000
                                                                        64785000
id        A list of jobs/sessions/scheduled jobs whose status           64790000
          information is to be displayed.  This parameter is            64795000
          written in this format:                                       64800000
              format:                                                   64805000
                                                                        64810000
                   @                                                    64815000
                   @J                                                   64820000
                   @S                                                   64825000
          [JOB= {  [jsname,]username.acctname } ]                       64830000
                   @,username.acctname                                  64835000
                   [@,]@.acctname                                       64840000
                                                                        64845000
          The symbol @ indicates all.  Thus @S means all sessions,      64850000
          @J means all jobs, and @.@.acctname means all sessions and    64855000
          jobs for all users in the specified account.  If only one     64860000
          job/session/scheduled job is displayed, output appears in     64865000
          Type I format; if more than one job/session/scheduled job     64870000
          is displayed, the output appears in Type III format. (For-    64875000
          mat types are described under OPERATION.)  Default is         64880000
          status information for all jobs/sessions/scheduled jobs is    64885000
          displayed.                                                    64890000
                                                                        64895000
state     A particular job/session/scheduled job state, specified as    64900000
          a further restriction on which jobs/sessions/scheduled        64905000
          jobs are to be displayed.  The format of this parameter is:   64910000
                                                                        64915000
                                                                        64920000
            INTRO                                                       64925000
                    ,N                                                  64930000
          [ WAIT   [   ] ]                                              64935000
                    ,D                                                  64940000
            EXEC                                                        64945000
                                                                        64950000
            SCHED                                                       64955000
                                                                        64960000
         N and D, which are requests for only non-deferred or           64965000
         deferred jobs/sessions/scheduled jobs, respectively,           64970000
         apply only to the WAIT state.                                  64975000
                                                                        64980000
         If only one job/session/scheduled job is displayed,            64985000
         output appears in Type I format; if more than one job/ses-     64990000
         sion/scheduled job is displayed, output appears in Type        64995000
         III format. (Format types are described under OPERATION.)      65000000
         Default is status information for all jobs/sessions/           65005000
         scheduled jobs is displayed.                                   65010000
                                                                        65015000
\ITEM=OPERATION                                                         65020000
                                                                        65025000
Obtains status information about any currently-defined jobs/sessions/   65030000
scheduled jobs.                                                         65035000
                                                                        65040000
Output appears in three possible formats:                               65045000
                                                                        65050000
Type I                                                                  65055000
                                                                        65060000
JOBNUM  STATE IPRI JIN  JLIST    INTRODUCED   JOB NAME                  65065000
                                                                        65070000
#S16    EXEC        45  45       TUE  7:08A   TEST.PUBS                 65075000
                                                                        65080000
JOBFENCE= 6; JLIMIT= 3; SLIMIT= 16                                      65085000
                                                                        65090000
                                                                        65095000
CURRENT:  8/15/84  14:32                                                65100000
                                                                        65105000
JOBNUM  STATE IPRI JIN  JLIST    SCHEDULED-INTRO   JOB NAME             65110000
                                                                        65115000
#S16    SCHED    8  10S LP        8/1/84  7:08     SEED84,CAROL.CURETON 65120000
                                                                        65125000
1 SCHEDULED JOB(S)                                                      65130000
                                                                        65135000
                                                                        65140000
Type II:                                                                65145000
                                                                        65150000
7 JOBS:                                                                 65155000
    0 INTRO                                                             65160000
    0 WAIT; INCL 0 DEFERRED                                             65165000
    7 EXEC; INCL 7 SESSIONS                                             65170000
    7 SCHEDULED JOBS                                                    65175000
JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16                                      65180000
                                                                        65185000
NOTE:  The #EXEC jobs/sessions equals the sum of #EXEC and the          65190000
       #EXEC* (EXEC* -  denotes that  job or session is in the          65195000
       state of initialization).                                        65200000
                                                                        65205000
Type III:                                                               65210000
                                                                        65215000
(Type I and Type II.)                                                   65220000
                                                                        65225000
\ITEM=EXAMPLE                                                           65230000
EXAMPLE                                                                 65235000
                                                                        65240000
To display the status of all sessions, enter:                           65245000
                                                                        65250000
    :SHOWJOB JOB=@S                                                     65255000
                                                                        65260000
To display the status of session number S16, enter:                     65265000
                                                                        65270000
    :SHOWJOB #S16                                                       65275000
                                                                        65280000
To display summary information for all jobs/sessions, enter:            65285000
                                                                        65290000
    :SHOWJOB STATUS                                                     65295000
                                                                        65300000
To display the status of all jobs in the INTRO state, enter:            65305000
                                                                        65310000
    :SHOWJOB JOB=@J;INTRO                                               65315000
                                                                        65320000
To display the status of Scheduled Job number S16, enter:               65325000
                                                                        65330000
    :SHOWJOB #J16                                                       65335000
                                                                        65340000
To find out the total number of Scheduled Jobs on the system:           65345000
                                                                        65350000
    :SHOWJOB STATUS                                                     65355000
                                                                        65360000
To display the information for all Scheduled Jobs in the OSE account:   65365000
                                                                        65370000
    :SHOWJOB JOB=@.OSE                                                  65375000
                                                                        65380000
                                                                        65385000
\ENTRY=SHOWLOG,PARMS,OPERATION,EXAMPLE                                  65390000
    :SHOWLOG  (System Supervisor capability required)                   65395000
                                                                        65400000
Displays the current Log File's number and the amount (percentage) of   65405000
available disc space currently used.                                    65410000
                                                                        65415000
SYNTAX                                                                  65420000
                                                                        65425000
    :SHOWLOG                                                            65430000
                                                                        65435000
\ITEM=PARMS                                                             65440000
PARAMETERS                                                              65445000
                                                                        65450000
None                                                                    65455000
                                                                        65460000
\ITEM=OPERATION                                                         65465000
OPERATION                                                               65470000
                                                                        65475000
(System Supervisor capability required)                                 65480000
This command displays the current Log File's number and the amount      65485000
(percentage) of available file space currently used.                    65490000
                                                                        65495000
The information displayed appears in the following format:              65500000
                                                                        65505000
    LOGFILE LOGxxxx IS yy% FULL                                         65510000
                                                                        65515000
where xxxx is the Log File number and yy is the percentage of file space65520000
used.                                                                   65525000
                                                                        65530000
If the Logging System is disabled, MPE outputs the message:             65535000
                                                                        65540000
    NO LOGGING                                                          65545000
                                                                        65550000
If logging is enabled but currently suspended as a result of a          65555000
managerial error, both messages appear.                                 65560000
                                                                        65565000
\ITEM=EXAMPLE                                                           65570000
EXAMPLE                                                                 65575000
                                                                        65580000
To display the number and percent of file space used for the current Log65585000
File, enter:                                                            65590000
                                                                        65595000
    :SHOWLOG                                                            65600000
\ENTRY=SHOWLOGSTATUS,PARMS,OPERATION,EXAMPLE                            65605000
    :SHOWLOGSTATUS                                                      65610000
                                                                        65615000
Displays status information of the currently opened logging             65620000
files.                                                                  65625000
                                                                        65630000
SYNTAX                                                                  65635000
                                                                        65640000
    :SHOWLOGSTATUS  logid                                               65645000
                                                                        65650000
\ITEM=PARMS                                                             65655000
PARAMETERS                                                              65660000
                                                                        65665000
logid         The logging identifier created by the :GETLOG             65670000
              command.                                                  65675000
                                                                        65680000
\ITEM=OPERATION                                                         65685000
OPERATION                                                               65690000
                                                                        65695000
This command is used to list the status of currently running            65700000
logging processes.  The status includes the total number of             65705000
records written by the process and the current number of users          65710000
accessing the logging file.                                             65715000
                                                                        65720000
This command gives the following information about all current-         65725000
ly opened logging files:                                                65730000
                                                                        65735000
     LOGID    - The identifier of the logging process.                  65740000
     USERS    - The number of users                                     65745000
     STATE    - Active or inactive.                                     65750000
     RECORDS  - The number of records in the log file                   65755000
                                                                        65760000
\ITEM=EXAMPLE                                                           65765000
EXAMPLE                                                                 65770000
                                                                        65775000
The display the status of an open log file, (LEN) enter:                65780000
                                                                        65785000
    :SHOWLOGSTATUS                                                      65790000
                                                                        65795000
         LOGID          USERS     STATE      RECORDS                    65800000
                                                                        65805000
         LEN              0       INACT      160                        65810000
                                                                        65815000
                                                                        65820000
\ENTRY=SHOWME,PARMS,OPERATION,EXAMPLE                                   65825000
    :SHOWME                                                             65830000
                                                                        65835000
Reports job/session status.                                             65840000
                                                                        65845000
                                                                        65850000
SYNTAX                                                                  65855000
                                                                        65860000
    :SHOWME                                                             65865000
                                                                        65870000
                                                                        65875000
\ITEM=PARMS                                                             65880000
PARAMETERS                                                              65885000
                                                                        65890000
None                                                                    65895000
                                                                        65900000
\ITEM=OPERATION                                                         65905000
OPERATION                                                               65910000
                                                                        65915000
The :SHOWME command reports the following information pertaining to     65920000
your job or session:                                                    65925000
                                                                        65930000
  Job/session number.                                                   65935000
                                                                        65940000
  User job/session identity.                                            65945000
                                                                        65950000
  MPE version.                                                          65955000
                                                                        65960000
  Current welcome message.                                              65965000
                                                                        65970000
  Current time.                                                         65975000
                                                                        65980000
  Log-on time.                                                          65985000
                                                                        65990000
  Central processor time used by this job/session.                      65995000
                                                                        66000000
  Amount of time job/session has been connected.                        66005000
                                                                        66010000
  Standard input device number.                                         66015000
                                                                        66020000
  Standard list device number.                                          66025000
                                                                        66030000
\ITEM=EXAMPLE                                                           66035000
EXAMPLE                                                                 66040000
                                                                        66045000
    :SHOWME                                                             66050000
                                                                        66055000
    USER: #S95,ED.MPE,SUPPORT      (NOT IN BREAK)                       66060000
    MPE VERSION: HP32002C.00.00                                         66065000
    CURRENT:  THU, OCT 13, 1977, 12:50 PM                               66070000
    LOGON:    THU, OCT 13, 1977, 11:37 AM                               66075000
    CPU SECONDS: 2          CONNECT MINUTES: 73                         66080000
    $STDIN LDEV: 20          $STDLIST LDEV: 20                          66085000
                                                                        66090000
                                                                        66095000
\ENTRY=SHOWNMLOG,PARMS,OPERATION,EXAMPLE                                66100000
                                                                        66105000
    :SHOWNMLOG  (Node Manager capability required)                      66110000
                                                                        66115000
                                                                        66120000
Displays the current NMLog File's number and the amount (percentage)    66125000
of available disc space currently used.                                 66130000
                                                                        66135000
SYNTAX                                                                  66140000
                                                                        66145000
    :SHOWNMLOG                                                          66150000
                                                                        66155000
\ITEM=PARMS                                                             66160000
PARAMETERS                                                              66165000
                                                                        66170000
None                                                                    66175000
                                                                        66180000
\ITEM=OPERATION                                                         66185000
OPERATION                                                               66190000
                                                                        66195000
(Node Manager capability required)                                      66200000
This command displays the current NMLog File's number and the amount    66205000
(percentage) of available file space currently used.                    66210000
                                                                        66215000
The information displayed appears in the following format:              66220000
                                                                        66225000
    NMLG FILE NUMBER x IS yy% FULL                                      66230000
                                                                        66235000
where x is the NMLog File number and yy is the percentage of file       66240000
space used.                                                             66245000
                                                                        66250000
If the NMLogging System is disabled, NM outputs the message:            66255000
                                                                        66260000
    NMLG FILE NUMBER x ERROR #nn. NM LOGGING STOPPED                    66265000
                                                                        66270000
If logging is enabled but currently suspended, NM outputs the message:  66275000
                                                                        66280000
    NMLG FILE NUMBER x IS yy% FULL                                      66285000
    NMLG FILE NUMBER x ERROR #nn. NM LOGGING SUSPENDED                  66290000
                                                                        66295000
\ITEM=EXAMPLE                                                           66300000
EXAMPLE                                                                 66305000
                                                                        66310000
To display the number and percent of file space used for the current    66315000
NMLog File, enter:                                                      66320000
                                                                        66325000
    :SHOWNMLOG                                                          66330000
\ENTRY=SHOWOUT,PARMS,OPERATION,EXAMPLE                                  66335000
    :SHOWOUT                                                            66340000
                                                                        66345000
Reports status of output devicefiles.                                   66350000
                                                                        66355000
SYNTAX                                                                  66360000
                                                                        66365000
               #Onnn                                                    66370000
               STATUS                                                   66375000
    :SHOWOUT [                    ]                                     66380000
               SP                                                       66385000
               item[;item[;item]]                                       66390000
                                                                        66395000
\ITEM=PARMS                                                             66400000
PARAMETERS                                                              66405000
                                                                        66410000
#Onnn         Identifies particular output devicefile for which         66415000
              information is to be displayed.  The information is       66420000
              displayed in Type I format, described under OPERATION.    66425000
              Default is a display of status information for            66430000
              all output device files.                                  66435000
                                                                        66440000
STATUS        Request to summarize status information for all current   66445000
              output devicefiles.  The information is displayed in Type 66450000
              II format, described under OPERATION. Default is          66455000
              a display of status information for all output            66460000
              device files.                                             66465000
                                                                        66470000
SP            Request to display status information for currently       66475000
              spooled output devicefiles associated with the logon      66480000
              job or session.  The information is displayed in Type     66485000
              III format, described under OPERATION.  Default is        66490000
              a display of status information for all output            66495000
              device files.                                             66500000
                                                                        66505000
item          Request to display status of all current output           66510000
              devicefiles.  This parameter is written in the following  66515000
              format:                                                   66520000
                                                                        66525000
                      ldev                                              66530000
              [DEV= {           } ]                                     66535000
                      classname                                         66540000
                                                                        66545000
                      @J                                                66550000
                      @S                                                66555000
              [JOB= { @     } ]                                         66560000
                      [#]Jnnn                                           66565000
                      [#]Snnn                                           66570000
                                                                        66575000
                ACTIVE                                                  66580000
                         ,N                                             66585000
                READY  [    ]                                           66590000
                         ,D                                             66595000
               [              ]                                         66600000
                OPENED                                                  66605000
                LOCKED                                                  66610000
                                                                        66615000
               Each set of brackets defines an item.  You cannot        66620000
               use the same item more than once in the parameter list.  66625000
               The subparameters are:                                   66630000
                                                                        66635000
               ldev         Display status of output devicefile residing66640000
                            on device identified by logical device      66645000
                            number <ldev>.                              66650000
                                                                        66655000
               classname    Display status of output devicefiles        66660000
                            residing on all devices having device class 66665000
                            name <classname>.                           66670000
                                                                        66675000
               @J           Display status of output devicefiles for all66680000
                            jobs.                                       66685000
                                                                        66690000
               @S           Display status of output devicefiles for all66695000
                            sessions.                                   66700000
                                                                        66705000
               #Jnnn        Display status of all output devicefiles for66710000
                            specified job.                              66715000
                                                                        66720000
               #Snnn        Display status of all output devicefiles for66725000
                            session indicated.                          66730000
                                                                        66735000
               ACTIVE       Display status of output devicefiles in     66740000
               READY        specified state.                            66745000
               OPENED                                                   66750000
               LOCKED                                                   66755000
                                                                        66760000
               N            Display status of non-deferred READY        66765000
                            devicefiles only.                           66770000
                                                                        66775000
               D            Display status of deferred READY device-    66780000
                            files only.                                 66785000
                                                                        66790000
               If information for only one devicefile is displayed,     66795000
               output is in Type I format; if information for more than 66800000
               one devicefile is displayed, output is in Type III       66805000
               format.  (Format types are described under OPERATION.)   66810000
                                                                        66815000
\ITEM=OPERATION                                                         66820000
OPERATION                                                               66825000
                                                                        66830000
Displays status information for one or more currently-defined output    66835000
devicefiles.  The information reflects the status at the time the       66840000
command is entered and always appears on the standard list device.  The 66845000
information includes:                                                   66850000
                                                                        66855000
    Logical device number or device class name of device.               66860000
                                                                        66865000
    Devicefile identification, in form #Onnn.                           66870000
                                                                        66875000
    Job/session number (jsnum) of job/session using devicefile, if not  66880000
    used for READY or ACTIVE data.  Otherwise, job/session name appears 66885000
    on line following standard device information.                      66890000
                                                                        66895000
    Filename assigned to devicefile.                                    66900000
                                                                        66905000
    State:                                                              66910000
                                                                        66915000
        ACTIVE    Spooled devicefile on disc is actually being written  66920000
                  to a printer, plotter, or card punch.                 66925000
                                                                        66930000
        READY     Devicefile on disc is ready for output.               66935000
                                                                        66940000
        LOCKED    READY, but system is using file with exclusive access.66945000
                                                                        66950000
        OPENED    Devicefile on disc is being accessed by a program.    66955000
                                                                        66960000
    Forms message indicator (the letter F) appearing only if a forms    66965000
    alignment message applies to this devicefile.                       66970000
                                                                        66975000
    Approximate disc space currently used (in sectors), for spooled     66980000
    output devicefiles only.                                            66985000
                                                                        66990000
    Rank, indicating the order in which the file is entered in the      66995000
    system with respect to other files.                                 67000000
                                                                        67005000
    D, indicating a deferred file, for spooled devicefiles only.        67010000
                                                                        67015000
    Outputpriority, requested by user, for spooled devicefiles only (1 =67020000
    lowest, 13 = highest, blank = current default priority).            67025000
                                                                        67030000
    Number of copies needed (#C), for spooled devicefiles only.         67035000
                                                                        67040000
Output may appear in three possible formats:                            67045000
                                                                        67050000
Type I:                                                                 67055000
                                                                        67060000
DEV/CL   DFID   JOBNUM   FNAME     STATE   FRM   SPACE   RANK  PRI  #C  67065000
                                                                        67070000
45       #O32   #S16     $STDLIST  OPENED                               67075000
                                                                        67080000
Type II:                                                                67085000
                                                                        67090000
    7 FILES:                                                            67095000
        0 ACTIVE                                                        67100000
        0 READY; INCL 0 SPOOFLES, 0 DEFERRED                            67105000
        7 OPENED; INCL 0 SPOOFLES                                       67110000
        0 SPOOFLES: 0 SECTORS                                           67115000
                                                                        67120000
    OUTFENCE= 0                                                         67125000
                                                                        67130000
Type III:                                                               67135000
                                                                        67140000
(Type I followed by Type II.)                                           67145000
                                                                        67150000
\ITEM=EXAMPLE                                                           67155000
EXAMPLE                                                                 67160000
                                                                        67165000
To display the status of the output devicefile with the identifier      67170000
#O977, enter:                                                           67175000
                                                                        67180000
    :SHOWOUT #O977                                                      67185000
                                                                        67190000
To display the status of all output devicefiles associated with         67195000
the logon job or session.                                               67200000
                                                                        67205000
    :SHOWOUT SP                                                         67210000
                                                                        67215000
To request summarized information about all output devicefiles, enter:  67220000
                                                                        67225000
    :SHOWOUT STATUS                                                     67230000
                                                                        67235000
                                                                        67240000
\ENTRY=SHOWQ,PARMS,OPERATION,EXAMPLE                                    67245000
    :SHOWQ (System Supervisor capability required)                      67250000
                                                                        67255000
Displays information about the scheduling of processes and the contents 67260000
of various scheduling subqueues or the master queue.                    67265000
                                                                        67270000
SYNTAX                                                                  67275000
                                                                        67280000
    :SHOWQ                                                              67285000
                                                                        67290000
\ITEM=PARMS                                                             67295000
PARAMETERS                                                              67300000
                                                                        67305000
None                                                                    67310000
                                                                        67315000
\ITEM=OPERATION                                                         67320000
OPERATION                                                               67325000
                                                                        67330000
(System Supervisor capability required)                                 67335000
This command displays information about the scheduling of processes and 67340000
the contents of various scheduling subqueues or the master queue.       67345000
                                                                        67350000
The information displayed is divided into three major columns.  In the  67355000
right column, the processes are listed in high-to-low priority order.   67360000
These processes currently (or will immediately) require the cpu in order67365000
to continue.  The cpu will be given automatically to the first process  67370000
which is able to use it.                                                67375000
                                                                        67380000
In the center column, also listed in order of high-to-low priority, the 67385000
processes are willing to yield their main memory resources to other     67390000
processes.  Memory is taken automatically (segment by segment) from     67395000
lower priority processes first.  These processes are displayed when the 67400000
process does not require the cpu for a relatively long time.  Note also 67405000
that processes which are neither main or user processes are system      67410000
processes.                                                              67415000
                                                                        67420000
In the left column, the processes are listed in numerical order and have67425000
no main memory resources.  These processes are waiting on longer- term  67430000
events, and will again contend for the cpu when those events occur.     67435000
                                                                        67440000
After displaying the process queues, :SHOWQ prints the number of        67445000
processes and the scheduling parameters currently in effect.            67450000
                                                                        67455000
On occasion, a process will appear in the right column as well as in one67460000
of the columns to the left.  This indicates that the process was being  67465000
moved to the right during the execution of :SHOWQ.                      67470000
                                                                        67475000
The following information is displayed for each process:                67480000
                                                                        67485000
    L                                                                   67490000
    C    M          J                                                   67495000
   { } [{ }] pin [#{ } jobnum]                                          67500000
    D    U          S                                                   67505000
    E                                                                   67510000
                                                                        67515000
where                                                                   67520000
                                                                        67525000
L - is a linearly scheduled process on the AS, BS, or master queue.     67530000
                                                                        67535000
C - is a circularly scheduled process on the CS queue.                  67540000
                                                                        67545000
D - is a circularly scheduled process on the DS queue.                  67550000
                                                                        67555000
E - is a circularly scheduled process on the ES queue.                  67560000
                                                                        67565000
M - is a job main process.                                              67570000
                                                                        67575000
U - is a user process.                                                  67580000
                                                                        67585000
pin - is the process identification number for this process.            67590000
                                                                        67595000
J - is the process executing in a batch job.                            67600000
                                                                        67605000
S - is the process executing from a session.                            67610000
                                                                        67615000
jobnum - is the job or session number.                                  67620000
                                                                        67625000
\ITEM=EXAMPLE                                                           67630000
EXAMPLE                                                                 67635000
                                                                        67640000
To display the queues of processes within MPE, enter:                   67645000
                                                                        67650000
    :SHOWQ                                                              67655000
\ENTRY=SHOWTIME,PARMS,OPERATION,EXAMPLE                                 67660000
    :SHOWTIME                                                           67665000
                                                                        67670000
Prints current time and date.                                           67675000
                                                                        67680000
SYNTAX                                                                  67685000
                                                                        67690000
    :SHOWTIME                                                           67695000
                                                                        67700000
\ITEM=PARMS                                                             67705000
PARAMETERS                                                              67710000
                                                                        67715000
None                                                                    67720000
                                                                        67725000
\ITEM=OPERATION                                                         67730000
OPERATION                                                               67735000
                                                                        67740000
Prints current time and date, as indicated by system clock,             67745000
in the following format:                                                67750000
                                                                        67755000
          |---------------------------|                                 67760000
          |WWW, MMM DD, YYYY, HH:MM AM| (or PM)                         67765000
          |---------------------------|                                 67770000
                                                                        67775000
                                                                        67780000
\ITEM=EXAMPLE                                                           67785000
EXAMPLE                                                                 67790000
                                                                        67795000
To display the time and date, enter:                                    67800000
                                                                        67805000
    :SHOWTIME                                                           67810000
                                                                        67815000
MPE responds with a message as follows:                                 67820000
                                                                        67825000
   TUE, JAN 18, 1977,  1:46 PM                                          67830000
                                                                        67835000
\ENTRY=SHUTQ,PARMS,OPERATION,EXAMPLE                                    67840000
                                                                        67845000
     :SHUTQ                                                             67850000
                                                                        67855000
Shuts a spool queue.                                                    67860000
                                                                        67865000
SYNTAX                                                                  67870000
                                                                        67875000
:SHUTQ [ldn]                                                            67880000
       [devclass]                                                       67885000
                                                                        67890000
                                                                        67895000
\ITEM=PARMS                                                             67900000
                                                                        67905000
PARAMETERS                                                              67910000
                                                                        67915000
ldn          The logical device number of an output spoolable device.   67920000
                                                                        67925000
devclass     A device class containing at least one output spoolable    67930000
             device                                                     67935000
                                                                        67940000
\ITEM=OPERATION                                                         67945000
                                                                        67950000
OPERATION                                                               67955000
                                                                        67960000
The :SHUTQ command shuts the spool queue for the specified logical      67965000
device or device class.                                                 67970000
                                                                        67975000
\ITEM=EXAMPLE                                                           67980000
                                                                        67985000
EXAMPLE                                                                 67990000
                                                                        67995000
To shut the spool queue for logical device 6, enter:                    68000000
                                                                        68005000
      :SHUTQ 6                                                          68010000
                                                                        68015000
To shut the spool queue for device class LP, enter:                     68020000
                                                                        68025000
      :SHUTQ LP                                                         68030000
                                                                        68035000
                                                                        68040000
\ENTRY=SNACONTROL,PARMS,OPERATION,EXAMPLE                               68045000
                                                                        68050000
           :SNACONTROL                                                  68055000
                                                                        68060000
This command controls the operation of the SNA Transport subsystem.     68065000
It is used to start and stop SNA nodes and to control tracing           68070000
on SNA sessions.                                                        68075000
                                                                        68080000
                                                                        68085000
SYNTAX                                                                  68090000
                                                                        68095000
      SNACONTROL START                                                  68100000
                 ;NODE=nodename                                         68105000
                 ;CONFIG=configfile                                     68110000
                 [;TDEST=destination]                                   68115000
                 [;TFILE=tracefile]                                     68120000
                 [;TFILESIZE=recordcount]                               68125000
                 [;ERROPT=erroroption]                                  68130000
                                                                        68135000
      SNACONTROL STOP                                                   68140000
                 ;NODE=nodename                                         68145000
                 ;TYPE=stoptype                                         68150000
                                                                        68155000
      SNACONTROL TRACEON                                                68160000
                 ;NODE=nodename                                         68165000
                 ;NAU=naunumber                                         68170000
                 ;STYPE=sessiontype                                     68175000
                 [;TDEST=destination]                                   68180000
                 [;TFILE=tracefile]                                     68185000
                 [;TFILESIZE=recordcount]                               68190000
                                                                        68195000
      SNACONTROL TRACEOFF                                               68200000
                 ;NODE=nodename                                         68205000
                 ;NAU=naunumber                                         68210000
                 ;STYPE=sessiontype                                     68215000
                                                                        68220000
                                                                        68225000
\ITEM=PARMS                                                             68230000
                                                                        68235000
PARMS                                                                   68240000
                                                                        68245000
      SNACONTROL START                                                  68250000
                 ;NODE=nodename                                         68255000
                 ;CONFIG=configfile                                     68260000
                 [;TDEST=destination]                                   68265000
                 [;TFILE=tracefile]                                     68270000
                 [;TFILESIZE=recordcount]                               68275000
                 [;ERROPT=erroroption]                                  68280000
                                                                        68285000
                                                                        68290000
nodename    - matches one of the SNA nodenames in the specified         68295000
              configuration file.                                       68300000
                                                                        68305000
configfile  - configuration file name of the form                       68310000
              file/lockword.group.account.                              68315000
                                                                        68320000
destination - may be "MEM" (for memory), "DISC", or "TAPE".             68325000
              "M", "D", or "T" may be used as abbreviations.            68330000
              This is used to specify where internal state trace        68335000
              records for the node will be written.                     68340000
                                                                        68345000
tracefile   - file name of the form file.group.account, to which        68350000
              internal state trace records will be written.             68355000
              Specification of this parameter is inconsistent with      68360000
              a specification of MEM for destination (see above)        68365000
              and will be treated as an error.  This parameter          68370000
              is an actual file designator; file equations are          68375000
              not allowed.                                              68380000
                                                                        68385000
recordcount - a decimal number specifying the trace file size in        68390000
              number of 128 word records.                               68395000
                                                                        68400000
erroroption - either "SYSFAIL" or "SUBSYSFAIL".  This indicates the     68405000
              action to be taken when SNA Transport detects an          68410000
              uncorrectable internal error.  The abbreviations          68415000
              "SYS" or "SUB" may be used.                               68420000
                                                                        68425000
The square brackets indicate optional parameters.  If a parameter       68430000
is not specified, the node is started with the parameters specified     68435000
in the configuration file.                                              68440000
                                                                        68445000
                                                                        68450000
      SNACONTROL STOP                                                   68455000
                 ;NODE=nodename                                         68460000
                 ;TYPE=stoptype                                         68465000
                                                                        68470000
                                                                        68475000
nodename    - must specify an active node.                              68480000
                                                                        68485000
stoptype    - may be "Q", "P", or "K" for Quiesce, Protocol             68490000
              Shutdown, or Kill, respectively.                          68495000
                                                                        68500000
                                                                        68505000
      SNACONTROL TRACEON                                                68510000
                 ;NODE=nodename                                         68515000
                 ;NAU=naunumber                                         68520000
                 ;STYPE=sessiontype                                     68525000
                 [;TDEST=destination]                                   68530000
                 [;TFILE=tracefile]                                     68535000
                 [;TFILESIZE=recordcount]                               68540000
                                                                        68545000
                                                                        68550000
nodename    - must specify an active node.                              68555000
                                                                        68560000
naunumber   - specifies the number of the NAU on which the session      68565000
              to be traced exists.  A zero indicates that the session   68570000
              is on the PU.                                             68575000
                                                                        68580000
sessiontype - indicates which session on the NAU is to be traced.       68585000
              If an LU is indicated by naunumber, the sessiontype       68590000
              may be either "LU-LU" or "LU-SSCP".  If the PU is         68595000
              indicated by naunumber, the only valid sessiontype        68600000
              is "PU-SSCP", which may either be specified for           68605000
              checking purposes or omitted.                             68610000
                                                                        68615000
destination - may be "DISC", "TAPE", or "NULL".  "D", "T", or "N"       68620000
              may be used as abbreviaions.  This specifies where        68625000
              (or if) user interface trace records are to be written    68630000
              for the specified session.                                68635000
                                                                        68640000
tracefile   - file name of the form file.group.account to which user    68645000
              interface trace records will be written.  Specification   68650000
              of this parameter is inconsistent with a specification    68655000
              of NULL for destination and will be treated as an error.  68660000
              Tracefile must be an actual file designator;  file        68665000
              equations are not allowed.                                68670000
                                                                        68675000
recordcount - a decimal number specifying the trace file size in        68680000
              number of 128 word records.                               68685000
                                                                        68690000
                                                                        68695000
The square brackets indicate optional parameters.  If a parameter       68700000
is not specified, the node is started with the parameters specified     68705000
in the configuration file.                                              68710000
                                                                        68715000
                                                                        68720000
      SNACONTROL TRACEOFF                                               68725000
                 ;NODE=nodename                                         68730000
                 ;NAU=naunumber                                         68735000
                 ;STYPE=sessiontype                                     68740000
                                                                        68745000
                                                                        68750000
nodename    - must specify an active node.                              68755000
                                                                        68760000
naunumber   - specifies the number of the NAU on which the session      68765000
              to be traced exists.  A zero indicates that the session   68770000
              is on the PU.                                             68775000
                                                                        68780000
sessiontype - indicates which session on the NAU is to be traced.       68785000
              If an LU is indicated by naunumber, the sessiontype       68790000
              may be either "LU-LU" or "LU-SSCP".  If the PU is         68795000
              indicated by naunumber, the only valid sessiontype        68800000
              is "PU-SSCP", which may either be specified for           68805000
              checking purposes or omitted.                             68810000
                                                                        68815000
The square brackets indicate optional parameters.                       68820000
                                                                        68825000
\ITEM=OPERATION                                                         68830000
                                                                        68835000
OPERATION                                                               68840000
                                                                        68845000
START    - a new instance of SNA Transport is created and assumes       68850000
           the identity of the SNA PU type 2 node specified by          68855000
           the indicated configuration.                                 68860000
                                                                        68865000
STOP     - an instance of SNA Transport is told to shut down.           68870000
                                                                        68875000
TRACEON  - tracing is started on the indicated SNA session.             68880000
                                                                        68885000
TRACEOFF - tracing is terminated on the indicated session.              68890000
                                                                        68895000
\ITEM=EXAMPLE                                                           68900000
                                                                        68905000
EXAMPLE                                                                 68910000
                                                                        68915000
:SNACONTROL START;NODE=A;CONFIG=C1.PUB.SYS;TDEST=D;TFILE=T1             68920000
                                                                        68925000
   This command starts a new instance of SNA Transport, which           68930000
   will function as an SNA PU as configured under node A in the         68935000
   configuration file C1.PUB.SYS.  Internal state tracing for           68940000
   that node will be to the disc file T1 in the group and account       68945000
   of the issuer of the command.                                        68950000
                                                                        68955000
:SNACONTROL TRACEON;NODE=A;NAU=1;STYPE=LU-LU                            68960000
                                                                        68965000
   This command starts tracing on the LU-LU session of LU 1 on          68970000
   Node A.  The destination of the trace data (and the file name,       68975000
   if the destination is to a file) will be taken from the config-      68980000
   uration file that was specified at the time node A was started.      68985000
                                                                        68990000
:SNACONTROL TRACEOFF;NODE=A;NAU=1;STYPE=LU-LU                           68995000
                                                                        69000000
   This command turns off the trace that was started in the             69005000
   previous example.                                                    69010000
                                                                        69015000
:SNACONTROL STOP;NODE=A;TYPE=Q                                          69020000
                                                                        69025000
   This command shuts down the node that was started in the first       69030000
   example. Sessions on the node are allowed to quiesce gracefully      69035000
   before the node is brought down.                                     69040000
\ENTRY=SPEED,PARMS,OPERATION,EXAMPLE                                    69045000
    :SPEED                                                              69050000
                                                                        69055000
Changes terminal operating speed.                                       69060000
                                                                        69065000
SYNTAX                                                                  69070000
                                                                        69075000
    :SPEED {newinspeed,newoutspeed}                                     69080000
                                                                        69085000
\ITEM=PARMS                                                             69090000
PARAMETERS                                                              69095000
                                                                        69100000
newinspeed      New input speed, in characters per second.  Must be 10, 69105000
                14, 15, 30, 60, 120, 240, 480, 960, or 1920.            69110000
                                                                        69115000
newoutspeed     New output speed, in characters per second.  Must be 10,69120000
                14, 15, 30, 60, 120, 240, 480, 960, or 1920.            69125000
                                                                        69130000
                                                                        69135000
                             NOTE                                       69140000
                                                                        69145000
      Newinspeed and newoutspeed must be the same.                      69150000
                                                                        69155000
\ITEM=OPERATION                                                         69160000
OPERATION                                                               69165000
                                                                        69170000
MPE automatically senses the input/output speed of a terminal when you  69175000
log on at that terminal.  If your terminal has speed-adjustment         69180000
controls, you can change the input and output speeds after log on with  69185000
the :SPEED command.                                                     69190000
Note that this command is not valid for terminals that operate on one   69195000
speed only.                                                             69200000
                                                                        69205000
When the command is entered, MPE outputs the following message at the   69210000
old output speed:                                                       69215000
                                                                        69220000
    CHANGE SPEED AND INPUT "MPE"                                        69225000
                                                                        69230000
Manually change the speed control on the terminal and verify the new    69235000
speed by entering:                                                      69240000
                                                                        69245000
    MPE                                                                 69250000
                                                                        69255000
If the characters "MPE" cannot be verified, the system assumes that the 69260000
terminal is to continue at the old speed.  (To continue, you must       69265000
reset the terminal to the old speed.)                                   69270000
                                                                        69275000
NOTE:  Not all speeds are available on all devices or CPUs.             69280000
                                                                        69285000
                                                                        69290000
\ITEM=EXAMPLE                                                           69295000
EXAMPLE                                                                 69300000
                                                                        69305000
To change the input and output speeds to 240 cps, enter:                69310000
                                                                        69315000
    :SPEED 240,240                                                      69320000
                                                                        69325000
MPE outputs:                                                            69330000
                                                                        69335000
    CHANGE SPEED AND INPUT "MPE"                                        69340000
                                                                        69345000
Manually change the speed and input MPE.                                69350000
                                                                        69355000
                                                                        69360000
\ENTRY=SPL,PARMS,OPERATION,EXAMPLE                                      69365000
    :SPL                                                                69370000
                                                                        69375000
Compiles an SPL program.                                                69380000
                                                                        69385000
SYNTAX                                                                  69390000
                                                                        69395000
 :SPL [textfile][,[uslfile][,[listfile][,[masterfile][,newfile]]]]      69400000
      [;INFO=quotedstring]                                              69405000
                                                                        69410000
\ITEM=PARMS                                                             69415000
PARAMETERS                                                              69420000
                                                                        69425000
textfile             Actual designator of input file from which source  69430000
                     program is read.  Can be any ASCII input file.     69435000
                     Formal designator is SPLTEXT. Default is $STDIN.   69440000
                                                                        69445000
uslfile              Actual designator of USL file on which object      69450000
                     program is written.  Can be any binary output file.69455000
                     Formal designator is SPLUSL.  If entered, this     69460000
                     parameter must indicate a file created previously  69465000
                     in one of four ways:                               69470000
                                                                        69475000
                     1.  By saving a USL file (with the MPE :SAVE       69480000
                         command) which was created by a previous       69485000
                         compilation where the default value was used   69490000
                         for the <uslfile> parameter.                   69495000
                                                                        69500000
                     2.  By building the USL with the MPE Segmenter     69505000
                         -BUILDUSL command.  (See the MPE Segmenter     69510000
                         Reference Manual.)                             69515000
                                                                        69520000
                     3.  By creating a new USL file with the MPE :BUILD 69525000
                         command with a <filecode> of USL or 1024.      69530000
                                                                        69535000
                     4.  By specifying a non-existent <uslfile>         69540000
                         parameter, thereby creating a permanent file of69545000
                         the correct size and type.                     69550000
                                                                        69555000
                     If the <uslfile> parameter is not supplied, the    69560000
                     USL file is saved to the temporary file, $OLDPASS. 69565000
                                                                        69570000
listfile             Actual designator of file on which program listing 69575000
                     is written.  Can be any ASCII output file.  Formal 69580000
                     designator is SPLLIST.  Default is $STDLIST.       69585000
                                                                        69590000
masterfile           Actual designator of master file which is merged   69595000
                     against <textfile> to produce composite source. Can69600000
                     be any ASCII input file.  Formal designator is     69605000
                     SPLMAST.  Default is master file is not read, input69610000
                     is read from <textfile>.                           69615000
                                                                        69620000
newfile              Actual designator of merged <textfile> and         69625000
                     <masterfile>.  Can be any ASCII output file. Formal69630000
                     designator is SPLNEW.  Default is no file is       69635000
                     written.                                           69640000
                                                                        69645000
quotedstring         A string of ASCII characters delimited by a        69650000
                     pair of single or double quotation marks.  If the  69655000
                     delimiting character is desired within the string  69660000
                     it can be doubled.  This feature is used for       69665000
                     specifying compiler options if the options start   69670000
                     with a "$".  Otherwise, the compiler will ingore   69675000
                     the string.  The string, if recognized, will       69680000
                     appear at the beginning of the source.  Refer to   69685000
                     SPL reference manual for further information.      69690000
                                                                        69695000
                                                                        69700000
                                 NOTE                                   69705000
                                                                        69710000
      The formal file designators used in this command                  69715000
      (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, SPLNEW)                       69720000
      cannot be back referenced as actual file designators              69725000
      in the command parameter list.  For further information,          69730000
      see the discussion of implied :FILE commands in                   69735000
      Section VII of the MPE Commands Reference Manual.                 69740000
                                                                        69745000
\ITEM=OPERATION                                                         69750000
OPERATION                                                               69755000
                                                                        69760000
Compiles SPL program onto a User Subprogram Library (USL) file on disc. 69765000
If <textfile> is not specified, MPE expects input from your standard    69770000
input device.                                                           69775000
                                                                        69780000
\ITEM=EXAMPLE                                                           69785000
EXAMPLE                                                                 69790000
                                                                        69795000
To compile an SPL program entered from the job input device into an     69800000
object program in the USL file $NEWPASS, and write the listing to your  69805000
standard list device, enter:                                            69810000
                                                                        69815000
    :SPL                                                                69820000
                                                                        69825000
If the next command is one to prepare an object program, $NEWPASS can be69830000
passed to that command by referencing $OLDPASS.                         69835000
                                                                        69840000
To compile an SPL program residing on the disc file SOURCE into an      69845000
object program on the USL file OBJECT, with program listing generated on69850000
the disc file LISTFL, enter:                                            69855000
                                                                        69860000
    :SPL SOURCE,OBJECT                                                  69865000
    :SAVE OBJECT                                                        69870000
                                                                        69875000
                                                                        69880000
\ENTRY=SPLGO,PARMS,OPERATION,EXAMPLE                                    69885000
    :SPLGO                                                              69890000
                                                                        69895000
Compiles, prepares, and executes an SPL program.                        69900000
                                                                        69905000
SYNTAX                                                                  69910000
                                                                        69915000
    :SPLGO [textfile][,[listfile][,[masterfile][,newfile]]]             69920000
           [;INFO=quotedstring]                                         69925000
                                                                        69930000
\ITEM=PARMS                                                             69935000
PARAMETERS                                                              69940000
                                                                        69945000
textfile            Actual designator of input file from which source   69950000
                    program is read.  Can be any ASCII input file.      69955000
                    Formal designator is SPLTEXT.  Default is $STDIN.   69960000
                                                                        69965000
listfile            Actual designator of file on which program listing  69970000
                    is written.  Can be any ASCII output file.  Formal  69975000
                    designator is SPLLIST.  Default is $STDLIST.        69980000
                                                                        69985000
masterfile          Actual designator of master file which is merged    69990000
                    against <textfile> to produce composite source.  Can69995000
                    be any ASCII input file.  Formal designator is      70000000
                    SPLMAST.  Default is master file is not read, input 70005000
                    is read from <textfile>.                            70010000
                                                                        70015000
newfile             Actual designator of merged <textfile> and          70020000
                    <masterfile>.  Can be any ASCII output file. Formal 70025000
                    designator is SPLNEW.  Default is no file is        70030000
                    written.                                            70035000
                                                                        70040000
quotedstring        A string of ASCII characters delimited by a         70045000
                    pair of single or double quotation marks.  If the   70050000
                    delimiting character is desired within the string   70055000
                    it can be doubled.  This feature is used for        70060000
                    specifying compiler options if the options start    70065000
                    with a "$".  Otherwise, the compiler will ingore    70070000
                    the string.  The string, if recognized, will        70075000
                    appear at the beginning of the source.  Refer to    70080000
                    SPL reference manual for further information.       70085000
                                                                        70090000
                                 NOTE                                   70095000
                                                                        70100000
      The formal file designators used in this command                  70105000
      (SPLTEXT, SPLLIST, SPLMAST, SPLNEW)                               70110000
      cannot be back referenced as actual file designators              70115000
      in the command parameter list.  For further information,          70120000
      see the discussion of implied :FILE commands in                   70125000
      Section VII of the MPE Commands Reference Manual.                 70130000
                                                                        70135000
\ITEM=OPERATION                                                         70140000
OPERATION                                                               70145000
                                                                        70150000
Compiles, prepares, and allocates/executes an SPL program.  If          70155000
<textfile> is omitted, MPE expects input from your standard input       70160000
device.  This command creates a temporary User Subprogram Library (USL) 70165000
file ($NEWPASS) that you cannot access, and a temporary program file    70170000
that you can access under the name $OLDPASS.                            70175000
                                                                        70180000
\ITEM=EXAMPLE                                                           70185000
EXAMPLE                                                                 70190000
                                                                        70195000
To compile, prepare, and execute an SPL program entered from your       70200000
standard input device, with the program listing sent to your standard   70205000
list device, enter:                                                     70210000
                                                                        70215000
    :SPLGO                                                              70220000
                                                                        70225000
To compile, prepare, and execute an SPL program read from the disc file 70230000
SOURCE and send the resulting program listing to the disc file LISTFL,  70235000
enter:                                                                  70240000
                                                                        70245000
    :SPLGO SOURCE,LISTFL                                                70250000
\ENTRY=SPLPREP,PARMS,OPERATION,EXAMPLE                                  70255000
    :SPLPREP                                                            70260000
                                                                        70265000
Compiles and prepares an SPL program.                                   70270000
                                                                        70275000
SYNTAX                                                                  70280000
                                                                        70285000
 :SPLPREP [textfile][,[progfile][,[listfile][,[masterfile][,newfile]]]] 70290000
          [;INFO=quotedstring]                                          70295000
$EDIT VOID=24655100                                                     70300000
                                                                        70305000
\ITEM=PARMS                                                             70310000
PARAMETERS                                                              70315000
                                                                        70320000
textfile            Actual designator of input file from which source   70325000
                    program is read.  Can be any ASCII input file.      70330000
                    Formal designator is SPLTEXT.  Default is $STDIN.   70335000
                                                                        70340000
progfile            Actual designator of program file on which program  70345000
                    segments are written.  Can be any binary output file70350000
                    with <filecode> of PROG or 1029.  If entered, this  70355000
                    parameter must indicate a file created on one of two70360000
                    ways:                                               70365000
                                                                        70370000
                    1.  By creating a new program file with the MPE     70375000
                        :BUILD command with a <filecode> of PROG or 102970380000
                        and a <numextents> parameter value of 1.        70385000
                                                                        70390000
                    2.  By specifying a non-existent file in the        70395000
                        <progfile> parameter, in which case a           70400000
                        job/session temporary file of the correct size  70405000
                        and type is created.                            70410000
                                                                        70415000
                    If the <uslfile> parameter is not supplied, the USL 70420000
                    file is saved to the temporary file, $OLDPASS.      70425000
                                                                        70430000
listfile            Actual designator of file on which program listing  70435000
                    is written.  Can be any ASCII output file.  Formal  70440000
                    designator is SPLLIST.  Default is $STDLIST.        70445000
                                                                        70450000
masterfile          Actual designator of master file which is merged    70455000
                    against <textfile> to produce composite source.  Can70460000
                    be any ASCII input file.  Formal designator is      70465000
                    SPLMAST.  Default is master file is not read, input 70470000
                    is read from <textfile>.                            70475000
                                                                        70480000
newfile             Actual designator of merged <textfile> and          70485000
                    <masterfile>.  Can be any ASCII output file. Formal 70490000
                    designator is SPLNEW.  Default is no file is        70495000
                    written.                                            70500000
                                                                        70505000
quotedstring        A string of ASCII characters delimited by a         70510000
                    pair of single or double quotation marks.  If the   70515000
                    delimiting character is desired within the string   70520000
                    it can be doubled.  This feature is used for        70525000
                    specifying compiler options if the options start    70530000
                    with a "$".  Otherwise, the compiler will ingore    70535000
                    the string.  The string, if recognized, will        70540000
                    appear at the beginning of the source.  Refer to    70545000
                    SPL reference manual for further information.       70550000
                                                                        70555000
                                  NOTE                                  70560000
                                                                        70565000
      The formal file designators used in this command                  70570000
      (SPLTEXT, SPLPROG, SPLLIST, SPLMAST, SPLNEW)                      70575000
      cannot be back referenced as actual file designators              70580000
      in the command parameter list.  For further information,          70585000
      see the discussion of implied :FILE commands in                   70590000
      Section VII of the MPE Commands Reference Manual.                 70595000
                                                                        70600000
\ITEM=OPERATION                                                         70605000
OPERATION                                                               70610000
                                                                        70615000
Compiles and prepares an SPL program onto a program on disc.  If        70620000
<textfile> is not specified, MPE expects input from your standard job/  70625000
session input device.  The User Subprogram Library (USL) file created   70630000
during compilation is a temporary file passed directly to the prepar-   70635000
ation mechanism; you can access it under the name $OLDPASS only if the  70640000
program file is not $NEWPASS.                                           70645000
                                                                        70650000
\ITEM=EXAMPLE                                                           70655000
EXAMPLE                                                                 70660000
                                                                        70665000
To compile and prepare an SPL program entered through the job input     70670000
device, onto the file $NEWPASS, with the listing printed on the job list70675000
device, enter:                                                          70680000
                                                                        70685000
    :SPLPREP                                                            70690000
                                                                        70695000
If the next command is one to execute the program, the file $NEWPASS can70700000
be passed to this command by referencing $OLDPASS.                      70705000
                                                                        70710000
To compile and prepare an SPL source program from a source file named   70715000
SFILE into a program named MYPROG, with the resulting listing sent to   70720000
the job/session list device, enter:                                     70725000
                                                                        70730000
    :SPLPREP SFILE,MYPROG                                               70735000
                                                                        70740000
                                                                        70745000
\ENTRY=STARTCACHE,PARMS,OPERATION,EXAMPLE                               70750000
     :STARTCACHE                                                        70755000
                                                                        70760000
Enables disc file caching on a logical device.                          70765000
                                                                        70770000
SYNTAX                                                                  70775000
                                                                        70780000
     :STARTCACHE ldn                                                    70785000
                                                                        70790000
\ITEM=PARMS                                                             70795000
PARAMETERS                                                              70800000
                                                                        70805000
ldn          The logical device number of a particular disc to have     70810000
             disc caching enabled.                                      70815000
                                                                        70820000
\ITEM=OPERATION                                                         70825000
OPERATION                                                               70830000
                                                                        70835000
This command allows a previously uncached disc to function as a         70840000
cached device. Note: the ldn must be that of a disc !                   70845000
                                                                        70850000
\ITEM=EXAMPLE                                                           70855000
EXAMPLE                                                                 70860000
                                                                        70865000
To enable caching of logical device number 10 to function enter:        70870000
                                                                        70875000
     :STARTCACHE 10                                                     70880000
                                                                        70885000
                                                                        70890000
\ENTRY=STARTSESS,PARMS,OPERATION,EXAMPLE                                70895000
                                                                        70900000
 :STARTSESS                                                             70905000
                                                                        70910000
 This command will start a session on the terminal specified            70915000
 by the <ldn> parameter.  It is the functional equivalent of            70920000
 :HELLO with the exception that rather than using the terminal          70925000
 that the command was entered on, the user is able to specify           70930000
 the logical device number of the desired terminal.                     70935000
SYNTAX                                                                  70940000
                                                                        70945000
 :STARTSESS ldn;[sessionname,]username[/userpass].acctname[/acctpass]   70950000
                [,groupname[/grouppass]]                                70955000
                                                                        70960000
                  [;TERM=termtype]                                      70965000
                  [;TIME=cpusecs]                                       70970000
                                                                        70975000
                          BS                                            70980000
                          CS                                            70985000
                  [;PRI={    }]                                         70990000
                          DS                                            70995000
                          ES                                            71000000
                                                                        71005000
                   ;INPRI=inputpriority                                 71010000
                  [                     ]                               71015000
                   ;HIPRI                                               71020000
                                                                        71025000
                  [;NOWAIT ]                                            71026000
                                                                        71027000
                                                                        71030000
\ITEM=PARMS                                                             71035000
                                                                        71040000
PARAMETERS                                                              71045000
                                                                        71050000
ldev                Logical device number of terminal that session      71055000
                    is to be started on.  Must be valid hard-wired      71060000
                    physical terminal. (REQUIRED PARAMETER)             71065000
                                                                        71070000
sessionname         Arbitrary name in conjunction with <username>       71075000
                    and <acctname> parameters to form a session         71080000
                    identity.  Contains from 1 to 8 alphanumeric        71085000
                    characters, beginning with a letter.  Default is    71090000
                    no session name is assigned.                        71095000
                                                                        71100000
username            A user name, established by Account Manager, that   71105000
                    allows you to log on under this account. Contains   71110000
                    from 1 to 8 alphanumeric characters, beginning      71115000
                    with a letter.  (REQUIRED PARAMETER)                71120000
                                                                        71125000
userpass            User password, optionally assigned by Account       71130000
                    Manager.  Contains from 1 to 8 alphanumeric         71135000
                    characters, beginning with a letter.                71140000
                                                                        71145000
acctname            Name of account, established by System Manager.     71150000
                    Contains from 1 to 8 alphanumeric characters,       71155000
                    beginning with a letter. The <acctname> parameter   71160000
                    must be preceded by a period.(REQUIRED PARAMETER)   71165000
                                                                        71170000
acctpass            Account password, optionally assigned by System     71175000
                    Manger.  Contains from 1 to 8 alphanumeric          71180000
                    characters, beginning with a letter.                71185000
                                                                        71190000
groupname           Name of group to be used for local file domain      71195000
                    and CPU charges.  Established by Account Manager.   71200000
                    Contains from 1 to 8 alphanumeric characters,       71205000
                    beginning with a letter.  Default is your home      71210000
                    group if you are assigned one by Account Manager.   71215000
                    (Optional if you have a home group, required if     71220000
                    home group not assigned.)                           71225000
                                                                        71230000
grouppass           (Required if assigned and you are logging on        71235000
                    under other than home group.  Not required if       71240000
                    logging on under home group.)                       71245000
                                                                        71250000
                    Group password, optionally assigned by Account      71255000
                    Manager.  Contains from 1 to 8 alphanumeric         71260000
                    characters, beginning with a letter.                71265000
                                                                        71270000
 termtype           Type of terminal used for input.  MPE uses this     71275000
                    parameter to determine device-dependent             71280000
                    characteristics such as delay factor for carriage   71285000
                    returns.  Must be a number from 0 to 15, as         71290000
                    follows:                                            71295000
                                                                        71300000
                    0   HP 2749B EIA-compatible HP 2749B (10 char.      71305000
                        per second (cps)).                              71310000
                                                                        71315000
                    1   ASR 37 EIA compatible (10 cps).                 71320000
                                                                        71325000
                    2   ASR 35 EIA compatible (10 cps).                 71330000
                                                                        71335000
                    3   Execuport 300 Data Communication Transceiver    71340000
                        Terminal (10, 15, 30 cps).                      71345000
                                                                        71350000
                    4   HP 2600A or Datapoint 3300 (10-240 cps).        71355000
                                                                        71360000
                    5   Memorex 1240 (10, 15, 30, 60 cps).              71365000
                                                                        71370000
                    6   GE Terminet 300, 1200, or Data Communication    71375000
                        Terminal, Model B (10, 15, 30, or 120 cps).     71380000
                                                                        71385000
                    9   HP 2615A (Beehive MiniBee) (10-240 cps).        71390000
                                                                        71395000
                   10   HP 2640A/B, HP 2641A, HP 2644A, or HP 2645A.    71400000
                        Character mode or full program control of       71405000
                        block mode transmission (10-240 cps).           71410000
                                                                        71415000
                   11   HP 2640A/B, HP 2641A, HP 2644A, or HP 2645A.    71420000
                        Allows user to use block mode without program   71425000
                        control of block mode transmission.  Requires   71430000
                        user to position cursor before pressing ENTER.  71435000
                        Recommended for speeds exceeding 30 cps when    71440000
                        you expect to switch between character mode     71445000
                        and block/line mode.  May not be used in        71450000
                        block/page mode (10-240 cps).                   71455000
                                                                        71460000
                   12   HP 2645K  Katakana/Roman Data Terminal.         71465000
                                                                        71470000
                   13   Message switching network or other computer.    71475000
                                                                        71480000
                   14   Multi-Point Terminal.                           71485000
                                                                        71490000
                   15   HP 2635A Printing Terminal.  8-bit protocol     71495000
                        (for second character set).                     71500000
                                                                        71505000
                   16   HP 2635A Printing Terminal.  7-bit protocol     71510000
                        (standard character set).                       71515000
                                                                        71520000
                   Default:  For hardwired terminals, determined by     71525000
                   System Supervisor during system configuration.       71530000
                                                                        71535000
                   Required parameter to insure correct listings if     71540000
                   your terminal is not the default term type.          71545000
                                                                        71550000
                                       NOTE                             71555000
                                                                        71560000
                   On Series 33, only term types 4, 6, 9, 10, 11        71565000
                   12, 15, and 16 may be used.                          71570000
                                                                        71575000
                                                                        71580000
cpusecs            Maximum CPU time that session can use, entered in    71585000
                   secs.  When limit is reached, session is aborted.    71590000
                   Must be a value from 1 to 32767.  To specify no      71595000
                   limit, enter question mark (?) or UNLIM, or omit     71600000
                   parameter.  Default is no limit.                     71605000
                                                                        71610000
BS, CS, DS, ES     Execution priority class. BS is highest priority,    71615000
                   ES is lowest. If you specify a priority that         71620000
                   exceeds the highest permitted for your account or    71625000
                   user name by the system, MPE assigns the highest     71630000
                   priority possible below BS.  Default is CS.          71635000
                                                                        71640000
                                       NOTE                             71645000
                                                                        71650000
                   DS and ES are used primarily for batch jobs; their   71655000
                   use for sessions is discouraged.                     71660000
                                                                        71665000
inputpriority      Relative input priority used in checking against     71670000
                   access restrictions imposed by the <jobfence>, if one71675000
                   exists.  Takes effect at logon time.  Must be a      71680000
                   value from 1 (lowest priority) to 13 (highest        71685000
                   priority).  If a value is specified that is less than71690000
                   or equal to current <jobfence> set by Console        71695000
                   Operator, session is denied access. Default is 8.    71700000
                                                                        71705000
HIPRI              Request for maximum session-selection input priority,71710000
                   causing session to be scheduled regardless of current71715000
                   <jobfence> or execution limit for sessions.  This    71720000
                   parameter can be specified only by users with System 71725000
                   Manager or System Supervisor capability.  Default is 71730000
                   the current <jobfence> and execution limit.          71735000
                                                                        71735100
NOWAIT             Request that the session starts executing            71736000
                   immediately without waiting for a carriage return    71737000
                   on the terminal.                                     71738000
                                                                        71739000
                   If this option is specified and the target ldev is   71740000
                   the system console, System Manager capability is     71741000
                   required.                                            71742000
                                                                        71743000
                                                                        71745000
\ITEM=OPERATION                                                         71750000
OPERATION                                                               71755000
                                                                        71760000
Initiates an interactive session on the logical device specified        71765000
by the ldev parameter.  (Note: LDEV must be a real terminal)            71770000
When the command executes successfully, a session is created on         71775000
LDEV and is waiting for a carriage return before printing the logon     71780000
banner.  The target terminal must be set to the configured baud rate for71785000
MPE to accept the carriage return.                                      71790000
                                                                        71795000
     :STARTSESS 21;KEN.OSE,JORDAN                                       71800000
                                                                        71805000
                                                                        71810000
\ITEM=EXAMPLE                                                           71815000
EXAMPLE                                                                 71820000
                                                                        71825000
To start a session named UI, with the username KEN, accountname         71830000
OSE, groupname JORDAN, grouppass PASS, on ldev 21, enter:               71835000
                                                                        71840000
    :STARTSESS 21;UI,KEN.OSE,JORDAN/PASS                                71845000
                                                                        71850000
    PROGRAMMATIC LOGON FOR SESSION #S7258                               71855000
                                                                        71860000
                                                                        71865000
                                                                        71870000
\ENTRY=STARTSPOOL,PARMS,OPERATION,EXAMPLE                               71875000
     :STARTSPOOL                                                        71880000
                                                                        71885000
Initiates spooling of a device.                                         71890000
                                                                        71895000
                                                                        71900000
SYNTAX                                                                  71905000
                                                                        71910000
     :STARTSPOOL {ldn     } [;SHUTQ]                                    71915000
                 {devclass}                                             71920000
                                                                        71925000
\ITEM=PARMS                                                             71930000
PARAMETERS                                                              71935000
                                                                        71940000
ldn               The logical device number of a spooled device.        71945000
                                                                        71950000
devclass          The device class specified at SYSDUMP.                71955000
                                                                        71960000
SHUTQ             The spool queue has been shut for the                 71965000
                  specified logical device.  Default is                 71970000
                  OPENQ.                                                71975000
                                                                        71980000
\ITEM=OPERATION                                                         71985000
OPERATION                                                               71990000
                                                                        71995000
The :STARTSPOOL command causes the spooler to own a specified device,   72000000
and the spooler then is able to determine whether the device is an      72005000
input or output spooling device.                                        72010000
                                                                        72015000
If a devclass is spooled but the device is not, then any reference      72020000
to the devclass is spooled.                                             72025000
                                                                        72030000
When devclass is used in a :STARTSPOOL command, the                     72035000
effect is to open the spool queue for the device.                       72040000
                                                                        72045000
The SHUTQ parametera corresponds only to ldn; it is                     72050000
meaningless to the devclass.                                            72055000
                                                                        72060000
                      NOTE                                              72065000
                                                                        72070000
       If the ldn referenced in a :STARTSPOOL                           72075000
       command is a 2894 Printer/Reader/Punch,                          72080000
       the following message will be generated                          72085000
       on the system console:                                           72090000
                                                                        72095000
       IS THIS AN INPUT OR OUTPUT SPOOLER (IN/OUT)?                     72100000
                                                                        72105000
       You must then enter the appropriate reply;                       72110000
       IN if cards are to be read; OUT if cards                         72115000
       are to be punched.                                               72120000
                                                                        72125000
\ITEM=EXAMPLE                                                           72130000
EXAMPLES                                                                72135000
                                                                        72140000
To start spooling on logical device 6, enter:                           72145000
                                                                        72150000
     :STARTSPOOL 6                                                      72155000
                                                                        72160000
To start spooling on devclass LP, enter:                                72165000
                                                                        72170000
     :STARTSPOOL LP                                                     72175000
                                                                        72180000
\ENTRY=STOPCACHE,PARMS,OPERATION,EXAMPLE                                72185000
    :STOPCACHE                                                          72190000
                                                                        72195000
Removes a disc from the disc caching system                             72200000
                                                                        72205000
SYNTAX                                                                  72210000
                                                                        72215000
     :STOPCACHE ldn                                                     72220000
                                                                        72225000
\ITEM=PARMS                                                             72230000
PARAMETERS                                                              72235000
                                                                        72240000
ldn          The logical device number of a particular disc to have     72245000
             disc caching enabled.                                      72250000
                                                                        72255000
                                                                        72260000
\ITEM=OPERATION                                                         72265000
OPERATION                                                               72270000
                                                                        72275000
If the device is being cached, the :STOPCACHE request will be           72280000
satisfied when the last access is complete.                             72285000
                                                                        72290000
\ITEM=EXAMPLE                                                           72295000
EXAMPLE                                                                 72300000
                                                                        72305000
To remove logical device number 20 from the disc caching system enter:  72310000
                                                                        72315000
     :STOPCACHE 20                                                      72320000
                                                                        72325000
\ENTRY=STOPSPOOL,PARMS,OPERATION,EXAMPLE                                72330000
                                                                        72335000
     :STOPSPOOL                                                         72340000
                                                                        72345000
Terminates spooling of a device.                                        72350000
                                                                        72355000
SYNTAX                                                                  72360000
                                                                        72365000
     :STOPSPOOL {ldn     }  [;OPENQ]                                    72370000
                {devclass}                                              72375000
                                                                        72380000
\ITEM=PARMS                                                             72385000
PARAMETERS                                                              72390000
                                                                        72395000
ldn               The logical device number of a spooled device.        72400000
                                                                        72405000
devclass          The device class specified during SYSDUMP.            72410000
                                                                        72415000
OPENQ             The spool queue has been opened for the               72420000
                  specified logical device. Default is SHUTQ.           72425000
                                                                        72430000
\ITEM=OPERATION                                                         72435000
OPERTION                                                                72440000
                                                                        72445000
The :STOPSPOOL command causes the specified logical device to stop      72450000
immediately, return the active spoolfile to the READY state, and        72455000
to be owned by the system, not the spooler.  Any FOPENs to a            72460000
particular device (either by ldn or devclass reference) results         72465000
in the device being allocated or a file system error message if         72470000
the device is already allocated.                                        72475000
                                                                        72480000
When devclass is used in a :STOPSTPOOL command, the effect              72485000
is to shut the spool queue for the device.                              72490000
                                                                        72495000
The OPENQ parameter corresponds only to ldn; it is                      72500000
meaningless to the devclass.                                            72505000
                                                                        72510000
                                                                        72515000
\ITEM=EXAMPLE                                                           72520000
EXAMPLES                                                                72525000
                                                                        72530000
To terminate spooling to logical device number 6, enter:                72535000
                                                                        72540000
     :STOPSPOOL 6                                                       72545000
                                                                        72550000
To terminate spooling to device class LP, enter:                        72555000
                                                                        72560000
     :STOPSPOOL LP                                                      72565000
                                                                        72570000
\ENTRY=STORE,PARMS,OPERATION,EXAMPLE                                    72575000
    :STORE                                                              72580000
                                                                        72585000
Stores disc files onto magnetic tape or serial disc.                    72590000
                                                                        72595000
SYNTAX                                                                  72600000
                                                                        72605000
    :STORE [filesetlist] [;[storefile] [;option [;...]]]                72610000
                                                                        72611000
        where option is                                                 72612000
           [;SHOW[=showparmlist]]                                       72615000
           [;ONERROR=recoverytype]                                      72620000
           [;FILES=maxfiles][; DATE<=accdate]                           72625000
                             ; DATE>=moddate                            72630000
           [;PURGE]                                                     72635000
           [;PROGRESS [=#minutes]]                                      72636000
                                                                        72637000
\ITEM=PARMS                                                             72640000
PARAMETERS                                                              72645000
                                                                        72650000
filesetlist            Specifies the set of files to be stored.  Default72655000
                       is @.  This parameter is of the form:            72660000
                                                                        72665000
                                 !indirectfilename                      72670000
                                         or                             72675000
                                 fileset [,fileset] [...] [,fileset]    72680000
                                                                        72685000
indirectfilename       A filename that may be backreferenced to a disc  72690000
                       file.  This file includes both the filesets and  72695000
                       options to STORE.                                72700000
                                                                        72705000
fileset                Specifies a set of files to be stored.  All files72710000
                       that match filestostore will be stored unless    72715000
                       the file also matches the filesnottostore.  The  72720000
                       syntax is:                                       72725000
                                                                        72730000
                              filestostore [ - filesnottostore]         72735000
                                                                        72740000
                       where filestostore and filesnottostore are file  72745000
                       designators.                                     72750000
                                                                        72755000
filedesignator         Describes one or many files.  Wild cards are     72760000
                       permitted for any of the three parts.  The       72765000
                       syntax is:                                       72770000
                                                                        72775000
                          filedesig[.groupdesig[.acctdesig]]            72780000
                                                                        72785000
                                      NOTE                              72790000
                                                                        72795000
              The characters @, #, and ? can be used as "wild card"     72800000
              characters in the fileset parameter.  These wild card     72805000
              characters have the following meanings:                   72810000
                                                                        72815000
              @ -- specifies zero or more alphanumeric characters.      72820000
                                                                        72825000
              # -- specifies one numeric character.                     72830000
                                                                        72835000
              ? -- specifies one alphanumeric character.                72840000
                                                                        72845000
storefile              Name of destination tape or serial disc file     72850000
                       onto which the stored files are to be written.   72855000
                       This can be any magnetic tape or serial disc from72860000
                       the output set.                                  72865000
                                                                        72870000
                      If a storefile is not supplied, the :STORE will   72875000
                      create a default file name.  The default file name72880000
                      is the user's logon username.  No file equation   72885000
                      is used.                                          72890000
                                                                        72895000
SHOW                   If the SHOW parameter is present then information72900000
                       is reported for every file that is stored.  If   72905000
                       the SHOW parameter is not present then only the  72910000
                       names of files not stored, and the number of     72915000
                       files stored and not stored are listed.  The     72920000
                       listing is sent to $STDLIST (formal designator is72925000
                       SYSLIST) unless a :FILE command is entered to    72930000
                       send the listing to some other device.  For      72935000
                       example,                                         72940000
                                                                        72945000
                       :FILE SYSLIST;DEV=LP                             72950000
                                                                        72955000
                       entered before the :STORE command would send the 72960000
                       listing to a line printer.                       72965000
                                                                        72970000
showparmlist           Tells store what information to display for      72975000
                       files stored.  If show is present, but           72980000
                       showparmlist is not then the default is          72985000
                       SHORT if the recordsize of SYSLIST is less       72990000
                       than 99 characters, and LONG otherwise.          72995000
                       The format for showparmlist is                   73000000
                                                                        73005000
                            showparm [,showparm][. . .][,showparm]      73010000
                                                                        73015000
showparm               May be one of SHORT, LONG, DATES, SECURITY,      73020000
                       or OFFLINE.  If neither SHORT or LONG are        73025000
                       selected then the base information is SHORT      73030000
                       if SYSLIST is less than 99 characters, and       73035000
                       LONG otherwise.                                  73040000
                                                                        73045000
SHORT                  Overrides default of LONG, and displays filename,73050000
                       groupname, acctname, logical device number,      73055000
                       sector address, reel number, and file size       73060000
                       in sectors.                                      73065000
                                                                        73070000
LONG                   Overrides default of SHORT, and displays all     73075000
                       information that SHORT does and additional       73080000
                       displays record size, filetype, eof, file record 73085000
                       limit, blocking factor, extents allocated and    73090000
                       maximum number of extents.                       73095000
                                                                        73100000
DATES                  Additionally displays creation date, last access 73105000
                       date, and last modification date.                73110000
                                                                        73115000
SECURITY               Additionally displays file creator, and file     73120000
                       security matrix.                                 73125000
                                                                        73130000
OFFLINE                Sends an additional copy to the file OFFLINE,    73135000
                       which defaults to device LP.                     73140000
                                                                        73145000
ONERROR                Tells STORE what to do in the case of a tape     73150000
                       write error.  If not present then the default is 73155000
                       QUIT for labeled tapes and REDO for unlabeled    73160000
                       tapes.  ONERR is a synonym for ONERROR.          73165000
                                                                        73170000
recoverytype           Is either QUIT or REDO.                          73175000
                                                                        73180000
QUIT                   Tells STORE to abort after a tape write error.   73185000
                                                                        73190000
REDO                   Tells STORE to do error recovery on a tape write 73195000
                       error.  First the tape is rewound, and a bad     73200000
                       record is written to the beginning of tape. The  73205000
                       tape is then unloaded and a new tape begins at   73210000
                       the same point that the tape with the error did. 73215000
                                                                        73220000
                                                                        73225000
maxfiles               Maximum number of files that may be stored.      73230000
                       Default is 4000.                                 73235000
                                                                        73240000
moddate, accdate       Restricts the files stored to those modified     73245000
                       on or after (>=) or accessed on or before        73250000
                       (<=) the specified date.  The date is ex-        73255000
                       pressed mm/dd/yy.                                73260000
                                                                        73265000
PURGE                 If specified, all files that existed on disc      73270000
                      that were stored are purged.                      73275000
                                                                        73275500
PROGRESS              If specified, STORE will periodically display     73276000
                      the message STORE OPERATION IS ..% COMPLETE.      73277000
                                                                        73278000
#minutes              A positive number of minutes specifying the       73279000
                      interval the progress messages be printed.        73280000
                      Default is one minute.                            73281000
                                                                        73285000
\ITEM=OPERATION                                                         73290000
OPERATION                                                               73295000
                                                                        73300000
Stores one or more disc files onto magnetic tape or serial disc.  The   73305000
:STORE command will store only those files whose home volume sets have  73310000
been pre-mounted.                                                       73315000
                                                                        73320000
Users with System Manager or System Supervisor capability can store any 73325000
user file in the system.  Users with Account Manager capability can     73330000
store any file in the account (but cannot dump those with negative file 73335000
codes unless they have Privileged Mode capability also).                73340000
                                                                        73345000
Before entering a :STORE command, you must identify storefile as a      73350000
magnetic tape or serial disc file with a :FILE command written in the   73355000
following format:                                                       73360000
                                                                        73365000
    :FILE formaldesignator[=filereference];DEV=device[REC=recsize]      73370000
     [;BUF]                                                             73375000
     [;NOBUF]                                                           73380000
                                                                        73385000
device          Must indicate the device class name or logical unit     73390000
                number of a magnetic tape or serial disc unit.          73395000
                                                                        73400000
recsize         Sets the size of the blocks on the store tape.  For     73405000
                1600 BPI tapes, the record size may be any multiple     73410000
                of 256 words between 256 and 4096 words.  For serial    73415000
                discs and 6250 BPI tapes, the record size may be any    73420000
                multiple of 256 between 256 and 8192 words.  The        73425000
                default record size for all tapes, except 6250 BPI      73430000
                unlabeled tapes, and for serial discs is 4096.  The     73435000
                default record size for 6250 BPI unlabeled tapes is     73440000
                8192 words.  The directory portion of magnetic tapes    73445000
                is never written larger than 4096 words.                73450000
                                                                        73455000
                                                                        73460000
NOBUF           Will not allow the tape and disc I/O to overlap.  It    73465000
                is suggested that BUF always be used with tape and      73470000
                that NOBUF always be used with serial disc.  Default    73475000
                is BUF.  For unlabeled tapes on the HP 7976A tape drive,73480000
                NOBUF will be ignored.  Recommended for Serial Disc.    73485000
                                                                        73490000
BUF             Causes the tape and disc I/O to overlap.  Recommended   73495000
                for Magnetic Tape.                                      73500000
                                                                        73505000
Other parameters for storefile are supplied by the :STORE command.      73510000
If you attempt to supply them, MPE will reject the :STORE               73515000
command.                                                                73520000
                                                                        73525000
If the BREAK key is pressed during a store operation, the operation     73530000
stops after storing the current file and further output is suppressed.  73535000
                                                                        73540000
If the PURGE option is supplied, the files are purged only after the    73545000
files are successfully stored.  In other words, no files are purged     73550000
until the files are successfully stored.                                73555000
                                                                        73560000
\ITEM=EXAMPLE                                                           73565000
EXAMPLE                                                                 73570000
                                                                        73575000
To store all files in the group GP4X in your logon account, to a tape   73580000
file named BACKUP, enter:                                               73585000
                                                                        73590000
    :FILE BACKUP;DEV=TAPE                                               73595000
    :STORE @.GP4X;*BACKUP;SHOW                                          73600000
                                                                        73605000
The console operator receives a request to mount the tape identified as 73610000
BACKUP.  A listing of the files stored appears on your standard list    73615000
device.                                                                 73620000
                                                                        73625000
                                                                        73630000
To store all files on the system except the files in the SYS            73635000
account, enter:                                                         73640000
                                                                        73645000
    :FILE TAP;DEV=TAPE                                                  73650000
    :STORE @.@.@-@.@.SYS;*TAP;SHOW=SECURITY,DATES,LONG,OFFLINE          73655000
                                                                        73660000
The console operator receives a request to mount the tape identified as 73665000
TAP.  A listing of the files stored appears on both standard list and   73670000
at the system lineprinter.  The listing will include all information    73675000
available from STORE.                                                   73680000
                                                                        73685000
                                                                        73690000
To store from indirect file INDFILE which contains:                     73695000
                                                                        73700000
               FILE1,FILE2;SHOW                                         73705000
               FILE3,@.PUB.SYS                                          73710000
               ;DATE>=6/1/83                                            73715000
enter:                                                                  73720000
                                                                        73725000
    :FILE T;DEV=TAPE                                                    73730000
    :STORE !INDFILE;*T                                                  73735000
                                                                        73740000
The console operator receives a request to mount the tape identified as 73745000
T.  Files FILE1, FILE2, FILE3 and all files in PUB.SYS will be stored   73750000
if they have been modified since June 1, 1983.  A listing of the files  73755000
stored appears on your standard list device.                            73760000
                                                                        73765000
To store files from a group and account with a default storefile, enter:73770000
                                                                        73775000
    :STORE @.GROUP.ACCOUNT                                              73780000
                                                                        73785000
or  :STORE                                                              73790000
                                                                        73795000
Note that the console operator receives a request to mount the tape     73800000
identified as the user's user name.                                     73805000
                                                                        73810000
To store files from a group and account and to purge them after the     73815000
store, enter:                                                           73820000
                                                                        73825000
    :FILE T;DEV=TAPE                                                    73830000
                                                                        73835000
    :STORE @.GROUP.ACCOUNT;PURGE                                        73840000
\ENTRY=STREAM,PARMS,OPERATION,EXAMPLE                                   73845000
    :STREAM                                                             73850000
                                                                        73855000
Spools batch jobs or data from session or job; schedules a              73860000
batch job to be introduced onto the system at a user-specified          73865000
time.                                                                   73870000
                                                                        73875000
SYNTAX                                                                  73880000
                                                                        73885000
    :STREAM [inputfile][,character]                                     73890000
            [;AT=hh:mm]                                                 73895000
            [;DAY={dow|dom|dem}   |  ;DATE=mm/dd/yy]                    73900000
                       or                                               73905000
            [;IN=[days [, [hours] [, minutes] ] ] ]                     73910000
                                                                        73915000
\ITEM=PARMS                                                             73920000
PARAMETERS                                                              73925000
                                                                        73930000
inputfile  File designator of ASCII input file from which jobs/data/    73935000
           scheduled jobs are spooled to disc.  May be a disc file      73940000
           created with the Editor and containing commands or data;     73945000
           or a file input from a card reader, tape unit, or terminal.  73950000
           Records in this file cannot exceed 255 characters.  All      73955000
           character positions within each record are significant.      73960000
           Default is $STDIN.                                           73965000
                                                                        73970000
character  Character used in place of colon (:) to identify MPE         73975000
           commands within <inputfile>.  When <inputfile> is            73980000
           entered on device configured to accept jobs sessions or      73985000
           data input via the :DATA command, this character can be      73990000
           any ASCII special (non-alphanumeric) character except a      73995000
           colon.  Default is exclamation point (!).                    74000000
                                                                        74005000
hh:mm      An absolute time at which the job is to be introduced        74010000
           onto the system.  This time is expressed in military         74015000
           hours; thus, 0 <= hh <= 23, and 0 <= mm <= 59.  If the       74020000
           time specified is later than the current time, then          74025000
           the current day is implied (unless DATE or DAY are also      74030000
           specified).  If the time specified is earlier than the       74035000
           current time, then the next day is implied (unless DATE      74040000
           or DAY are specified.                                        74045000
                                                                        74050000
dow        Day-Of-Week.  The name of the day of the week on which       74055000
           the specified job is to be introduced.  Either the full      74060000
           name of the Day-Of-Week may be used (e.g. MONDAY), or a      74065000
           three-letter abbreviation may be used (e.g. MON).            74070000
                                                                        74075000
dom        Day-Of-Month.  A positive integer specifying either the      74080000
           month date number of the current month (if <dom> is          74085000
           greater than or equal to the current day's date number)      74090000
           or the next month (if <dom> is less than the current         74095000
           day's date number).                                          74100000
                                                                        74105000
dem        Day-from-End-Month.  A negative integer specifying a day     74110000
           from the end of the month (where -1 equals the last day      74115000
           of the month).  If the number of days in the current month   74120000
           minus the <dem> specification is greater than or equal       74125000
           to the current day's month day, then the current month       74130000
           is used; otherwise, the next month is used.                  74135000
mm/dd/yy   A string specifying a specific date.  Thus, 1 <= mm <= 12    74140000
           and 1 <= dd <= 31 (or 30, 29, 28, depending on the month     74145000
           and the year) and yy is between the current year of the      74150000
           century and 99.                                              74155000
                                                                        74160000
days       A positive integer specifying the number of days offset      74165000
           from the current day on which the job(s) will be             74170000
           introduced onto the system.                                  74175000
                                                                        74180000
hours      A positive integer specifying the number of hours offset     74185000
           from the current hour in which the job(s) will be            74190000
           introduced onto the system.                                  74195000
                                                                        74200000
minutes    A positive integer specifying the number of minutes          74205000
           offset from the current time in which the job(s) will be     74210000
           introduced onto the system.                                  74215000
                                                                        74220000
                                                                        74225000
\ITEM=OPERATION                                                         74230000
OPERATION                                                               74235000
                                                                        74240000
Spools batch jobs and data from inputfile to disc, and schedules each   74245000
job independently.  Most commonly used for initiating batch jobs from   74250000
sessions.                                                               74255000
                                                                        74260000
For this command to take effect, the Console Operator must first enable 74265000
streaming with the :STREAMS command.                                    74270000
                                                                        74275000
When you enter :STREAM with the terminal as the default input device,   74280000
whether during a session or job, MPE prompts you for input by displaying74285000
a greater than (>) character.  When you enter :STREAM for another input 74290000
device, MPE does not print the prompt character.  In any case, you      74295000
terminate <inputfile> by entering the :EOD command.  At the terminal,   74300000
this halts prompting for job input and returns control to your job/     74305000
session.                                                                74310000
                                                                        74315000
Begin each job in <inputfile> with the JOB command and terminate it with74320000
the EOJ command.  Begin each data file with the DATA command and        74325000
terminate this file with the EOD command.  Begin all commands with an   74330000
appropriate substitute (other than colon) character, as in !JOB or      74335000
#DATA.  When <inputfile> is spooled to disc, MPE replaces the substitute74340000
command identifier with a colon so that command reports are properly    74345000
interpreted when executed.                                              74350000
                                                                        74355000
MPE assigns each job a unique job number, and prints this number on the 74360000
standard list device.  MPE also assigns each job a preset priority      74365000
unless you specify otherwise in the JOB command, and processes the job  74370000
independent of the initiating job.  Regardless of which device you use  74375000
to submit the <inputfile>, all jobs in that file are treated as though  74380000
they originated on a unique streaming device designated by the Console  74385000
Operator (with the :STREAMS command).  The listing for each spooled job 74390000
is written to the standard list device that corresponds to the streaming74395000
device, unless you use the OUTCLASS= parameter of the JOB command to    74400000
direct the listing to another device.                                   74405000
                                                                        74410000
Pressing the BREAK key aborts the :STREAM command and any job currently 74415000
being entered through the command.                                      74420000
                                                                        74425000
The user specifies a time at which the job is to be introduced onto the 74430000
system.  The user may specify either a relative time (by using the      74435000
;IN, keyword) or an absolute time (by using a combination of the ;AT,   74440000
;DATE, and ;DAY keywords).  When the user-specified time arrives,       74445000
that job will enter the normal job WAIT state, at which time the job    74450000
is subject to the current job situation (e.g. the job limit, the        74455000
JOBFENCE, the number of jobs EXECuting, etc.).                          74460000
                                                                        74465000
 The <inputfile> must satisfy all passwords at the time the             74470000
scheduled job is executed; no new password checks are performed         74475000
when the job enters the WAIT state.  The <inputfile> can contain        74480000
up to 64 jobs--all jobs in the file will be scheduled to be intro-      74485000
duced at the same, user-specified time.                                 74490000
                                                                        74495000
<inputfile> may contain :DATA files, but these are not scheduled.       74500000
Rather, they are spooled in immediately and will remain on the          74505000
system until accessed or deleted.                                       74510000
                                                                        74515000
MPE assigns all jobs (including scheduled jobs) a unique identification 74520000
number.  This number is reported on $STDLIST and could be used in the   74525000
:ABORTJOB and :SHOWJOB commands.                                        74530000
                                                                        74535000
Scheduled Jobs are recovered on a WARMSTART; a COOLSTART or any kind of 74540000
load from tape will purge all Scheduled Jobs.  During the WARMSTART, if 74545000
a Scheduled Job is scheduled to be introduced at a time that is earlier 74550000
than the DATE and TIME specified by the operator, those jobs will enter 74555000
the WAIT queue instead.                                                 74560000
                                                                        74565000
Special Caution:  All jobs in the system require an entry in MPE's Job  74570000
Master Table.  A Scheduled Job will hold onto its JMAT entry for the    74575000
entire time that it is waiting to be introduced.  It is therefore not   74580000
recommended to scheduled a job far in advance of its introduction.      74585000
                                                                        74590000
\ITEM=EXAMPLE                                                           74595000
EXAMPLE                                                                 74600000
                                                                        74605000
To initiate, from a session, a batch job that compiles, prepares, and   74610000
executes the FORTRAN program MYPROG, enter:                             74615000
                                                                        74620000
    :STREAM                                                             74625000
    >!JOB SOFT.PUBS                                                     74630000
    >!FORTGO MYPROG                                                     74635000
    >!EOJ                                                               74640000
     #J73  (Job number returned by MPE)                                 74645000
    >!EOD                                                               74650000
                                                                        74655000
                                                                        74660000
For the following examples, assume that the current date is February 7, 74665000
1984, 1:30 pm.                                                          74670000
                                                                        74675000
To schedule the job in MYJOBS to execute in two days and three hours:   74680000
   :STREAM MYJOBS;IN=2,3                                                74685000
                                                                        74690000
To schedule the job in BACKUP to be introduced at two o'clock in the    74695000
morning, next Sunday:                                                   74700000
   :STREAM BACKUP;AT=2:00;DAY=SUNDAY                                    74705000
                                                                        74710000
To schedule REPORT to run on the first of next month:                   74715000
   :STREAM REPORT;DAY=1                                                 74720000
          or                                                            74725000
   :STREAM REPORT;DATE=3/1/84                                           74730000
                                                                        74735000
To schedule REPORT to run on the last day of this month:                74740000
   :STREAM REPORT;DAY=-1                                                74745000
                                                                        74750000
                                                                        74755000
\ENTRY=STREAMS,PARMS,OPERATION,EXAMPLE                                  74760000
     :STREAMS                                                           74765000
                                                                        74770000
Enables or disables the user's ability to submit job/session and/or     74775000
data streams.                                                           74780000
                                                                        74785000
SYNTAX                                                                  74790000
                                                                        74795000
              {ldn}                                                     74800000
     :STREAMS {   }                                                     74805000
              {OFF}                                                     74810000
                                                                        74815000
\ITEM=PARMS                                                             74820000
PARAMETERS                                                              74825000
                                                                        74830000
ldn          The logical device number of the device being enabled.     74835000
             Any accepting input device can be used, except termi-      74840000
             nals or the system console.                                74845000
                                                                        74850000
OFF          Disables the stream facility.                              74855000
                                                                        74860000
\ITEM=OPERATION                                                         74865000
OPERATION                                                               74870000
                                                                        74875000
This command enables users to designate any file containing jobs        74880000
(or data) which is then spooled in as if it came from a normal          74885000
accepting device.  The device is in no way affected (its state          74890000
is unaltered; a spooler is not created for it, etc.).  The state        74895000
of the device also is not relevant - it can be job and/or data-         74900000
accepting.                                                              74905000
                                                                        74910000
STREAMS is disabled on all cold loads.                                  74915000
                                                                        74920000
\ITEM=EXAMPLE                                                           74925000
EXAMPLES                                                                74930000
                                                                        74935000
To enable jobs and data streams on logical device number 5, enter:      74940000
                                                                        74945000
     :STREAMS 5                                                         74950000
                                                                        74955000
To disable data streams, enter:                                         74960000
                                                                        74965000
     :STREAMS OFF                                                       74970000
                                                                        74975000
                                                                        74980000
\ENTRY=SUSPENDSPOOL,PARMS,OPERATION,EXAMPLE                             74985000
     :SUSPENDSPOOL                                                      74990000
                                                                        74995000
Causes a spooled device to stop operation.                              75000000
                                                                        75005000
SYNTAX                                                                  75010000
                                                                        75015000
     :SUSPENDSPOOL ldn [;FINISH]                                        75020000
                                                                        75025000
\ITEM=PARMS                                                             75030000
PARAMETERS                                                              75035000
                                                                        75040000
ldn          The logical device number of a particular device.          75045000
                                                                        75050000
FINISH       Causes a spooled device to continue to completion          75055000
             of the currently active spool file, and then stop.         75060000
                                                                        75065000
\ITEM=OPERATION                                                         75070000
OPERATION                                                               75075000
                                                                        75080000
The :SUSPENDSPOOL command causes a spooler process to suspend           75085000
output to a spooled device.                                             75090000
                                                                        75095000
If the FINISH option is specified, the device will continue             75100000
to completion of the currently active spoolfile before stopping.        75105000
                                                                        75110000
                                                                        75115000
                                                                        75120000
                                                                        75125000
                                                                        75130000
                                                                        75135000
\ITEM=EXAMPLE                                                           75140000
EXAMPLES                                                                75145000
                                                                        75150000
To cause logical device number 6 (a line printer) to stop printing,     75155000
enter:                                                                  75160000
                                                                        75165000
     :SUSPENDSPOOL 6                                                    75170000
                                                                        75175000
To cause logical device number 6 (a line printer) to continue to        75180000
print and stop when completed, enter:                                   75185000
                                                                        75190000
     :SUSPENDSPOOL 6;FINISH                                             75195000
                                                                        75200000
\ENTRY=SWITCHLOG,PARMS,OPERATION,EXAMPLE                                75205000
    :SWITCHLOG (System Supervisor capability required)                  75210000
                                                                        75215000
Closes the current Log File, and creates and opens a new Log File.      75220000
                                                                        75225000
SYNTAX                                                                  75230000
                                                                        75235000
    :SWITCHLOG                                                          75240000
                                                                        75245000
\ITEM=PARMS                                                             75250000
PARAMETERS                                                              75255000
                                                                        75260000
None                                                                    75265000
                                                                        75270000
\ITEM=OPERATION                                                         75275000
OPERATION                                                               75280000
                                                                        75285000
(System Supervisor capability required)                                 75290000
This command closes the current Log File, and creates and opens a new   75295000
Log File.  The new Log File becomes the current Log File.               75300000
                                                                        75305000
If logging is disabled when :SWITCHLOG is entered, no action is taken.  75310000
                                                                        75315000
MPE displays the following information when :SWITCHLOG is entered:      75320000
                                                                        75325000
    LOGFILE LOGxxxx IS yy% FULL                                         75330000
    LOG FILE NUMBER zzzz ON                                             75335000
                                                                        75340000
where                                                                   75345000
                                                                        75350000
    xxxx - is the previous Log File number.                             75355000
                                                                        75360000
    yy - is the percentage of file space used.                          75365000
                                                                        75370000
    zzzz - current log file now opened (increment of 1 over last Log    75375000
           File number).                                                75380000
                                                                        75385000
If logging is enabled but not currently suspended, MPE displays the     75390000
message:                                                                75395000
                                                                        75400000
    NO LOGGING                                                          75405000
                                                                        75410000
\ITEM=EXAMPLE                                                           75415000
EXAMPLE                                                                 75420000
                                                                        75425000
To switch logging to a new Log File, enter:                             75430000
                                                                        75435000
    :SWITCHLOG                                                          75440000
                                                                        75445000
                                                                        75450000
\ENTRY=SWITCHNMLOG,PARMS,OPERATION,EXAMPLE                              75455000
    :SWITCHNMLOG (Node Manager capability required)                     75460000
                                                                        75465000
Closes the current NMLog File, and creates and opens a new NMLog File.  75470000
                                                                        75475000
SYNTAX                                                                  75480000
                                                                        75485000
    :SWITCHNMLOG                                                        75490000
                                                                        75495000
\ITEM=PARMS                                                             75500000
PARAMETERS                                                              75505000
                                                                        75510000
None                                                                    75515000
                                                                        75520000
\ITEM=OPERATION                                                         75525000
OPERATION                                                               75530000
                                                                        75535000
(Node Manager capability required)                                      75540000
This command closes the current NMLog File, and creates and opens a     75545000
new NMLog File.  The new NMLog File becomes the current NMLog File.     75550000
                                                                        75555000
If NMlogging is disabled when :SWITCHNMLOG is entered, NM outputs       75560000
the message:                                                            75565000
                                                                        75570000
    NMLG FILE NUMBER x ERROR #nn. NM LOGGING STOPPED                    75575000
                                                                        75580000
If NMlogging is enabled but currently suspended, NM outputs the         75585000
message:                                                                75590000
                                                                        75595000
    NMLG FILE NUMBER x ERROR #nn. NM LOGGING SUSPENDED                  75600000
                                                                        75605000
NM displays the following information when :SWITCHNMLOG is entered:     75610000
                                                                        75615000
    NMLG FILE NUMBER x IS yy% FULL                                      75620000
    NMLG FILE NUMBER z ON                                               75625000
                                                                        75630000
where                                                                   75635000
                                                                        75640000
    x  - is the previous NMLog File number.                             75645000
                                                                        75650000
    yy - is the percentage of file space used.                          75655000
                                                                        75660000
    z  - current NMlog file now opened (increment of 1 over last Log    75665000
         File number).                                                  75670000
                                                                        75675000
\ITEM=EXAMPLE                                                           75680000
EXAMPLE                                                                 75685000
                                                                        75690000
To switch NMlogging to a new NMLog File, enter:                         75695000
                                                                        75700000
    :SWITCHNMLOG                                                        75705000
                                                                        75710000
                                                                        75715000
\ENTRY=SYSDUMP,PARMS,OPERATION,EXAMPLE                                  75720000
    :SYSDUMP (System Supervisor capability required)                    75725000
                                                                        75730000
Starts Configurator dialog and copies MPE to tape.                      75735000
                                                                        75740000
SYNTAX                                                                  75745000
                                                                        75750000
    :SYSDUMP dumpfile[,auxlistfile]                                     75755000
                                                                        75760000
\ITEM=PARMS                                                             75765000
PARAMETERS                                                              75770000
                                                                        75775000
dumpfile        A back reference to a previous :FILE command that       75780000
                defines the file on which the modified or duplicate     75785000
                system is to be written.  This back reference must      75790000
                indicate a magnetic tape file.  Formal designator is    75795000
                DUMPTAPE.  Use the following file statement form:       75800000
                                                                        75805000
                    FILE dumpfile[=filereference][;DEV=device]          75810000
                         [;REC=recordsize][;BUF  ]                      75815000
                                           ;NOBUF                       75820000
                                                                        75825000
                       REC      Specifies the tape record size.  May    75830000
                                be any number which is a multiple of    75835000
                                256 words between 256 and 8192 words.   75840000
                                The default for non-programmatic calls  75845000
                                to SYSDUMP is 4096 words.  For pro-     75850000
                                grammatic calls the default is 1024     75855000
                                words to accomodate programs written    75860000
                                with the old version of SYSDUMP.        75865000
                                                                        75870000
                       BUF      User specification on whether buffered  75875000
                                I/O is used to do the store.  For serial75880000
                                disc it is recommended that NOBUF is    75885000
                                used because the system automatically   75890000
                                buffers the transfer.  For tape trans-  75895000
                                fers the default of BUF should be used. 75900000
                                                                        75905000
                                                                        75910000
auxlistfile     Actual file designator of the output file (device) to   75915000
                which all listings requested during the Configur-       75920000
                ator/User dialog are written.  The formal file          75925000
                designator used by the :SYSDUMP command executor for    75930000
                this file is SYSLIST; the formal file designator used by75935000
                the MPE Segmenter (when it is invoked to add or replace 75940000
                SL segments) for this file is SEGLIST.  Default is      75945000
                $STDLIST.                                               75950000
                                                                        75955000
\ITEM=OPERATION                                                         75960000
OPERATION                                                               75965000
                                                                        75970000
(System Supervisor capability required)                                 75975000
This command starts the Configurator/User dialog and copies MPE to      75980000
magnetic tape.                                                          75985000
                                                                        75990000
In addition to the names of the files to be used for <dumpfile> and     75995000
<auxlistfile> output, you must specify what types of devices these files76000000
are to reside on.  You do this by preceding the :SYSDUMP command with   76005000
MPE :FILE commands defining each of the two files.  Then, in the        76010000
:SYSDUMP command, you precede each <filename> with an asterisk (*) to   76015000
indicate a back reference to the definitions in the :FILE commands.     76020000
                                                                        76025000
\ITEM=EXAMPLE                                                           76030000
EXAMPLE                                                                 76035000
                                                                        76040000
To begin dialog with the MPE Configurator, the :SYSDUMP command is      76045000
entered.  At the end of the dialog, the MPE configuration requested is  76050000
copied to the file named DUMP.  Any listings requested  during the      76055000
dialog are output to the file named LIST.  The first :FILE command      76060000
specifies that DUMP is a magnetic tape file; the second :FILE command   76065000
defines LIST as a line printer.  (In the :FILE commands, the TAPE and LP76070000
parameters are device class names arbitrarily defined by a user during  76075000
the previous configuration.)                                            76080000
                                                                        76085000
    :FILE DUMP;DEV=TAPE                                                 76090000
    :FILE LIST;DEV=LP                                                   76095000
    :SYSDUMP *DUMP,*LIST                                                76100000
                                                                        76105000
                                                                        76110000
\ENTRY=TAKE,PARMS,OPERATION,EXAMPLE                                     76115000
     :TAKE                                                              76120000
                                                                        76125000
De-assigns a :GIVEn device from diagnostics.                            76130000
                                                                        76135000
SYNTAX                                                                  76140000
                                                                        76145000
     :TAKE ldn                                                          76150000
                                                                        76155000
\ITEM=PARMS                                                             76160000
PARAMETERS                                                              76165000
                                                                        76170000
ldn          The logical device number of the device taken from         76175000
             diagnostics but left :DOWNed.                              76180000
                                                                        76185000
\ITEM=OPERATION                                                         76190000
OPERATION                                                               76195000
                                                                        76200000
None.                                                                   76205000
                                                                        76210000
\ITEM=EXAMPLE                                                           76215000
EXAMPLES                                                                76220000
                                                                        76225000
To take logical device number 35 from diagnostics, enter:               76230000
                                                                        76235000
     :TAKE 35                                                           76240000
     :SHOWDEV 35                                                        76245000
     LDEV   AVAIL      OWNERSHIP      VOLID                             76250000
                                                                        76255000
      35  A UNAVAIL    DOWN                                             76260000
     :UP 35                                                             76265000
     :SHOWDEV 35                                                        76270000
     LDEV   AVAIL      OWNERSHIP      VOLID                             76275000
                                                                        76280000
      35  A AVAIL                                                       76285000
                                                                        76290000
\ENTRY=TELL,PARMS,OPERATION,EXAMPLE                                     76295000
    :TELL                                                               76300000
                                                                        76305000
Sends a message to another job or session.                              76310000
                                                                        76315000
SYNTAX                                                                  76320000
                                                                        76325000
            [#]Snnn                                                     76330000
            [sname,]username.acctname                                   76335000
    :TELL {  @                           };[text]                       76340000
             @.acctname                                                 76345000
             @S                                                         76350000
                                                                        76355000
                                                                        76360000
\ITEM=PARMS                                                             76365000
PARAMETERS                                                              76370000
                                                                        76375000
                                                                        76380000
#Snnn              Session number (as assigned by MPE) of the session   76385000
                   that is to receive the message.                      76390000
                                                                        76395000
sname,username.    Names of the session and user to receive the         76400000
acctname           message, and the account name under which they are   76405000
                   running.  (This parameter is the same as the job     76410000
                   identity entered with the :HELLO command to          76415000
                   initiate the session.)                               76420000
                                                                        76425000
                   If several users are running under the same          76430000
                   session identity, MPE will send the message to all   76435000
                   users.                                               76440000
                                                                        76445000
@                  All users.                                           76450000
                                                                        76455000
@.acctname         All users under acctname.                            76460000
                                                                        76465000
@S                 All sessions.                                        76470000
                                                                        76475000
text               Message text, consisting of any string of ASCII      76480000
                   characters.  Default is no message is transmitted;   76485000
                   however, MPE prints the FROM message as follows:     76490000
                                                                        76495000
                       FROM/sessionid/                                  76500000
                                                                        76505000
\ITEM=OPERATION                                                         76510000
OPERATION                                                               76515000
                                                                        76520000
Transmits a message from the senders session to one or more             76525000
sessions running currently.  The message appears on the receiving       76530000
session list device.                                                    76535000
                                                                        76540000
If a message is sent to a terminal that is currently interacting with a 76545000
program, MPE queues the message as high as possible among the current   76550000
input/output requests but does not interrupt reading or writing in      76555000
progress.  If the session or user designated to receive the message     76560000
is not running, the transmitting session receives a system message      76565000
indicating this.  MPE rejects the :TELL command if the receiving        76570000
device is operating in the QUIET mode (see :SETMSG command).  MPE       76575000
also rejects attempts to do a TELL to a JOB.                            76580000
                                                                        76585000
\ITEM=EXAMPLE                                                           76590000
EXAMPLE                                                                 76595000
                                                                        76600000
To send a message to a user identified as BROWN, logged on under account76605000
A, running a session named BROWNSES, enter:                             76610000
                                                                        76615000
    :TELL BROWNSES,BROWN.A; message text                                76620000
                                                                        76625000
To send a message to all users logged on in account A:                  76630000
                                                                        76635000
    :TELL @.A;message text                                              76640000
                                                                        76645000
                                                                        76650000
\ENTRY=TELLOP,PARMS,OPERATION,EXAMPLE                                   76655000
    :TELLOP                                                             76660000
                                                                        76665000
Sends message to Console Operator.                                      76670000
                                                                        76675000
SYNTAX                                                                  76680000
                                                                        76685000
    :TELLOP [text]                                                      76690000
                                                                        76695000
\ITEM=PARMS                                                             76700000
PARAMETERS                                                              76705000
                                                                        76710000
text            Message text, consisting of any string of ASCII         76715000
                characters. Default is                                  76720000
                no message is sent.                                     76725000
                                                                        76730000
\ITEM=OPERATION                                                         76735000
OPERATION                                                               76740000
                                                                        76745000
Sends a message from the sender's job/session to the operator's console.76750000
The message appears in this format:                                     76755000
                                                                        76760000
\ITEM=EXAMPLE                                                           76765000
EXAMPLE                                                                 76770000
                                                                        76775000
To send a message to the operator instructing him to mount a tape, you  76780000
could enter:                                                            76785000
                                                                        76790000
    :TELLOP PLS MOUNT MYTAPE, VERSION I                                 76795000
                                                                        76800000
                                                                        76805000
\ENTRY=TUNE                                                             76810000
     :TUNE                                                              76815000
                                                                        76820000
Changes the filter and/or priority limits of the circular subqueues.    76825000
                                                                        76830000
SYNTAX                                                                  76835000
                            CQ                                          76840000
    :TUNE [minclockcycle][;{DQ} = [base][,[limit][,[min][,[max]]]]]     76845000
                            EQ                                          76850000
                                                                        76855000
                                                                        76860000
\ITEM=PARMS                                                             76865000
PARAMETERS                                                              76870000
                                                                        76875000
minclockcycle       Minimum value (in milliseconds) for replacement     76880000
                    algorithm cycle through memory.  If algorithm       76885000
                    cycles through memory in less time than this value, 76890000
                    memory allocation is delayed.  (thrash prevention   76895000
                    mechanism.)                                         76900000
                                                                        76905000
base                Priority at which C, D, or E processes will begin   76910000
                    in queue.                                           76915000
                                                                        76920000
limit               Worst (highest number) priority C, D, or E processes76925000
                    can attain.                                         76930000
                                                                        76935000
min                 The minimum value indicating the length of time     76940000
                    (filter value) in milliseconds which a process can  76945000
                    have the CPU before its priority is reduced.        76950000
                                                                        76955000
max                 The maximum value indicating the length of time     76960000
                    (filter value) in milliseconds which a process can  76965000
                    have the CPU before its priority is reduced.        76970000
                                                                        76975000
NOTE:  Currently min must equal max for D and E subqueues.  Also, the   76980000
       following relationships must hold:                               76985000
       base<=limit and min<=max.                                        76990000
                                                                        76995000
\ITEM=OPERATION                                                         77000000
OPERATION                                                               77005000
                                                                        77010000
This command changes the filter or priority limits of a circular        77015000
subqueue, and is used primarily in on-line tuning of the system         77020000
to best accomodate the current load.                                    77025000
                                                                        77030000
CAUTION! MISUSE OF THIS COMMAND CAN SIGNIFICANTLY DEGRADE SYSTEM        77035000
         OPERATING EFFICIENCY!                                          77040000
                                                                        77045000
A CS process is given a priority of CBASE when it begins.  When a       77050000
process stops (for disc I/O, terminal I/O, preemption, etc.), a         77055000
new priority is determined so that it may be re-queued for the cpu.     77060000
If the process has completed a transaction ( a transaction is defined   77065000
as the time between terminal reads), the priority become CBASE.  The    77070000
value of an "average short transaction" is then recalculated.  If the   77075000
CS process has not completed a transaction, and if the process has      77080000
exceeded the average short transaction filter value since its priority  77085000
was last reduced, the priority is decreased by 2.  Also, if the process 77090000
stopped because it needed memory resources, its priority is decreased by77095000
1.                                                                      77100000
                                                                        77105000
DS and ES processes begin at DBASE and EBASE respectively, and are re-  77110000
scheduled according to the same criteria as used for CS processes, with 77115000
the exception that a fixed value (the value of max which has been       77120000
specified for the subqueue) is used in place of the average short       77125000
transaction value, which is used for CS processes only.                 77130000
                                                                        77135000
If the values specified for max in the CS, DS, and ES queues are        77140000
too large, system response may become erratic.  If they are too         77145000
small, excessive swapping may result because process-swapping occurs    77150000
too frequently.  In either case, system performance is degraded.        77155000
Recommended settings for min and max for the CS subqueue are 0 and      77160000
300, as it is desirable to favor short transactions in most cases.  A   77165000
value for min and max of 10,000 usually produces efficient system       77170000
operation for the DS and ES subqueues.                                  77175000
                                                                        77180000
The minclockcycle parameter is used by the memory manager to determine  77185000
when thrashing (excessive memory management activity) is occuring.      77190000
Making this value smaller increases the probability of thrasing.        77195000
Recommended value for this parameter is 1000.                           77200000
                                                                        77205000
\ITEM=EXAMPLE                                                           77210000
EXAMPLE                                                                 77215000
                                                                        77220000
   To set the minimum clock cycle to 1000 and CQ base to 152, and       77225000
   DQ minimum and maximum filter to 10000, enter:                       77230000
                                                                        77235000
   :TUNE 1000;CQ=152;DQ=,,10000,10000                                   77240000
                                                                        77245000
\ENTRY=UP,PARMS,OPERATION,EXAMPLE                                       77250000
     :UP                                                                77255000
                                                                        77260000
Allows a :DOWNed device to function again.                              77265000
                                                                        77270000
SYNTAX                                                                  77275000
                                                                        77280000
     :UP ldn                                                            77285000
                                                                        77290000
\ITEM=PARMS                                                             77295000
PARAMETERS                                                              77300000
                                                                        77305000
ldn          The logical device number of a particular device being     77310000
             placed on-line.                                            77315000
                                                                        77320000
\ITEM=OPERATION                                                         77325000
OPERATION                                                               77330000
                                                                        77335000
This command allows a previously DOWNed device to function again,       77340000
but does not change ownership of the device.                            77345000
                                                                        77350000
\ITEM=EXAMPLE                                                           77355000
EXAMPLES                                                                77360000
                                                                        77365000
To allow logical device number 10 to function again, enter:             77370000
                                                                        77375000
     :UP 10                                                             77380000
     :SHOWDEV 10                                                        77385000
     LDEV   AVAIL      OWNERSHIP      VOLID                             77390000
                                                                        77395000
      10  A AVAIL                                                       77400000
                                                                        77405000
                              NOTE                                      77410000
                                                                        77415000
              When this device was :DOWNed, it was owned by             77420000
              the system and remains unchanged by the :UP               77425000
              command.                                                  77430000
                                                                        77435000
\ENTRY=VFC                                                              77440000
     VERTICAL FORMAT CONTROL (VFC)                                      77445000
                                                                        77450000
If your system has an HP 2608 line printer, you may receive a           77455000
forms message requesting specific forms, and the Vertical               77460000
Format Control (VFC) needed for printing a particular job/session.      77465000
                                                                        77470000
The file containing the VFC image consists of at least one record       77475000
and is an ASCII file.                                                   77480000
                                                                        77485000
If a margin setting is desired then the first record consists of        77490000
a record containing the string "MARGIN=nn" where "nn" is between        77495000
1 and 16 inclusive; the next (or first if no MARGIN) record             77500000
identifies the following records of the file as a VFC image and         77505000
contains a record of 80 bytes with the string "VFC" in columns          77510000
1 through 3.  Column 5 contains either a 6, 8, or a blank,              77515000
indicating the number of lines per inch.  (The default is 6 lines       77520000
per inch.)  Following the lines per inch is the number of print         77525000
lines per page.  This number must be between 0 and 127 inclusive.       77530000
If "0" is specified then the printer resets its internal VFC to         77535000
the default state.  All parameters are separated by commas.             77540000
                                                                        77545000
The following records contain an ASCII representation of the VFC        77550000
image of 1 to 127 records at least 16 bytes each.  A blank              77555000
or a zero in a column indicates a 0 or no-punch; Column 1               77560000
of the record corresponds to channel 1, column 2 is channel 2,          77565000
and so on up to channel 16.  Each record corresponds to a line          77570000
position on the page.                                                   77575000
                                                                        77580000
Channel 3 is the single space channel.  Channel 3 must be defined       77585000
in order to single space, otherwise, the line printer will advance      77590000
the paper one page length for each line printed.  Additionally,         77595000
it is recommended that Channel 1 be defined.  If Channel 1 is not       77600000
defined a warning will be issued to the operator's console              77605000
stating the top of form must be alligned.                               77610000
                                                                        77615000
                           NOTE                                         77620000
                                                                        77625000
          If a selected VFC channel is blank, the paper                 77630000
          will advance one page length; and the next                    77635000
          print line will be the same but on the next                   77640000
          page.  The page length also is defaulted to                   77645000
          11 inches if not specifically programmed to                   77650000
          another value.                                                77655000
                                                                        77660000
The examples, which follow, illustrate this format:                     77665000
                                                                        77670000
o A standard vfc for 6 lines per inch called VFC6.                      77675000
                                                                        77680000
                               1111111                                  77685000
            column    1234567890123456                                  77690000
                                                                        77695000
                      VFC,6,0                                           77700000
                                                                        77705000
                                                                        77710000
o A special vfc for 6 lines per inch setting the margin to 4.           77715000
  Channel 1 is the top of the page and there are 66 lines per           77720000
  page.  Channel 2 is defined for lines 12 and 24.                      77725000
                                                                        77730000
                      MARGIN=4                                          77735000
                      VFC,6,66                                          77740000
                      1                                                 77745000
                      0                                                 77750000
                      0                                                 77755000
                      0                                                 77760000
                      0                                                 77765000
                      0                                                 77770000
                      0                                                 77775000
                      0                                                 77780000
                      0                                                 77785000
                      0                                                 77790000
                      0                                                 77795000
          (line 12)   01                                                77800000
                      0                                                 77805000
                      0                                                 77810000
                      0                                                 77815000
                      0                                                 77820000
                      0                                                 77825000
                      0                                                 77830000
                      0                                                 77835000
                      0                                                 77840000
                      0                                                 77845000
                      0                                                 77850000
                      0                                                 77855000
          (line 24)   01                                                77860000
                                                                        77865000
  Note:  If no channel specifications appear below line 24 then         77870000
         an EOF can occur after record 24 in this example.  Also,       77875000
         blanks and zeros are interchangeable.                          77880000
                                                                        77885000
o A special vfc for 8 lines per inch.  Channel 1 is top of page.        77890000
  There are 88 lines per page, and channel 9 is line 13.                77895000
                                                                        77900000
                      VFC,8,88                                          77905000
                      1                                                 77910000
                      0                                                 77915000
                      0                                                 77920000
                      0                                                 77925000
                      0                                                 77930000
                      0                                                 77935000
                      0                                                 77940000
                      0                                                 77945000
                      0                                                 77950000
                      0                                                 77955000
                      0                                                 77960000
                      0                                                 77965000
                      000000001                                         77970000
                                                                        77975000
Note:  Refer to DOWNLOAD command for use of VFC files.                  77980000
                                                                        77985000
\ENTRY=VINIT,PARMS,OPERATION,EXAMPLE                                    77990000
                                                                        77995000
    :VINIT (System Supervisor capability required)                      78000000
                                                                        78005000
Accesses the Vinit subsystem.                                           78010000
                                                                        78015000
SYNTAX                                                                  78020000
                                                                        78025000
    :VINIT [listdevice]                                                 78030000
                                                                        78035000
\ITEM=PARMS                                                             78040000
PARAMETERS                                                              78045000
                                                                        78050000
listdevice       Device name of a device to receive output generated    78055000
                 by the Vinit subsystem.  If specified, this parameter  78060000
                 must be in the back-reference format.  Default is      78065000
                 $STDLIST.                                              78070000
                                                                        78075000
\ITEM=OPERATION                                                         78080000
OPERATION                                                               78085000
                                                                        78090000
(System Supervisor capability required)                                 78095000
The :VINIT command accesses the Vinit subsystem, which is used for      78100000
disc volume conditioning.                                               78105000
                                                                        78110000
\ITEM=EXAMPLE                                                           78115000
EXAMPLE                                                                 78120000
                                                                        78125000
To access the Vinit subsystem and have the output sent to the line      78130000
printer, enter:                                                         78135000
                                                                        78140000
    :FILE LISTD;DEV=LP                                                  78145000
    :VINIT *LISTD                                                       78150000
                                                                        78155000
                                                                        78160000
\ENTRY=VMOUNT,PARMS,OPERATION,EXAMPLE                                   78165000
     :VMOUNT                                                            78170000
                                                                        78175000
Enables or disables the Private Volumes Facility of MPE.                78180000
                                                                        78185000
SYNTAX                                                                  78190000
                                                                        78195000
             {ON [,AUTO]}                                               78200000
     :VMOUNT {          } [;ALL]                                        78205000
             {OFF       }                                               78210000
                                                                        78215000
\ITEM=PARMS                                                             78220000
PARAMETERS                                                              78225000
                                                                        78230000
ON          Specifies Private Volumes mount and dismount requests       78235000
            be accepted.                                                78240000
                                                                        78245000
AUTO        Allows the system to approve or disapprove users' mount     78250000
            and dismount requests without your intervention.  If        78255000
            not specified, you will be required to reply at the         78260000
            console to all mount requests, even those that request      78265000
            you to mount an already mounted volume set.                 78270000
                                                                        78275000
OFF         Specifies that requests involving the private volumes       78280000
            facility will be rejected.                                  78285000
                                                                        78290000
ALL         Causes all private volumes mount-related console messages,  78295000
            including those not requiring your intervention, to be      78300000
            printed on the system console.                              78305000
                                                                        78310000
\ITEM=OPERATION                                                         78315000
OPERATION                                                               78320000
                                                                        78325000
If the Private Volumes Facility is in use when you issue a VMOUNT OFF   78330000
command, users with currently mounted volume sets will be unaffected;   78335000
the command will be satisfied when the last access is complete.         78340000
                                                                        78345000
Once the facility has been enabled, you can determine what volumes      78350000
are actually mounted and which users are using particular volume        78355000
sets with the :DSTAT and :VSUSER commands respectively.                 78360000
                                                                        78365000
Immediately following a system cold load, the private volumes           78370000
facility is disabled.  However, you still receive console messages      78375000
concerning private volumes mount requests.  The setting after a cold    78380000
load is equivalent to the following:                                    78385000
                                                                        78390000
                        :VMOUNT OFF;ALL                                 78395000
                                                                        78400000
The command that gives you the most interaction with, and control       78405000
over, private volumes use is:                                           78410000
                                                                        78415000
                        :VMOUNT ON;ALL                                  78420000
                                                                        78425000
The command that provides the least interruption to you during          78430000
private volumes use is:                                                 78435000
                                                                        78440000
                        :VMOUNT ON,AUTO                                 78445000
                                                                        78450000
\ITEM=EXAMPLE                                                           78455000
EXAMPLES                                                                78460000
                                                                        78465000
The follwoing example disables the private volumes facility.  By        78470000
default, the example requests that no messages be sent to the console   78475000
when users attempt to use the facility.                                 78480000
                                                                        78485000
     :VMOUNT OFF                                                        78490000
                                                                        78495000
The next example disables the private volumes facility but specifies    78500000
messages should be sent to the console when users attempt to mount      78505000
private volumes.                                                        78510000
                                                                        78515000
     :VMOUNT OFF;ALL                                                    78520000
                                                                        78525000
\ENTRY=VSUSER,PARMS,OPERATION,EXAMPLE                                   78530000
    :VSUSER                                                             78535000
                                                                        78540000
Prints a listing of all users of a currently mounted volume set.        78545000
                                                                        78550000
SYNTAX                                                                  78555000
                                                                        78560000
    :VSUSER [vsname]                                                    78565000
                                                                        78570000
\ITEM=PARMS                                                             78575000
PARAMETERS                                                              78580000
                                                                        78585000
vsname      A fully-qualified volume set name.                          78590000
                                                                        78595000
\ITEM=OPERATION                                                         78600000
OPERATION                                                               78605000
                                                                        78610000
The :VSUSER command lists all users who have explicitly or implicitly   78615000
mounted a volume set.                                                   78620000
                                                                        78625000
\ITEM=EXAMPLE                                                           78630000
EXAMPLE                                                                 78635000
                                                                        78640000
    :VSUSER                                                             78645000
\ENTRY=WARN,PARMS,OPERATION,EXAMPLE                                     78650000
     :WARN                                                              78655000
                                                                        78660000
Sends an urgent message to jobs/sessions.                               78665000
                                                                        78670000
SYNTAX                                                                  78675000
                                                                        78680000
             @                                                          78685000
     :WARN { #Jnnn                       }[;]message                    78690000
             #Snnn                                                      78695000
             [jsname,]username.acctname                                 78700000
                                                                        78705000
\ITEM=PARMS                                                             78710000
PARAMETERS                                                              78715000
                                                                        78720000
@                 Requests the message be sent to all sessions          78725000
                  (QUIET and non-/quiet).                               78730000
                                                                        78735000
#Jnnn             A job number.  Only jobs submitted on interactive     78740000
                  devices can receive messages; although syntactically  78745000
                  correct in this command, messages are rarely sent     78750000
                  to jobs.                                              78755000
                                                                        78760000
#Snnn             A session number.                                     78765000
                                                                        78770000
jsname            The name of the job or session to which the message   78775000
                  is to be sent.                                        78780000
                                                                        78785000
username          A user name.                                          78790000
                                                                        78795000
acctname          An account name.                                      78800000
                                                                        78805000
message           An ASCII string; the length of the string must not    78810000
                  be greater than 67 characters.  The message is        78815000
                  terminated by a carriage return.                      78820000
                                                                        78825000
\ITEM=OPERATION                                                         78830000
OPERATION                                                               78835000
                                                                        78840000
An urgent message (:WARN), interrupting any current pending read --     78845000
or write in progress, will appear on the list devices of all            78850000
sessions (even QUIET) as:                                               78855000
                                                                        78860000
                    OPERATOR WARNING:  message                          78865000
                                                                        78870000
WARN messages will be received by jobs only if the job was submitted    78875000
on an interactive device.                                               78880000
                                                                        78885000
The user has the option of running his session in QUIET mode, wherein   78890000
:TELL messages from other users and :TELL messages from the Console     78895000
Operator will be refused.  (:WARN messages from the Console Operator,   78900000
however, will override the QUIET mode condition.)                       78905000
                                                                        78910000
\ITEM=EXAMPLE                                                           78915000
EXAMPLES                                                                78920000
                                                                        78925000
To send a WARN message to all sessions followed by a WARN message       78930000
to session #S51, enter:                                                 78935000
                                                                        78940000
     :WARN @;THE SYSTEM WILL SHUTDOWN IN 5 MINUTES..PLS LOG-OFF         78945000
     :WARN #S51;LAST CHANCE TO LOG-OFF GRACEFULLY..                     78950000
                                                                        78955000
\ENTRY=WELCOME,PARMS,OPERATION,EXAMPLE                                  78960000
    :WELCOME                                                            78965000
                                                                        78970000
Defines the welcome message.                                            78975000
                                                                        78980000
SYNTAX                                                                  78985000
                       :WELCOME [file]                                  78990000
                                                                        78995000
\ITEM=PARMS                                                             79000000
PARAMETERS                                                              79005000
                                                                        79010000
file         The name of an ASCII file containing the new welcome       79015000
             message. If the file parameter is omitted, the welcome     79020000
             message is taken from the standard input.                  79025000
                                                                        79030000
\ITEM=OPERATION                                                         79035000
OPERATION                                                               79040000
                                                                        79045000
The :WELCOME command will load the welcome message from an ASCII file   79050000
or the standard input device.  To load the message from a file, include 79055000
the filename as a parameter.  To enter the welcome message directly,    79060000
enter :WELCOME with no parameters.  You are then prompted with a # to   79065000
begin each line of the message.  The message is terminated and the      79070000
command completed when a carriage return is entered in response to the  79075000
# prompt character.                                                     79080000
                                                                        79085000
Any number of lines may be used for the welcome message.  If no message 79090000
is given (either an empty file or responding with a carriage return to  79095000
the first prompt character), the old welcome message will be deleted.   79100000
                                                                        79105000
The welcome message is preserved when the WARMSTART, COOLSTART, and     79110000
UPDATE system restart options are used.                                 79115000
                                                                        79120000
The WELCOME message will be printed on the $STDLIST device of each job  79125000
or session as it goes into execution.                                   79130000
\ITEM=EXAMPLE                                                           79135000
                                                                        79140000
EXAMPLE                                                                 79145000
                                                                        79150000
To create a multi-line welcome message directly from the standard input 79155000
device, enter:                                                          79160000
                                                                        79165000
      :WELCOME                                                          79170000
      #HEWLETT-PACKARD DEMONSTRATION CENTER                             79175000
      #WELCOME TO THE HP3000 COMPUTER SYSTEM.                           79180000
      #NOTE: FILES WILL BE STORED EACH DAY BETWEEN 6AM AND 7AM.         79185000
      #return                                                           79190000
                                                                        79195000
To copy the message from a file named WELMESG.PUB.SYS, enter:           79200000
                                                                        79205000
      :WELCOME WELMESG.PUB.SYS                                          79210000
\ALL                                                                    79215000
