\ENTRY=HELPMENU,SESSIONS,JOBS,PROGRAMS,FILES,MANAGE,OPERATOR,SPOOL,UTIL 00010000
Information is available on the following classes of commands:          00012000
  Running Sessions                                                      00014000
  Running Jobs                                                          00016000
  Managing Files                                                        00018000
  Running Subsystems and Programs                                       00020000
  System Management, Status, and Accounting                             00022000
  Operator Control                                                      00024000
  Spooler Control                                                       00026000
  Utility Functions                                                     00028000
                                                                        00030000
For more information, enter a KEYWORD.  You can also enter any command  00032000
name as a keyword.  Enter 'help' for information on help.  Enter 'exit' 00034000
to leave help.                                                          00036000
\ITEM=SESSIONS                                                          00038000
Running Sessions.  Following are the commands used:                     00040000
   COMMAND ( ) LOG ON                                                   00042000
   ABORT                                                                00044000
   BYE                                                                  00046000
   DSLINE                                                               00048000
   EOD                                                                  00050000
   EOF                                                                  00052000
   HELLO                                                                00054000
   HELP                                                                 00056000
   REMOTE                                                               00058000
   REMOTE HELLO                                                         00060000
   RESUME                                                               00062000
                                                                        00064000
You can use any command as a keyword.                                   00066000
\ITEM=JOBS                                                              00068000
Running Jobs.  Following are the commands used.                         00070000
   COMMENT                                                              00072000
   CONTINUE                                                             00074000
   DATA                                                                 00076000
   EOD                                                                  00078000
   EOF                                                                  00080000
   EOJ                                                                  00082000
   IF                                                                   00084000
   ENDIF                                                                00086000
   ELSE                                                                 00088000
   JOB                                                                  00090000
   SET                                                                  00092000
   SETJCW                                                               00094000
   SHOWJCW                                                              00096000
   STREAM                                                               00098000
                                                                        00100000
You can use any command name as a keyword.                              00102000
\ITEM=PROGRAMS                                                          00104000
Running Subsystems & Programs.  Following are the commands used:        00106000
   APL            FCOPY          RPG                                    00108000
   BASIC          FORTGO         RPGGO                                  00110000
   BASICGO        FORTPREP       RPGPREP                                00112000
   BASICOMP       FORTRAN        RUN                                    00114000
   BASICPREP      IML            SEGMENTER                              00116000
   COBOL          IMLMGR         SETDUMP                                00118000
   COBOLGO        MRJE           SPL                                    00120000
   COBOLPREP      PREP           SPLGO                                  00122000
   DEBUG          PREPRUN        SPLPREP                                00124000
   DSCOPY         RESETDUMP      VINIT                                  00126000
   EDITOR         RJE                                                   00128000
                                                                        00130000
You can use any command name as a keyword.                              00132000
\ITEM=FILES                                                             00134000
Managing Files/Device Files.  Following are the commands used:          00136000
   ALTSEC         LISTF          RENAME                                 00138000
   ALTVSET        LISTVS         RESET                                  00140000
   ASSOCIATE      MOUNT          RESTORE                                00142000
   BUILD          NEWVSET        SAVE                                   00144000
   DISASSOCIATE   PURGE          SECURE                                 00146000
   DISMOUNT       PURGEVSET      STORE                                  00148000
   FILE           RELEASE        VSUSER                                 00150000
                                                                        00152000
                                                                        00154000
You can use any command name as a keyword.                              00156000
\ITEM=MANAGE                                                            00158000
System Management, Status and Accounting.                               00160000
   Status            Accounting           System      Resource          00162000
   ------            ----------         Management   Management         00164000
                                        ----------   ----------         00166000
                                                                        00168000
   DSTAT        ALTACCT    NEWGROUP     ALLOCATE       ALTLOG           00170000
   SHOWDEV      ALTGROUP   NEWUSER      DEALLOCATE     FREERIN          00172000
   SHOWIN       ALTUSER    PURGEACCT    JOBPRI         GETLOG           00174000
   SHOWJOB      LISTACCT   PURGEGROUP   RESUMELOG      GETRIN           00176000
   SHOWOUT      LISTGROUP  PURGEUSER    SHOWLOG        LISTLOG          00178000
                LISTUSER   REPORT       SHOWQ          RELLOG           00180000
                NEWACCT    RESETACCT    SWITCHLOG      SHOWLOGSTATUS    00182000
                                        SYSDUMP                         00184000
                                        TUNE                            00186000
                                                                        00188000
You can use any command name as a keyword.                              00190000
\ITEM=OPERATOR                                                          00192000
Operator Control.  Following are the commands used:                     00194000
                                                                        00196000
    ABORTIO           GIVE          REFUSE                              00198000
    ABORTJOB          HEADOFF       REPLY                               00200000
    ACCEPT            HEADON        RESUMEJOB                           00202000
    ALLOW             IMLCONTROL    RESUMESPOOL                         00204000
    ALTJOB            JOBFENCE      SHOWCOM                             00206000
    ALTSPOOLFILE      JOBSECURITY   STARTSPOOL                          00208000
    BREAKJOB          LIMIT         STOPSPOOL                           00210000
    CONSOLE           LDISMOUNT     STREAMS                             00212000
    DELETESPOOLFILE   LMOUNT        SUSPENDSPOOL                        00214000
    DISALLOW          LOG           TAKE                                00216000
    DOWN              MPLINE        UP                                  00218000
    DOWNLOAD          MRJECONTROL   VMOUNT                              00220000
    DSCONTROL         OUTFENCE      WARN                                00222000
    FOREIGN           RECALL        WELCOME                             00224000
                                                                        00226000
                                                                        00228000
You can use any command name as a keyword.                              00230000
\ITEM=SPOOLER                                                           00232000
Spooler Control.  Following are the commands used:                      00234000
                                                                        00236000
     ALTSPOOLFILE                                                       00238000
     DELETESPOOLFILE                                                    00240000
     RESUMESPOOL                                                        00242000
     STARTSPOOL                                                         00244000
     STOPSPOOL                                                          00246000
     SUSPENDSPOOL                                                       00248000
                                                                        00250000
You can use any command name as a keyword.                              00252000
                                                                        00254000
\ITEM=UTILITY                                                           00256000
Utility Functions.  Following are the commands used:                    00258000
   CONSOLE       SHOWALLOW                                              00260000
   PTAPE         SHOWCATALOG                                            00262000
   SETCATALOG    SHOWME                                                 00264000
   SETMSG        SHOWTIME                                               00266000
   SPEED         TELL                                                   00268000
   RECALL        TELLOP                                                 00270000
   REDO                                                                 00272000
                                                                        00274000
You can use any command name as a keyword.                              00276000
                                                                        00278000
                                                                        00280000
\ENTRY=COMMAND,PARMS,OPERATION,EXAMPLE                                  00282000
    :() COMMAND LOG ON                                                  00284000
                                                                        00286000
Begins a session, executes the enclosed MPE command, and ends the       00288000
session upon completion of the command.                                 00290000
                                                                        00292000
SYNTAX                                                                  00294000
                                                                        00296000
    :([:]commandname) [sessionname,]username[/userpass]                 00298000
        .acctname[/acctpass][,groupname[/grouppass]]                    00300000
                                                                        00302000
         [;TERM=termtype]                                               00304000
         [;TIME=cpusecs]                                                00306000
                                                                        00308000
                 BS                                                     00310000
                 CS                                                     00312000
         [;PRI= {  }                                                    00314000
                 DS                                                     00316000
                 ES                                                     00318000
                                                                        00320000
          ;INPRI=inputpriority                                          00322000
         [                    ]                                         00324000
          ;HIPRI                                                        00326000
                                                                        00328000
\ITEM=PARMS                                                             00330000
PARAMETERS                                                              00332000
                                                                        00334000
commandname        Any MPE command, including its parameter list.       00336000
                   The prompting colon may be omitted.  (REQUIRED       00338000
                   PARAMETER)                                           00340000
                                                                        00342000
sessionname        Arbitrary name used in conjunction with <username>   00344000
                   and <acctname> to form a fully-qualified session     00346000
                   identity.  Contains from 1 to 8 alphanumeric         00348000
                   characters, beginning with a letter.  Default is     00350000
                   no session name.                                     00352000
                                                                        00354000
username           A user name, established by the Account Manager, that00356000
                   allows you to log on under this account.  This name  00358000
                   is unique within the account.  Contains from 1 to 8  00360000
                   alphanumeric characters, beginning with a letter.    00362000
                   (REQUIRED PARAMETER)                                 00364000
                                                                        00366000
userpass           Your user password, optionally assigned by the       00368000
                   Account Manager.  Contains from 1 to 8 alphanumeric  00370000
                   characters, beginning with a letter.                 00372000
                                                                        00374000
acctname           Name of your account, as established by the System   00376000
                   Manager.  Contains from 1 to 8 alphanumeric          00378000
                   characters, beginning with a letter.                 00380000
                                                                        00382000
                                                                        00384000
                                     NOTE                               00386000
                                                                        00388000
                   Must be preceded by a period as a delimiter.         00390000
                                                                        00392000
                   (REQUIRED PARAMETER)                                 00394000
                                                                        00396000
acctpass           Account password, optionally assigned by the System  00398000
                   Manager.  Contains from 1 to 8 alphanumeric          00400000
                   characters, beginning with a letter.                 00402000
                                                                        00404000
groupname          Name of file group to be used for local file domain  00406000
                   and central processor time charges, as established   00408000
                   by the Account Manager.  Contains from 1 to 8        00410000
                   alphanumeric characters, beginning with a letter.    00412000
                   Default is your home group if one is assigned.       00414000
                   (REQUIRED IF HOME GROUP NOT ASSIGNED)                00416000
                                                                        00418000
grouppass          Group password, optionally assigned by the Account   00420000
                   Manager.  Contains from 1 to 8 alphanumeric          00422000
                   characters, beginning with a letter.  Not needed     00424000
                   when you log on under home group; otherwise, required00426000
                   if assigned.                                         00428000
                                                                        00430000
termtype           Type of terminal used for input.  (MPE uses this     00432000
                   parameter to determine device-dependent              00434000
                   characteristics such as delay factors for carriage   00436000
                   returns.  Must be a number from 0 to 15, as follows: 00438000
                                                                        00440000
                   0    HP 2749B (ASR 33 EIA-compatible) (10 characters 00442000
                        per second (cps)).                              00444000
                                                                        00446000
                   1    ASR 37 EIA-compatible (10 cps).                 00448000
                                                                        00450000
                   2    ASR 35 EIA-compatible (10 cps).                 00452000
                                                                        00454000
                   3    Execuport 300 Data Communication Transceiver    00456000
                        Terminal (10, 15, 30 cps).                      00458000
                                                                        00460000
                   4    HP 2600A or Datapoint 3300 (10-240 cps).        00462000
                                                                        00464000
                   5    Memorex 1240 (10, 15, 30, 60 cps).              00466000
                                                                        00468000
                   6    HP 2762A/B (GE Terminet 300 or 1200), or Data   00470000
                        Communications Terminal, Model B (10, 15, 30,   00472000
                        120 cps).                                       00474000
                                                                        00476000
                   9    HP 2615A (Beehive MiniBee) (10-240 cps).        00478000
                                                                        00480000
                  10    HP 2640A/B, HP 2641A, HP 2644A, or HP 2645A.    00482000
                        Character mode or full program control of block 00484000
                        mode transmission (10-240 cps).                 00486000
                                                                        00488000
                  11    HP 2640A/B, HP 2641A, HP 2644A, or HP 2645A.    00490000
                        Allows use of block mode without program control00492000
                        of block mode transmission.  Requires you to    00494000
                        position cursor before pressing ENTER.          00496000
                        Recommended for speeds exceeding 30 cps when you00498000
                        expect to switch between character mode block/  00500000
                        line mode.  May not be used in block/page mode  00502000
                        (10-240 cps).                                   00504000
                                                                        00506000
                  12    HP 2645K  Katakana/Roman Data Terminal.         00508000
                                                                        00510000
                  13    Message switching network or other computer.    00512000
                                                                        00514000
                  14    Multi-Point Terminal.                           00516000
                                                                        00518000
                  15    HP 2635A Printing Terminal.  8-bit protocol     00520000
                        (for second character set).                     00522000
                                                                        00524000
                  16    HP 2635A Printing Terminal.  7-bit protocol     00526000
                        (standard character set).                       00528000
                                                                        00530000
                                       NOTE                             00532000
                                                                        00534000
                   On Series 33, only term types 4, 6, 9, 10, 11,       00536000
                 12, 15, and 16 may be used.                            00538000
\stophelp                                                               00540000
                   terminal types other than the above may result       00542000
                   in system failure.                                   00544000
\starthelp                                                              00546000
                                                                        00548000
                  Default:  For hardwired terminals, determined by      00550000
                  System Supervisor during system configuration.  No    00552000
                  default for terminals that are not hard wired.        00554000
                  (Required parameter to insure correct listings if     00556000
                  your terminal is not the default <termtype>.)         00558000
                                                                        00560000
cpusecs           Maximum central processor time that your session can  00562000
                  use, entered in seconds.  When this limit is reached, 00564000
                  session is aborted.  Must be a value from 1 to 32767. 00566000
                  To specify no limit, specify question mark or omit    00568000
                  this parameter.  Default is no limit.                 00570000
                                                                        00572000
BS,CS,DS,ES       The execution priority class that the Command         00574000
                  Interpreter uses for your session, and also the       00576000
                  default priority for all programs executed within     00578000
                  the session.  BS is highest priority, ES is lowest.   00580000
                  If you specify a priority that exceeds the highest    00582000
                  permitted for your account or user name by the system,00584000
                  MPE assigns the highest priority possible below BS.   00586000
                  Default is CS.                                        00588000
                                                                        00590000
                                                                        00592000
                                     NOTE                               00594000
                                                                        00596000
                  DS and ES are intended primarily for batch jobs,      00598000
                  their use for sessions is generally discouraged.      00600000
                                                                        00602000
                                                                        00604000
inputpriority     Relative input priority used in checking against      00606000
                  access restrictions imposed by <jobfence>, if one     00608000
                  exists.  Takes effect at logon time.  Must be a value 00610000
                  from 1 (lowest priority) to 13 (highest priority).  If00612000
                  you supply a value less than or equal to current      00614000
                  <jobfence> set by Console Operator, session is denied 00616000
                  access.  Default is 8.                                00618000
                                                                        00620000
HIPRI             Request for maximum session selection input priority, 00622000
                  causing session to be scheduled regardless of current 00624000
                  <jobfence> or execution limit for sessions.  Default  00626000
                  is the current <jobfence> and execution limit.        00628000
                                                                        00630000
                                       NOTE                             00632000
                                                                        00634000
                  You can specify this parameter only if you have       00636000
                  System Manager or System Supervisor capability.       00638000
                                                                        00640000
\ITEM=OPERATION                                                         00642000
OPERATION                                                               00644000
                                                                        00646000
This command initiates a session and immediately executes the command   00648000
contained within the parentheses.  Once in contact with the command or  00650000
subsystem specified inside the parentheses, all input, output, break    00652000
capabilities, and prompts operate as described in the command or        00654000
subsystem instructions.  After the execution of the command or subsytem 00656000
is completed, either normally or through an abort, a log off is         00658000
performed automatically.                                                00660000
                                                                        00662000
                        NOTE                                            00664000
                                                                        00666000
      You must enter the :( ) command log on at a terminal -- no        00668000
      other device can be used for this command.                        00670000
                                                                        00672000
      :( ) command log on is not recognized within sessions, as         00674000
      for example, the :HELLO command is.                               00676000
                                                                        00678000
      Commands which would normally cause an end of file, such as       00680000
      :HELLO, :BYE, :JOB, :DATA, :EOF, and :EOJ are not recognized      00682000
      and if used the session is terminated immediately.                00684000
                                                                        00686000
      Only one MPE command is allowed within the parentheses.           00688000
      Also, the leading and trailing blanks are suppressed within       00690000
      the parentheses.                                                  00692000
                                                                        00694000
The logon and logoff messages can be terminated using BREAK, and the    00696000
command specified within the parentheses is breakable or not in         00698000
accordance with its usual break or no break capability.  When the       00700000
command inside the parentheses is aborted, a log off is performed       00702000
immediately.                                                            00704000
                                                                        00706000
If you omit any passwords required in the :( ) command log on, MPE      00708000
prompts you for them individually.                                      00710000
                                                                        00712000
When MPE initiates the session, it displays the HP 3000 Model Number,   00714000
and the date and time as follows:                                       00716000
                                                                        00718000
    HP3000 / MPE IV C.00.00.  FRI, APR  6, 1979,  9:11 AM               00720000
                                                                        00722000
After the logon message is printed at your terminal, MPE executes the   00724000
command specified within the parentheses.  The information MPE generates00726000
as a result of this command is transmitted to your terminal immediately;00728000
just as if you had called that command or subsystem during a session.   00730000
When the command or subsystem is exited, MPE terminates the session at  00732000
once and displays the cpu time used (in seconds), the connect time (in  00734000
minutes), and the date and time, as follows:                            00736000
                                                                        00738000
    CPU=1.  CONNECT=1.  FRI, APR 6, 1979,  9:11 AM                      00740000
                                                                        00742000
\ITEM=EXAMPLE                                                           00744000
EXAMPLE                                                                 00746000
                                                                        00748000
To log on under <username> MAC, <acctname> TECHPUB, and <groupname>     00750000
XGROUP, and execute the LISTF command, enter:                           00752000
                                                                        00754000
    :(LISTF) MAC.TECHPUB,XGROUP                                         00756000
                                                                        00758000
    HP3000 / MPE IV C.00.00.  FRI, APR  6, 1979,  9:11 AM               00760000
                                                                        00762000
    FILENAME                                                            00764000
                                                                        00766000
    FIRST     GP005     TRIAL     XPROG                                 00768000
                                                                        00770000
    CPU=1.  CONNECT=1.  FRI, APR  6, 1979,  9:11 AM                     00772000
                                                                        00774000
                                                                        00776000
\ENTRY=ABORT,PARMS,OPERATION,EXAMPLE                                    00778000
    :ABORT                                                              00780000
                                                                        00782000
Aborts current program or operation.                                    00784000
                                                                        00786000
SYNTAX                                                                  00788000
                                                                        00790000
    :ABORT                                                              00792000
                                                                        00794000
\ITEM=PARMS                                                             00796000
PARAMETERS                                                              00798000
                                                                        00800000
None                                                                    00802000
                                                                        00804000
\ITEM=OPERATION                                                         00806000
OPERATION                                                               00808000
                                                                        00810000
After you suspend a program or MPE command operation by pressing the    00812000
BREAK key, the :ABORT command immediately terminates that program or    00814000
operation.  Note that the :ABORT command is available only from a       00816000
session and only during a break.  An :ABORT command results in the      00818000
Job Control Word (JCW) being set to the SYSTEM 0 state.                 00820000
                                                                        00822000
\ITEM=EXAMPLE                                                           00824000
EXAMPLE                                                                 00826000
                                                                        00828000
To abort the current operation, enter:                                  00830000
                                                                        00832000
    :ABORT                                                              00834000
                                                                        00836000
                                                                        00838000
\ENTRY=ABORTIO,PARMS,OPERATION,EXAMPLE                                  00840000
    :ABORTIO                                                            00842000
                                                                        00844000
Aborts all pending I/O requests for a device.                           00846000
                                                                        00848000
SYNTAX                                                                  00850000
                                                                        00852000
    :ABORTIO ldn                                                        00854000
                                                                        00856000
\ITEM=PARMS                                                             00858000
PARAMETERS                                                              00860000
                                                                        00862000
ldn    The logical device number of the device for which I/O is         00864000
       being aborted.                                                   00866000
                                                                        00868000
\ITEM=OPERATION                                                         00870000
OPERATION                                                               00872000
                                                                        00874000
This command causes all pending I/O operations on the specified ldn     00876000
to be aborted.  If no queued I/O requests are present at the time       00878000
the command is issued, the message "LDEV #ldn NO I/O PENDING" will be   00880000
printed on the system console.                                          00882000
                                                                        00884000
JOB/DATA accepting devices always have outstanding read requests        00886000
pending due to the auto-recognition feature of MPE.  The :ABORTIO       00888000
command is used to clear these pending input requests.  Clearing        00890000
all outstanding I/O requests is sometimes required to allow proper      00892000
execution of other console commands.  In certain cases :ABORTJOB,       00894000
:TAKE, :DOWN, and :REFUSE will not correctly function unless an         00896000
:ABORTIO command is first issued to clear pending I/O operations        00898000
on the appropriate device.                                              00900000
                                                                        00902000
\ITEM=EXAMPLE                                                           00904000
EXAMPLE                                                                 00906000
                                                                        00908000
To abort all pending output requests for logical device 20, enter:      00910000
                                                                        00912000
     :ABORTIO 20                                                        00914000
     11:16/3/LDEV#20 NO I/O PENDING                                     00916000
                                                                        00918000
To completely clear spooled device 5 it is necessary to abort all       00920000
pending I/O operations as shown below:                                  00922000
                                                                        00924000
     :STOPSPOOL 5                                                       00926000
     11:20/31/SP#5/STOPPED                                              00928000
     11/20/31/LDEV#5 NOT READY                                          00930000
     :REFUSE 5                                                          00932000
     :ABORTIO 5                                                         00934000
     :ABORTIO 5                                                         00936000
     11:21/40/LDEV#5 NO I/O PENDING                                     00938000
                                                                        00940000
\ENTRY=ABORTJOB,PARMS,OPERATION,EXAMPLE                                 00942000
     :ABORTJOB                                                          00944000
                                                                        00946000
Aborts a job or session.                                                00948000
                                                                        00950000
SYNTAX                                                                  00952000
                                                                        00954000
                #Jnnn                                                   00956000
     :ABORTJOB {#Snnn                  }                                00958000
                [jobname,]user.account                                  00960000
\ITEM=PARMS                                                             00962000
PARAMETERS                                                              00964000
                                                                        00966000
#Jnnn                   A job number.                                   00968000
                                                                        00970000
#Snnn                   A session number.                               00972000
                                                                        00974000
jobname,user.account    A user's name as identified by SHOWJOB.         00976000
                                                                        00978000
\ITEM=OPERATION                                                         00980000
OPERATION                                                               00982000
                                                                        00984000
This command terminates the designated job or session and displays      00986000
the message *SESSION (or JOB) ABORTED BY SYSTEM MANAGEMENT* on the      00988000
job/session list device.  Although the job/session is abnormally        00990000
terminated, standard cleanup is performed (log records are issued       00992000
and CPU connect times are updated).                                     00994000
                                                                        00996000
:ABORTJOB can be applied to waiting as well as executing jobs/sessions. 00998000
If the input devicefile for a ready batch job is spooled, then it       01000000
will be deleted; whereas if the output devicefile is spooled, it is     01002000
made ready for spooling.  This is the case whenever a batch job         01004000
terminates.                                                             01006000
                                                                        01008000
The successful execution of an :ABORTJOB command results in a logoff    01010000
message associated with the job (if the job was in execution) or        01012000
session affected as shown below:                                        01014000
                                                                        01016000
     :ABORTJOB #J9                                                      01018000
     11:20/#j9/34/LOGOFF                                                01020000
                                                                        01022000
If the logoff message does not appear, it means the affected            01024000
process was WAITing or is not in an abortable state.  One reason        01026000
for this can be outstanding device allocation messages that have        01028000
not been replied to.  You must satisfy the allocation message to        01030000
allow the :ABORTJOB to continue by responding with a REPLY pin, 0       01032000
(where pin is the process identification number).  This is a            01034000
negative response to an allocation message and causes a file open       01036000
error in the accessing program, as shown in one of the examples         01038000
below.                                                                  01040000
\ITEM=EXAMPLE                                                           01042000
EXAMPLES                                                                01044000
                                                                        01046000
To terminate session number 139, enter:                                 01048000
                                                                        01050000
     :ABORTJOB #S139                                                    01052000
                                                                        01054000
To terminate job number 9, enter:                                       01056000
                                                                        01058000
     :ABORTJOB #J9                                                      01060000
     20:18/#J9/26/LOGOFF                                                01062000
                                                                        01064000
(The execution was successful.)                                         01066000
                                                                        01068000
To terminate session 6, which has a pending device allocation message,  01070000
you must reply to the message as shown below:                           01072000
                                                                        01074000
     ?17:00/#S6/23/LDEV# FOR "SCRTAPE" ON TAPE1600 (NUM)?               01076000
     :ABORTJOB #S6                                                      01078000
     :REPLY 23,0                                                        01080000
     17:10:/#S6/34/LOGOFF                                               01082000
                                                                        01084000
\ENTRY=ACCEPT,PARMS,OPERATION,EXAMPLE                                   01086000
    :ACCEPT                                                             01088000
                                                                        01090000
Permits the device to accept jobs/sessions and/or data.                 01092000
                                                                        01094000
SYNTAX                                                                  01096000
                                                                        01098000
              JOBS,                                                     01100000
     :ACCEPT [     ] ldn                                                01102000
              DATA,                                                     01104000
                                                                        01106000
\ITEM=PARMS                                                             01108000
PARAMETERS                                                              01110000
                                                                        01112000
ldn          The logical device number of the device for which :JOB     01114000
             or :HELLO) and :DATA commands are being enabled.           01116000
                                                                        01118000
JOBS         Specifies that :JOB and :HELLO commands will be recog-     01120000
             nized by the designated device.  The device must be        01122000
             interactive to support sessions.                           01124000
                                                                        01126000
DATA         Specifies that :DATA commands will be recognized by the    01128000
             designated device.                                         01130000
                                                                        01132000
\ITEM=OPERATION                                                         01134000
OPERATION                                                               01136000
                                                                        01138000
If both the JOBS and DATA parameters are omitted, both :JOB (or         01140000
:HELLO) and :DATA commands are allowed.                                 01142000
                                                                        01144000
The :ACCEPT command is rejected if JOBS is explicitly requested         01146000
and the device has not been configured with a default output device     01148000
(refer to Output Devicefiles).                                          01150000
                                                                        01152000
\ITEM=EXAMPLE                                                           01154000
EXAMPLES                                                                01156000
                                                                        01158000
To permit logical device 35 to accept jobs and data, enter:             01160000
                                                                        01162000
     :ACCEPT 35                                                         01164000
     :SHOWDEV 35                                                        01166000
     LDEV   AVAIL     OWNERSHIP     VOLID                               01168000
                                                                        01170000
      35 A  AVAIL                                                       01172000
                                                                        01174000
To permit logical device 10 to accept jobs and data, and to allow       01176000
the device to be spooled, enter:                                        01178000
                                                                        01180000
     :ACCEPT 10                                                         01182000
     :STARTSPOOL 10                                                     01184000
     11:12/31/SP#10/SPOOLED IN                                          01186000
     11:12/6/LDEV#10 NOT READY                                          01188000
     :SHOWDEV 10                                                        01190000
     LDEV    AVAIL    OWNERSHIP     VOLID                               01192000
                                                                        01194000
      10  A  AVAIL    SPOOLER IN                                        01196000
                                                                        01198000
\ENTRY=ALLOCATE,PARMS,OPERATION,EXAMPLE                                 01200000
    :ALLOCATE (System Supervisor capability required)                   01202000
                                                                        01204000
Loads a program or procedure.                                           01206000
                                                                        01208000
SYNTAX                                                                  01210000
                                                                        01212000
               PROCEDURE                                                01214000
    :ALLOCATE [        ,]name                                           01216000
               PROGRAM                                                  01218000
                                                                        01220000
\ITEM=PARMS                                                             01222000
PARAMETERS                                                              01224000
                                                                        01226000
PROGRAM       The program file indicated by <name> is allocated.        01228000
                                                                        01230000
PROCEDURE     The procedure indicated by <name> in SL.PUB.SYS is        01232000
              allocated.  The default is PROGRAM.                       01234000
                                                                        01236000
name          The name of the program file or procedure to be allocated.01238000
              (REQUIRED PARAMETER)                                      01240000
                                                                        01242000
\ITEM=OPERATION                                                         01244000
OPERATION                                                               01246000
                                                                        01248000
(System Supervisor capability required)                                 01250000
This command loads the code segments for a program or procedure.  These 01252000
segments remain loaded until DEALLOCATED.                               01254000
                                                                        01256000
The user issuing the :ALLOCATE command must have execute access for any 01258000
file referenced in the name parameter of this command.                  01260000
                                                                        01262000
\ITEM=EXAMPLE                                                           01264000
EXAMPLE                                                                 01266000
                                                                        01268000
To permanently allocate a procedure identified as PROC1, residing in    01270000
SL.PUB.SYS, enter:                                                      01272000
                                                                        01274000
    :ALLOCATE PROCEDURE,PROC1                                           01276000
                                                                        01278000
                                                                        01280000
\ENTRY=ALLOW,PARMS,OPERATION,EXAMPLE                                    01282000
     :ALLOW                                                             01284000
                                                                        01286000
Grants a user access to a specific operator command.                    01288000
                                                                        01290000
SYNTAX                                                                  01292000
                                                                        01294000
             FILE=formaldesignator [;SHOW]                              01296000
                                                                        01298000
               @.@                                                      01300000
            [  user.@                                               ]   01302000
     :ALLOW   {@.acct   } ;COMMANDS=command1[,command2,...,commandn]    01304000
               user.acct                                                01306000
                                                                        01308000
\ITEM=PARMS                                                             01310000
PARAMETERS                                                              01312000
                                                                        01314000
formaldesignator    A formal ASCII file name.                           01316000
                                                                        01318000
SHOW                Lists input lines on $STDLIST.                      01320000
                                                                        01322000
@.@                 Grants access to all users whether logged on or     01324000
                    not.                                                01326000
                                                                        01328000
user.@              Grants access to a specific user in all accounts.   01330000
                                                                        01332000
@.acct              Grants access to all users in a specific account.   01334000
                                                                        01336000
user.acct           Grants access to a specific user in a specific      01338000
                    account.                                            01340000
                                                                        01342000
\ITEM=OPERATION                                                         01344000
OPERATION                                                               01346000
                                                                        01348000
Through the :ALLOW command, the console operator has the ability to     01350000
distribute console capabilities among system users by directly          01352000
entering:                                                               01354000
                                                                        01356000
             @.@                                                        01358000
     :ALLOW {user.@   };COMMANDS=command1[,command2,...,commandn]       01360000
             @.acct                                                     01362000
             user.acct                                                  01364000
                                                                        01366000
This command can also be used in an indirect and subsystem mode.        01368000
In the indirect mode, an EDITOR file is created that contains:          01370000
                                                                        01372000
             @.@                                                        01374000
            {user.@   };COMMANDS=command1[,command2,...,commandn]       01376000
             @.acct                                                     01378000
             user.acct                                                  01380000
                                                                        01382000
The :ALLOW command is then executed by entering at the system           01384000
console:                                                                01386000
                                                                        01388000
     :ALLOW FILE=formaldesignator[;SHOW]                                01390000
                                                                        01392000
which enables the EDITOR file.                                          01394000
                                                                        01396000
In subsystem mode, just type ALLOW followed by a carriage return.       01398000
The command prompts you with a > sign, accepting command parameters     01400000
until an EOF is received or EXIT is entered.                            01402000
                                                                        01404000
The user receiving the capabilities must be logged on at the time       01406000
and automatically loses the capability by logging off.  (Notice @.@     01408000
effects all users whether they`re logged on or off.                     01410000
                                                                        01412000
\ITEM=EXAMPLE                                                           01414000
EXAMPLES                                                                01416000
                                                                        01418000
To give the user BARB.LEWIS the ability to execute the REPLY and        01420000
ABORTIO commands, enter on the system console:                          01422000
                                                                        01424000
     :ALLOW BARB.LEWIS;COMMANDS=REPLY,ABORTIO                           01426000
                                                                        01428000
To give the user PAUL.JONES the ability to execute the BREAKJOB         01430000
command in subsystem mode, enter on the system console:                 01432000
                                                                        01434000
     :ALLOW                                                             01436000
     >PAUL.JONES;COMMANDS=BREAKJOB                                      01438000
     >EXIT                                                              01440000
                                                                        01442000
\ENTRY=ALTACCT,PARMS,OPERATION,EXAMPLE                                  01444000
    :ALTACCT (System Manager capability required)                       01446000
                                                                        01448000
Changes the attributes of an existing account.                          01450000
                                                                        01452000
SYNTAX                                                                  01454000
                                                                        01456000
    :ALTACCT acctname                                                   01458000
             [;PASS=[password]]                                         01460000
             [;FILES=[filespace]]                                       01462000
             [;CPU=[cpu]]                                               01464000
             [;CONNECT=[connect]]                                       01466000
             [;CAP=[capabilitylist]]                                    01468000
             [;ACCESS=[fileaccess]]                                     01470000
             [;MAXPRI=[subqueuename]]                                   01472000
             [;LOCATTR=[localattribute]]                                01474000
                          SPAN                                          01476000
             [;VS=volset:{    }]                                        01478000
                          ALT                                           01480000
                                                                        01482000
\ITEM=PARMS                                                             01484000
PARAMETERS                                                              01486000
                                                                        01488000
acctname             The name of the account to be altered. (REQUIRED   01490000
                     PARAMETER)                                         01492000
                                                                        01494000
password             Account password (used for verifying logon access  01496000
                     only).  If omitted, any existing password is       01498000
                     removed.                                           01500000
                                                                        01502000
filespace            Disc storage limit, in sectors, for the permanent  01504000
                     files in the account.  <Filespace> limit cannot be 01506000
                     less than the number of sectors currently in use   01508000
                     for the account.  Default is unlimited <filespace>.01510000
                                                                        01512000
cpu                  The limit on cpu time, in seconds, for the account.01514000
                     This limit is checked only when a job/session is   01516000
                     initiated -- thus, the limit never causes a        01518000
                     job/session to abort. The maximum value permitted  01520000
                     is 2,147,483,647 seconds.  Default is unlimited    01522000
                     cpu time.                                          01524000
                                                                        01526000
connect              The limit on total session connect time, in        01528000
                     minutes, allowed the account.  This limit is       01530000
                     checked only at log on.  The maximum value allowed 01532000
                     is 2,147,483,647 minutes.  Default is unlimited    01534000
                     connect time.                                      01536000
                                                                        01538000
capabilitylist       List of capabilities, mutually separated by commas,01540000
                     permitted this account.  Each capability is denoted01542000
                     by a two-letter mnemonic, as follows:              01544000
                                                                        01546000
                     System Manager          = SM                       01548000
                     Account Manager         = AM                       01550000
                     Account Librarian       = AL                       01552000
                     Group Librarian         = GL                       01554000
                     Diagnostician           = DI                       01556000
                     System Supervisor       = OP                       01558000
                                                                        01560000
                     Permanent Files         = SF                       01562000
                     Access of non-sharable                             01564000
                     I/O devices             = ND                       01566000
                     Create Volumes          = CV                       01568000
                     Use Volumes             = UV                       01570000
                     Use Communications                                 01572000
                     Subsystems              = CS                       01574000
                                                                        01576000
                     Process Handling        = PH                       01578000
                     Extra Data Segments     = DS                       01580000
                     Multiple RINS           = MR                       01582000
                     Privileged Mode         = PM                       01584000
                     Interactive Access      = IA                       01586000
                     Local Batch Access      = BA                       01588000
                     User Logging            = LG                       01590000
                     Default is AM, AL, GL, SF, ND, IA, BA.             01592000
                                                                        01594000
fileaccess           File security specifications, entered as follows:  01596000
                                                                        01598000
                      R                                                 01600000
                      L     ANY                                         01602000
                     {A} : {   }                                        01604000
                      W     AC                                          01606000
                      X                                                 01608000
\starthelp                                                              01610000
                                                                        01612000
                     where R, L, A, W, X specify modes of access by     01614000
                     types of users (ANY, AC) as follows:               01616000
\starthelp                                                              01618000
                                                                        01620000
                     R = Read                                           01622000
                     L = Lock (allows exclusive access to file)         01624000
                     A = Append (implicitly specifies L also)           01626000
                     W = Write (implicitly specifies A and L also)      01628000
                     X = Execute                                        01630000
\starthelp                                                              01632000
                                                                        01634000
                     Two or more modes may be specified if they are     01636000
                     separated by commas.                               01638000
                                                                        01640000
                     The user types are specified as follows:           01642000
                                                                        01644000
                     ANY = Any user                                     01646000
                     AC  = Member of this account only                  01648000
\stophelp                                                               01650000
                     AL  = Account librarian user only                  01652000
                     GL  = Group librarian user only                    01654000
\starthelp                                                              01656000
                                                                        01658000
                     Two or more user types may be specified if they are01660000
                     separated by commas.                               01662000
                                                                        01664000
                     The default is:                                    01666000
                                                                        01668000
                        R, L, A, W, X: AC  (All accounts except SYS)    01670000
                        R, X: ANY; L, A, W: AC  (SYS account only)      01672000
                                                                        01674000
subqueuename         Name of the subqueue of highest priority that can  01676000
                     be requested by any process of any job/session in  01678000
                     the account, specified as xS, where x is A, B, C,  01680000
                     D, or E.  Default is CS.                           01682000
                                                                        01684000
locatattribute       Local attribute of the user, as defined at the     01686000
                     installation site.  This is a double-word of       01688000
                     arbitrary meaning which might be used to further   01690000
                     classify users.  While it is not involved in       01692000
                     standard MPE security provisions, it is available  01694000
                     to processes through the WHO intrinsic for use in  01696000
                     the programmer's own security provisions.  Default 01698000
                     is double-word 0 (null).                           01700000
                                                                        01702000
volset:SPAN          Volset is a volume set or class reference which,   01704000
                     when fully qualified, is in the form               01706000
                                                                        01708000
                     vcsid.groupname.acctname                           01710000
                                                                        01712000
                     where vcsid refers to a previously-defined volume  01714000
                     set or class definition.                           01716000
                                                                        01718000
                     SPAN indicates that the acctname is to be inserted 01720000
                     in the accounting directory of the specified volume01722000
                     set (volset).  The specified volume set must have  01724000
                     been previously mounted (via a MOUNT command) for  01726000
                     the SPAN operation to succeed.                     01728000
                                                                        01730000
volset:ALT           ALT directs the altering of an account or group    01732000
                     entry on the specified volume set.  ALT is useful  01734000
                     only if it is necessary to alter account and group 01736000
                     file space limits for entries that have already    01738000
                     been spanned.                                      01740000
                                                                        01742000
\ITEM=OPERATION                                                         01744000
OPERATION                                                               01746000
                                                                        01748000
(System Manager capability required)                                    01750000
This command changes the attributes of an existing account.  When       01752000
altering the <capabilitylist> for the SYS account, the SM capability    01754000
cannot be removed.  If <acctname> is SYS, and the <fileaccess> parameter01756000
is omitted, the following default security is assigned:                 01758000
                                                                        01760000
    R, X: ANY; A, W, L: AC                                              01762000
                                                                        01764000
When an entire keyword parameter group is omitted from the :ALTACCT     01766000
command, that parameter remains unchanged for the account.  When a      01768000
keyword is included but the corresponding parameter is omitted (as in   01770000
;PASS=), the default value is assigned as follows:                      01772000
                                                                        01774000
    PARAMETER        DEFAULT VALUES                                     01776000
                                                                        01778000
    password         No password                                        01780000
                                                                        01782000
    filespace        Unlimited                                          01784000
                                                                        01786000
    cpu              Unlimited                                          01788000
                                                                        01790000
    connect          Unlimited                                          01792000
                                                                        01794000
    capabilitylist   AM, AL, GL, SF, ND, IA, BA                         01796000
\stophelp                                                               01798000
                                                                        01800000
                     SM, AM, AL, GL, DI, OP, SF, ND, PH, DS, MR, PM, IA,01802000
\starthelp                                                              01804000
                                                                        01806000
    fileaccess       R, A, W, L, X: AC  (All accounts except SYS)       01808000
                                                                        01810000
                     R, X: ANY; A, W, L: AC  (SYS account only)         01812000
                                                                        01814000
    subqueuename     CS subqueue                                        01816000
                                                                        01818000
    localattribute   Double-word 0 (null)                               01820000
                                                                        01822000
When removing a capability and/or a local attribute from an account,    01824000
all groups and users within the account will automatically lose that    01826000
same capability/attribute.  However, the system will ensure that any    01828000
user with Account Manager capability will always have at least one      01830000
of the logon capabilities, i.e. IA or BA.                               01832000
                                                                        01834000
When changing one capability in a <capabilitylist> presently containing 01836000
several non-default values, you must re-specify the entire new <capabil-01838000
itylist>, not just the changed parameter.                               01840000
\starthelp                                                              01842000
                                                                        01844000
Any value changed through the :ALTACCT command becomes effective the    01846000
next time MPE is requested to check this value; if an attribute is taken01848000
away from an account, users of this account currently running with that 01850000
attribute will retain it until again logging on.  For this reason, it is01852000
recommended that all account users be advised of all changes in advance.01854000
                                                                        01856000
\ITEM=EXAMPLE                                                           01858000
EXAMPLE                                                                 01860000
                                                                        01862000
To change an account named AC2 so that its password is GLOBALX and its  01864000
<filespace> is limited to 50,000 sectors, enter:                        01866000
                                                                        01868000
    :ALTACCT AC2;PASS=GLOBALX;FILES=50000                               01870000
\ENTRY=ALTGROUP,PARMS,OPERATION,EXAMPLE                                 01872000
                                                                        01874000
                                                                        01876000
    :ALTGROUP (Account Manager capability required)                     01878000
                                                                        01880000
Changes one or more attributes of a group.                              01882000
                                                                        01884000
                                                                        01886000
SYNTAX                                                                  01888000
                                                                        01890000
    :ALTGROUP groupname                                                 01892000
              [;PASS=[password]]                                        01894000
              [;CAP=[capabilitylist]]                                   01896000
              [;FILES=[filespace]]                                      01898000
              [;CPU=[cpu]]                                              01900000
              [;CONNECT=[connect]]                                      01902000
              [;ACCESS=[fileaccess]]                                    01904000
                             SPAN                                       01906000
              [;VS=[volset[:{    }]]]                                   01908000
                             ALT                                        01910000
                                                                        01912000
\ITEM=PARMS                                                             01914000
PARAMETERS                                                              01916000
                                                                        01918000
groupname        Specifies the name of the group whose attributes are to01920000
                 be changed.  (REQUIRED PARAMETER)                      01922000
                                                                        01924000
password         The new password to be assigned to the group. (This    01926000
                 password is used to verify logon access only.)  If     01928000
                 omitted, any existing password is removed.             01930000
                                                                        01932000
capabilitylist   Specifies the list of capabilities permitted this      01934000
                 group.  Each capability is denoted by a two-letter     01936000
                 mnemonic, as follows:                                  01938000
                                                                        01940000
                 Process Handling        = PH                           01942000
                 Extra Data Segments     = DS                           01944000
                 Multiple RINs           = MR                           01946000
                 Privileged Mode         = PM                           01948000
                 Interactive Access      = IA                           01950000
                 Local Batch Access      = BA                           01952000
                                                                        01954000
                 Two or more capabilities may be specified if they are  01956000
                 separated by commas.                                   01958000
                                                                        01960000
                 Default is IA, BA.                                     01962000
                                                                        01964000
filespace        Disc storage limit, in sectors, for the permanent files01966000
                 of the group.  A group's <filespace> cannot be         01968000
                 specified as greater than the corresponding limits     01970000
                 currently defined for the group's account, nor can it  01972000
                 be changed to be less than the number of sectors       01974000
                 currently allocated for the group. However, an         01976000
                 account's <filespace> can later be changed so that some01978000
                 of its groups are left with limits that exceed the new 01980000
                 account limits.  Default is unlimited file space.      01982000
                                                                        01984000
cpu              The limit on total cpu time, in seconds, for the group.01986000
                 This limit is checked only when a job or session is    01988000
                 initiated -- thus, the limit never causes a job/session01990000
                 to abort.  The maximum value permitted is 2,147,483,64701992000
                 seconds. A group's cpu limit cannot be specified as    01994000
                 greater than the corresponding limit currently defined 01996000
                 for the group's account.  However, an account's cpu    01998000
                 limit can be changed later so that some of its groups  02000000
                 are left with a limit that exceeds the new account     02002000
                 limits.  Default is unlimited cpu time.                02004000
                                                                        02006000
connect          The limit on total session connect time, in minutes,   02008000
                 allowed the group.  This limit is checked only at log  02010000
                 on time. The maximum value allowed is 2,147,483,647    02012000
                 minutes.  A group's connect limit cannot be specified  02014000
                 as greater than the corresponding limit currently      02016000
                 defined for the group's account.  However, an account's02018000
                 connect limit can be changed later so that some of its 02020000
                 groups are left with a limit that exceeds the new      02022000
                 account limits.  Default is unlimited connect time.    02024000
                                                                        02026000
fileaccess       File security specifications, entered as follows:      02028000
                                                                        02030000
                  R     ANY                                             02032000
                  L     AC                                              02034000
                 {A} : {GU }                                            02036000
                  W     AL                                              02038000
                  X     GL                                              02040000
                  S                                                     02042000
                                                                        02044000
                 where R, L, A, W, X, S specify modes of access by types02046000
                 of users (ANY, AC, GU, AL, GL) as follows:             02048000
                                                                        02050000
                 R = Read                                               02052000
                 L = Lock (allows exclusive access to file)             02054000
                 A = Append (implicitly specifies L also)               02056000
                 W = Write (implicitly specifies A and L also)          02058000
                 X = Execute                                            02060000
                 S = Save                                               02062000
                                                                        02064000
                 Two or more modes may be specified if they are         02066000
                 separated by commas.                                   02068000
                                                                        02070000
                 The user types are specified as follows:               02072000
                                                                        02074000
                 ANY = Any user                                         02076000
                 AC  = Member of this account only                      02078000
                 GU  = Member of this group only                        02080000
                 AL  = Account librarian user only                      02082000
                 GL  = Group librarian user only                        02084000
\starthelp                                                              02086000
                                                                        02088000
                 Two or more user types may be specified if they are    02090000
                 separated by commas.                                   02092000
                                                                        02094000
                 Default is R, A, W, L, X, S : GU (all groups except    02096000
                 PUB); or R, X : ANY; A, W, L, S : AL, GU (PUB group    02098000
                 only).                                                 02100000
                                                                        02102000
volset:SPAN      Volset is a volume set or class reference which, when  02104000
                 fully qualified, is in the form                        02106000
                                                                        02108000
                 vcsid.groupname.acctname                               02110000
                                                                        02112000
                 where vcsid refers to a previously-defined volume set  02114000
                 or class definition.                                   02116000
                                                                        02118000
                 If volset is different from the old volume set, and the02120000
                 old volume set is the system set, then the old volume  02122000
                 set must be examined for the presence of files         02124000
                 belonging to groupname.  If no such files are found,   02126000
                 the command will succeed, and the group is reassigned  02128000
                 to volset as its new home volume set.                  02130000
                                                                        02132000
                 If volset is omitted from the VS= parameter, the group 02134000
                 will be reassigned to the system volume set.  If the   02136000
                 old volume set already is the system volume set and    02138000
                 contains files belonging to groupname, the command     02140000
                 will fail (that is, nothing is altered).               02142000
                                                                        02144000
                 It is permissible to reassign a group to a different   02146000
                 volume set regardless of the presence of files         02148000
                 belonging to groupname, so long as the old volume set  02150000
                 is not the system volume set and that groupname is not 02152000
                 currently bound (either explicitly via the MOUNT       02154000
                 command or implicitly via the FOPEN intrinsic) to its  02156000
                 home volume set.                                       02158000
                                                                        02160000
                 SPAN indicates that groupname is to be inserted in     02162000
                 the accounting directory of the specified volume       02164000
                 set (volset).  The specified volume set must have      02166000
                 been previously mounted (via the MOUNT command) for    02168000
                 the span operation to succeed.                         02170000
                                                                        02172000
volset:ALT       ALT directs the altering of an account or group entry  02174000
                 on the specified volume set.  ALT is useful only if it 02176000
                 is necessary to alter account and group file space     02178000
                 limits for entries that have already been spanned.     02180000
                                                                        02182000
\ITEM=OPERATION                                                         02184000
OPERATION                                                               02186000
                                                                        02188000
(Account Manager capability required)                                   02190000
This command changes one or more attributes of a group.  When an entire 02192000
parameter is omitted from an :ALTGROUP command, the corresponding value 02194000
for the group remains unchanged.  When a keyword is included but the    02196000
corresponding parameter is omitted (as in ;PASS=), the default value is 02198000
assigned as follows:                                                    02200000
                                                                        02202000
    PARAMETER       DEFAULT                                             02204000
                                                                        02206000
    password        Null (no password)                                  02208000
                                                                        02210000
    capabilitylist  IA, BA                                              02212000
                                                                        02214000
    filespace       Unlimited                                           02216000
                                                                        02218000
    cpu             Unlimited                                           02220000
                                                                        02222000
    connect         Unlimited                                           02224000
                                                                        02226000
    fileaccess      R, A, W, L, X, S: GU  (All groups except PUB)       02228000
                                                                        02230000
                    R, X: ANY; A, W, L, S: AL, GU (PUB group only)      02232000
                                                                        02234000
When a parameter is modified through :ALTGROUP, it immediately takes    02236000
effect in the directory but does not apply to current accesses under the02238000
group; thus, if an attribute is taken away from a group, users of the   02240000
group currently running with that attribute retain it until again       02242000
logging on.  For this reason, it is recommended that all group users be 02244000
advised of the change in advance.                                       02246000
                                                                        02248000
\ITEM=EXAMPLE                                                           02250000
EXAMPLE                                                                 02252000
                                                                        02254000
To assign a new password of PASS2 to a group named GROUPX, enter:       02256000
                                                                        02258000
    :ALTGROUP GROUPX;PASS=PASS2                                         02260000
                                                                        02262000
                                                                        02264000
\ENTRY=ALTJOB,PARMS,OPERATION,EXAMPLE                                   02266000
     :ALTJOB                                                            02268000
                                                                        02270000
Alters attributes of waiting jobs.                                      02272000
                                                                        02274000
SYNTAX                                                                  02276000
              #Jnnn                                                     02278000
     :ALTJOB {     }                                                    02280000
              #Snnn                                                     02282000
             [;INPRI=inputpriority]                                     02284000
                       ldn                                              02286000
             [;OUTDEV={        }]                                       02288000
                       devclass                                         02290000
                                                                        02292000
\ITEM=PARMS                                                             02294000
PARAMETERS                                                              02296000
                                                                        02298000
#Jnnn     A job number.                                                 02300000
                                                                        02302000
#Snnn     A session number.  (Although syntactically correct, this      02304000
          parameter is rarely used; sessions do not wait.)              02306000
                                                                        02308000
INPRI     Specifies the new input priority (1=lowest;13=highest).       02310000
                                                                        02312000
OUTDEV    Specifies the logical device number or device class name      02314000
          of the device file`s destination device.  (Optional           02316000
          parameter.)                                                   02318000
                                                                        02320000
\ITEM=OPERATION                                                         02322000
OPERATION                                                               02324000
                                                                        02326000
Only jobs in the introduced or WAITing state can be altered.            02328000
                                                                        02330000
Jobs with input priority less than or equal to the current jobfence,    02332000
which consists of a numerical value from 0 to 14, will be deferred.     02334000
                                                                        02336000
The :ALTJOB command in conjunction with the :JOBFENCE command allows    02338000
you to control the flow of all non-HIPRI jobs on the system.            02340000
                                                                        02342000
\ITEM=EXAMPLE                                                           02344000
                                                                        02346000
EXAMPLES                                                                02348000
                                                                        02350000
Three jobs are submitted by a user.  All jobs have an INPRI value       02352000
of 8.  To change the INPRI values of the user jobs to insure that       02354000
JOB1 runs first, JOB2 runs last, and JOB3 runs second with LP           02356000
allocated to the OUTDEV for JOB3, enter the following commands:         02358000
                                                                        02360000
:JOBFENCE 14                                                            02362000
15:11/#J4/24/DEFERRED JOB INTRODUCED ON LDEV #10                        02364000
15:11/#J5/25/DEFERRED JOB INTRODUCED ON LDEV #10                        02366000
15:13/#J6/26/DEFERRED JOB INTRODUCED ON LDEV #10                        02368000
:SHOWJOB                                                                02370000
                                                                        02372000
JOBNUM  STATE  IPRI  JIN  JLIST   INTRODUCED   JOB  NAME                02374000
                                                                        02376000
#S23    EXEC         20   20      THU  2:15P   FIELD.SUPPORT            02378000
#J4     WAIT    D 8  10S  12      THU  3:11P   JOB2,FIELD.SUPPORT       02380000
#J5     WAIT    D 8  10S  12      THU  3:11P   JOB3,FIELD.SUPPORT       02382000
#J6     WAIT    D 8  10S  12      THU  3:13P   JOB1,FIELD.SUPPORT       02384000
                                                                        02386000
4 JOBS:                                                                 02388000
  0 INTRO                                                               02390000
  3 WAIT; INCL 3 DEFERRED                                               02392000
  1 EXEC; INCL 1 SESSIONS                                               02394000
  0 SUSP                                                                02396000
JOBFENCE= 14; JLIMIT= 5; SLIMIT= 16                                     02398000
                                                                        02400000
:ALTJOB #J6; INPRI=12                                                   02402000
15:15/#J6/26/DEFERRED JOB INTRODUCED ON LDEV #10                        02404000
:ALTJOB #J5;INPRI=11;OUTDEV=LP                                          02406000
15:16/#J5/25/DEFERRED JOB INTRODUCED ON LDEV #10                        02408000
:ALTJOB #J4;INPRI=9                                                     02410000
15:17/#J4/24/DEFERRED JOB INTRODUCED ON LDEV #10                        02412000
:SHOWJOB                                                                02414000
                                                                        02416000
JOBNUM  STATE  IPRI  JIN  JLIST   INTRODUCED   JOB  NAME                02418000
#S23    EXEC          20  20      THU  2:15    FIELD.SUPPORT            02420000
#J6     WAIT    D12   10S 12      THU  3:13P   JOB1,FIELD.SUPPORT       02422000
#J5     WAIT    D11   10S LP      THU  3:11P   JOB3,FIELD.SUPPORT       02424000
#J4     WAIT    D 9   10S 12      THU  3:11P   JOB2,FIELD.SUPPORT       02426000
                                                                        02428000
4 JOBS:                                                                 02430000
   0 INTRO                                                              02432000
   3 WAIT; INCL  3 DEFERRED                                             02434000
   1 EXEC; INCL  1 SESSIONS                                             02436000
   0 SUSP                                                               02438000
JOBFENCE= 14; JLIMIT= 5; SLIMIT=16                                      02440000
                                                                        02442000
:LIMIT 1,16                                                             02444000
:JOBFENCE 0                                                             02446000
                                                                        02448000
\ENTRY=ALTLOG,PARMS,OPERATION,EXAMPLE                                   02450000
     :ALTLOG                                                            02452000
                                                                        02454000
Alters the attributes of an existing logging identifier.                02456000
SYNTAX                                                                  02458000
                                                                        02460000
                            ,DISC                                       02462000
:ALTLOG logid [;LOG=logfile{     }][;PASS=password]                     02464000
                            ,TAPE                                       02466000
                                                                        02468000
\ITEM=PARMS                                                             02470000
PARAMETERS                                                              02472000
                                                                        02474000
logid          The logging identifier containing from 1 to 8            02476000
               alphanumeric characters whose attributes are to          02478000
               be changed, (REQUIRED PARAMETER).                        02480000
                                                                        02482000
logfile        The new destination file name for the logfile.           02484000
               Must be specified as residing on tape or disc.           02486000
                                                                        02488000
password       The new password containing from 1 to 8 alpha-           02490000
               numeric characters for the logging identifier.           02492000
\STARTHELP                                                              02494000
                                                                        02496000
\ITEM=OPERATION                                                         02498000
OPERATION                                                               02500000
                                                                        02502000
Changes the attributes of an existing logging identifier to those       02504000
specified in the parameter list.  Parameters not included in the        02506000
:ALTLOG command retain their current values.  This command can          02508000
be used only by the creator of the logging identifier.                  02510000
                                                                        02512000
\ITEM=EXAMPLE                                                           02514000
EXAMPLE                                                                 02516000
                                                                        02518000
To change the destination logfile of the logging identifier             02520000
DATALOG to FILEX, and specify that FILEX reside on tape, enter:         02522000
     :ALTLOG DATALOG;LOG=FILEX,TAPE                                     02524000
                                                                        02526000
Since the ;PASS parameter was not included, DATALOG retains             02528000
the password previously specified.                                      02530000
\ENTRY=ALTSEC,PARMS,OPERATION,EXAMPLE                                   02532000
    :ALTSEC                                                             02534000
                                                                        02536000
Permanently changes file's security provisions.                         02538000
                                                                        02540000
SYNTAX                                                                  02542000
                                                                        02544000
    :ALTSEC filereference[;([fileaccess                                 02546000
            [;[fileaccess[;. . .]]])]                                   02548000
                                                                        02550000
\ITEM=PARMS                                                             02552000
PARAMETERS                                                              02554000
                                                                        02556000
filereference        Actual designator of the file whose security       02558000
                     provisions are to be altered, written in the       02560000
                     format:                                            02562000
                                                                        02564000
                     filename[/lockword][.groupname[.accountname]]      02566000
                                                                        02568000
                     The lockword, if any, must be specified. (REQUIRED 02570000
                     PARAMETER)                                         02572000
                                                                        02574000
fileaccess           File security specifications, entered as follows:  02576000
                                                                        02578000
                      R     ANY                                         02580000
                      L     AC                                          02582000
                     {A} : {GU }                                        02584000
                      W     AL                                          02586000
                      X     GL                                          02588000
                            CR                                          02590000
                                                                        02592000
                     where R, L, A, W, X specify modes of access by     02594000
                     types of users (ANY, AC, GU, AL, GL, CR) as        02596000
                     follows:                                           02598000
                                                                        02600000
                     R = Read                                           02602000
                     L = Lock (allows opening with dynamic locking      02604000
                         option)                                        02606000
                     A = Append (implicitly specifies L also)           02608000
                     W = Write (implicitly specifies A and L also       02610000
                     X = Execute                                        02612000
                                                                        02614000
                     Two or more modes may be specified if they are     02616000
                     separated by commas.                               02618000
                     The user types are specified as follows:           02620000
                                                                        02622000
                     ANY = Any user                                     02624000
                     AC  = Member of this account only                  02626000
                     GU  = Member of this group only                    02628000
                     AL  = Account librarian user only                  02630000
                     GL  = Group librarian user only                    02632000
                     CR  = Creating user only                           02634000
                                                                        02636000
                     Two or more user types may be specified if they are02638000
                     separated by commas.                               02640000
                                                                        02642000
                     Default is R, A, W, L, X: ANY                      02644000
\stophelp                                                               02646000
\starthelp                                                              02648000
                                                                        02650000
\ITEM=OPERATION                                                         02652000
OPERATION                                                               02654000
                                                                        02656000
Permanently deletes all security provisions for a file at the file      02658000
level, and replaces them as specified by the <fileaccess> parameter.    02660000
Does not affect account and group level security provisions or file     02662000
lockword.  This command can be issued only by the creator of the file.  02664000
                                                                        02666000
Note that you can only use this command for a permanent disc file that  02668000
you have created, and that this command will fail if the group's home   02670000
volume set is not mounted.  When the normal (default) MPE security      02672000
provisions are in effect, the file must be in your logon account and    02674000
must belong to your logon or home group.                                02676000
                                                                        02678000
Even though you may be barred by <fileaccess> restrictions from         02680000
accessing a file that you have created, you still can issue an :ALTSEC  02682000
command for that file.  Thus, you can change the security provisions to 02684000
allow yourself access to it.                                            02686000
                                                                        02688000
\ITEM=EXAMPLE                                                           02690000
EXAMPLE                                                                 02692000
                                                                        02694000
You have created a file named FDATA and you wish to change its security 02696000
provisions to allow write access to yourself only.  Enter:              02698000
                                                                        02700000
    :ALTSEC FDATA;(W:CR)                                                02702000
                                                                        02704000
To change the security provisions for a program file (FPROG) so that any02706000
group user can execute the program but only account and group librarian 02708000
users can read or write on the file, enter:                             02710000
                                                                        02712000
    :ALTSEC FPROG;(X:GU;R,W:AL,GL)                                      02714000
                                                                        02716000
                                                                        02718000
\ENTRY=ALTSPOOLFILE,PARMS,OPERATION,EXAMPLE                             02720000
     :ALTSPOOLFILE                                                      02722000
                                                                        02724000
Alters the characteristics of an active or ready spoolfile.             02726000
                                                                        02728000
SYNTAX                                                                  02730000
                                                                        02732000
                           [;PRI=outpriority ]                          02734000
                   {#Onnn} [;COPIES=numcopies]                          02736000
     :ALTSPOOLFILE {ldn1 } [;DEV={ldn2    }  ]                          02738000
                           [     {devclass}  ]                          02740000
                           [;DEFER           ]                          02742000
                                                                        02744000
\ITEM=PARMS                                                             02746000
PARAMETERS                                                              02748000
                                                                        02750000
#Onnn          The output devicefile identification.                    02752000
ldn1           The logical device of an active spoolfile.               02754000
ldn2           The logical device number of the device for which        02756000
               the spooled file is being altered.                       02758000
                                                                        02760000
PRI            Specifies the output priority of the designated          02762000
               devicefile (0=lowest; 14=highest).                       02764000
                                                                        02766000
COPIES         Specifies the number of copies to be produced from       02768000
               the designated devicefile.                               02770000
                                                                        02772000
DEV            Specifies the logical device number or device class      02774000
               name of the devicefile's destination device.             02776000
                                                                        02778000
DEFER          Results in the output priority of the currently          02780000
               active spooled device file being changed immediately     02782000
               to 0 and the file being returned to ready state,         02784000
               thus deferring the file.                                 02786000
                                                                        02788000
\ITEM=OPERATION                                                         02790000
OPERATION                                                               02792000
                                                                        02794000
Output spooled devicefiles with a priority less than or equal to        02796000
the current output fence will not be selected (they will be deferred)   02798000
for spooling.                                                           02800000
                                                                        02802000
Before using the DEFER option parameters it is desirable to physically  02804000
stop the output device first.  This allows you time to enter the        02806000
command and to ascertain that the currently ACTIVE spooled file         02808000
corresponds to the devicefile physically being output.                  02810000
                                                                        02812000
                           NOTE                                         02814000
                                                                        02816000
             If you stop the device before entering                     02818000
             the command, you must return the device to                 02820000
             the on-line state before the command can                   02822000
             be physically executed.                                    02824000
                                                                        02826000
\ITEM=EXAMPLE                                                           02828000
EXAMPLES                                                                02830000
To defer the currently active spooled file being output to logical      02832000
device 6 (a line printer), first stop the device, then enter:           02834000
                                                                        02836000
     :ALTSPOOLFILE 6;DEFER                                              02838000
                                                                        02840000
                           NOTE                                         02842000
                                                                        02844000
             The DEFER optional parameter places the                    02846000
             currently ACTIVE output spooled file in                    02848000
             the READY state, and in addition lowers                    02850000
             the outputpriority to 0 (lowest priority).                 02852000
             Action by you is required to raise the                     02854000
             outputpriority of the DEFERed file.                        02856000
                                                                        02858000
To display and then change the priority of deferred devicefile #O---    02860000
from 0 to 3, enter:                                                     02862000
                                                                        02864000
     :SHOWOUT SP                                                        02866000
                                                                        02868000
                                                                        02870000
 DEV/CL   DFID    JOBNUM  FNAME    STATE FRM SPACE RANK PRI #C          02872000
 LP       #O930   #S507   TEPELIST READY       384  1    8   1          02874000
                                                                        02876000
                                                                        02878000
     :ALTSPOOLFILE #O930;PRI=3                                          02880000
                                                                        02882000
                                                                        02884000
\ENTRY=ALTUSER,PARMS,OPERATION,EXAMPLE                                  02886000
    :ALTUSER (Account Manager capability required)                      02888000
                                                                        02890000
Alters attributes currently defined for a user.                         02892000
                                                                        02894000
SYNTAX                                                                  02896000
                                                                        02898000
    :ALTUSER username                                                   02900000
             [;PASS=[password]]                                         02902000
             [;CAP=[capabilitylist]]                                    02904000
             [;MAXPRI=[subqueuename]]                                   02906000
             [;LOCATTR=[localattribute]]                                02908000
             [;HOME=[homegroupname]]                                    02910000
                                                                        02912000
\ITEM=PARMS                                                             02914000
PARAMETERS                                                              02916000
                                                                        02918000
username             The name assigned to the user (with the :NEWUSER   02920000
                     command or the first user assigned with a :NEWACCT 02922000
                     command).  (REQUIRED PARAMETER)                    02924000
                                                                        02926000
password             The new password to be assigned to the user. If    02928000
                     omitted, any existing password is removed.         02930000
                                                                        02932000
capabilitylist       List of capabilities, mutually separated by commas,02934000
                     permitted this account.  Each capability is denoted02936000
                     by a two-letter mnemonic, as follows:              02938000
                                                                        02940000
                     System Manager          = SM                       02942000
                     Account Manager         = AM                       02944000
                     Account Librarian       = AL                       02946000
                     Group Librarian         = GL                       02948000
                     Diagnostician           = DI                       02950000
                     System Supervisor       = OP                       02952000
                                                                        02954000
                     Permanent Files         = SF                       02956000
                     Access of non-sharable                             02958000
                     I/O devices             = ND                       02960000
                     Create Volumes          = CV                       02962000
                     Use Volumes             = UV                       02964000
                                                                        02966000
                     Process Handling        = PH                       02968000
                     Extra Data Segments     = DS                       02970000
                     Multiple RINS           = MR                       02972000
                     Privileged Mode         = PM                       02974000
                     Interactive Access      = IA                       02976000
                     Local Batch Access      = BA                       02978000
                     User Logging            = LG                       02980000
                     Default is SF, ND, IA, BA.                         02982000
                                                                        02984000
subqueuename         The name of the subqueue of highest priority that  02986000
                     can be requested by any process of any job/session 02988000
                     in the account, specified as xS, where x is A, B,  02990000
                     C, D, or E.                                        02992000
                                                                        02994000
                     The priority specified with the :ALTUSER command   02996000
                     cannot be greater than that specified with the     02998000
                     :NEWACCT or :ALTACCT commands.  (But, if the user's03000000
                     account is altered later, he may be left with      03002000
                     excessive limits.)  The <subqueuename> defined for 03004000
                     the user is checked against the <subqueuename>     03006000
                     defined for his account at logon time, and the     03008000
                     lower priority of the two is used as the maximum   03010000
                     priority restricting all processes of the          03012000
                     job/session. Also, the priority requested by the   03014000
                     user when he logs on is checked against the        03016000
                     <subqueuename> defined for him, and he is granted  03018000
                     the lower of these two values.  Default is CS.     03020000
                                                                        03022000
localattribute       The local attribute of the user, as defined at the 03024000
                     installation site.  This is a double-word of       03026000
                     arbitrary meaning which might be used to further   03028000
                     classify users.  While it is not involved in       03030000
                     standard MPE security provisions, it is available  03032000
                     to processes through the WHO intrinsic for use in  03034000
                     the programmer's own security provisions.  Default 03036000
                     is double-word 0 (null).                           03038000
                                                                        03040000
homegroupname        The name of an existing group to be assigned as the03042000
                     homegroup for this user.  Default is no homegroup. 03044000
                                                                        03046000
\ITEM=OPERATION                                                         03048000
OPERATION                                                               03050000
                                                                        03052000
(Account Manager capability required)                                   03054000
This command alters the attributes currently defined for a user.        03056000
                                                                        03058000
When an entire keyword parameter group is omitted from the :ALTUSER     03060000
command, the corresponding value for this user remains unchanged. When a03062000
keyword is included but the corresponding parameter is omitted (as in   03064000
;PASS=), a default value is assigned as follows:                        03066000
                                                                        03068000
    PARAMETER          DEFAULT VALUE                                    03070000
                                                                        03072000
    password           Null (no password)                               03074000
                                                                        03076000
    capabilitylist     SF, ND, IA, BA (provided the account has these   03078000
                       capabilities)                                    03080000
                                                                        03082000
    subqueuename       CS                                               03084000
                                                                        03086000
    localattribute     Null (double-word 0)                             03088000
                                                                        03090000
    homegroupname      None (no home group).  If a user has no homegroup03092000
                       assigned, he must specify a logon group when     03094000
                       initiating a job or session.                     03096000
                                                                        03098000
When a parameter is modified with the :ALTUSER command, it takes effect 03100000
immediately in the directory, but does not apply to users currently     03102000
logged on; it will take effect for the next log on by such users.  For  03104000
this reason, it is recommended that the users involved be advised of the03106000
change in advance.  It is not recommended that the capabilitylist or    03108000
homegroupname of the MANAGER.SYS user be altered.                       03110000
                                                                        03112000
\ITEM=EXAMPLE                                                           03114000
EXAMPLE                                                                 03116000
                                                                        03118000
Suppose an account's capabilities are AM, AL, GL, SF, ND, PH, DS, MR,   03120000
IA, BA.  To change the <capabilitylist> of the user JONES from IA, BA,  03122000
SF, PH, DS to include the Multiple RIN capability (MR), enter:          03124000
                                                                        03126000
    :ALTUSER JONES;CAP=IA,BA,SF,PH,DS,MR                                03128000
                                                                        03130000
                                                                        03132000
\ENTRY=ALTVSET,PARMS,OPERATION,EXAMPLE                                  03134000
    :ALTVSET                                                            03136000
                                                                        03138000
(System Manager, or Account Manager with Volume Set Creation (CV)       03140000
capability required)                                                    03142000
                                                                        03144000
Modifies volume set definitions.                                        03146000
                                                                        03148000
SYNTAX                                                                  03150000
                                                                        03152000
    :ALTVSET vsname                                                     03154000
             [;ADDCLASS=vcname:vname[,vname],...[,vname]]               03156000
             [;EXPANDCLASS=vcname:vname[,vname],...[,vname]]            03158000
             [;EXPANDSET=vname:type[,vname:type],...[vname:type]]       03160000
                                                                        03162000
\ITEM=PARMS                                                             03164000
PARAMETERS                                                              03166000
                                                                        03168000
vsname             Existing volume set name.  MPE will implicitly       03170000
                   reference <vsname> as <vsname.groupname.acctname>,   03172000
                   where <groupname> and <acctname> are the logon group 03174000
                   and account.  (REQUIRED PARAMETER)                   03176000
                                                                        03178000
vcname:vname       Volume class name, consisting of up to eight         03180000
                   alphanumeric characters, beginning with a letter.    03182000
                   Each volume class consists of a volume class name and03184000
                   an associated list of volume names <vname>. The list 03186000
                   of volume names must be a subset of the volumes      03188000
                   comprising the volume set, and one of the volume     03190000
                   names must be that of the volume set's master volume.03192000
                                                                        03194000
;ADDCLASS          Add a volume class and an associated list of volume  03196000
                   names.  The list of volume names must be a subset of 03198000
                   the volumes comprising the volume set and one of the 03200000
                   volume names must be that of the volume set's master 03202000
                   volume.                                              03204000
                                                                        03206000
;EXPANDCLASS       Add names of new members in the volume class.  These 03208000
                   new members can only be members of already existing  03210000
                   classes of the parent volume set.                    03212000
                                                                        03214000
;EXPANDSET         Add names of new members in the volume set and types 03216000
                   of devices required to accomodte the new members.    03218000
                   Total members in a volume set may not exceed eight.  03220000
                   The <type> must be specified with each volume member 03222000
                   name to define the type of disc drive.  Types of disc03224000
                   drives that may be specified are HP7905, HP7906,     03226000
                   HP7920, and HP7925.                                  03228000
                                                                        03230000
\ITEM=OPERATION                                                         03232000
OPERATION                                                               03234000
                                                                        03236000
(System Manager, or Account Manager with Volume Set Creation (CV)       03238000
capability required)                                                    03240000
                                                                        03242000
The :ALTVSET command is used to modify volume set definitions.  Volume  03244000
class names can be added or deleted, and the number of member volumes   03246000
can be increased.  The overall size of the volume set, however, cannot  03248000
be decreased (member volumes cannot be deleted; deleting a volume class 03250000
does not delete the volumes in that class).                             03252000
                                                                        03254000
\ITEM=EXAMPLE                                                           03256000
EXAMPLE                                                                 03258000
                                                                        03260000
To add member volumes MEM3 and MEM4 to the existing volume set USERSET, 03262000
enter:                                                                  03264000
                                                                        03266000
    :ALTVSET USERSET;ADDVOL MEM3:HP7920,MEM4:HP7920                     03268000
\ENTRY=APL,PARMS,OPERATION,EXAMPLE                                      03270000
    :APL                                                                03272000
                                                                        03274000
Accesses APL subsystem.                                                 03276000
                                                                        03278000
SYNTAX                                                                  03280000
                                                                        03282000
    :APL                                                                03284000
                                                                        03286000
\ITEM=PARMS                                                             03288000
PARAMETERS                                                              03290000
                                                                        03292000
None                                                                    03294000
                                                                        03296000
\ITEM=OPERATION                                                         03298000
OPERATION                                                               03300000
                                                                        03302000
Accesses the APL subsystem, which is used to create and execute APL     03304000
programs.                                                               03306000
                                                                        03308000
                                                                        03310000
                           NOTE                                         03312000
                                                                        03314000
      The recommended way of accessing the APL subsystem from           03316000
      terminals equipped with the APL character set is through          03318000
      the command log on.  The unusual APL character set and its        03320000
      resultant coding causes unreadable logon and logoff               03322000
      messages when the :HELLO and :BYE commands are used at APL        03324000
      terminals.                                                        03326000
                                                                        03328000
\ITEM=EXAMPLE                                                           03330000
EXAMPLE                                                                 03332000
                                                                        03334000
    :(APL) MAC.TECHPUBS                                                 03336000
\ENTRY=ASSOCIATE,EXAMPLE                                                03338000
     :ASSOCIATE                                                         03340000
                                                                        03342000
Gives a user operator control of a device.                              03344000
                                                                        03346000
SYNTAX                                                                  03348000
                                                                        03350000
     :ASSOCIATE devclass                                                03352000
                                                                        03354000
\ITEM=PARMS                                                             03356000
                                                                        03358000
PARAMETERS                                                              03360000
                                                                        03362000
devclass        The device class specified during SYSDUMP.              03364000
                                                                        03366000
\ITEM=OPERATION                                                         03368000
OPERATION                                                               03370000
                                                                        03372000
The :ASSOCIATE command allows a user to use any operator command        03374000
dealing with a specific device class.  Once this occurs, the            03376000
associated user receives device status messages relating to             03378000
that device.  The device messages no longer go to the system            03380000
console; they go to the terminal of the associated user.                03382000
However, the messages are still logged in the console log               03384000
file if enabled. When a user :ASSOCIATEs a device the operator is       03386000
notified; and if the operator attempts to control an ASSOCIATEd         03388000
device, the operator is notified that the device is ASSOCIATEd          03390000
and who the user in control is.  At this point, the operator is         03392000
asked whether he wants to continue with the operation.                  03394000
                                                                        03396000
Associations continue until the original user in control of the         03398000
device or the operator explicitly DISASSOCIATEs (gives control          03400000
to) the device, or when the user in control logs off.                   03402000
                                                                        03404000
                              NOTE                                      03406000
In order for a user to use the :ASSOCIATE command, the System           03408000
Manager must create a device-user association table.  This              03410000
table is created by running the ASOCTABL utility.  (Refer to the        03412000
System Utilities Reference Manual).                                     03414000
                                                                        03416000
\ITEM=EXAMPLE                                                           03418000
EXAMPLES                                                                03420000
                                                                        03422000
To be the controller of deviceclass TAPE, enter:                        03424000
                                                                        03426000
     :ASSOCIATE TAPE                                                    03428000
                                                                        03430000
\ENTRY=BASIC,PARMS,OPERATION,EXAMPLE                                    03432000
    :BASIC                                                              03434000
                                                                        03436000
Interprets a BASIC program.                                             03438000
                                                                        03440000
SYNTAX                                                                  03442000
                                                                        03444000
    :BASIC [commandfile][,[inputfile][,listfile]]                       03446000
                                                                        03448000
\ITEM=PARMS                                                             03450000
PARAMETERS                                                              03452000
                                                                        03454000
commandfile          Actual designator of source file (device) from     03456000
                     which BASIC commands and statements are input.  Can03458000
                     be any ASCII input file. Formal designator is      03460000
                     BASCOM.  Default is $STDINX.                       03462000
                                                                        03464000
inputfile            Actual designator of file containing data input for03466000
                     BASIC program.  Can be any ASCII input file. Formal03468000
                     designator is BASIN. Default is $STDINX.           03470000
                                                                        03472000
listfile             Actual designator of destination file for program  03474000
                     listing and output.  Can be any ASCII output file. 03476000
                     Formal designator is BASLIST.  Default is $STDLIST.03478000
                                                                        03480000
                              NOTE                                      03482000
                                                                        03484000
      The formal file designators used in this command                  03486000
      (BASCOM, BASIN, BASLIST)                                          03488000
      cannot be back referenced as actual file designators              03490000
      in the command parameter list.  For further information,          03492000
      see the discussion of implied :FILE commands in                   03494000
      Section VII of the MPE Commands Reference Manual.                 03496000
                                                                        03498000
\ITEM=OPERATION                                                         03500000
OPERATION                                                               03502000
                                                                        03504000
Generally used for on-line programming in BASIC, but it can also be used03506000
to interpret BASIC programs submitted in batch mode.  In batch mode, the03508000
BASIC >EOD command is required after any data following the BASIC >RUN  03510000
command, or after the >RUN command itself if there is no data.          03512000
                                                                        03514000
\ITEM=EXAMPLE                                                           03516000
EXAMPLE                                                                 03518000
                                                                        03520000
To enter commands and data from your standard input device, with program03522000
listing and output transmitted to the standard output device, enter:    03524000
                                                                        03526000
    :BASIC                                                              03528000
                                                                        03530000
To submit BASIC interpreter commands and statements from the command    03532000
file MYCOMDS, and data from the input file MYDATA, with program listing 03534000
and output written to the list file MYLIST, enter:                      03536000
                                                                        03538000
    :BASIC MYCOMDS,MYDATA,MYLIST                                        03540000
                                                                        03542000
(All three files are disc files.)                                       03544000
                                                                        03546000
Note that input files created on the Editor must be kept with the UNN   03548000
option of the Editor KEEP command.                                      03550000
                                                                        03552000
                                                                        03554000
\ENTRY=BASICGO,PARMS,OPERATION,EXAMPLE                                  03556000
    :BASICGO                                                            03558000
                                                                        03560000
Compiles, prepares, and executes a BASIC program.                       03562000
                                                                        03564000
SYNTAX                                                                  03566000
                                                                        03568000
    :BASICGO [commandfile][,listfile]                                   03570000
                                                                        03572000
\ITEM=PARMS                                                             03574000
PARAMETERS                                                              03576000
                                                                        03578000
commandfile           Actual designator of input file from which BASIC  03580000
                      compiler commands are read.  Can be any ASCII     03582000
                      input file.  Formal designator is BSCTEXT. Default03584000
                      is $STDINX.                                       03586000
                                                                        03588000
listfile              Actual designator of file on which program listing03590000
                      is written.  Can be any ASCII output file.  Formal03592000
                      designator is BSCLIST.  Default is $STDLIST.      03594000
                                                                        03596000
                              NOTE                                      03598000
      The formal file designators used in this command                  03600000
      (BSCTEXT and BSCLIST) cannot be back referenced as                03602000
      actual file designators in the command parameter                  03604000
      list.  For further information, see the discussion                03606000
      of implied :FILE commands in Section VII of the                   03608000
      MPE Commands Reference Manual.                                    03610000
                                                                        03612000
\ITEM=OPERATION                                                         03614000
OPERATION                                                               03616000
                                                                        03618000
Compiles, prepares, and executes a program from a SAVE FAST file        03620000
(created by BASIC interpreter).  This enables the program to run faster 03622000
than it would if executed by the interpreter.  After the program is     03624000
written, it can be saved with the BASIC interpreter command SAVE        03626000
<filename>, FAST.  The program then can be compiled, prepared, and      03628000
executed with the :BASICGO command.                                     03630000
                                                                        03632000
\ITEM=EXAMPLE                                                           03634000
EXAMPLE                                                                 03636000
                                                                        03638000
To compile, prepare, and execute the BASIC program MYPROG, with the     03640000
listing directed to the disc file LISTFL, enter:                        03642000
                                                                        03644000
    :BASICGO ,LISTFL              Calls the BASIC compiler              03646000
                                                                        03648000
    :$CONTROL USLINIT,SOURCE      Initializes USL and requests program  03650000
                                  listing                               03652000
                                                                        03654000
    :COMPILE MYPROG               Compiles program MYPROG               03656000
                                                                        03658000
    $EXIT                         Exits from compiler                   03660000
                                                                        03662000
                                                                        03664000
\ENTRY=BASICOMP,PARMS,OPERATION,EXAMPLE                                 03666000
    :BASICOMP                                                           03668000
                                                                        03670000
Compiles a BASIC program.                                               03672000
                                                                        03674000
SYNTAX                                                                  03676000
                                                                        03678000
    :BASICOMP [commandfile][,[uslfile][,listfile]]                      03680000
                                                                        03682000
\ITEM=PARMS                                                             03684000
PARAMETERS                                                              03686000
                                                                        03688000
commandfile            Actual designator of input file from which       03690000
                       compiler commands are read.  Can be any ASCII    03692000
                       input file.  Formal designator is BSCTEXT.       03694000
                       Default is $STDINX.                              03696000
                                                                        03698000
uslfile                Actual designator of user subprogram library     03700000
                       (USL) file on which compiled object program is   03702000
                       written.  Can be any binary output file with     03704000
                       filecode of USL (or 1024). Formal designator is  03706000
                       BSCUSL. This parameter, if entered, must specify 03708000
                       a file created previously in one of four ways:   03710000
                                                                        03712000
                       1.  By saving a USL file (with the :SAVE command)03714000
                           created by a previous compilation where the  03716000
                           default value was used for the uslfile       03718000
                           parameter.                                   03720000
                                                                        03722000
                       2.  By building the USL with the Segmenter       03724000
                           command -BUILDUSL (see the MPE Segmenter     03726000
                           Reference Manual).                           03728000
                                                                        03730000
                       3.  By creating a new USL file with the MPE      03732000
                           :BUILD command and a filecode parameter of   03734000
                           USL or 1024.                                 03736000
                                                                        03738000
                       4.  By specifying a non-existent <uslfile>       03740000
                           parameter, thereby creating a permanent file 03742000
                           of the correct size and type.                03744000
                                                                        03746000
                       Default is $NEWPASS is assigned.                 03748000
                                                                        03750000
listfile               Actual designator of file on which program       03752000
                       listing is written.  Can be any ASCII output     03754000
                       file.  Formal designator is BSCLIST.  Default is 03756000
                       $STDLIST.                                        03758000
                                                                        03760000
                              NOTE                                      03762000
                                                                        03764000
      The formal file designators used in this command                  03766000
      (BSCTEXT, BSCUSL, BSCLIST)                                        03768000
      cannot be back referenced as actual file designators              03770000
      in the command parameter list.  For further information,          03772000
      see the discussion of implied :FILE commands in                   03774000
      Section VII of the MPE Commands Reference Manual.                 03776000
                                                                        03778000
\ITEM=OPERATION                                                         03780000
OPERATION                                                               03782000
                                                                        03784000
Compiles a program from a SAVE FAST file (created by the BASIC inter-   03786000
preter) onto disc in USL format.  This enables the program to run faster03788000
than it would if left in the form generated by the interpreter.  After  03790000
the program is written, it is stored in a SAVE FAST file with the BASIC 03792000
interpreter command SAVE filename,FAST.  The program then can be        03794000
compiled with the compiler command COMPILE, prepared with the MPE :PREP 03796000
command, and executed with the MPE :RUN command.                        03798000
                                                                        03800000
\ITEM=EXAMPLE                                                           03802000
EXAMPLE                                                                 03804000
                                                                        03806000
To compile the BASIC program MYPROG onto the USL named OBJECT, enter:   03808000
                                                                        03810000
    :BUILD OBJECT;CODE=USL           Builds USL file                    03812000
                                                                        03814000
    :BASICOMP ,OBJECT                Calls BASIC compiler, specifies USL03816000
                                     named OBJECT                       03818000
                                                                        03820000
    $COMPILE MYPROG                  Compiles SAVE FAST program named   03822000
                                     MYPROG                             03824000
                                                                        03826000
    $EXIT                            Exits from compiler                03828000
                                                                        03830000
                                                                        03832000
                                                                        03834000
\ENTRY=BASICPREP,PARMS,OPERATION,EXAMPLE                                03836000
    :BASICPREP                                                          03838000
                                                                        03840000
Compiles and prepares a BASIC program.                                  03842000
                                                                        03844000
SYNTAX                                                                  03846000
                                                                        03848000
    :BASICPREP [commandfile][,[progfile][,listfile]]                    03850000
                                                                        03852000
\ITEM=PARMS                                                             03854000
PARAMETERS                                                              03856000
                                                                        03858000
commandfile           Actual designator of input file from which        03860000
                      compiler commands are read.  Can be any ASCII     03862000
                      file.  Formal designator is BSCTEXT. Default is   03864000
                      $STDINX.                                          03866000
                                                                        03868000
progfile              Actual designator of program file on which        03870000
                      prepared program segments are written.  Can be any03872000
                      binary output file with file code of PROG (or     03874000
                      1029).  This parameter, if entered, must indicate 03876000
                      a file created in one of two ways:                03878000
                                                                        03880000
                      1.  With the MPE :BUILD command using the filecode03882000
                          parameter PROG or 1029, and a numextents      03884000
                          parameter value of 1.                         03886000
                                                                        03888000
                      2.  By specifying a non-existent file in the      03890000
                          progfile parameter, in which case a job       03892000
                          temporary file of the correct size and type is03894000
                          created.                                      03896000
                                                                        03898000
                      Default is $NEWPASS is assigned.                  03900000
                                                                        03902000
listfile              Actual designator of file on which program listing03904000
                      is written.  Can be any ASCII output file.  Formal03906000
                      designator is BSCLIST.  Default is $STDLIST.      03908000
                                                                        03910000
                              NOTE                                      03912000
                                                                        03914000
      The formal file designators used in this command                  03916000
      (BSCTEXT, BSCPROG,BSCLIST) cannot be back                         03918000
      referenced as actual file designators in the                      03920000
      command parameter list.  For further information,                 03922000
      see the discussion of implied :FILE commands in                   03924000
      Section VII of the MPE Commands Reference Manual.                 03926000
                                                                        03928000
\ITEM=OPERATION                                                         03930000
OPERATION                                                               03932000
                                                                        03934000
Compiles and prepares a program from a SAVE FAST file (created by BASIC 03936000
interpreter) into a program file on disc.  This enables the program to  03938000
run considerably faster than it would if executed by the interpreter.   03940000
After the program is written, it can be stored in a SAVE FAST file with 03942000
the BASIC interpreter command SAVE filename,FAST. It then can be        03944000
compiled/prepared with the MPE :BASICPREP command and executed with the 03946000
MPE :RUN command.                                                       03948000
                                                                        03950000
\ITEM=EXAMPLE                                                           03952000
EXAMPLE                                                                 03954000
                                                                        03956000
To compile and prepare a program named MYPROG from the BASIC SAVE FAST  03958000
file named MYCOMDS, with listing directed to the standard list device,  03960000
enter:                                                                  03962000
                                                                        03964000
    :BASICPREP ,MYCOMDS                                                 03966000
                                                                        03968000
The file MYCOMDS is an ASCII file that contains the following BASIC     03970000
compiler commands:                                                      03972000
                                                                        03974000
    $CONTROL USLINIT,SOURCE       Initializes USL and lists program     03976000
                                                                        03978000
    $COMPILE MYPROG               Compiles SAVE FAST program            03980000
                                                                        03982000
    $EXIT                         Exits from compiler                   03984000
                                                                        03986000
                                                                        03988000
\ENTRY=BREAKJOB,PARMS,OPERATION,EXAMPLE                                 03990000
     :BREAKJOB                                                          03992000
                                                                        03994000
Suspends an executing job.                                              03996000
                                                                        03998000
SYNTAX                                                                  04000000
                                                                        04002000
     :BREAKJOB #Jnnn                                                    04004000
                                                                        04006000
\ITEM=PARMS                                                             04008000
PARAMETERS                                                              04010000
                                                                        04012000
#Jnnn          A job number.                                            04014000
                                                                        04016000
\ITEM=OPERATION                                                         04018000
OPERATION                                                               04020000
                                                                        04022000
                                                                        04024000
Any executing job may be suspended, including spooled and streamed      04026000
jobs.  A job that is holding a critical system resource, such as        04028000
a SIR Table (System Internal Resource), will be allowed to continue     04030000
running until it releases the resource at which time it will be         04032000
suspended.                                                              04034000
                                                                        04036000
All commands that normally function on, or pertain to executing jobs,   04038000
such as :ABORTJOB, will be operative on suspended jobs.                 04040000
                                                                        04042000
If a request is made to suspend a job that owns a non-sharable device,  04044000
such as a tape drive, a console message will be issued to inform you    04046000
that the job owns the device.  Up to ten non-sharable devices can       04048000
be listed.  You may then decide if the job should be allowed to run     04050000
until it releases the devices, or if it should be aborted.              04052000
                                                                        04054000
a SHOWJOB listing will show SUSP for jobs that are in the suspended     04056000
state.  SUSP may also be used as a qualifier in the :SHOWJOB command.   04058000
Thus :SHOWJOB SUSP will display all suspended jobs present in the       04060000
system.                                                                 04062000
                                                                        04064000
\ITEM=EXAMPLE                                                           04066000
EXAMPLES                                                                04068000
                                                                        04070000
To suspend job number 68, enter:                                        04072000
                                                                        04074000
     :BREAKJOB #J68                                                     04076000
                                                                        04078000
\ENTRY=BUILD,PARMS,OPERATION,EXAMPLE                                    04080000
    :BUILD                                                              04082000
                                                                        04084000
Creates and immediately allocates new empty file on disc.               04086000
                                                                        04088000
SYNTAX                                                                  04090000
                                                                        04092000
                                                         F   BINARY     04094000
    :BUILD filereference[;REC=[recsize][,[blockfactor][,[U][,      ]]]] 04096000
                                                         V   ASCII      04098000
                                                                        04100000
           ;CCTL                                                        04102000
          [        ]                                                    04104000
           ;NOCCTL                                                      04106000
                                                                        04108000
          [;TEMP]                                                       04110000
          [;DEV=[device]]                                               04112000
          [;CODE=[filecode]]                                            04114000
          [;DISC=[numrec][,[numextents[,[initalloc]]]]]                 04116000
          [;RIO]                                                        04118000
          [;NORIO]                                                      04120000
          [;MSG]                                                        04122000
          [;CIR]                                                        04124000
                                                                        04126000
\ITEM=PARMS                                                             04128000
PARAMETERS                                                              04130000
                                                                        04132000
filereference          Actual name of file to be created, in the        04134000
                       following format:                                04136000
                                                                        04138000
                       filename[/lockword][.groupname][.acctname]       04140000
                                                                        04142000
                       Names may contain from 1 to 8 alphanumeric       04144000
                       characters, beginning with a letter.  If         04146000
                       <acctname> is specified, it must be that of your 04148000
                       logon account (you cannot create a file in       04150000
                       another account).  Default <groupname> and       04152000
                       <acctname> are the logon group and account.      04154000
                       (REQUIRED PARAMETER)                             04156000
                                                                        04158000
recsize                Record size.  A positive number indicates words  04160000
                       while negative indicates bytes. For fixed-length 04162000
                       files, this is logical record size.  For         04164000
                       undefined-length, this is the maximum record     04166000
                       size.  For variable-length files this is the     04168000
                       maximum physical record size.  Default is        04170000
                       determined at device configuration.              04172000
                                                                        04174000
blockfactor            Number of logical records per physical block.    04176000
                       Default is calculated by dividing the specified  04178000
                       <recsize> into the configured <blocksize>; this  04180000
                       value is rounded downward to an integer that is  04182000
                       never less than 1.                               04184000
                                                                        04186000
F, U, V                File contains fixed (F), undefined (U), or       04188000
                       variable (V) length records.  Default is <F> for 04190000
                       disc files, <U> for all others.                  04192000
                                                                        04194000
BINARY                 File contains binary-coded records.  Default.    04196000
                                                                        04198000
ASCII                  File contains ASCII-coded records.  Default is   04200000
                       BINARY.                                          04202000
                                                                        04204000
CCTL                   Indicates carriage-control characters will be    04206000
                       supplied with write requests.  Default is NOCCTL.04208000
                                                                        04210000
NOCCTL                 Indicates carriage-control characters will not be04212000
                       supplied with write requests. Default.           04214000
                                                                        04216000
TEMP                   File will be created as a job temporary file and 04218000
                       will be saved in the job/session temporary file  04220000
                       domain when closed. Default is permanent file.   04222000
                                                                        04224000
device                 Specifies the device on which the file is to     04226000
                       reside, entered in one of the following forms:   04228000
                                                                        04230000
                       devclass                                         04232000
                       ldn                                              04234000
                                                                        04236000
                       The device class <devclass> specifies the type of04238000
                       device.  If <devclass> is specified, the file is 04240000
                       allocated to any of the home volume set's volumes04242000
                       that fall within that device class.              04244000
                                                                        04246000
                       The logical device number <ldn> specifies a      04248000
                       specific device.  If <ldn> is specified, the file04250000
                       will be allocated to that device only if one of  04252000
                       volumes in the home volume set currently occupies04254000
                       the device.                                      04256000
                                                                        04258000
                       Default is device class name DISC.               04260000
                                                                        04262000
filecode               Code indicating a specially-formatted file.  This04264000
                       code is recorded in the file label and is        04266000
                       available to processes accessing the file through04268000
                       the FGETINFO intrinsic.  For this parameter, any 04270000
                       user can specify a positive integer ranging from 04272000
                       0 to 1023.  Certain integers have HP-defined     04274000
                       meanings, as follows:                            04276000
                                                                        04278000
                       Mnemonic     Integer       Meaning               04280000
                                                                        04282000
                       USL          1024     USL file.                  04284000
                       BASD         1025     BASIC data file.           04286000
                       BASP         1026     BASIC program file.        04288000
                       BASFP        1027     BASIC fast program file.   04290000
                       RL           1028     RL file.                   04292000
                       PROG         1029     Program file.              04294000
                       SL           1031     SL file.                   04296000
                       VFORM        1035     V/3000 FORMS file.         04298000
                       VFAST        1036     V/3000 FAST FORMS file.    04300000
                       VREF         1037     V/3000 Reformat file       04302000
                       XLSAV        1040     Cross Loader ASCII file    04304000
                                             (SAVE).                    04306000
                       XLBIN        1041     Cross Loader relocated     04308000
                                             binary file.               04310000
                       XLDSP        1042     Cross Loader ASCII file    04312000
                                             (DISPLAY).                 04314000
                       EDITQ        1050     Edit KEEPQ file (non-      04316000
                                             COBOL).                    04318000
                       EDTCQ        1051     Edit KEEPQ file (COBOL).   04320000
                       EDTCT        1052     Edit TEXT file (COBOL).    04322000
                       TDPDT        1054     TDP/3000 Diary keep file   04324000
                       TDPQM        1055     TDP/3000 Standard Q-Mark   04326000
                       TDPP         1056     TDP/3000 Standard P-Mark   04328000
                       TDPCP        1057     TDP/3000 Cobol P-Mark      04330000
                       TDPQ         1058     TDP/3000 Work File         04332000
                       TDPCQ        1059     TDP/3000 Work File         04334000
                       RJEPN        1060     RJE punch file.            04336000
                       QPROC        1070     QUERY procedure file.      04338000
                                    1071     QUERY work file.           04340000
                                    1072     QUERY work file.           04342000
                       KSAMK        1080     KSAM key file.             04344000
                       GRAPH        1083     GRAPH Specification file   04346000
                       SD           1084     Self-describing file       04348000
                       LOG          1090     User Logging logfile.      04350000
                       WDOC         1100     HP Word Document           04352000
                       WDICT        1101     Hyphenation Dict.          04354000
                       WCONF        1102     HP Word Configuration file 04356000
                       W2601        1103     HP 2601 Environment file   04358000
                       PCELL        1110     IDS/3000 Character Set file04360000
                       PFORM        1111     IDS/3000 Form file         04362000
                       P2680        1112     IFS/3000 Environment file  04364000
                       PCCMP        1113     IFS/3000 Char file         04366000
                       RASTR        1114     Graphics Image             04368000
                                              in RASTR format           04370000
                       OPTLF        1130     On-line Performance        04372000
                                              Tool file                 04374000
                       TEPES        1131     TEPE/3000 Script file      04376000
                       TEPEL        1132     TEPE/3000 Log file         04378000
                       SAMPL        1133     APS/3000 Log file          04380000
                       MPEDL        1139     MPEDCP/DRP Log file        04382000
                       TSR          1140     TOOLSET Root file          04384000
                       TSR          1141     TOOLSET Log file           04386000
                       DRAW         1145     Drawing file for HP Draw   04388000
                       FIG          1146     Figure file for HP Draw    04390000
                       DSTOR        1156     Store file for             04392000
                                              RAPID/3000 DICTDBU        04394000
                       TCODE        1157     Code file for TRANSACT/300004396000
                       RCODE        1158     Code file for REPORT/3000  04398000
                       ICODE        1159     Code file for INFORM/3000  04400000
                       MDIST        1166     HPMAIL Distribution list   04402000
                       MTEXT        1167     HPMAIL Text                04404000
                       NCONF        1192     Network Configuration file 04406000
                       NTRAC        1193     Network Trace file         04408000
                       NLOG         1194     Network Log file           04410000
                                                                        04412000
                       Default is 0.                                    04414000
                                                                        04416000
numrec                 Maximum number of logical records.  For          04418000
                       fixed and undefined length files the             04420000
                       maximum value allowed for this field is          04422000
                       2,147,483,647.  For variable length files        04424000
                       this value is dependent upon input record        04426000
                       size and blocksize.  The file system uses        04428000
                       these values to compute other character-         04430000
                       istics of the file as well.  Therefore           04432000
                       the values (or default values) specified         04434000
                       on the :FILE command may be valid within         04436000
                       their respective fields, but may cause           04438000
                       overflow errors in the computation of            04440000
                       internally needed file specifications.           04442000
                       Default is a value of 1023.                      04444000
                                                                        04446000
                                                                        04448000
numextents             Maximum number of disc extents.  This is a value 04450000
                       from 1 to 32.  Default is 8.                     04452000
initialloc             Number of extents to be initially allocated to   04454000
                       the file at the time it is opened.  This is a    04456000
                       value from 1 to 32.  Default is 1.               04458000
                                                                        04460000
RIO                    If RIO is specified, a relative I/O file         04462000
                       is created.  The record length parameter         04464000
                       will implicitly be changed to fixed              04466000
                       record length.  RIO is a special file            04468000
                       access method supported by Cobol II.             04470000
                                                                        04472000
NORIO                  A non-relative I/O file is created.              04474000
                                                                        04476000
MSG                    If MSG is specified, a message file              04478000
                       is created.  MSG is a special file organi-       04480000
                       zation which allow processes to communicate      04482000
                       with each other via uni-directional files.       04484000
                                                                        04486000
CIR                    If CIR is specified, a circular file is          04488000
                       created.  A CIR file is a special file access    04490000
                       which causes the oldest record in the file to    04492000
                       be deleted as a new record is added once the file04494000
                       is full.                                         04496000
\ITEM=OPERATION                                                         04498000
OPERATION                                                               04500000
                                                                        04502000
Builds a new file on disc and immediately allocates space for it,       04504000
initialized to blanks (if an ASCII file) or zeros (if a binary file).   04506000
Unless <TEMP> parameter specified, file is permanent.  (Note that you   04508000
must have SAVE access to the group to which the new file is to belong   04510000
and that you can only build a file belonging to your logon account.)    04512000
If the home volume set is not mounted for the group in which the new    04514000
file is to be built, this command will implicitly cause a volume set    04516000
mount request to be generated.                                          04518000
                                                                        04520000
\ITEM=EXAMPLE                                                           04522000
EXAMPLE                                                                 04524000
                                                                        04526000
To create a permanent disc file named WORKFILE, with fixed-length       04528000
records each 80 bytes long, 3 records per block (blockfactor), and in   04530000
ASCII code, enter:                                                      04532000
                                                                        04534000
    :BUILD WORKFILE;REC=-80,3,F,ASCII;DISC=2000,10,2                    04536000
                                                                        04538000
The file can reside on any disc, has a maximum capacity of 2000 records 04540000
divided into 10 extents, with 2 extents allocated immediately.          04542000
\ENTRY=BYE,PARMS,OPERATION,EXAMPLE                                      04544000
    :BYE                                                                04546000
                                                                        04548000
Ends an interactive session.                                            04550000
                                                                        04552000
SYNTAX                                                                  04554000
                                                                        04556000
    :BYE                                                                04558000
                                                                        04560000
\ITEM=PARMS                                                             04562000
PARAMETERS                                                              04564000
                                                                        04566000
None                                                                    04568000
                                                                        04570000
\ITEM=OPERATION                                                         04572000
OPERATION                                                               04574000
                                                                        04576000
Terminates a session, resulting in a display of logoff information in   04578000
the following format:                                                   04580000
                                                                        04582000
CPU=<cpusecs>. CONNECT=<connectmin>. <currentdatetime>                  04584000
\STOPHELP                                                               04586000
\STARTHELP                                                              04588000
                                                                        04590000
    cpusecs             Total central processor time used by the        04592000
                        session, in seconds, charged against the logon  04594000
                        group and account.                              04596000
                                                                        04598000
    connectmin          Total elapsed time between log on and log off,  04600000
                        rounded upward to nearest minute, charged       04602000
                        against logon group and account.                04604000
                                                                        04606000
    currentdatetime     The current day, date and time at logoff.       04608000
                                                                        04610000
\ITEM=EXAMPLE                                                           04612000
EXAMPLE                                                                 04614000
                                                                        04616000
To terminate a session, enter:                                          04618000
                                                                        04620000
    :BYE                                                                04622000
                                                                        04624000
    CPU=190. CONNECT=16. MON, NOV 10, 1980, 11:14 AM                    04626000
                                                                        04628000
\STARTHELP                                                              04630000
\ENTRY=COBOL,PARMS,OPERATION,EXAMPLE                                    04632000
    :COBOL                                                              04634000
                                                                        04636000
Compiles a COBOL program.                                               04638000
                                                                        04640000
SYNTAX                                                                  04642000
                                                                        04644000
 :COBOL [textfile][,[uslfile][,[listfile][,[masterfile][,newfile]]]]    04646000
                                                                        04648000
\ITEM=PARMS                                                             04650000
PARAMETERS                                                              04652000
                                                                        04654000
textfile              Actual designator of input file from which source 04656000
                      program is read.  Can be any ASCII input file.    04658000
                      Formal designator is COBTEXT. Default is $STDIN.  04660000
                                                                        04662000
uslfile               Actual designator of user subprogram library (USL)04664000
                      file on which object program is written. Can be   04666000
                      any binary output file with filecode of USL (or   04668000
                      1024).  Formal designator is COBUSL.  If entered, 04670000
                      this parameter must indicate a file created in    04672000
                      one of four ways:                                 04674000
                                                                        04676000
                      1.  By saving a USL file (with the :SAVE command) 04678000
                          created by a previous compilation where the   04680000
                          default value was used for the <uslfile>      04682000
                          parameter.                                    04684000
                                                                        04686000
                      2.  By building the USL with the Segmenter command04688000
                          -BUILDUSL.                                    04690000
                                                                        04692000
                      3.  By creating a new USL file with the MPE :BUILD04694000
                          command and a <filecode> parameter of USL or  04696000
                          1024.                                         04698000
                                                                        04700000
                      4.  By specifying a non-existent <uslfile>        04702000
                          parameter, thereby creating a permanent file  04704000
                          of the correct size and type.                 04706000
                                                                        04708000
                      Default is $NEWPASS is assigned.                  04710000
                                                                        04712000
listfile              Actual designator of file on which program listing04714000
                      is written.  Can be any ASCII output file.  Formal04716000
                      designator is COBLIST. Default is $STDLIST.       04718000
                                                                        04720000
masterfile            Actual designator of master file which is merged  04722000
                      against <textfile> to produce composite source.   04724000
                      Can be any ASCII input file.  Formal designator is04726000
                       COBMAST. Default is master file is not read,input04728000
                      is read from <textfile>.                          04730000
                                                                        04732000
newfile               Actual designator of merged <textfile> and        04734000
                      <masterfile>.  Can be any ASCII output file.      04736000
                      Formal designator is COBNEW.  Default is no file  04738000
                      is written.                                       04740000
                                                                        04742000
                              NOTE                                      04744000
                                                                        04746000
      The formal file designators used in this command                  04748000
      (COBTEXT, COBUSL, COBLIST, COBMAST, COBNEW)                       04750000
      cannot be back referenced as actual file designators              04752000
      in the command parameter list.  For further information,          04754000
      see the discussion of implied :FILE commands in                   04756000
      Section VII of the MPE Commands Reference Manual.                 04758000
                                                                        04760000
\ITEM=OPERATION                                                         04762000
OPERATION                                                               04764000
                                                                        04766000
Compiles COBOL program onto a USL file on disc.  If you do not specify a04768000
source text file, MPE expects input from your standard input device.  If04770000
you create the USL prior to compilation, you must specify a <filecode>  04772000
of USL or 1024.  If you do not specify a <listfile>, MPE sends the      04774000
program listing to the current list device.                             04776000
                                                                        04778000
\ITEM=EXAMPLE                                                           04780000
EXAMPLE                                                                 04782000
                                                                        04784000
To compile a COBOL program that you enter from your current input device04786000
into an object program in the USL file $NEWPASS, and write the listing  04788000
to your current list device, enter:                                     04790000
                                                                        04792000
    :COBOL                                                              04794000
                                                                        04796000
If the next command is one to prepare an object program, $NEWPASS can be04798000
passed to that command by specifying $OLDPASS for the <uslfile>         04800000
parameter.                                                              04802000
                                                                        04804000
To compile a COBOL program residing on the disc file SOURCE into an     04806000
object program on the USL file OBJECT, with the program listing to be   04808000
sent to the disc file LISTFL, enter:                                    04810000
                                                                        04812000
    :BUILD OBJECT;CODE=USL                                              04814000
    :COBOL SOURCE,OBJECT,LISTFL                                         04816000
                                                                        04818000
                                                                        04820000
\ENTRY=COBOLGO,PARMS,OPERATION,EXAMPLE                                  04822000
    :COBOLGO                                                            04824000
                                                                        04826000
Compiles, prepares, and executes a COBOL program.                       04828000
                                                                        04830000
SYNTAX                                                                  04832000
                                                                        04834000
    :COBOLGO [textfile][,[listfile][,[masterfile][,newfile]             04836000
                                                                        04838000
\ITEM=PARMS                                                             04840000
PARAMETERS                                                              04842000
                                                                        04844000
textfile            Actual designator of input file from which source   04846000
                    program is read.  Can be any ASCII input file.      04848000
                    Formal designator is COBTEXT. Default is $STDIN.    04850000
                                                                        04852000
listfile            Actual designator of file on which program listing  04854000
                    is written.  Can be any ASCII output file.  Formal  04856000
                    designator is COBLIST.  Default is $STDLIST.        04858000
                                                                        04860000
masterfile          Actual designator of master file which is merged    04862000
                    against <textfile> to produce composite source.  Can04864000
                    be any ASCII input file.  Formal designator is      04866000
                    COBMAST.  Default is master file is not read, input 04868000
                    is read from <textfile>.                            04870000
                                                                        04872000
newfile             Actual designator of merged <textfile> and          04874000
                    <masterfile>.  Can be any ASCII output file. Formal 04876000
                    designator is COBNEW.  Default is no file is        04878000
                    written.                                            04880000
                                                                        04882000
                              NOTE                                      04884000
                                                                        04886000
      The formal file designators used in this command                  04888000
      (COBTEXT, COBLIST, COBMAST, COBNEW)                               04890000
      cannot be back referenced as actual file designators              04892000
      in the command parameter list.  For further information,          04894000
      see the discussion of implied :FILE commands in                   04896000
      Section VII of the MPE Commands Reference Manual.                 04898000
                                                                        04900000
\ITEM=OPERATION                                                         04902000
OPERATION                                                               04904000
                                                                        04906000
Compiles, prepares, and allocates/executes a COBOL program.  If you do  04908000
not specify <textfile>, MPE expects your input from your current input  04910000
device.  If you do not specify <listfile>, MPE writes the listing to    04912000
your current list device.  This command creates a temporary USL file    04914000
($NEWPASS) that cannot be accessed, and a temporary program file that   04916000
can be accessed under the name $OLDPASS.                                04918000
                                                                        04920000
\ITEM=EXAMPLE                                                           04922000
EXAMPLE                                                                 04924000
                                                                        04926000
To compile, prepare, and execute a COBOL program entered from your      04928000
current input device, with the program listing sent to your current list04930000
device, enter:                                                          04932000
                                                                        04934000
    :COBOLGO                                                            04936000
                                                                        04938000
To compile, prepare, and execute a COBOL program from the disc file     04940000
SOURCE and send the program listing to the disc file LISTFL, enter:     04942000
                                                                        04944000
    :COBOLGO SOURCE,LISTFL                                              04946000
                                                                        04948000
                                                                        04950000
\ENTRY=COBOLPREP,PARMS,OPERATION,EXAMPLE                                04952000
    :COBOLPREP                                                          04954000
                                                                        04956000
Compiles and prepares a COBOL program.                                  04958000
                                                                        04960000
SYNTAX                                                                  04962000
                                                                        04964000
:COBOLPREP [textfile][,[progfile][,[listfile]                           04966000
           [,[masterfile][newfile]]]]                                   04968000
                                                                        04970000
\ITEM=PARMS                                                             04972000
PARAMETERS                                                              04974000
                                                                        04976000
textfile                Actual designator of input file from which      04978000
                        source program is read.  Can be any ASCII input 04980000
                        file.  Formal designator is COBTEXT. Default is 04982000
                        $STDIN.                                         04984000
                                                                        04986000
progfile                Actual designator of program file on which      04988000
                        prepared program segments are written.  Can be  04990000
                        any binary output file with <filecode> of PROG  04992000
                        or 1029.  If parameter is specified, it must    04994000
                        indicate a file created in one of two ways:     04996000
                                                                        04998000
                        1.  With the MPE :BUILD command, specifying a   05000000
                            <filecode> of PROG or 1029 and a            05002000
                            <numextents> parameter value of 1.          05004000
                                                                        05006000
                        2.  By specifying a non-existent file in the    05008000
                            <progfile> parameter in which case a job    05010000
                            temporary file of the correct size and type 05012000
                            is created.                                 05014000
                                                                        05016000
                        Default is $NEWPASS is assigned.                05018000
                                                                        05020000
                         Formal designator is COBPROG.                  05022000
                                                                        05024000
listfile                Actual designator of file on which program      05026000
                        listing is written.  Can be any ASCII output    05028000
                        file.  Formal designator is COBLIST. Default is 05030000
                        $STDLIST.                                       05032000
                                                                        05034000
masterfile              Actual designator if master file which is merged05036000
                        against <textfile> to produce composite source. 05038000
                        Can be any ASCII input file.  Formal designator 05040000
                        is COBMAST. Default is master file is not read, 05042000
                        input is read from <textfile>.                  05044000
                                                                        05046000
newfile                 Actual designator of merger <textfile> and      05048000
                        <masterfile>.  Can be any ASCII output file.    05050000
                        Formal designator is COBNEW.  Default is no file05052000
                        is written.                                     05054000
                                                                        05056000
                              NOTE                                      05058000
                                                                        05060000
      The formal file designators used in this command                  05062000
      (COBTEXT, COBPROG, COBLIST, COBMAST, COBNEW)                      05064000
      cannot be back referenced as actual file designators              05066000
      in the command parameter list.  For further information,          05068000
      see the discussion of implied :FILE commands in                   05070000
      Section VII of the MPE Commands Reference Manual.                 05072000
                                                                        05074000
\ITEM=OPERATION                                                         05076000
OPERATION                                                               05078000
                                                                        05080000
Compiles and prepares a COBOL program onto a program file on disc. If   05082000
you do not specify <textfile>, MPE expects your input from your current 05084000
input device.  If you create the program file prior to compilation, you 05086000
must use the <filecode> parameter of PROG or 1029 and a <numextents>    05088000
parameter value of 1.  If you do not specify <listfile>, MPE sends the  05090000
listing output to your current list device.  The USL file created during05092000
compilation is a temporary file passed directly to the preparation      05094000
mechanism; you can access it under the name $OLDPASS only if the program05096000
file is not $NEWPASS.                                                   05098000
                                                                        05100000
\ITEM=EXAMPLE                                                           05102000
EXAMPLE                                                                 05104000
                                                                        05106000
To compile and prepare a COBOL program entered through your current     05108000
input device, onto the file $NEWPASS, with the listing printed on the   05110000
current list device, enter:                                             05112000
                                                                        05114000
    :COBOLPREP                                                          05116000
                                                                        05118000
If the next command is one to execute the program, the file $NEWPASS is 05120000
referenced in the execute command under the name $OLDPASS.              05122000
                                                                        05124000
To compile and prepare a COBOL source program input from the textfile   05126000
named SFILE into a program file named MYPROG, with the resulting listing05128000
sent to the current list device, enter:                                 05130000
                                                                        05132000
    :COBOLPREP SFILE,MYPROG                                             05134000
                                                                        05136000
                                                                        05138000
\ENTRY=COMMENT,PARMS,OPERATION,EXAMPLE                                  05140000
    :COMMENT                                                            05142000
                                                                        05144000
Inserts comment into command stream.                                    05146000
                                                                        05148000
SYNTAX                                                                  05150000
                                                                        05152000
    :COMMENT [text]                                                     05154000
                                                                        05156000
\ITEM=PARMS                                                             05158000
PARAMETERS                                                              05160000
                                                                        05162000
text            Information comprising comment text.  If last non-blank 05164000
                character is ampersand (&), comment text is continued   05166000
                onto next line.  Default is null comment.  (A record    05168000
                containing only :COMMENT is inserted in command stream.)05170000
                                                                        05172000
\ITEM=OPERATION                                                         05174000
OPERATION                                                               05176000
                                                                        05178000
Inserts a record containing the characters :COMMENT, optionally followed05180000
by text, into command stream.  Used primarily in batch jobs.            05182000
                                                                        05184000
\ITEM=EXAMPLE                                                           05186000
EXAMPLE                                                                 05188000
                                                                        05190000
    :JOB MAC.PUBS                                                       05192000
     PRIORITY = DS; INPRI= 8; TIME = 2500 SECONDS                       05194000
     JOB NUMBER = #J3                                                   05196000
     FRI, APR  6, 1979,   1:03 PM                                       05198000
     HP3000 / MPE IV C.00.00                                            05200000
    :COMMENT  THIS IS A SAMPLE JOB                                      05202000
                                                                        05204000
                                                                        05206000
\ENTRY=CONSOLE,PARMS,OPERATION,EXAMPLE                                  05208000
     :CONSOLE                                                           05210000
                                                                        05212000
Changes the system console from its current device to another           05214000
job-accepting (non-DS) terminal.                                        05216000
                                                                        05218000
SYNTAX                                                                  05220000
                                                                        05222000
     :CONSOLE [ldn]                                                     05224000
                                                                        05226000
\ITEM=PARMS                                                             05228000
PARAMETERS                                                              05230000
                                                                        05232000
ldn          The logical device number of the new console operator      05234000
                                                                        05236000
\ITEM=OPERATION                                                         05238000
OPERATION                                                               05240000
                                                                        05242000
Once the :CONSOLE command is executed, a message is printed on          05244000
the old console device telling the old console operator where           05246000
the system console went.  The old console is now just another           05248000
session device and all the console capabilities are transferred         05250000
to the other terminal.                                                  05252000
                                                                        05254000
                                                                        05256000
The :CONSOLE command, when used without parameters, will                05258000
report to any user the current device number of the system              05260000
console.                                                                05262000
                                                                        05264000
Users with SM (system manager) capability may use the                   05266000
:CONSOLE command even if they have not been allowed the                 05268000
command.                                                                05270000
                                                                        05272000
                        NOTE                                            05274000
                                                                        05276000
        Before you, the Console Operator, transfer                      05278000
        the system console to another terminal, you                     05280000
        should give yourself the capability to take                     05282000
        the console back at any time by :ALLOWING your-                 05284000
        self the use of the :CONSOLE command.                           05286000
                                                                        05288000
The system console is a session device.  The console must be            05290000
logged on to use the console operator commands; however, if             05292000
the device is logged off, the console messages are still                05294000
printed.                                                                05296000
                                                                        05298000
                                                                        05300000
\ITEM=EXAMPLE                                                           05302000
EXAMPLES                                                                05304000
                                                                        05306000
To change logical device 81 (a terminal) to a system console, enter:    05308000
                                                                        05310000
     :CONSOLE 81                                                        05312000
                                                                        05314000
To determine the location of the console, enter:                        05316000
                                                                        05318000
     :CONSOLE                                                           05320000
     CONSOLE IS CURRENTLY ASSIGNED TO LDEV 20.                          05322000
                                                                        05324000
\ENTRY=CONTINUE,PARMS,OPERATION,EXAMPLE                                 05326000
    :CONTINUE                                                           05328000
                                                                        05330000
Overrides job/session error.                                            05332000
                                                                        05334000
SYNTAX                                                                  05336000
                                                                        05338000
    :CONTINUE                                                           05340000
                                                                        05342000
\ITEM=PARMS                                                             05344000
PARAMETERS                                                              05346000
                                                                        05348000
None                                                                    05350000
                                                                        05352000
\ITEM=OPERATION                                                         05354000
OPERATION                                                               05356000
                                                                        05358000
The :CONTINUE command permits a job or session to continue even         05360000
though the next command results in an error (with accompanying          05362000
error message).  Typically used when anticipating errors that you       05364000
wish to override.  Applies only to command immediately following        05366000
:CONTINUE.                                                              05368000
                                                                        05370000
                                                                        05372000
\ITEM=EXAMPLE                                                           05374000
EXAMPLE                                                                 05376000
                                                                        05378000
If you anticipate a possible error resulting from the command           05380000
                                                                        05382000
    :RUN MYPROG                                                         05384000
                                                                        05386000
and wish to override this error and allow a job to continue, enter:     05388000
                                                                        05390000
    :JOB MAC.PUBS                                                       05392000
    :CONTINUE                                                           05394000
    :RUN MYPROG                                                         05396000
    :RUN MYPROG2                                                        05398000
    :EOJ                                                                05400000
                                                                        05402000
                                                                        05404000
\ENTRY=DATA,PARMS,OPERATION,EXAMPLE                                     05406000
    :DATA                                                               05408000
                                                                        05410000
Enters data into system from devicefile.  (Cannot be used to enter data 05412000
from $STDIN.)                                                           05414000
                                                                        05416000
SYNTAX                                                                  05418000
                                                                        05420000
    :DATA [jsname,]username[/userpass].acctname[/acctpass][;filename]   05422000
                                                                        05424000
\ITEM=PARMS                                                             05426000
PARAMETER                                                               05428000
                                                                        05430000
jsname              Name of job or session that is to read data. Default05432000
                    is no job/session name.                             05434000
                                                                        05436000
username            Your user name that allows you to access MPE under  05438000
                    this account, as established by Account Manager.    05440000
                    (REQUIRED PARAMETER)                                05442000
                                                                        05444000
userpass            Your user password, optionally assigned by Account  05446000
                    Manager.                                            05448000
                                                                        05450000
acctname            Name of account under which job/session is running, 05452000
                    as established by System Manager. (REQUIRED         05454000
                    PARAMETER)                                          05456000
                                                                        05458000
acctpass            Account password, optionally assigned by System     05460000
                    Manager.                                            05462000
                                                                        05464000
filename            Additional qualifying name for the data that can be 05466000
                    used by job or session to access the data.  May be  05468000
                    used, for instance, to distinguish two separate data05470000
                    decks from different card readers read by the same  05472000
                    program.  Default is no distinguishing name is      05474000
                    assigned.                                           05476000
                                                                        05478000
Note that the <jsname>, <username>, <userpass>, <acctname>, <acctpass>, 05480000
and <filename> parameters all are names that can contain up to 8 alpha- 05482000
numeric characters, beginning with a letter.                            05484000
                                                                        05486000
\ITEM=OPERATION                                                         05488000
OPERATION                                                               05490000
                                                                        05492000
Identifies input consisting entirely of data to be read from devicefile 05494000
other than standard input file.  The input device must be one that is   05496000
configured by the System Supervisor or Console Operator to automatically05498000
accept :DATA command.  This command often is used to access data from a 05500000
batch input device while in session mode -- for instance, to read a deck05502000
from a card reader while running an interactive session.  A :DATA       05504000
command is required for card decks not embedded in standard input stream05506000
($STDIN) and which are submitted from devices configured to accept      05508000
:DATA; and may not be used for data submitted from a device not         05510000
configured to accept the :DATA command, nor for data embedded within the05512000
input stream, or for data on disc files.                                05514000
                                                                        05516000
To designate data for your job or session, enter the :DATA command,     05518000
followed by the data, followed by the :EOD command.  The data can only  05520000
be read by a job/session that has the same identity ([jsname,]          05522000
username.acctname).                                                     05524000
                                                                        05526000
If the <filename> parameter is omitted, data can be read by any access  05528000
from a job/session with the same identity.                              05530000
                                                                        05532000
When the data file is placed on the input device and the device is      05534000
readied, MPE reads the entire file (if input from a spooled device), or 05536000
the :DATA command only (if input from a non-spooled device).  From this 05538000
point on, your job can access the data, which remains available until it05540000
is actually read.                                                       05542000
                                                                        05544000
The :DATA command implicitly initiates communication with MPE, and thus 05546000
is the only command not entered within a formally-initiated job or      05548000
session.  Files identified by :DATA may be input on cards, magnetic     05550000
tape, paper tape, or from a terminal (but not from disc). When entered  05552000
from magnetic tape, such a file must reside on a single tape volume.    05554000
                                                                        05556000
\ITEM=EXAMPLE                                                           05558000
EXAMPLE                                                                 05560000
                                                                        05562000
To designate a data file on cards for a session identified as           05564000
SESS1,BLACK.ACCTSP, enter:                                              05566000
                                                                        05568000
    :DATA SESS1,BLACK.ACCTSP                                            05570000
          .                                                             05572000
          .                                                             05574000
        data                                                            05576000
          .                                                             05578000
          .                                                             05580000
    :EOD                                                                05582000
                                                                        05584000
                                                                        05586000
\ENTRY=DEALLOCATE,PARMS,OPERATION,EXAMPLE                               05588000
    :DEALLOCATE (System Supervisor capability required)                 05590000
                                                                        05592000
Removes from virtual memory a program file or procedure segment that has05594000
been permanently allocated with an :ALLOCATE command.                   05596000
                                                                        05598000
SYNTAX                                                                  05600000
                                                                        05602000
                 PROGRAM                                                05604000
    :DEALLOCATE [         ],name                                        05606000
                 PROCEDURE                                              05608000
                                                                        05610000
\ITEM=PARMS                                                             05612000
PARAMETERS                                                              05614000
                                                                        05616000
PROGRAM     The program file indicated by <name> is deallocated.        05618000
            Default.                                                    05620000
                                                                        05622000
PROCEDURE   The code segment containing the procedure specified by      05624000
            <name> in SL.PUB.SYS is deallocated.  Default is PROGRAM.   05626000
                                                                        05628000
\ITEM=OPERATION                                                         05630000
OPERATION                                                               05632000
                                                                        05634000
(System Supervisor capability required)                                 05636000
This command removes from virtual memory a program file or procedure    05638000
segment that has been permanently allocated with an :ALLOCATE command.  05640000
                                                                        05642000
The program file or procedure segment is deallocated immediately if it  05644000
is not being used by a process; otherwise, it is deallocated as soon as 05646000
it is no longer in use.                                                 05648000
                                                                        05650000
\ITEM=EXAMPLE                                                           05652000
EXAMPLE                                                                 05654000
                                                                        05656000
To deallocate a program file named PROGX, enter:                        05658000
                                                                        05660000
    DEALLOCATE ,PROGX                                                   05662000
                                                                        05664000
                                                                        05666000
\ENTRY=DEBUG,PARMS,OPERATION                                            05668000
    :DEBUG (Privileged Mode capability required)                        05670000
                                                                        05672000
Invokes the MPE Debug facility.                                         05674000
                                                                        05676000
SYNTAX                                                                  05678000
                                                                        05680000
    :DEBUG                                                              05682000
                                                                        05684000
\ITEM=PARMS                                                             05686000
PARAMETERS                                                              05688000
                                                                        05690000
None                                                                    05692000
                                                                        05694000
\ITEM=OPERATION                                                         05696000
OPERATION                                                               05698000
                                                                        05700000
(Privileged Mode capability required)                                   05702000
The :DEBUG command is an extension of the MPE Debug facility and is used05704000
primarily by systems programmers; its use is explained in the MPE       05706000
Debug/Stack Dump Reference Manual.                                      05708000
                                                                        05710000
                          IMPORTANT NOTE                                05712000
                                                                        05714000
      The normal checks and limitations that apply to the               05716000
      standard users in MPE are bypassed in privileged mode.            05718000
      It is possible for a privileged mode user to destroy              05720000
      the integrity, including the MPE operating system                 05722000
      software itself.  Hewlett-Packard will investigate and            05724000
      attempt to resolve problems resulting from the use of             05726000
      privileged mode code.  This service, which is not                 05728000
      provided under the standard Service Contract, is                  05730000
      available on a time and materials billing basis.                  05732000
      However, Hewlett-Packard will not support, correct,               05734000
      or attend to any modification of the MPE operating                05736000
      system software.                                                  05738000
                                                                        05740000
                                                                        05742000
\ENTRY=DELETESPOOLFILE,PARMS,OPERATION,EXAMPLE                          05744000
     :DELETESPOOLFILE                                                   05746000
                                                                        05748000
Deletes a spooled file.                                                 05750000
                                                                        05752000
SYNTAX                                                                  05754000
                                                                        05756000
                      {#Onnn}                                           05758000
     :DELETESPOOLFILE {#Innn}                                           05760000
                      {ldn  }                                           05762000
                                                                        05764000
\ITEM=PARMS                                                             05766000
PARAMETERS                                                              05768000
                                                                        05770000
#Onnn          The output devicefile identification.                    05772000
                                                                        05774000
#Innn          The input devicefile identification                      05776000
                                                                        05778000
ldn            The logical device number of the device of an active     05780000
               spoolfile.                                               05782000
                                                                        05784000
                                                                        05786000
\ITEM=OPERATION                                                         05788000
OPERATION                                                               05790000
                                                                        05792000
None.                                                                   05794000
                                                                        05796000
\ITEM=EXAMPLE                                                           05798000
EXAMPLES                                                                05800000
                                                                        05802000
To delete an output spooled file from being output to logical device    05804000
6 (a line printer), first stop the device, then enter:                  05806000
                                                                        05808000
     11:21/7/LDEV#6 NOT READY (message generated by the system          05810000
     :DELETESPOOLFILE 6        when device is taken offline)            05812000
                                                                        05814000
\ENTRY=DISALLOW,PARMS,OPERATION,EXAMPLE                                 05816000
     :DISALLOW                                                          05818000
                                                                        05820000
Prohibits a user access to a specific operator command.                 05822000
                                                                        05824000
SYNTAX                                                                  05826000
                                                                        05828000
                FILE=formaldesignator [;SHOW]                           05830000
                 @.@                                                    05832000
                 user.@                                                 05834000
     :DISALLOW {{@.acct   } ;COMMANDS=command1[,command2,...commandn]}  05836000
                 user.acct                                              05838000
                                                                        05840000
\ITEM=PARMS                                                             05842000
PARAMETERS                                                              05844000
                                                                        05846000
formaldesignator     A formal ASCII file name.                          05848000
                                                                        05850000
SHOW                 Lists input lines on $STDLIST.                     05852000
                                                                        05854000
@.@                  Prohibits access to all users whether logged       05856000
                     on or not.                                         05858000
                                                                        05860000
user.@               Prohibits access to a specific user in all         05862000
                     accounts.                                          05864000
                                                                        05866000
@.acct               Prohibits access to all users in a specific        05868000
                     account.                                           05870000
                                                                        05872000
user.acct            Prohibits access to a specific user in a           05874000
                     specific account.                                  05876000
                                                                        05878000
                                                                        05880000
\ITEM=OPERATION                                                         05882000
OPERATION                                                               05884000
                                                                        05886000
Through the :DISALLOW command, the console operator has the ability     05888000
to withhold console capabilities among system users by directly         05890000
entering:                                                               05892000
                                                                        05894000
                @.@                                                     05896000
     :DISALLOW {user.@   } ;COMMANDS=command1[,command2,...commandn]    05898000
                @.acct                                                  05900000
                user.acct                                               05902000
                                                                        05904000
This command can also be used in indirect and subsystem mode.  In       05906000
the indirect mode, a user predefined EDITOR file is deactivated         05908000
that contains:                                                          05910000
                                                                        05912000
                @.@                                                     05914000
     :DISALLOW {user.@   } ;COMMANDS=command1[,command2,...commandn]    05916000
                @.acct                                                  05918000
                user.acct                                               05920000
                                                                        05922000
The :DISALLOW command is then executed by entering at the system        05924000
console:                                                                05926000
                                                                        05928000
     :DISALLOW FILE=formaldesignator [;SHOW]                            05930000
                                                                        05932000
which deactivates the EDITOR file.  In subsystem mode, just type        05934000
DISALLOW, followed by a carriage return.  The subsystem prompts you     05936000
with a ">" sign, accepting command parameters until an EOF is           05938000
received or EXIT is entered.                                            05940000
                                                                        05942000
\ITEM=EXAMPLE                                                           05944000
EXAMPLES                                                                05946000
To prohibit the user BARB.LEWIS the ability to execute the REPLY        05948000
and ABORTIO commands, enter on the system console:                      05950000
                                                                        05952000
     :DISALLOW BARB.LEWIS;COMMANDS=REPLY,ABORTIO                        05954000
                                                                        05956000
To prohibit the user PAUL.USER the ability to execute the BREAKJOB      05958000
command in subsystem mode, enter on the system console:                 05960000
                                                                        05962000
     :DISALLOW                                                          05964000
     >PAUL.USER;COMMANDS=BREAKJOB                                       05966000
     >EXIT                                                              05968000
                                                                        05970000
\ENTRY=DISASSOCIATE,PARMS,OPERATION,EXAMPLE                             05972000
     :DISASSOCIATE                                                      05974000
                                                                        05976000
Removes a device from the control of a user.                            05978000
                                                                        05980000
SYNTAX                                                                  05982000
                                                                        05984000
     :DISASSOCIATE devclass                                             05986000
                                                                        05988000
\ITEM=PARMS                                                             05990000
PARAMETERS                                                              05992000
                                                                        05994000
devclass          The device class specified during SYSDUMP.            05996000
                                                                        05998000
\ITEM=OPERATION                                                         06000000
OPERATION                                                               06002000
                                                                        06004000
When a user DISASSOCIATEs a device, the operator is notified.           06006000
                                                                        06008000
\ITEM=EXAMPLE                                                           06010000
EXAMPLES                                                                06012000
                                                                        06014000
To return control of devclass TAPE to the console operator, enter:      06016000
                                                                        06018000
     :DISASSOCIATE TAPE                                                 06020000
                                                                        06022000
\ENTRY=DISMOUNT,PARMS,OPERATION,EXAMPLE                                 06024000
    :DISMOUNT                                                           06026000
                                                                        06028000
Causes a volume set that was previously explicitly mounted by the user  06030000
to be dismounted.                                                       06032000
                                                                        06034000
SYNTAX                                                                  06036000
                                                                        06038000
                  *                                                     06040000
    :DISMOUNT {         }[.groupname[.acctname]]]                       06042000
                vcsname                                                 06044000
                                                                        06046000
\ITEM=PARMS                                                             06048000
PARAMETERS                                                              06050000
                                                                        06052000
*                   Specifies the home volume set for the group and     06054000
                    account specified, or the logon group and account   06056000
                    if <groupname.acctname> are not specified.  Default.06058000
                                                                        06060000
vcsname             Volume set/class name, specifying a previously-     06062000
                    defined volume class name or volume set name.       06064000
                    Default is *.                                       06066000
                                                                        06068000
groupname.acctname  Specify the group and account which created the     06070000
                    volume set.  Default is logon group and account.    06072000
                                                                        06074000
\ITEM=OPERATION                                                         06076000
OPERATION                                                               06078000
                                                                        06080000
The :DISMOUNT command allows you to have dismounted                     06082000
a volume set that you previously explicitly mounted via a               06084000
:MOUNT command.  If there are no other users of the volume set, the     06086000
devices on which it resides are made available to the system.  You      06088000
can only request a dismount for a volume set which you have caused to be06090000
mounted; you cannot affect the status of the volume set with respect to 06092000
other users.                                                            06094000
                                                                        06096000
\ITEM=EXAMPLE                                                           06098000
EXAMPLE                                                                 06100000
                                                                        06102000
To dismount the volume set MYSET, previously mounted by you via a :MOUNT06104000
command, enter:                                                         06106000
                                                                        06108000
    :DISMOUNT MYSET                                                     06110000
                                                                        06112000
                                                                        06114000
\ENTRY=DOWN,PARMS,OPERATION,EXAMPLE                                     06116000
    :DOWN                                                               06118000
                                                                        06120000
Removes a device from normal system use.                                06122000
                                                                        06124000
SYNTAX                                                                  06126000
                                                                        06128000
     :DOWN ldn                                                          06130000
                                                                        06132000
\ITEM=PARMS                                                             06134000
PARAMETERS                                                              06136000
                                                                        06138000
ldn          The logical device number of the device being taken        06140000
             off-line.                                                  06142000
                                                                        06144000
\ITEM=OPERATION                                                         06146000
OPERATION                                                               06148000
                                                                        06150000
If the device is in use, the :DOWN request will be satisfied when       06152000
the last access is complete.                                            06154000
                                                                        06156000
For non-system domain disc drives, if a master volume is mounted        06158000
on a DOWNed device, MPE rejects all further requests to use ANY         06160000
volume of the set to which the master volume belongs.                   06162000
                                                                        06164000
When any device is powered-down and the :DOWN command is not used,      06166000
access to that device can result in indefinite waiting, erroneous       06168000
transfers, or other incorrect operation.  Often these failures will     06170000
occur with no indication to you or the user.  For this reason, it       06172000
is very important that every device which is not fully operational      06174000
(especially powered-down) to be :DOWNed.  A device that will be         06176000
inoperable for more than a few hours can be temporarily removed         06178000
from the I/O configuration at system start-up time.                     06180000
                                                                        06182000
\ITEM=EXAMPLE                                                           06184000
EXAMPLES                                                                06186000
                                                                        06188000
To take logical device number 20 off-line, enter:                       06190000
                                                                        06192000
     :DOWN 20                                                           06194000
                                                                        06196000
To take logical device number 10 off-line (an input-spooled job-        06198000
accepting magnetic tape), enter:                                        06200000
                                                                        06202000
     :DOWN 10                                                           06204000
     :STOPSPOOL 10                                                      06206000
     11:16/31/SP#10/STOPPED                                             06208000
     11:16/31/LDEV#10 NOT READY                                         06210000
                                                                        06212000
\ENTRY=DOWNLOAD,PARMS,OPERATION,EXAMPLE                                 06214000
     :DOWNLOAD                                                          06216000
                                                                        06218000
Downloads/Resets the output device.                                     06220000
                                                                        06222000
SYNTAX                                                                  06224000
                                                                        06226000
                   [,filename ]                                         06228000
     :DOWNLOAD ldn [          ]                                         06230000
                   [,MARGIN=nn]                                         06232000
                                                                        06234000
\ITEM=PARMS                                                             06236000
PARAMETERS                                                              06238000
                                                                        06240000
ldn          The logical device number of the output device.  This      06242000
             device must be a 2608 or a 2631 line printer.              06244000
                                                                        06246000
filename     The fully qualified name of a file containing the down-    06248000
             load control information and data.                         06250000
                                                                        06252000
nn           The print position that the first byte of data will        06254000
             assume.  This number can be between 1 and 16 inclusive.    06256000
                                                                        06258000
\ITEM=OPERATION                                                         06260000
OPERATION                                                               06262000
                                                                        06264000
This command is primarily for control of an HP 2608 and an HP 2631      06266000
line printer.  The user will in a forms message indicate what forms     06268000
and VFC (Vertical Format Control) must be used for printing the job.    06270000
On all other printers, the VFC is controlled by a loop or tape in-      06272000
serted in the printer.  The HP 2608 has electronic VFC only.            06274000
\starthelp                                                              06276000
                                                                        06278000
The VFC image file can define the margin setting as well as the VFC     06280000
image.  The number of print lines per form is limited to 127.           06282000
For information on VFC files, enter the command:  HELP VFC.             06284000
                                                                        06286000
\ITEM=EXAMPLE                                                           06288000
EXAMPLES                                                                06290000
                                                                        06292000
To respond to a forms message, enter:                                   06294000
                                                                        06296000
     IO/15:46/22/FORMS: PLEASE MOUNT PAYCHECK FORMS USE VFC=VFCPAY      06298000
     IO/1 55:46/22SP#12/LDFV# FOR #S93:OUTFILE ON 2608 (1)              06300000
                                                                        06302000
          :DOWNLOAD 11,VFCPAY                                           06304000
                                                                        06306000
To reset the VFC to its original state, enter:                          06308000
                                                                        06310000
     :DOWNLOAD 11,VFC6.PUB.SYS                                          06312000
                                                                        06314000
To set the left margin print position to column 4, enter:               06316000
                                                                        06318000
      :DOWNLOAD 11,MARGIN=4                                             06320000
                                                                        06322000
\ENTRY=DSCONTROL,PARMS,OPERATION,EXAMPLE                                06324000
     :DSCONTROL                                                         06326000
                                                                        06328000
Enables or disables the DS subsystem on the communication link.         06330000
Replaces former  =DSLINE console command.  Uses keywords to combine     06332000
functions.  Console may be moved.                                       06334000
                                                                        06336000
SYNTAX                                                                  06338000
                                                                        06340000
    :DSCONTROL dsdevice;function [;function [;... function]]            06342000
                                                                        06344000
where the command syntax has the following meaning:                     06346000
                                                                        06348000
function       ::=  OPEN [,open option [,...open option]]               06350000
                    SHUT                                                06352000
                                                                        06354000
                    TRACE,ON [trace options]                            06356000
                    TRACE,OFF                                           06358000
                                                                        06360000
                    COMP                                                06362000
                    NOCOMP                                              06364000
                                                                        06366000
                    MON [,mon option]                                   06368000
                    MOFF                                                06370000
                                                                        06372000
                    RETRY=[retry option]                                06374000
                                                                        06376000
open option    ::=  MASTER                                              06378000
                    SLAVE                                               06380000
                    SPEED=linespeed                                     06382000
                                                                        06384000
trace options  ::=  [,[ALL][,[mask][,[numentries][,[WRAP]               06386000
                             [,filename]]]]]                            06388000
                                                                        06390000
mon option     ::=  DS                                                  06392000
                    CS                                                  06394000
                                                                        06396000
retry option   ::=  DEFAULT                                             06398000
                    retry count                                         06400000
                                                                        06402000
\ITEM=PARMS                                                             06404000
                                                                        06406000
PARAMETERS                                                              06408000
                                                                        06410000
dsdevice            The logical device number or the device class       06412000
                    name of the DS/3000 communications device. On       06414000
                    your system's I/O configuration listing, the        06416000
                    device is back referenced by a pound sign (#)       06418000
                    to a previously defind HSI,INP, or SSLC.            06420000
                    (Required parameter.)                               06422000
                                                                        06424000
OPEN                Establishes a communication link with another       06426000
                    HP 3000.  Makes the line available for remote       06428000
                    communication via the DS/3000 Subsystem.            06430000
                    (Required parameter.)                               06432000
                                                                        06434000
SHUT                Initiates an orderly line shutdown.  Refer to       06436000
                    OPERATION for details about the line closing        06438000
                    procedure.                                          06440000
                                                                        06442000
MASTER              Limits DS/3000 line activity to outgoing            06444000
                    requests only.  No incoming slave sessions          06446000
                    are allowed.                                        06448000
                                                                        06450000
SLAVE               Limits DS/3000 line activity to incoming            06452000
                    slave requests only, no outgoing master             06454000
                    activity is allowed.                                06456000
                                                                        06458000
                                    NOTE                                06460000
                                                                        06462000
                         OPEN,MASTER = SHUT,SLAVE                       06464000
                         OPEN,SLAVE  = SHUT,MASTER                      06466000
                         SHUT,MASTER = OPEN,SLAVE                       06468000
                         SHUT,SLAVE  = OPEN,MASTER                      06470000
                                                                        06472000
                    Default:  Both MASTER and SLAVE processing          06474000
                              are allowed.                              06476000
                                                                        06478000
linespeed           Transmission rate in characters per second.         06480000
                    This parameter is effective only if your sys-       06482000
                    tem generation for the line controller (HSI,        06484000
                    INP, or SSLC) selected SPEED CHANGEABLE.            06486000
                    Specify linespeed if yours is a European            06488000
                    installation with modems running at half            06490000
                    speed; or if the length of cables used for          06492000
                    data communications at your site have been          06494000
                    changed since the system was configured.            06496000
                    Default: System configuration values.               06498000
                                                                        06500000
                    HSI speed:          250,000 (cable lengths          06502000
                                        less than 1000 ft.)             06504000
                                        125,000 (cable lengths          06506000
                                        greater than 1000 ft.)          06508000
                    INP or SSLC speed:  250,300,600, or 1200            06510000
                                                                        06512000
TRACE,ON            Activates the TRACE facility to provide a           06514000
                    record of communications activities.  Trace         06516000
                    parameters are positional.  The line must           06518000
                    already be open, or the OPEN keyword must           06520000
                    also be included (to open the line).                06522000
                                                                        06524000
ALL                 Generates trace records for all line                06526000
                    activity. Default: Records are written only         06528000
                    for transmission errors.                            06530000
                                                                        06532000
mask                An octal number preceded by a percent sign          06534000
                    (%nn). Used to select type of trace entries         06536000
                    generated. Refer to DS/3000 Reference Manual        06538000
                    for an explanation of the mask bits.                06540000
                    Default: %37 (all except STN).                      06542000
                                                                        06544000
numentries          Decimal integer for the maximum number of           06546000
                    entries in a trace record, not greater than         06548000
                    255.  INP maximum is 24.  Default: 24.              06550000
                    (See OPERATION)                                     06552000
                                                                        06554000
WRAP                Trace entries that overflow the trace record        06556000
                    overlay the prior trace record entries.             06558000
                    Default: Overflow entries are discarded.            06560000
                                                                        06562000
filename            A name for the trace file.                          06564000
                    Default: DSTRCxxx.PUB.SYS (where xxx is the         06566000
                             ldn of the dsdevice).                      06568000
                                                                        06570000
TRACE,OFF           Deactivates the TRACE facility so that no           06572000
                    records are kept of DS/3000 actions, states,        06574000
                    and events.  Also closes the trace file.            06576000
                                                                        06578000
COMP                Activates the data compression facility for         06580000
                    all line users.  The line need not be open to       06582000
                    use COMP.                                           06584000
                                                                        06586000
NOCOMP              Deactivates the data compression facility for       06588000
                    all line users.  Line need not be open to           06590000
                    use NOCOMP.                                         06592000
                                                                        06594000
MON                 Activates internal monitoring of DS/3000            06596000
                    activity to give additional information on a        06598000
                    subsequent cold dump of the system.  The line       06600000
                    must be open for the use of MON.                    06602000
                    Only use for system troubleshooting.                06604000
                                                                        06606000
MOFF                Deactivates internal DS/3000 monitor records.       06608000
                    Line must be open for the use of MOFF.              06610000
                                                                        06612000
RETRY               Changes communications error retry count to         06614000
                    specified value.  Specifying "DEFAULT" causes       06616000
                    a retry count of 15.  The retry count must be       06618000
                    between 0 and 255 inclusive.                        06620000
                                                                        06622000
\ITEM=OPERATION                                                         06624000
                                                                        06626000
OPERATION                                                               06628000
                                                                        06630000
                                                                        06632000
Unless :DSCONTROL is issued from the master console, this command       06634000
requires the user to have CS capability.  In addition, all users        06636000
except the console operator are granted access to :DSCONTROL only       06638000
if they are ALLOWed to use the command or are ASSOCIATEd with the       06640000
specified DS device.                                                    06642000
                                                                        06644000
Only one DS/3000 communications device can be active (OPEN) on a        06646000
controller at any given time.  Once opened (with the :DSCONTROL         06648000
command), a communications link can be shared by multiple DS/3000       06650000
users.  It cannot, however, be shared by users of other communi-        06652000
cations subsystems supported by your system (for example,               06654000
MRJE/3000).  Thus you must SHUT a DSLINE before it can be opened        06656000
for use by another subsystem.                                           06658000
                                                                        06660000
Before issuing a :DSCONTROL command, use the :SHOWDEV command to        06662000
check whether a communications link is already established. The         06664000
ldn for the SSLC, INP, or HSI port will be UNAVAIL if the com-          06666000
munication link is in use by any subsystem; the ldn for a DS            06668000
communication pseudo device (driver IODS0) will be AVAIL if it is       06670000
currently in use by DS/3000.                                            06672000
                                                                        06674000
If a DS device class includes more than one DS device, the func-        06676000
tions specified in the :DSCONTROL command apply to all devices in       06678000
that class.  If you have not been ALLOWed to use this command,          06680000
you can only control those devices in the device class with which       06682000
you have been ASSOCIATEd (if any).                                      06684000
                                                                        06686000
If you include more than one function in a :DSCONTROL command,          06688000
each function (with its subparameter list) must be separated by a       06690000
semicolon.  A function that duplicates or conflicts with a pre-         06692000
vious function overrides that function.  Functions can appear in        06694000
any order but are executed in the following order:                      06696000
                                                                        06698000
1.  OPEN/SHUT                                                           06700000
                                                                        06702000
2.  TRACE                                                               06704000
                                                                        06706000
3.  MON/MOFF                                                            06708000
                                                                        06710000
4.  COMP/NOCOMP                                                         06712000
                                                                        06714000
5.  RETRY                                                               06716000
                                                                        06718000
                                                                        06720000
The SPEED= keyword in the open option may be omitted from a             06722000
:DSCONTROL command.  For example, the following two commands have       06724000
exactly the same effect:                                                06726000
                                                                        06728000
     :DSCONTROL 60;OPEN,MASTER,SPEED=25000                              06730000
                                                                        06732000
     :DSCONTROL 60;OPEN,MASTER,25000                                    06734000
                                                                        06736000
                                                                        06738000
When you turn on the trace facility, the trace file is                  06740000
DSTRCxxx.PUB.SYS (where xxx is the logical device number of             06742000
the dsdevice), unless you specify otherwise in the "filename"           06744000
option of the trace options.  If the trace file already exists,         06746000
and the record size is not compatible with the requested record         06748000
size (based on the requested numentries), the old file is               06750000
purged before a new, permanent file (with the old file's                06752000
file limit and maximum number of extents) is created.  If you           06754000
do not include the numentries parameter, the file will be               06756000
created to hold 24 entries per record.  To change numentries,           06758000
simply turn trace off and then turn it on again with the new            06760000
number of entries.                                                      06762000
                                                                        06764000
The SHUT parameter initiates an orderly line closing procedure.         06766000
If no sessions or applications are using the line when you shut         06768000
it, line disconnection occurs immediately.  If any user                 06770000
(including applications) has the line open, the line remains            06772000
connected until all sessions and applications CLOSE the line, or        06774000
until those accessing the line terminate or are aborted.  Once          06776000
closed by the console operator, no new users may access the line        06778000
until the operator reopens it.                                          06780000
                                                                        06782000
Specifying a high retry count in the RETRY parameter increases          06784000
the chance of obtaining a connection with a user :DSLINE command        06786000
when attempting to connect over bad phone lines.                        06788000
                                                                        06790000
\ITEM=EXAMPLE                                                           06792000
                                                                        06794000
EXAMPLES                                                                06796000
                                                                        06798000
                                                                        06800000
To open DS line number 55, thereby making it available for use by       06802000
the DS/3000 Subsystem, enter:                                           06804000
                                                                        06806000
     :DSCONTROL 55;OPEN                                                 06808000
                                                                        06810000
                                                                        06812000
To permit the local HP 3000 to process only master (outgoing)           06814000
requests on DS line number 55, enter:                                   06816000
                                                                        06818000
     :DSCONTROL 55;OPEN,MASTER                                          06820000
                                                                        06822000
                                                                        06824000
To activate the CS Trace facility for DS line 55 (the line is           06826000
already open), enter:                                                   06828000
                                                                        06830000
     :DSCONTROL 55;TRACE,ON                                             06832000
                                                                        06834000
                                                                        06836000
To open DS line 55 and activate CS Trace with a maximum of 250          06838000
entries in a trace record, enter:                                       06840000
                                                                        06842000
     :DSCONTROL 55;OPEN;TRACE,ON,,,250                                  06844000
                                                                        06846000
                                                                        06848000
To open the line named REMSYS and provide compression and               06850000
internal monitoring, enter:                                             06852000
                                                                        06854000
     :DSCONTROL REMSYS;OPEN;COMP;MON                                    06856000
                                                                        06858000
                                                                        06860000
To open the line named SDS and set the retry count for that line        06862000
to 100, enter:                                                          06864000
                                                                        06866000
     :DSCONTROL SDS;OPEN;RETRY=100                                      06868000
                                                                        06870000
                                                                        06872000
\ENTRY=DSCOPY,PARMS,OPERATION,EXAMPLE                                   06874000
    :DSCOPY                                                             06876000
                                                                        06878000
Utility which copies entire files either locally or across DS           06880000
lines.                                                                  06882000
                                                                        06884000
                                                                        06886000
SYNTAX                                                                  06888000
                                                                        06890000
The syntax of the DSCOPY command is:                                    06892000
                                                                        06894000
<copy command> ::=                                                      06896000
                                                                        06898000
     DSCOPY  [ <source id> ] [ TO [ <target id> ] ]                     06900000
                             [ ;                  ]                     06902000
                                                                        06904000
<source id>    ::=                                                      06906000
                                                                        06908000
     <source file> [, [node] [, [device] ]]                             06910000
                   [         [# [device] ]]                             06912000
                                                                        06914000
                                                                        06916000
<target id>    ::=                                                      06918000
                                                                        06920000
     <target file> [, [node] [, [device] ]]                             06922000
                   [  [ *  ] [# [device] ]]                             06924000
                                                                        06926000
                                                                        06928000
\ITEM=PARMS                                                             06930000
                                                                        06932000
PARAMETERS                                                              06934000
                                                                        06936000
<source id>       Gives the name and location of source file.           06938000
                                                                        06940000
<target id>       Gives the name and location of target file.           06942000
                                                                        06944000
<source file>                                                           06946000
<target file>     The fully qualified file names of the source          06948000
                  and target files.  Syntactically each may be          06950000
                  any sequence of characters which does not             06952000
                  contain a comma, semi-colon, "#", quote or            06954000
                  blank.  There is no default for <source file>.        06956000
                  The default <target file> will generally be           06958000
                  derived from <source file>.  The default will         06960000
                  consist of the first sequence of characters           06962000
                  in <source file> which constitutes a legal            06964000
                  HP/3000 file name.  For example, in "DSCOPY           06966000
                  file.group.node1" the default <target file>           06968000
                  would be "file".  If a default KSAM keyfile           06970000
                  name must be generated also, the data file            06972000
                  name plus a "K" will be used.  The user spec-         06974000
                  ifies a data and keyfile name pair by enclosing       06976000
                  them in quotes and separating them with a             06978000
                  comma (DSCOPY source TO "datafile,keyfile").          06980000
                                                                        06982000
<node>                                                                  06984000
*                 The name of the network node where the file           06986000
                  resides or will reside.  This will be a dsline        06988000
                  name or number.  If <node> is not given for a         06990000
                  source or target file, the file is assumed to         06992000
                  be local.  The asterisk can be used to indicate       06994000
                  that the target system is the same as the             06996000
                  source system.                                        06998000
                                                                        07000000
<device>          The name of the device or device class where          07002000
                  the file resides as defined by the system             07004000
                  where it resides.  The default is DISC.  If a         07006000
                  user desires to specify the device for a KSAM         07008000
                  keyfile separately, he may use the same tech-         07010000
                  nique used for target file names, (DSCOPY K TO        07012000
                  "data,keys", , "datadev,keydev").  The default        07014000
                  for the keyfile device is the same device the         07016000
                  data file resides on.                                 07018000
                                                                        07020000
\ITEM=OPERATION                                                         07022000
                                                                        07024000
OPERATION                                                               07026000
                                                                        07028000
The DSCOPY command invokes the file transfer process (NFT).             07030000
DSCOPY only copies entire files.  Its goal is to provide easy to        07032000
use, efficient transfer of files across DS lines.  If parameters are    07034000
included in the DSCOPY command, then control will return                07036000
to the user after the completion of the file transfer.  To invoke       07038000
the file transfer process for a series of transactions, only the        07040000
command DSCOPY is entered.  NFT will then open the file DSCOPYI         07042000
and read requests from it.  DSCOPYI defaults to $STDINX.  NFT           07044000
will prompt the user with the word DSCOPY.  The syntax of the           07046000
response is:                                                            07048000
                                                                        07050000
    <source id> [TO [ <target id> ] ]                                   07052000
                [;                  ]                                   07054000
                                                                        07056000
To continue a response to a second line, place an "&" as the last       07058000
non-blank on the current line and hit carriage return.  A               07060000
continue prompt will be issued and the remaining input may be           07062000
entered.  To cancel a request while entering a continuation line,       07064000
hit control-Y.  Control-Y is also used to cancel a copy in progress.    07066000
If control-Y is hit during a copy, NFT will respond with the            07068000
percent complete and prompt the user for cancel or continue.            07070000
NFT should never be broken and ABORTed during a copy.                   07072000
                                                                        07074000
To terminate NFT hit control-Y or enter "//" in response to the         07076000
DSCOPY prompt.                                                          07078000
                                                                        07080000
While in sub-system mode, MPE commands may be entered and               07082000
executed.  (eg. DSCOPY :LISTF)                                          07084000
                                                                        07086000
The NFT process produces various bits and pieces of printed             07088000
output to document its input and results.  This output may              07090000
be obtained by equating the line printer or a file to the               07092000
formal designator "DSCOPYL".                                            07094000
                                                                        07096000
DSCOPY is not allowed in break.                                         07098000
                                                                        07100000
\ITEM=EXAMPLE                                                           07102000
                                                                        07104000
EXAMPLES                                                                07106000
                                                                        07108000
1.   :DSCOPY file TO newfile                                            07110000
                                                                        07112000
      Makes a local copy named newfile of the local file "file".        07114000
                                                                        07116000
2.   :DSCOPY file; newfile, sysa                                        07118000
                                                                        07120000
      Makes a copy of the local "file" on the system attached to        07122000
  the dsline sysa.  The newfile will be named newfile.  A user          07124000
  DSLINE command and a REMOTE HELLO  must precede this or any           07126000
  DSCOPY request which references a dsline.  The word "TO" has          07128000
  been replaced with a semi-colon.                                      07130000
                                                                        07132000
3.   :DSCOPY                                                            07134000
                                                                        07136000
      Enter sub-system mode.  The remainder of the example is in        07138000
  sub-system mode.  The word DSCOPY is furnished by NFT as a            07140000
  prompt.                                                               07142000
                                                                        07144000
4.   DSCOPY file,sysa; newfile                                          07146000
                                                                        07148000
      Source file is remote, target file is local.                      07150000
                                                                        07152000
5.   DSCOPY file, sysa TO newfile, sysb                                 07154000
                                                                        07156000
      The source and target files are on different remote systems.      07158000
                                                                        07160000
6.   DSCOPY file, sysa                                                  07162000
                                                                        07164000
      The source file is on sysa.  The target file has the same         07166000
  name as the source, but is local.                                     07168000
                                                                        07170000
7.   DSCOPY file, sysa TO newfile,*                                     07172000
                                                                        07174000
      The "*" means the target system is the same as the source         07176000
  system.                                                               07178000
                                                                        07180000
8.   DSCOPY file                                                        07182000
                                                                        07184000
      The file name of the target is the same as the source and         07186000
  both are local.  An error message will always result.                 07188000
                                                                        07190000
9.   DSCOPY file.group.acct                                             07192000
                                                                        07194000
      The target file will have the same name as the target, but        07196000
  will default to the logon group and account.                          07198000
                                                                        07200000
10.  DSCOPY //                                                          07202000
                                                                        07204000
      Terminates NFT.  Control returns to user.                         07206000
                                                                        07208000
                                                                        07210000
                                                                        07212000
\ENTRY=DSLINE,PARMS,OPERATION,EXAMPLE                                   07214000
    :DSLINE                                                             07216000
                                                                        07218000
Opens or closes communication lines with DS/3000.                       07220000
This is the Users command, refer DSCONTROL for Console command.         07222000
                                                                        07224000
                                                                        07226000
SYNTAX                                                                  07228000
                                                                        07230000
To open a DS communications line:                                       07232000
                                                                        07234000
    :DSLINE dsdevice                                                    07236000
            [;LINEBUF=bufsize]                                          07238000
            [;COMP]                                                     07240000
            [;NOCOMP]                                                   07242000
            [;LOCID=local-id-sequence]                                  07244000
            [;REMID=remote-id-sequence1[,remote-id-sequence2]....]      07246000
            [;PHNUM=telephone number]                                   07248000
            [;EXCLUSIVE]                                                07250000
            [;QUIET]                                                    07252000
                                                                        07254000
To close a communication line:                                          07256000
                                                                        07258000
             dsdevice                                                   07260000
    :DSLINE [ds-line-number][;CLOSE]                                    07262000
             @                                                          07264000
                                                                        07266000
\ITEM=PARMS                                                             07268000
PARAMETERS                                                              07270000
                                                                        07272000
dsdevice           Device class name or logical device number           07274000
                   assigned to the DS/3000 communications driver        07276000
                   IODS0 during system configuration.  This para-       07278000
                   meter specifies what physical line you wish          07280000
                   to use.  (REQUIRED PARAMETER)                        07282000
                                                                        07284000
bufsize            A decimal integer specifying the size (in words)     07286000
                   of the DS/3000 line buffer to be used in conjunc-    07288000
                   tion the particular communications line.  The        07290000
                   integer must be within the range 304 < buffer        07292000
                   size < 4096.  Default is the buffer size entered     07294000
                   in response to the PREFERRED BUFFER SIZE prompt      07296000
                   during system configuration.                         07298000
                                                                        07300000
                                                                        07302000
COMP               Overrides default line configuration and allows      07304000
                   Compression for this user.                           07306000
                                                                        07308000
NOCOMP             Overrides default line configuration and             07310000
                   prevents compression for this user.                  07312000
                                                                        07314000
QUIET              Prevents the logon and logoff messages from          07316000
                   writing to $STDLIST device for the remote            07318000
                   DS session or job.                                   07320000
                                                                        07322000
EXCLUSIVE          Specifies that you want exclusive use of the         07324000
                   particular communications line.  If the requested    07326000
                   line already is open and you have specified the      07328000
                   exclusive option, DS/3000 will deny you access       07330000
                   to the line.  Use of this parameter requires CS      07332000
                   capability.  Default is the line is opened non-      07334000
                   exclusive.                                           07336000
                                                                        07338000
local-id-sequence  A string of ASCII characters contained within        07340000
                   quotation marks or a string of octal numbers         07342000
                   separated by commas and contained within             07344000
                   parameters.  If you wish to use a quotation mark     07346000
                   within an ASCII string, use two successive           07348000
                   quotation marks.  In the case of an octal se-        07350000
                   quence each octal number represents one byte and     07352000
                   must be within the range 0 - 377.  The maximum       07354000
                   number of ASCII characters or octal numbers          07356000
                   allowed is 16.                                       07358000
                                                                        07360000
                   The supplied string of ASCII characters or octal     07362000
                   numbers defines the ID sequence that will be sent    07364000
                   from your HP 3000 to the remote HP 3000 when you     07366000
                   attempt to establish the telephone connection.       07368000
                   If the remote HP 3000 does not recognize the         07370000
                   supplied ID sequence as valid, the telephone         07372000
                   connection is terminated.  Default is the ASCII      07374000
                   or octal string entered in response to the LOCAL     07376000
                   SEQUENCE prompt during system configuration.         07378000
                                                                        07380000
remote-id-sequence A string of ASCII characters or octal numbers in     07382000
                   the same format as described under the local-id-     07384000
                   sequence parameter.                                  07386000
                                                                        07388000
                   The supplied strings of ASCII characters or octal    07390000
                   numbers define those remote HP 3000 ID sequences     07392000
                   that will be considered valid when you attempt to    07394000
                   establish the telephone connection.  If the remote   07396000
                   HP 3000 does not send a valid ID sequence, the       07398000
                   telephone connection is terminated.  Default is      07400000
                   the ASCII and octal strings entered in response to   07402000
                   the REMOTE ID SEQUENCE prompt during system          07404000
                   configuration.                                       07406000
                                                                        07408000
telephone-number   A telephone number consisting of digits and dashes.  07410000
                   The maximum length permitted (including both digits  07412000
                   and dashes) is 20 characters.  Provided that YES     07414000
                   was entered in response to the DIAL FACILITY         07416000
                   prompt during system configuration, this telephone   07418000
                   number will be displayed at the operator's console   07420000
                   of your HP 3000 and the operator will then           07422000
                   establish the telephone connection by dialing that   07424000
                   number at the MODEM.  Default is the first one       07426000
                   entered in response to the PHONE NUMBER prompt       07428000
                   during system configuration.                         07430000
                                                                        07432000
ds-line-number     The DS line number assigned to you by DS/3000        07434000
                   when the particular line was opened.                 07436000
                                                                        07438000
@                  Specifies that you wish to close all lines that      07440000
                   you currently have open.                             07442000
                                                                        07444000
CLOSE              Specifies that you wish to close the specified       07446000
                   lines.                                               07448000
                                                                        07450000
\ITEM=OPERATION                                                         07452000
OPERATION                                                               07454000
                                                                        07456000
The :DSLINE command opens or closes hardwired or telephone              07458000
communications lines with DS/3000.                                      07460000
                                                                        07462000
\ITEM=EXAMPLE                                                           07464000
EXAMPLE                                                                 07466000
                                                                        07468000
To initiate a local session on System A, obtain access to the           07470000
hardwired communications line that connects System A to System B, and   07472000
initiate a remote session on System B, enter:                           07474000
                                                                        07476000
  :HELLO USER.X                                                         07478000
  :DSLINE HDS1                                                          07480000
  :REMOTE HELLO USER.X                                                  07482000
                                                                        07484000
Another example using compression and quiet.                            07486000
                                                                        07488000
   :DSLINE REMSYS;COMP;QUIET                                            07490000
                                                                        07492000
Closing the line, to remove logical access; to correct errors;          07494000
and to allow the Console Operator to SHUT the line:                     07496000
                                                                        07498000
   :DSLINE @;CLOSE                                                      07500000
                                                                        07502000
                                                                        07504000
\ENTRY=DSTAT,PARMS,OPERATION,EXAMPLE                                    07506000
    :DSTAT                                                              07508000
                                                                        07510000
Displays the current status of the disc drives on the system.           07512000
                                                                        07514000
SYNTAX                                                                  07516000
                                                                        07518000
              ldn                                                       07520000
    :DSTAT  [     ]                                                     07522000
              ALL                                                       07524000
                                                                        07526000
\ITEM=PARMS                                                             07528000
PARAMETERS                                                              07530000
                                                                        07532000
ldn      An integer specifying the logical device number of the disc    07534000
         drive whose status is desired.                                 07536000
                                                                        07538000
ALL      Causes the status of all disc drives, system and non-system, to07540000
         be displayed.                                                  07542000
                                                                        07544000
The default is that if no parameter is included, only the status of     07546000
non-system discs is displayed.                                          07548000
                                                                        07550000
\ITEM=OPERATION                                                         07552000
OPERATION                                                               07554000
                                                                        07556000
The :DSTAT command causes the display of the current status of the disc 07558000
drives on the system.                                                   07560000
                                                                        07562000
\ITEM=EXAMPLE                                                           07564000
EXAMPLE                                                                 07566000
                                                                        07568000
To display the status of all disc drives, enter:                        07570000
                                                                        07572000
    :DSTAT ALL                                                          07574000
                                                                        07576000
                                                                        07578000
\ENTRY=EDITOR,PARMS,OPERATION,EXAMPLE                                   07580000
    :EDITOR                                                             07582000
                                                                        07584000
Invokes the Editor.                                                     07586000
                                                                        07588000
SYNTAX                                                                  07590000
                                                                        07592000
    :EDITOR [listfile]                                                  07594000
                                                                        07596000
\ITEM=PARMS                                                             07598000
PARAMETERS                                                              07600000
                                                                        07602000
listfile             Actual designator of file to receive any output    07604000
                     resulting from Editor commands LIST and XPLAIN when07606000
                     the OFFLINE option is specified.  Can be any ASCII 07608000
                     output file. Formal designator is EDTLIST.  Because07610000
                     this file often is a line printer, it usually is   07612000
                     defined in an MPE :FILE command and back           07614000
                     referenced as follows:                             07616000
                                                                        07618000
                     :FILE LISTFILE;DEV=LP                              07620000
                     :EDITOR*LISTFILE                                   07622000
                                                                        07624000
                     Default:  If omitted, default is EDITLIST.   If    07626000
                               specified with no device parameter,      07628000
                               default is device LP.                    07630000
                                                                        07632000
                             NOTE                                       07634000
                                                                        07636000
      The formal file designator used in this command                   07638000
      (EDTLIST)                                                         07640000
      cannot be back referenced as an actual file designator            07642000
      in the command parameter list.  For further information,          07644000
      see the discussion of implied :FILE commands in                   07646000
      Section VII of the MPE Commands Reference Manual.                 07648000
                                                                        07650000
\ITEM=OPERATION                                                         07652000
OPERATION                                                               07654000
                                                                        07656000
Accesses the Editor subsystem.                                          07658000
                                                                        07660000
\ITEM=EXAMPLE                                                           07662000
EXAMPLE                                                                 07664000
                                                                        07666000
To access the Editor during a session and specify a line printer        07668000
(device class LP1) as the list device for offline output, enter:        07670000
                                                                        07672000
    :FILE LISTFILE;DEV=LP1                                              07674000
    :EDITOR*LISTFILE                                                    07676000
                                                                        07678000
                                                                        07680000
                                                                        07682000
\ENTRY=ELSE,PARMS,OPERATION,EXAMPLE                                     07684000
    :ELSE                                                               07686000
                                                                        07688000
Provides an alternate execution sequence for an :IF statement.          07690000
                                                                        07692000
SYNTAX                                                                  07694000
                                                                        07696000
    :ELSE                                                               07698000
                                                                        07700000
\ITEM=PARMS                                                             07702000
PARAMETERS                                                              07704000
                                                                        07706000
None                                                                    07708000
                                                                        07710000
\ITEM=OPERATION                                                         07712000
OPERATION                                                               07714000
                                                                        07716000
The :ELSE command is used only with the :IF command.  The :IF command   07718000
is used with the :ENDIF command and, optionally, the :ELSE command,     07720000
to control the execution of a job.  The :IF command, :ENDIF command,    07722000
and optional :ELSE command constitute an IF block.  A logical           07724000
expression is evaluated and, if true, the IF block is executed, if      07726000
false, the ELSE block (if one exists) is executed.                      07728000
                                                                        07730000
\ITEM=EXAMPLE                                                           07732000
EXAMPLE                                                                 07734000
                                                                        07736000
    :RUN UPDATE1               (Run first data base update)             07738000
    :IF JCW<WARN THEN          (Continue if OK so far)                  07740000
    :  SETJCW UPDATE1JCW:=JCW  (Save that return code)                  07742000
    :  RUN UPDATE2             (Run second data base update)            07744000
    :  IF JCW<WARN THEN        (Continue if still OK)                   07746000
    :    SETJCW UPDATE2JCW:=JCW    (Save the second return code)        07748000
    :    RUN DBSTATUS              (Report current status of DB)        07750000
    :    IF (UPDATE1JCW < 50) AND (UPDATE2JCW < 50) THEN                07752000
    :      RUN DAILYRPT                                                 07754000
    :    ENDIF                                                          07756000
    :    IF ((UPDATE1JCW = 1) OR (UPDATE2JCW =1)) THEN                  07758000
    :      RUN WEEKLYRPT                                                07760000
    :    ENDIF                                                          07762000
    :  ELSE           (Second update program failed)                    07764000
    :    RUN FIXUP    (Repair data base and report)                     07766000
    :  ENDIF                                                            07768000
    :ENDIF                                                              07770000
                                                                        07772000
                                                                        07774000
\ENTRY=ENDIF,PARMS,OPERATION,EXAMPLE                                    07776000
    :ENDIF                                                              07778000
                                                                        07780000
Terminates an IF block.                                                 07782000
                                                                        07784000
SYNTAX                                                                  07786000
                                                                        07788000
    :ENDIF                                                              07790000
                                                                        07792000
\ITEM=PARMS                                                             07794000
PARAMETERS                                                              07796000
                                                                        07798000
None                                                                    07800000
                                                                        07802000
\ITEM=OPERATION                                                         07804000
OPERATION                                                               07806000
                                                                        07808000
The :ENDIF command is used to terminate an IF block.  The :IF           07810000
command, :ENDIF command, and optional :ELSE commad, constitute an IF    07812000
block and are used to control the execution of a job.  A logical        07814000
expression is evaluated and, if true, the IF block is executed; if      07816000
false, the :ELSE block (if one exists) is executed.                     07818000
                                                                        07820000
\ITEM=EXAMPLE                                                           07822000
EXAMPLE                                                                 07824000
    :RUN UPDATE1               (Run first data base update)             07826000
    :IF JCW<WARN THEN          (Continue if OK so far)                  07828000
    :  SETJCW UPDATE1JCW:=JCW  (Save that return code)                  07830000
    :  RUN UPDATE2             (Run second data base update)            07832000
    :  IF JCW<WARN THEN        (Continue if still OK)                   07834000
    :    SETJCW UPDATE2JCW:=JCW    (Save the second return code)        07836000
    :    RUN DBSTATUS              (Report current status of DB)        07838000
    :    IF (UPDATE1JCW < 50) AND (UPDATE2JCW < 50) THEN                07840000
    :      RUN DAILYRPT                                                 07842000
    :    ENDIF                                                          07844000
    :    IF ((UPDATE1JCW = 1) OR (UPDATE2JCW =1)) THEN                  07846000
    :      RUN WEEKLYRPT                                                07848000
    :    ENDIF                                                          07850000
    :  ELSE           (Second update program failed)                    07852000
    :    RUN FIXUP    (Repair data base and report)                     07854000
    :  ENDIF                                                            07856000
    :ENDIF                                                              07858000
                                                                        07860000
                                                                        07862000
\ENTRY=EOD,PARMS,OPERATION,EXAMPLE                                      07864000
    :EOD                                                                07866000
                                                                        07868000
Denotes end-of-data on input stream.                                    07870000
                                                                        07872000
SYNTAX                                                                  07874000
                                                                        07876000
    :EOD                                                                07878000
                                                                        07880000
\ITEM=PARMS                                                             07882000
PARAMETERS                                                              07884000
                                                                        07886000
None                                                                    07888000
                                                                        07890000
\ITEM=OPERATION                                                         07892000
OPERATION                                                               07894000
                                                                        07896000
Denotes the end-of-data read through an input stream.  Used primarily to07898000
signify the end-of-data entered through standard input device. Also used07900000
for data submitted through a non-sharable device via the :DATA command. 07902000
                                                                        07904000
\ITEM=EXAMPLE                                                           07906000
EXAMPLE                                                                 07908000
                                                                        07910000
To terminate a data file entered on cards for a session identified as   07912000
:DATA SESS1,BLACK.ACCTSP, you would enter:                              07914000
                                                                        07916000
    :DATA SESS1,BLACK.ACCTSP                                            07918000
             .                                                          07920000
             .                                                          07922000
           data                                                         07924000
             .                                                          07926000
             .                                                          07928000
    :EOD                                                                07930000
                                                                        07932000
                                                                        07934000
\ENTRY=EOF,PARMS,OPERATION,EXAMPLE                                      07936000
    :EOF:                                                               07938000
                                                                        07940000
Simulates hardware end-of-file on input stream from any device.         07942000
                                                                        07944000
SYNTAX                                                                  07946000
                                                                        07948000
    :EOF:  (The last colon in this command must be followed by a blank) 07950000
                                                                        07952000
\ITEM=PARMS                                                             07954000
PARAMETERS                                                              07956000
                                                                        07958000
None                                                                    07960000
                                                                        07962000
\ITEM=OPERATION                                                         07964000
OPERATION                                                               07966000
                                                                        07968000
Denotes end-of-file read through an input stream.  Required to simulate 07970000
a physical end-of-file on HP 2894A Card Reader/Punch when that device is07972000
configured to refuse data submitted via a :DATA command. (This device   07974000
does not provide a true hardware end-of-file indication.)               07976000
                                                                        07978000
\ITEM=EXAMPLE                                                           07980000
EXAMPLE                                                                 07982000
                                                                        07984000
    :EOF:  (The last colon in this command must be followed by a blank) 07986000
\ENTRY=EOJ,PARMS,OPERATION,EXAMPLE                                      07988000
    :EOJ                                                                07990000
                                                                        07992000
Ends a batch job.                                                       07994000
                                                                        07996000
SYNTAX                                                                  07998000
                                                                        08000000
    :EOJ                                                                08002000
                                                                        08004000
\ITEM=PARMS                                                             08006000
PARAMETERS                                                              08008000
                                                                        08010000
None                                                                    08012000
                                                                        08014000
\ITEM=OPERATION                                                         08016000
OPERATION                                                               08018000
                                                                        08020000
Terminates a batch job, and displays the cpu time used (in seconds),    08022000
the elapsed time (in minutes), and the date and time, as follows:       08024000
                                                                        08026000
    CPU=4.  CONNECT=8.  TUE, OCT 18, 1977, 4:17 PM                      08028000
                                                                        08030000
\ITEM=EXAMPLE                                                           08032000
EXAMPLE                                                                 08034000
                                                                        08036000
    :EOJ                                                                08038000
                                                                        08040000
    CPU=4.  CONNECT=8.  TUE, OCT 18, 1977, 4:17 PM                      08042000
                                                                        08044000
                                                                        08046000
\ENTRY=FCOPY                                                            08048000
    :FCOPY                                                              08050000
                                                                        08052000
Accesses the FCOPY subsystem.                                           08054000
                                                                        08056000
SYNTAX                                                                  08058000
                                                                        08060000
    :FCOPY [fcopycommand]                                               08062000
                                                                        08064000
\ITEM=PARMS                                                             08066000
PARAMETERS                                                              08068000
                                                                        08070000
fcopycommand      an FCOPY subsystem command.  (See the FCOPY Reference 08072000
                  Manual for a description of the command syntax.)      08074000
                                                                        08076000
\ITEM=OPERATION                                                         08078000
OPERATION                                                               08080000
                                                                        08082000
This command accesses the FCOPY subsystem from MPE.  If the command is  08084000
entered with no parameters, FCOPY prompts (>) the user for subsystem    08086000
commands one at a time until an EXIT command is entered.  When the MPE  08088000
command contains <fcopycommand> as a parameter, FCOPY executes the      08090000
command and then returns control to MPE.                                08092000
                                                                        08094000
\ITEM=EXAMPLE                                                           08096000
EXAMPLE                                                                 08098000
                                                                        08100000
To access the FCOPY subsystem to execute multiple commands, enter:      08102000
                                                                        08104000
             :FCOPY                                                     08106000
             HP32212A.3.12 FILE COPIER (C) HEWLETT-PACKARD CO. 1980     08108000
                                                                        08110000
             >             (FCOPY subsystem prompt character)           08112000
                                                                        08114000
To access FCOPY to execute a single command and return control to       08116000
MPE, enter the command as follows:                                      08118000
                                                                        08120000
             :FCOPY FROM=UDC.COHEN;TO=;OCTAL;CHAR                       08122000
                                                                        08124000
\ENTRY=FILE,PARMS,NAME,DEVICE,ACCESS,DISP,OPERATION,EXAMPLE             08126000
    :FILE                                                               08128000
                                                                        08130000
Specifies a file's attributes when it is opened.                        08132000
                                                                        08134000
SYNTAX                                                                  08136000
                                                                        08138000
                    { devicespec [access] [disposition] }               08140000
     :FILE namespec { access [devicespec] [disposition] }               08142000
                    { disposition [access] [devicespec] }               08144000
                                                                        08146000
PARAMETERS                                                              08148000
                                                                        08150000
namespec (NAME)       Consists of the formal name used by the program   08152000
                      and may be equated to another file in the system. 08154000
                      (REQUIRED PARAMETER)                              08156000
                                                                        08158000
devicespec (DEVICE)   A list of parameters giving the physical          08160000
                      description of the file.  This consists of the    08162000
                      REC, DEV, ENV, DEN, DISC, CODE, RIO, NORIO,       08164000
                      STD, MSG, and CIR parameters.                     08166000
                                                                        08168000
access (ACCESS)       A list of parameters specifying the type of access08170000
                      granted to a file.                                08172000
                                                                        08174000
disposition (DISP)    Specifies what is to be done with the file after  08176000
                      it is closed. This consists of the DEL, SAVE, and 08178000
                      TEMP parameters.                                  08180000
                                                                        08182000
Enter "PARMS" for information on all the :FILE parameters.              08184000
For information on the subitems NAME, DEVICE, ACCESS or                 08186000
DISP, enter the specific keyword. Carriage return will then             08188000
lead to the next subitem.                                               08190000
                                                                        08192000
\ITEM=PARMS                                                             08194000
\SUBITEM=NAME                                                           08196000
SYNTAX FOR NAMESPEC                                                     08198000
                                                                        08200000
   formaldesignator [= *formaldesignator       ]                        08202000
                    [=$NULL                    ]                        08204000
                    [=$NEWPASS                 ]                        08206000
                    [=$OLDPASS                 ]                        08208000
                    [=$STDIN                   ]                        08210000
                    [=$STDINX                  ]                        08212000
                    [=$STDLIST                 ]                        08214000
                    [=filereference] [,NEW    ]]                        08216000
\STARTHELP                                                              08218000
                                     [,OLD    ]                         08220000
                                     [,OLDTEMP]                         08222000
                                                                        08224000
                                                                        08226000
NAMESPEC PARAMETERS                                                     08228000
                                                                        08230000
formaldesignator      Formal name specified by program opening the file.08232000
                      Contains from 1 to 8 alphanumeric characters      08234000
                      in each field, beginning with a letter.  formal-  08236000
                      designator is used as the file name when file-    08238000
                      reference is not specified.  The format is:       08240000
                                                                        08242000
                        filename[.groupname[.accountname]]              08244000
                           (Lockwords for fields may be supplied.)      08246000
                                                                        08248000
                                                                        08250000
$NULL                 SYSTEM-DEFINED FILE THAT IS ALWAYS EMPTY.         08252000
                                                                        08254000
$NEWPASS              SYSTEM-DEFINED JOB TEMPORARY FILE.  OPENING       08256000
                      $NEWPASS purges any previous temporary file. When 08258000
                      $NEWPASS is closed, it is referenced by the name  08260000
                      $OLDPASS.                                         08262000
                                                                        08264000
$OLDPASS              SYSTEM-DEFINED NAME OF THE LAST TEMPORARY FILE    08266000
                      closed as $NEWPASS.                               08268000
                                                                        08270000
$STDIN                SYSTEM DEFINED NAME OF THE STANDARD JOB INPUT     08272000
                      device. A colon as the first character read on    08274000
                      this file indicates end-of-data.                  08276000
                                                                        08278000
$STDINX               EQUIVALENT TO $STDIN EXCEPT COLON CAN BE READ AS  08280000
                      the first character and received as data (:JOB,   08282000
                      :DATA, :EOJ, and :EOD can not be read as data,    08284000
                      however).                                         08286000
                                                                        08288000
$STDLIST              SYSTEM DEFINED NAME FOR STANDARD JOB/SESSION LIST 08290000
                      device.                                           08292000
                                                                        08294000
filereference         Actual name of file, in the following format:     08296000
                                                                        08298000
                        filename[/lockword][.groupname[.accountname]]   08300000
                                                                        08302000
                      Each field may contain from 1 to 8 alphanumeric   08304000
                      characters, beginning with a letter. Omission of  08306000
                      <lockword> causes MPE to ask for it when the file 08308000
                      is opened, if one is present.  Default <groupname>08310000
                      and <accountname> are the logon group and account.08312000
                                                                        08314000
NEW                   Specification that the file is a new file.        08316000
                                                                        08318000
OLD                   Previously-existing permanent file saved in       08320000
                      system file domain.  File continues to exist      08322000
                      after current session/job terminates.             08324000
                                                                        08326000
OLDTEMP               Previously-existing temporary file in session/    08328000
                      job temporary file domain.  File is deleted       08330000
                      at end of current session/job.                    08332000
                                                                        08334000
                                             NOTE                       08336000
                                                                        08338000
                         NEW, OLD, and OLDTEMP specify the file domain  08340000
                         indicating where the file exists.  If all are  08342000
                         omitted, the domain specified in FOPEN         08344000
                         intrinsic takes effect.                        08346000
                                                                        08348000
                                                                        08350000
\SUBITEM=DEVICE                                                         08352000
SYNTAX FOR DEVICESPEC                                                   08354000
                                                                        08356000
   [;REC= [recsize] [,[blockfactor] [,[F] [,BINARY]]]]                  08358000
\STARTHELP                                                              08360000
                                      [U] [,ASCII ]                     08362000
                                      [V]                               08364000
                                                                        08366000
   [;DEV= [[dsdevice]#] [device][,[outpriority][,numcopies]]]           08368000
                                                                        08370000
   [;ENV= [environment]]                                                08372000
                                                                        08374000
   [;DEN= [density]]                                                    08376000
                                                                        08378000
   [;DISC= [numrec] [,[numextents] [,initalloc]]]                       08380000
                                                                        08382000
   [;CODE= [filecode]]                                                  08384000
   [;RIO]                                                               08386000
                                                                        08388000
   [;NORIO]                                                             08390000
                                                                        08392000
   [;STD]                                                               08394000
                                                                        08396000
   [;MSG]                                                               08398000
                                                                        08400000
   [;CIR]                                                               08402000
                                                                        08404000
These parameters can be used for new files only. An exception is that   08406000
REC can be specified for system-defined files.                          08408000
                                                                        08410000
                                                                        08412000
DEVICESPEC PARAMETERS                                                   08414000
                                                                        08416000
recsize       Record size.  A positive number indicates words while     08418000
              negative indicates bytes. For fixed-length files, this is 08420000
              the logical record size. For undefined-length this is the 08422000
              maximum record size.  For variable length files this is   08424000
              the maximum physical record size.                         08426000
                                                                        08428000
              For either ASCII or binary files with fixed or            08430000
              undefined length records, the recored size is             08432000
              rounded up to the nearest word boundary. For ex-          08434000
              ample, a recsize specified as -106 for an ASCII           08436000
              file is 106 characters (53 words) in length. A            08438000
              recsize of -113 for a binary file is 114 charac-          08440000
              ters (57 words) in length. The rounded sizes              08442000
              should be used in computations for blockfactor            08444000
              or block size.                                            08446000
              Default:  The default value is the configured             08448000
              physical record width of the associated device.           08450000
                                                                        08452000
blockfactor   Number of logical records per physcical block. Default is 08454000
              calculated by dividing the specified <recsize> into the   08456000
              configured <blocksize>; this value is rounded downward to 08458000
              an integer that is never less than 1.                     08460000
                                                                        08462000
F, U, V       File contains fixed (F), undefined (U) or variable (V)    08464000
              length records. Default is <F> for disc and magnetic tape 08466000
              files, <U> for all others.                                08468000
                                                                        08470000
BINARY        File contains binary-coded records. Default.              08472000
                                                                        08474000
ASCII         File contains ASCII-coded records.  Default is BINARY.    08476000
                                                                        08478000
device        Contains a string of ASCII characters terminating with    08480000
              any non-alphanumeric character except a slash or period,  08482000
              designating the device on which the file is to reside.    08484000
              This parameter may be specified in one of the following   08486000
              forms:                                                    08488000
                                                                        08490000
              devclass                                                  08492000
              ldn                                                       08494000
                                                                        08496000
              The devclass form represents a device class name of up to 08498000
              eight alphanumeric characters beginning with a letter, as 08500000
              for example, DISC or TAPE.  If devclass is specified, the 08502000
              file is allocated to any available device in that class.  08504000
              If you are opening a file which is to reside on a private 08506000
              volume, you must specify device class DISC; the file then 08508000
              is allocated to any of the home volume set's volumes that 08510000
              fall within that device class.                            08512000
                                                                        08514000
              The logical device number (ldn) consists of a three-byte  08516000
              numeric string specifying a particular device.  If you are08518000
              opening a file which is to reside on a private volume, you08520000
              must specify a disc drive on which one of the volumes in  08522000
              the home volume set resides.                              08524000
                                                                        08526000
              Default is DISC.                                          08528000
                                                                        08530000
dsdevice      Any of the forms may be used to reference files on        08532000
              a remote computer by preceding the device or volume       08534000
              specification with <dsdevice> #.                          08536000
                                                                        08538000
outpriority   The output priority for spooled device files.  This is a  08540000
              value between 1 (lowest priority) and 13 (highest         08542000
              priority).  Default is 8 when logging is enabled, or 13 if08544000
              logging is disabled.                                      08546000
                                                                        08548000
numcopies     Number of copies of file for spooled output device files. 08550000
              Maximum is 127.  Default is 1.                            08552000
                                                                        08554000
environment   [;ENV= [*formaldesignator] ]                              08556000
                     [filereference    ]                                08558000
                                                                        08560000
              A compiled disc file containing the specifications        08562000
              for a printed page which are not part of the data.        08564000
              These specifications may include the page size, the       08566000
              character font, forms, and other printed requirements     08568000
              to be used in conjunction with the HP 2680A Laser         08570000
              Printing System.  Refer to the manuals for IDS/3000       08572000
              and IFS/3000 for further information.                     08574000
                                                                        08576000
              For example:                                              08578000
                 Create a file for a travel form via IDS/3000 and       08580000
                 IFS/3000.                                              08582000
                    :FILE TRAVEL=TRADMIN.HPENV.HP2680A                  08584000
                    :FILE LP;DEV=LP;ENV=[TRADMIN.HPENV.HP2680A]         08586000
                                        [*TRAVEL              ]         08588000
                                                                        08590000
              The ;ENV parameter in :FILE commands has precedence       08592000
              over environments specified in an FOPEN.                  08594000
                                                                        08596000
              If the environment keyword is specified and the           08598000
              <*formaldesignator> or <filereference> is omitted,        08600000
              any environment from FOPEN is ignored.                    08602000
                                                                        08604000
density       [;DEN= [6250] ]                                           08606000
                     [1600]                                             08608000
                                                                        08610000
              Corresponds to tape densities in BPI, bits per inch.      08612000
              This parameter is only applicable when writing to a       08614000
              tape mounted on the HP7976A variable density tape         08616000
              drive.                                                    08618000
                                                                        08620000
              The density value from a file equation takes precedence   08622000
              over the density specified in a call to FOPEN.  For       08624000
              details on the operation of density selection, see        08626000
              the Intrinsics Manual, Section II.                        08628000
                                                                        08630000
numrec        Maximum number of logical records.  For fixed             08632000
              and undefined length files the maximum value              08634000
              allowed for this field is 2,147,483,647.  For             08636000
              variable length files this value is dependent             08638000
              upon input record size and blocksize.  The file           08640000
              system uses these values to compute other                 08642000
              characteristics of the file as well.  Therefore           08644000
              the values (or default values) specified on the           08646000
              :FILE command may be valid within their respec-           08648000
              tive fields, but may cause overflow errors in             08650000
              the computation of internally needed file                 08652000
              specifications.  Default is a value of 1023.              08654000
                                                                        08656000
                                                                        08658000
numextents    Maximum number of disc extents. This is a value from 1 to 08660000
              32.  Default is 8.                                        08662000
                                                                        08664000
initalloc     Number of extents to be initially allocated to the file   08666000
              at the time is it opened. This is a value from 1 to 32.   08668000
              Default is 1.                                             08670000
                                                                        08672000
filecode      Code indicating a specially-formatted file. This code is  08674000
              recorded in the file label and is available to processes  08676000
              accessing the file through the FGETINFO intrinsic.  For   08678000
              this parameter, any user can specify a positive integer   08680000
              ranging from 0 to 1023.  Certain integers have HP-        08682000
              defined meanings, as follows:                             08684000
                                                                        08686000
              Mnemonic   Integer       Meaning                          08688000
\stophelp                                                               08690000
\stophelp                                                               08692000
                         -401      IMAGE data set.                      08694000
\starthelp                                                              08696000
              USL        1024      USL file.                            08698000
              BASD       1025      BASIC data file.                     08700000
              BASP       1026      BASIC program file.                  08702000
              BASFP      1027      BASIC fast program file.             08704000
              RL         1028      RL file.                             08706000
              PROG       1029      Program file.                        08708000
              SL         1031      SL file.                             08710000
              VFORM      1035      V/3000 FORMS file.                   08712000
              VFAST      1036      V/3000 FAST FORMS file.              08714000
              VREF       1037      V/3000 reformat file.                08716000
              XLSAV      1040      Cross-Loader ASCII file (SAVE).      08718000
              XLBIN      1041      Cross-Loader relocated binary file.  08720000
              XLDSP      1042      Cross-Loader ASCII file (DISPLAY).   08722000
              EDITQ      1050      Edit KEEPQ file (non-COBOL).         08724000
              EDTCQ      1051      Edit KEEPQ file (COBOL).             08726000
              EDTCT      1052      Edit TEXT file (COBOL).              08728000
              TDPDT      1054      TDP/3000 Diary keep file             08730000
              TDPQM      1055      TDP/3000 Standard Q-Mark             08732000
              TDPP       1056      TDP/3000 Standard P-Mark             08734000
              TDPCP      1057      TDP/3000 Cobol P-Mark                08736000
              TDPQ       1058      TDP/3000 Work File                   08738000
              TDPCQ      1059      TDP/3000 Work File                   08740000
\STARTHELP                                                              08742000
              RJEPN      1060      RJE punch file.                      08744000
              QPROC      1070      QUERY procedure file.                08746000
                         1071      QUERY work file.                     08748000
                         1072      QUERY work file.                     08750000
              KSAMK      1080      KSAM key file.                       08752000
              GRAPH      1083      GRAPH specification file.            08754000
              SD         1084      Self-Describing file.                08756000
              LOG        1090      User logging file.                   08758000
              WDOC       1100      HP Word Document                     08760000
              WDICT      1101      HP Word Hyphenation Dictionary       08762000
              WCONF      1102      HP Word Configuration file           08764000
              W2601      1103      HP 2601 Environment file             08766000
              PCELL      1110      IDS/3000 character set file.         08768000
              PFORM      1111      IDS/3000 form file.                  08770000
              P2680      1112      IFS/3000 environment file.           08772000
              PCCMP      1113      IFS/3000 Compiled Char cell file     08774000
              RASTR      1114      Graphics Image in RASTR format       08776000
              OPTLF      1130      On-Line Performance Tool file.       08778000
              TEPES      1131      TEPE/3000 Script file                08780000
              TEPEL      1132      TEPE/3000 Log file                   08782000
              SAMPL      1133      APS/3000 Log file                    08784000
              MPEDL      1139      MPEDCP/DRP Log file                  08786000
              TSR        1140      TOOLSET Root file                    08788000
              TSD        1141      TOOLSET Data file                    08790000
              DRAW       1145      Drawing file for HP Draw             08792000
              FIG        1146      Figure file for HP Draw              08794000
              DSTOR      1156      Store file for RAPID/3000 DICTDBU    08796000
              TCODE      1157      Code file for TRANSACT/3000          08798000
              RCODE      1158      Code file for REPORT/3000            08800000
              ICODE      1159      Code file for INFORM/3000            08802000
              MDIST      1166      HPMAIL Distribution list             08804000
              MTEXT      1167      HPMAIL text                          08806000
              NCONF      1192      Network Configuration file           08808000
              NTRAC      1193      Network Trace file                   08810000
              NLOG       1194      Network Log file                     08812000
              The default is 0.                                         08814000
                                                                        08816000
                                                                        08818000
RIO           If RIO is specified, a relative I/O file is               08820000
              created.  The record length parameter will                08822000
              implicitly be changed to fixed record length.             08824000
              RIO is a special file access method supported             08826000
              by Cobol II.                                              08828000
                                                                        08830000
              The default is NORIO.                                     08832000
                                                                        08834000
              Note that "RIO" and "NORIO" specifications                08836000
              affect only the physical characteristics of               08838000
              the file.  If "NOBUF" is specified in the                 08840000
              :FILE command, the file will be accessed in               08842000
              NON-RIO mode; otherwise RIO access is used with           08844000
              RIO files.  Note that "NOBUF" access is provided          08846000
              for special operations on RIO files such as               08848000
              replicating an RIO file.  "NOBUF" is not                  08850000
              normally used by the RIO user.                            08852000
                                                                        08854000
                                                                        08856000
NORIO         A non-relative I/O file is created.                       08858000
                                                                        08860000
STD           A standard MPE Disc file.                                 08862000
                                                                        08864000
MSG           Specification for a MSG (Message) file allows             08866000
              communication between any set of processes.  Acts like    08868000
              a FIFO (First In, First Out) queue where records are      08870000
              read from the start of the file and logically deleted     08872000
              and/or are appended to the end of the file.               08874000
                                                                        08876000
CIR           Acts like a normal sequential file until full.  When      08878000
              full, the first physical block will be deleted when       08880000
              the next record is written, and remaining blocks will     08882000
              be logically shifted to the front of the file.  Cannot    08884000
              be simultaneously accessed by readers and writers.        08886000
                                                                        08888000
\SUBITEM=ACCESS                                                         08890000
SYNTAX FOR ACCESS                                                       08892000
                                                                        08894000
   [;NOCCTL]                [;NOMULTI]                                  08896000
\STARTHELP                                                              08898000
   [;CCTL  ]                [;MULTI  ]                                  08900000
                            [;GMULTI ]                                  08902000
                                                                        08904000
   [;ACC= {IN     }]        [;NOMR]                                     08906000
          {OUT    }         [;MR  ]                                     08908000
          {UPDATE }                                                     08910000
          {OUTKEEP}                                                     08912000
          {APPEND }         [;WAIT  ]                                   08914000
          {INOUT  }         [;NOWAIT]                                   08916000
                                                                        08918000
   [;BUF= [numbuffers]]                                                 08920000
\STARTHELP                                                              08922000
\STARTHELP                                                              08924000
   [;NOBUF            ]                                                 08926000
                                                                        08928000
   [;EXC]                                                               08930000
   [;SHR]                                                               08932000
   [;EAR]                                                               08934000
   [;SEMI]                                                              08936000
                                                                        08938000
   [;NOLABEL]                                                           08940000
              volid                                                     08942000
   [;LABEL[=[       ][,[type][,[expdate][,[seq]]]]]]                    08944000
             "volid"                                                    08946000
                                                                        08948000
   [;FORMS=formsmsg]                                                    08950000
                                                                        08952000
   [;NOLOCK]                                                            08954000
   [;LOCK]                                                              08956000
                                                                        08958000
   [;STD]                                                               08960000
   [;MSG]                                                               08962000
   [;CIR]                                                               08964000
                                                                        08966000
   [;COPY]                                                              08968000
   [;NOCOPY]                                                            08970000
                                                                        08972000
                                                                        08974000
ACCESS PARAMETERS                                                       08976000
                                                                        08978000
NOCCTL       Indicates that carriage control characters are not being   08980000
             specified in writes to the file.  Default.                 08982000
                                                                        08984000
CCTL         Indicates that carriage control characters are being       08986000
             supplied in writes to the file.  Default is NOCCTL.        08988000
                                                                        08990000
IN           Read-access only permitted to the file. If the ACC= group  08992000
             is omitted, <IN> is the default. with the exception of     08994000
             device files that are output-only.                         08996000
                                                                        08998000
OUT          Write-access only permitted to the file.  Default is       09000000
             read-access only.                                          09002000
                                                                        09004000
OUTKEEP      Write-access only permitted to file, except that previous  09006000
             data is not deleted.  Default is read-access only.         09008000
                                                                        09010000
APPEND       Append-access only permitted to the file.  Default is      09012000
             read-access only.                                          09014000
                                                                        09016000
UPDATE       Any type of access is permitted to the file. Default is    09018000
             read-access only.                                          09020000
                                                                        09022000
INOUT        File permits input/output access.  (Any file intrinsic     09024000
             except FUPDATE can be issued against the file.)  Default is09026000
             read-access only.                                          09028000
                                                                        09030000
numbuffers   Number of buffers to be allocated for the file. This is an 09032000
             integer from 1 to 16. <numbuffers> is ignored for          09034000
             terminals.  Default is 2.                                  09036000
                                                                        09038000
NOBUF        Specifies that no buffers are allocated for the file.      09040000
                                                                        09042000
EXC          Exclusive access.  After the file is opened no other       09044000
             accessors are permitted.  When any access other than ACC=IN09046000
             is specified, this is the default.                         09048000
                                                                        09050000
SHR          Share access.  After file is opened other accessors are    09052000
             permitted.  When access ACC=IN is specified, this is the   09054000
             default.                                                   09056000
                                                                        09058000
EAR          Exclusive, allow read access.  After the file is opened    09060000
             concurrent read access is permitted other accessors,       09062000
             except for message files, where no other readers are       09064000
             allowed.                                                   09066000
                                                                        09068000
SEMI         Semi-exclusive access for message files.  Allows multiple  09070000
             readers only.                                              09072000
                                                                        09074000
NOMULTI      Prohibits sharing files in MULTI mode.  Default.           09076000
                                                                        09078000
MULTI        Concurrent accessors of the file may regard the file as if 09080000
             no buffering is taking place.  Access-control information  09082000
             is shared by the accessors within the same job or session. 09084000
\STARTHELP                                                              09086000
                                                                        09088000
GMULTI       Concurrent global accessors of the file may regard the     09090000
             file as if no buffering is taking place.  Access-control   09092000
             information is shared by all accessors, not restricted to  09094000
             job or session tree.                                       09096000
                                                                        09098000
NOMR         Multi-record access to file is not permitted. Default.     09100000
                                                                        09102000
MR           Multi-record access to file is permitted.  Default is NOMR.09104000
                                                                        09106000
WAIT         I/O requests to the file must be complete before control is09108000
             returned to the program.  Default                          09110000
                                                                        09112000
NOWAIT       Control is returned to the program as soon as I/O requests 09114000
             are queued by MPE.  The program does not have to wait for  09116000
             the physical I/O to be complete before resuming execution. 09118000
             Default is WAIT.                                           09120000
                                                                        09122000
NOLABEL      Specifies that this is not a labeled tape.  Default.       09124000
                                                                        09126000
LABEL        Specifies that this is a labeled tape. Default             09128000
             is NOLABEL.                                                09130000
                                                                        09132000
"volid"      Up to six characters identifying a labeled magnetic tape   09134000
 volid       volume.  Optional when file opened for output; volid for   09136000
             at least first volume must be specified when file opened   09138000
             for input.                                                 09140000
                                                                        09142000
             In the unquoted form, the volume id can only contain       09144000
             alphanumeric characters.  In the quoted form, it can       09146000
             contain any printable character.  To use a quotation       09148000
             mark (") in the volid, it must be entered twice.           09150000
                                                                        09152000
type         Three characters that specify label type information, as   09154000
             follows:                                                   09156000
                                                                        09158000
             ANS - ANSI-standard label.                                 09160000
             IBM - IBM-standard label.                                  09162000
                                                                        09164000
             Default is ANS.                                            09166000
                                                                        09168000
expdate      Month/day/year, written in the format mm/dd/yy.  This      09170000
             specifies the expiration date of the file, or the date     09172000
             after which information contained in the file is no longer 09174000
             useful.  The file can be overwritten after this date.      09176000
                                                                        09178000
                                                                        09180000
             immediately.                                               09182000
                                                                        09184000
seq          Up to four numeric characters that specify the position of 09186000
             the file relative to other files on the tape, or one of the09188000
             following:                                                 09190000
                                                                        09192000
             0     - Causes a search of all volumes until the file is   09194000
                     found.                                             09196000
                                                                        09198000
             ADDF  - The tape will be positioned so as to add a new file09200000
                     on the end of the volume (or last volume in a      09202000
                     multi-volume set).  Not to be used for the first   09204000
                     file on a volume set.                              09206000
                                                                        09208000
             NEXT  - Tape will be positioned at next file on the tape.  09210000
                     If this is the first open for the file, then NEXT  09212000
                     will position the file as the first file on the    09214000
                     tape.  If this is not the first open for the file  09216000
                     and rewind occurred on the previous close, then the09218000
                     position will remain at the beginning of the       09220000
                     previous file.                                     09222000
                                                                        09224000
                     Default is NEXT.                                   09226000
                                                                        09228000
formsmsg     A forms message that can be used for such purposes as      09230000
             telling the Console Operator what type of paper to use in  09232000
             the line printer.  This message will be displayed on the   09234000
             console and must be verified by the operator before the    09236000
             user can access the file.  The message itself is a string  09238000
             of not more than 49 characters terminated with a period.   09240000
             Default is no message.                                     09242000
                                                                        09244000
NOLOCK       Unlocks a locked file.  Does not allow the file to         09246000
             be locked programmatically.  Default.                      09248000
                                                                        09250000
LOCK         Dynamically locks a file.  Permits the file to be locked   09252000
             programmatically.  Default is NOLOCK.                      09254000
                                                                        09256000
STD          Specifies a standard file type (not KSAM, RIO, MSG, or     09258000
             circular type file.)                                       09260000
                                                                        09262000
MSG          Specifies a message file type.  This allows esta-          09264000
             blishment of unidirectional, FIFO oriented files which     09266000
             allow processes to communicate with one another.           09268000
                                                                        09270000
CIR          Specifies a circular file type.  This establishes a file   09272000
             which behaves like a sequential file until it is full,     09274000
             after which writing of the next record causes the oldest   09276000
             block to be deleted.                                       09278000
                                                                        09280000
COPY         Specifies that the file, while being of non-STD type, will 09282000
             be treated as a file system sequential file.  This allows  09284000
             for nondestructive copying and replication.                09286000
                                                                        09288000
NOCOPY       This denies COPY access to a file.                         09290000
                                                                        09292000
\SUBITEM=DISP                                                           09294000
SYNTAX FOR DISPOSITION                                                  09296000
                                                                        09298000
   [;DEL ]                                                              09300000
   [;TEMP]                                                              09302000
   [;SAVE]                                                              09304000
                                                                        09306000
If none of these parameters are supplied, the disposition of the file is09308000
as it was when opened, or as specified by the close.                    09310000
                                                                        09312000
DISPOSITION PARAMETERS                                                  09314000
                                                                        09316000
DEL    The file is deleted when closed.                                 09318000
                                                                        09320000
SAVE   The file is saved in the permanent file domain when closed.      09322000
                                                                        09324000
TEMP   The file is saved in the job/session temporary domain when       09326000
       closed.                                                          09328000
                                                                        09330000
\ITEM=OPERATION                                                         09332000
OPERATION                                                               09334000
                                                                        09336000
Specifies the attributes for a file.  Used to override the              09338000
specifications given to FOPEN by a program.  The attributes of an       09340000
existing disc file or physical devices constraints cannot be overridden.09342000
The :FILE command remains in effect for entire job/session.  It is put  09344000
to use when a program or subsystem opens a file using the               09346000
<formaldesignator> specified by the :FILE command. The :FILE command can09348000
be revoked by :RESET or superceded by another :FILE command.            09350000
                                                                        09352000
\ITEM=EXAMPLE                                                           09354000
EXAMPLE                                                                 09356000
                                                                        09358000
A program references two files by the file names (<formaldesignators>)  09360000
SOURCE and DEST, but you wish to use two existing disc files INX and    09362000
OUTX as the actual files for the program.  This is done by:             09364000
                                                                        09366000
   :FILE SOURCE=INX                                                     09368000
   :FILE DEST=OUTX                                                      09370000
   :RUN MYPROG                                                          09372000
                                                                        09374000
Now you wish to run the program using input from a card reader which has09376000
80-byte records and has the device class name CARD:                     09378000
                                                                        09380000
   :FILE SOURCE,OLD;REC=-80;DEV=CARD                                    09382000
                                                                        09384000
Output is to be sent to a new file FILEX with 64-word fixed-length      09386000
records, blocked two records per block in ASCII code.  FILEX is limited 09388000
to 800 records among 10 extents, two of which are to be immediately     09390000
allocated.  The file is to be permanently saved when MYPROG closes it.  09392000
Enter:                                                                  09394000
                                                                        09396000
   :FILE DEST=FILEX,NEW;REC=64,2,F,ASCII;DISC=800,10,2;SAVE             09398000
   :RUN MYPROG                                                          09400000
                                                                        09402000
                                                                        09404000
                                                                        09406000
                                                                        09408000
\ENTRY=FOREIGN,PARMS,OPERATION,EXAMPLE                                  09410000
    :FOREIGN                                                            09412000
                                                                        09414000
Informs the system that a particular disc volume is a foreign           09416000
disc.                                                                   09418000
                                                                        09420000
SYNTAX                                                                  09422000
                                                                        09424000
   :FOREIGN ldn                                                         09426000
                                                                        09428000
\ITEM=PARMS                                                             09430000
PARAMETERS                                                              09432000
                                                                        09434000
ldn          Logical device that foreign disc volume is mounted         09436000
             on.                                                        09438000
\ITEM=OPERATION                                                         09440000
OPERATION                                                               09442000
                                                                        09444000
Forces the system to treat the volume currently mounted on              09446000
device ldn as a foreign disc volume. The ldn must be in a               09448000
foreign class, and the volume must not be in use.                       09450000
                                                                        09452000
                             NOTE                                       09454000
                                                                        09456000
                                                                        09458000
                                                                        09460000
      If a foreign disc is to be FOPENed by logical device              09462000
      number, it is necessary for the volume to be mounted              09464000
      BEFORE the FOPEN takes place.  Otherwise FOPEN will               09466000
      assume a serial disc is to be mounted by defasult.                09468000
      This problem may be avoided by opening the disc by                09470000
      class name.                                                       09472000
                                                                        09474000
\ITEM=EXAMPLE                                                           09476000
EXAMPLE                                                                 09478000
                                                                        09480000
To force the system to treat logical device 3 as a foreign              09482000
disc volume, enter:                                                     09484000
                                                                        09486000
     :FOREIGN 3                                                         09488000
                                                                        09490000
\ENTRY=FORTGO,PARMS,OPERATION,EXAMPLE                                   09492000
    :FORTGO                                                             09494000
                                                                        09496000
Compiles, prepares, and executes a FORTRAN program.                     09498000
                                                                        09500000
SYNTAX                                                                  09502000
                                                                        09504000
   :FORTGO [textfile][,[listfile][,[masterfile][,[newfile]              09506000
                                                                        09508000
\ITEM=PARMS                                                             09510000
PARAMETERS                                                              09512000
                                                                        09514000
textfile     Actual designator of input file from which source program  09516000
             is read.  Can be any ASCII input file.  Formal designator  09518000
             is FTNTEXT.  Default is $STDIN.                            09520000
                                                                        09522000
listfile     Actual designator of file on which program listing is      09524000
             written.  Can be any ASCII output file. Formal designator  09526000
             is FTNLIST.  Default is $STDLIST.                          09528000
                                                                        09530000
masterfile   Actual designator of master file which is merged against   09532000
             <textfile> to produce composite source. Can be any ASCII   09534000
             input file.  Formal designator is FTNMAST.  Default is for 09536000
             no file to be read, input is read from <textfile>.         09538000
                                                                        09540000
newfile      Actual designator of merged <textfile> and <masterfile>.   09542000
             Can be any ASCII output file.  Formal designator is FTNNEW.09544000
             Default is for no file to be written.                      09546000
                                                                        09548000
                             NOTE                                       09550000
                                                                        09552000
      The formal file designators used in this command                  09554000
      (FTNTEXT, FTNLIST, FTNMAST, FTNNEW)                               09556000
      cannot be back referenced as actual file designators              09558000
      in the command parameter list.  For further information,          09560000
      see the discussion of implied :FILE commands in                   09562000
      Section VII of the MPE Commands Reference Manual.                 09564000
                                                                        09566000
\ITEM=OPERATION                                                         09568000
OPERATION                                                               09570000
                                                                        09572000
Compiles, prepares, and allocates/executes a FORTRAN program.  If you do09574000
not specify a source file, MPE expects your input from your standard    09576000
job/session input device.  If you do not specify <listfile>, MPE writes 09578000
your listing to your standard job/session list device.  This command    09580000
creates a temporary user subprogram library (USL) file ($NEWPASS) that  09582000
cannot be accessed, and a temporary program file that can be accessed   09584000
under the name $OLDPASS.                                                09586000
                                                                        09588000
\ITEM=EXAMPLE                                                           09590000
EXAMPLE                                                                 09592000
                                                                        09594000
To compile, prepare, and execute a FORTRAN program entered from your    09596000
standard input device, with the program listing transmitted to your     09598000
standard list device, enter:                                            09600000
                                                                        09602000
    :FORTGO                                                             09604000
                                                                        09606000
To compile, prepare, and execute a FORTRAN program entered from the disc09608000
file SOURCE and transmit the resulting program listing to the disc file 09610000
LISTFL, enter:                                                          09612000
                                                                        09614000
    :FORTGO SOURCE,LISTFL                                               09616000
                                                                        09618000
                                                                        09620000
\ENTRY=FORTPREP,PARMS,OPERATION,EXAMPLE                                 09622000
    :FORTPREP                                                           09624000
                                                                        09626000
Compiles and prepares a FORTRAN program.                                09628000
                                                                        09630000
SYNTAX                                                                  09632000
                                                                        09634000
 :FORTPREP [textfile][,[progfile][,[listfile][,[masterfile][,newfile]]]]09636000
                                                                        09638000
\ITEM=PARMS                                                             09640000
PARAMETERS                                                              09642000
                                                                        09644000
textfile            Actual designator of input file from which source   09646000
                    program is read.  Can be any ASCII input file.      09648000
                    Formal designator is FTNTEXT.  Default is $STDIN.   09650000
                                                                        09652000
progfile            Actual designator of program file on which prepared 09654000
                    program segments are written.  Can be any binary    09656000
                    output file with file code of PROG or 1029.  If     09658000
                    entered, this parameter must indicate a file created09660000
                    in one of two ways:                                 09662000
                                                                        09664000
                    1.  With the MPE :BUILD command using a <filecode>  09666000
                        parameter of PROG or 1029.                      09668000
                                                                        09670000
                                     NOTE                               09672000
                                                                        09674000
                    A program file is limited to only one extent. Thus, 09676000
                    the <numextents> parameter of the :BUILD command    09678000
                    must be 1.                                          09680000
                                                                        09682000
                    2.  By specifying a non-existent file in the        09684000
                        <progfile> parameter, in which case a job/      09686000
                        session temporary file of the correct size and  09688000
                        type is created.                                09690000
                                                                        09692000
                    Default is $NEWPASS is assigned.                    09694000
                                                                        09696000
listfile            Actual designator of file on which program listing  09698000
                    is written.  Can be any ASCII output file.  Formal  09700000
                    designator is FTNLIST. Default is $STDLIST.         09702000
                                                                        09704000
masterfile          Actual designator of master file which is merged    09706000
                    against <textfile> to produce composite source.  Can09708000
                    be any ASCII input file. Formal designator is       09710000
                    FTNMAST.  Default is master file is not read, input 09712000
                    is read from <textfile>.                            09714000
                                                                        09716000
newfile             Actual designator of merged <textfile> and          09718000
                    <masterfile>.  Can be any ASCII output file. Formal 09720000
                    designator is FTNNEW.  Default is no file is        09722000
                    written.                                            09724000
                                                                        09726000
                             NOTE                                       09728000
                                                                        09730000
      The formal file designators used in this command                  09732000
      (FTNTEXT, FTNPROG, FTNLIST, FTNMAST, FTNNEW)                      09734000
      cannot be back referenced as actual file designators              09736000
      in the command parameter list.  For further information,          09738000
      see the discussion of implied :FILE commands in                   09740000
      Section VII of the MPE Commands Reference Manual.                 09742000
                                                                        09744000
\ITEM=OPERATION                                                         09746000
OPERATION                                                               09748000
                                                                        09750000
Compiles and prepares a FORTRAN program onto a program file on disc. If 09752000
you do not specify a source file, MPE expects your input from your      09754000
current job/session input device.  If you create the program file prior 09756000
to compilation, you must assign a <filecode> of PROG or 1029.  If you do09758000
not specify <listfile>, MPE sends the output to your current list       09760000
device.  The user subprogram library (USL) file created during compil-  09762000
ation is a temporary file passed directly to the preparation mechanism; 09764000
you can access it under the name $OLDPASS only if the program file is   09766000
not $NEWPASS.  The program file also is opened as a temporary file.     09768000
                                                                        09770000
\ITEM=EXAMPLE                                                           09772000
EXAMPLE                                                                 09774000
                                                                        09776000
To compile and prepare a FORTRAN program entered through the current    09778000
input device, onto the file $NEWPASS, with the listing printed on the   09780000
current list device, enter:                                             09782000
                                                                        09784000
    :FORTPREP                                                           09786000
                                                                        09788000
If the next command is one to execute the program, the file $NEWPASS is 09790000
referenced in the execute command under the name $OLDPASS.              09792000
                                                                        09794000
To compile and prepare a FORTRAN source program from a source file named09796000
SFILE into a program file named MYPROG, with the resulting listing sent 09798000
to the current list device, enter:                                      09800000
                                                                        09802000
    :FORTPREP SFILE,MYPROG                                              09804000
                                                                        09806000
                                                                        09808000
\ENTRY=FORTRAN,PARMS,OPERATION,EXAMPLE                                  09810000
    :FORTRAN                                                            09812000
                                                                        09814000
Compiles a FORTRAN program.                                             09816000
                                                                        09818000
SYNTAX                                                                  09820000
                                                                        09822000
 :FORTRAN [textfile][,[uslfile][,[listfile][,[masterfile][,newfile]]]]  09824000
                                                                        09826000
\ITEM=PARMS                                                             09828000
PARAMETERS                                                              09830000
                                                                        09832000
textfile           Actual designator of input file from which source    09834000
                   program is read.  Can be any ASCII input file. Formal09836000
                   designator is FTNTEXT.  Default is $STDIN.           09838000
                                                                        09840000
uslfile            Actual designator of user subprogram library (USL)   09842000
                   file on which object program is written. Can be any  09844000
                   binary output file with <filecode> of USL or 1024.   09846000
                   Formal designator is FTNUSL.  If entered, this       09848000
                   parameter must indicate a file created previously in 09850000
                   one of four ways:                                    09852000
                                                                        09854000
                   1.  By saving a USL file (with the MPE :SAVE command)09856000
                       created by a previous compilation where the      09858000
                       default value was used for the <uslfile>         09860000
                       parameter.                                       09862000
                                                                        09864000
                   2.  By building the USL with the Segmenter -BUILDUSL 09866000
                       command.  (See the MPE Segmenter Reference       09868000
                       Manual.)                                         09870000
                                                                        09872000
                   3.  By creating a new USL file with the MPE :BUILD   09874000
                       command with a <filecode> of USL or 1024.        09876000
                                                                        09878000
                   4.  By specifying a non-existent <uslfile> parameter,09880000
                       thereby creating a permanent file of the correct 09882000
                       size and type.                                   09884000
                                                                        09886000
                   Default is $NEWPASS is assigned.                     09888000
                                                                        09890000
listfile           Actual designator of file on which program listing is09892000
                   written.  Can be any ASCII output file.  Formal      09894000
                   designator is FTNLIST.  Default is $STDLIST.         09896000
                                                                        09898000
masterfile         Actual designator of master file which is merged     09900000
                   against <textfile> to produce composite source. Can  09902000
                   be any ASCII input file.  Formal designator is       09904000
                   FTNMAST.  Default is master file is not read, input  09906000
                   is read from <textfile>.                             09908000
                                                                        09910000
newfile            Actual designator of merged <textfile> and           09912000
                   <masterfile>.  Can be any ASCII output file. Formal  09914000
                   designator is FTNNEW.  Default is no file is written.09916000
                                                                        09918000
                             NOTE                                       09920000
                                                                        09922000
      The formal file designators used in this command                  09924000
      (FTNTEXT, FTNUSL, FTNLIST, FTNMAST, FTNNEW)                       09926000
      cannot be back referenced as actual file designators              09928000
      in the command parameter list.  For further information,          09930000
      see the discussion of implied :FILE commands in                   09932000
      Section VII of the MPE Commands Reference Manual.                 09934000
                                                                        09936000
\ITEM=OPERATION                                                         09938000
OPERATION                                                               09940000
                                                                        09942000
Compiles FORTRAN program onto a USL file on disc.  If you do not specify09944000
<textfile>, MPE expects your input from your current input device.  If  09946000
you create the USL prior to compilation, you must assign a <filecode> of09948000
USL or 1024.  If you do not specify <listfile>, MPE sends the listing to09950000
the current list device.                                                09952000
                                                                        09954000
\ITEM=EXAMPLE                                                           09956000
EXAMPLE                                                                 09958000
                                                                        09960000
To compile a FORTRAN program entered from your current input device into09962000
an object program in the USL file $NEWPASS, and write the listing to    09964000
your current list device, enter:                                        09966000
                                                                        09968000
    :FORTRAN                                                            09970000
                                                                        09972000
If the next command is one to prepare an object program, $NEWPASS can be09974000
passed to that command as an input file named $OLDPASS.                 09976000
                                                                        09978000
To compile a FORTRAN program residing on the disc file SOURCE into an   09980000
object program on the USL file OBJECT, with the program listing sent to 09982000
the disc file LISTFL, enter:                                            09984000
                                                                        09986000
    :BUILD OBJECT;CODE=USL                                              09988000
    :FORTRAN SOURCE,OBJECT,LISTFL                                       09990000
                                                                        09992000
                                                                        09994000
\ENTRY=FREERIN,PARMS,OPERATION,EXAMPLE                                  09996000
    :FREERIN                                                            09998000
                                                                        10000000
Releases a global Resource Identification Number (RIN).                 10002000
                                                                        10004000
SYNTAX                                                                  10006000
                                                                        10008000
    :FREERIN rin                                                        10010000
                                                                        10012000
\ITEM=PARMS                                                             10014000
PARAMETERS                                                              10016000
                                                                        10018000
rin            The RIN to be released.  Must be a number from 1 to 1024.10020000
               (REQUIRED PARAMETER)                                     10022000
                                                                        10024000
\ITEM=OPERATION                                                         10026000
OPERATION                                                               10028000
                                                                        10030000
If you have acquired a RIN with the :GETRIN command, you can release it 10032000
with the :FREERIN command.  This returns the RIN to the RIN pool managed10034000
by MPE.  (A RIN is used to manage a resource shared between two or more 10036000
jobs/sessions so that only one job/session at a time can access that    10038000
resource.)                                                              10040000
                                                                        10042000
                               NOTE                                     10044000
                                                                        10046000
    To free a RIN, you must be the original owner of that RIN --        10048000
    the user who actually issued the :GETRIN command that               10050000
    allocated the RIN and assigned it a password.                       10052000
                                                                        10054000
\ITEM=EXAMPLE                                                           10056000
EXAMPLE                                                                 10058000
                                                                        10060000
To release RIN 1, enter:                                                10062000
                                                                        10064000
    :FREERIN 1                                                          10066000
                                                                        10068000
                                                                        10070000
\ENTRY=GETLOG,PARMS,OPERATION,EXAMPLE                                   10072000
:GETLOG                                                                 10074000
                                                                        10076000
Establishes a logging identifier on the system.                         10078000
                                                                        10080000
SYNTAX                                                                  10082000
                                                                        10084000
                                 ,DISC                                  10086000
     :GETLOG logid; LOG=logfile {     }[;PASS=password]                 10088000
                                 ,TAPE                                  10090000
\ITEM=PARMS                                                             10092000
PARAMETERS                                                              10094000
logid     The logging identifier to be established.  Contains           10096000
          from 1 to 8 alphanumeric characters, beginning with           10098000
          a letter. (REQUIRED PARAMETER)                                10100000
                                                                        10102000
logfile   The name of the file to receive data from the logging         10104000
          procedure.  Must be specified as residing on DISC or          10106000
          TAPE.  Contains from 1 to 8 alphanumeric characters           10108000
          beginning with a letter.  (For disc files the                 10110000
          user can specify the fully qualified file name.)              10112000
          (REQUIRED PARAMETER).                                         10114000
                                                                        10116000
password  Logging identifier password, optionally assigned by           10118000
          the creator for protection against illegal use of             10120000
          of his identifier.  Contains from 1 to 8 alphanumeric         10122000
          characters, beginning with a letter.                          10124000
                                                                        10126000
\ITEM=OPERATION                                                         10128000
OPERATION                                                               10130000
                                                                        10132000
Establishes a logging identifier on the system by entering the logid,   10134000
and the other information specified in the command, into the            10136000
directory of logging identifiers.  To access the logging system         10138000
with this identifier, the OPENLOG intrinsic must supply the             10140000
identifier and the password.  There cannot be two logid's               10142000
on the system with the same name at the same time.  The                 10144000
LISTLOG command can be used to find out what logid's                    10146000
currently exist.                                                        10148000
                                                                        10150000
\ITEM=EXAMPLE                                                           10152000
EXAMPLE                                                                 10154000
To create the logging identifier FINANCE and associate it with          10156000
the tape destination file NEWDATE, enter:                               10158000
                                                                        10160000
          :GETLOG FINANCE;LOG=NEWDATA, TAPE                             10162000
\ENTRY=GETRIN,PARMS,OPERATION,EXAMPLE                                   10164000
    :GETRIN                                                             10166000
                                                                        10168000
Acquires global Resource Identification Number (RIN) and assigns        10170000
password to it.                                                         10172000
                                                                        10174000
SYNTAX                                                                  10176000
                                                                        10178000
    :GETRIN rinpassword                                                 10180000
                                                                        10182000
\ITEM=PARMS                                                             10184000
PARAMETERS                                                              10186000
                                                                        10188000
rinpassword          Password required in the intrinsic that locks the  10190000
                     RIN.  This is a string of up to eight alphanumeric 10192000
                     characters, beginning with a letter.               10194000
                     (REQUIRED PARAMETER)                               10196000
                                                                        10198000
\ITEM=OPERATION                                                         10200000
OPERATION                                                               10202000
                                                                        10204000
Acquires a global RIN.  (A RIN is used in managing a resource shared    10206000
between two or more jobs/sessions so that only one job/session at a time10208000
can access this resource.)                                              10210000
                                                                        10212000
MPE displays the RIN on your current list device as follows:            10214000
                                                                        10216000
    RIN: <rin>                                                          10218000
                                                                        10220000
where <rin> is the RIN acquired and is a number ranging from 1 to 1024. 10222000
                                                                        10224000
Users who know the RIN and its password can use the RIN in jobs until   10226000
the use who acquired the RIN releases it with the :FREERIN command.     10228000
The RIN acquired always is a positive integer unique within MPE.  The   10230000
total number of RIN's that MPE can allocate is specified when the system10232000
is configured, and in no case can exceed 1024.                          10234000
                                                                        10236000
\ITEM=EXAMPLE                                                           10238000
EXAMPLE                                                                 10240000
                                                                        10242000
To acquire a global RIN and assign to it the password MYRIN, enter:     10244000
                                                                        10246000
    :GETRIN MYRIN                                                       10248000
                                                                        10250000
MPE responds with the RIN number assigned, as for example:              10252000
                                                                        10254000
    RIN: 1                                                              10256000
                                                                        10258000
                                                                        10260000
\ENTRY=GIVE,PARMS,OPERATION,EXAMPLE                                     10262000
     :GIVE                                                              10264000
                                                                        10266000
Assigns a :DOWNed device to diagnostics.                                10268000
                                                                        10270000
SYNTAX                                                                  10272000
                                                                        10274000
     :GIVE ldn                                                          10276000
                                                                        10278000
\ITEM=PARMS                                                             10280000
PARAMETERS                                                              10282000
                                                                        10284000
ldn          The logical device number.                                 10286000
                                                                        10288000
\ITEM=OPERATION                                                         10290000
OPERATION                                                               10292000
                                                                        10294000
This command is currently not required by the HP 3000 diagnostics       10296000
operating under MPE IV.                                                 10298000
                                                                        10300000
\ITEM=EXAMPLE                                                           10302000
EXAMPLES                                                                10304000
                                                                        10306000
To assign a :DOWNed device with logical device number 35 to diag-       10308000
nostics enter:                                                          10310000
                                                                        10312000
     :DOWN 35                                                           10314000
     :GIVE 35                                                           10316000
     :UP 35                                                             10318000
     11:20/3/LDEV#35 IN USE BY DIAGNOSTICS                              10320000
                                                                        10322000
To assign a spooled job-accepting card reader to diagnostics enter:     10324000
                                                                        10326000
     :STOPSPOOL 5                                                       10328000
     11:16/31/SP#5/STOPPED                                              10330000
     11:16/31/LDEV#5 NOT READY                                          10332000
     :REFUSE 5                                                          10334000
     :ABORTIO 5                                                         10336000
     11:16/3/LDEV#5 NO I/O PENDING                                      10338000
     :DOWN 5                                                            10340000
     :GIVE 5                                                            10342000
     :UP 5                                                              10344000
     11:16/3/LDEV#5 IN USE BY DIAGNOSTICS                               10346000
                                                                        10348000
\ENTRY=HEADOFF,PARMS,OPERATION,EXAMPLE                                  10350000
     :HEADOFF                                                           10352000
                                                                        10354000
Stops HEADER/TRAILER output to a device.                                10356000
                                                                        10358000
SYNTAX                                                                  10360000
                                                                        10362000
     :HEADOFF ldn                                                       10364000
                                                                        10366000
\ITEM=PARMS                                                             10368000
PARAMETERS                                                              10370000
                                                                        10372000
ldn          The logical device number.                                 10374000
                                                                        10376000
\ITEM=OPERATION                                                         10378000
OPERATION                                                               10380000
                                                                        10382000
If the device is in use and a HEADER has already printed, the request   10384000
will be satisfied after the associated TRAILER is printed.              10386000
                                                                        10388000
\ITEM=EXAMPLE                                                           10390000
EXAMPLES                                                                10392000
                                                                        10394000
To stop HEADER/TRAILER output to logical device 6, enter:               10396000
                                                                        10398000
     :HEADOFF 6                                                         10400000
                                                                        10402000
\ENTRY=HEADON,PARMS,OPERATION,EXAMPLE                                   10404000
     :HEADON                                                            10406000
                                                                        10408000
Resumes HEADER/TRAILER output to device.                                10410000
                                                                        10412000
SYNTAX                                                                  10414000
                                                                        10416000
     :HEADON ldn                                                        10418000
                                                                        10420000
\ITEM=PARMS                                                             10422000
PARAMETERS                                                              10424000
                                                                        10426000
ldn          The logical device number.                                 10428000
                                                                        10430000
\ITEM=OPERATION                                                         10432000
OPERATION                                                               10434000
                                                                        10436000
If the device is in use, the request will be satisfied after the        10438000
current output is completed.  HEADON is enabled on all cold loads.      10440000
                                                                        10442000
When the header/trailer facility is enabled, and output is directed     10444000
to a card punch, MPE automatically punches a header card and a          10446000
trailer card identifying the job that produced the file; if output      10448000
is directed to a line printer, MPE automatically prints header and      10450000
trailer pages identifying the job that produced the file.               10452000
                                                                        10454000
\ITEM=EXAMPLE                                                           10456000
EXAMPLES                                                                10458000
                                                                        10460000
To resume HEADER/TRAILER output to logical device number 6, enter:      10462000
                                                                        10464000
     :HEADON 6                                                          10466000
                                                                        10468000
\ENTRY=HELLO,PARMS,OPERATION,EXAMPLE                                    10470000
    :HELLO                                                              10472000
                                                                        10474000
Initiates an interactive session.                                       10476000
                                                                        10478000
SYNTAX                                                                  10480000
                                                                        10482000
    :HELLO [sessionname,]username[/userpass].acctname[/acctpass]        10484000
           [,groupname[/grouppass]]                                     10486000
                                                                        10488000
           [;TERM=termtype]                                             10490000
           [;TIME=cpusecs]                                              10492000
                                                                        10494000
                   BS                                                   10496000
                   CS                                                   10498000
           [;PRI={    }]                                                10500000
                   DS                                                   10502000
                   ES                                                   10504000
                                                                        10506000
            ;INPRI=inputpriority                                        10508000
           [                     ]                                      10510000
            ;HIPRI                                                      10512000
                                                                        10514000
\ITEM=PARMS                                                             10516000
PARAMETERS                                                              10518000
                                                                        10520000
sessionname         Arbitrary name used in conjunction with <username>  10522000
                    and <acctname> parameters to form a session         10524000
                    identity.  Contains from 1 to 8 alphanumeric        10526000
                    characters, beginning with a letter.  Default is no 10528000
                    session name is assigned.                           10530000
                                                                        10532000
username            A user name, established by Account Manager, that   10534000
                    allows you to log on under this account. Contains   10536000
                    from 1 to 8 alphanumeric characters, beginning with 10538000
                    a letter.  (REQUIRED PARAMETER)                     10540000
                                                                        10542000
userpass            User password, optionally assigned by Account       10544000
                    Manager.  Contains from 1 to 8 alphanumeric         10546000
                    characters, beginning with a letter.                10548000
                                                                        10550000
acctname            Name of account, as established by Account Manager. 10552000
                    Contains from 1 to 8 alphanumeric characters,       10554000
                    beginning with a letter.  The <acctname> parameter  10556000
                    must be preceded by a period. (REQUIRED PARAMETER)  10558000
                                                                        10560000
acctpass            Account password, optionally assigned by System     10562000
                    Manger.  Contains from 1 to 8 alphanumeric          10564000
                    characters, beginning with a letter.                10566000
                                                                        10568000
groupname           Name of group to be used for local file domain and  10570000
                    CPU time charges.  Established by Account Manager.  10572000
                    Contains from 1 to 8 alphanumeric characters,       10574000
                    beginning with a letter.  Default is your home group10576000
                    if you are assigned one by Account Manager.         10578000
                    (Optional if you have a home group, required if home10580000
                    group not assigned.)                                10582000
                                                                        10584000
grouppass           (Required if assigned and you are logging on under  10586000
                     other than home group.  Not required if logging on 10588000
                     under home group.)                                 10590000
                                                                        10592000
                    Group password, optionally assigned by Account      10594000
                    Manager.  Contains from 1 to 8 alphanumeric         10596000
                    characters, beginning with a letter.                10598000
                                                                        10600000
 termtype           Type of terminal used for input.  MPE uses this     10602000
                    parameter to determine device-dependent             10604000
                    characteristics such as delay factors for carriage  10606000
                    returns.  Must be a number from 0 to 15, as follows:10608000
                                                                        10610000
                    0   HP 2749B EIA-compatible HP 2749B (10 characters 10612000
                        per second (cps)).                              10614000
                                                                        10616000
                    1   ASR 37 EIA compatible (10 cps).                 10618000
                                                                        10620000
                    2   ASR 35 EIA compatible (10 cps).                 10622000
                                                                        10624000
                    3   Execuport 300 Data Communication Transceiver    10626000
                        Terminal (10, 15, 30 cps).                      10628000
                                                                        10630000
                    4   HP 2600A or Datapoint 3300 (10-240 cps).        10632000
                                                                        10634000
                    5   Memorex 1240 (10, 15, 30, 60 cps).              10636000
                                                                        10638000
                    6   GE Terminet 300 or 1200, or Data Communication  10640000
                        Terminal, Model B (10, 15, 30, or 120 cps).     10642000
                                                                        10644000
                    9   HP 2615A (Beehive MiniBee) (10-240 cps).        10646000
                                                                        10648000
                   10   HP 2640A/B, HP 2641A, HP 2644A, or HP 2645A.    10650000
                        Character mode or full program control of block 10652000
                        mode transmission (10-240 cps).                 10654000
                                                                        10656000
                   11   HP 2640A/B, HP 2641A, HP 2644A, or HP 2645A.    10658000
                        Allows user to use block mode without program   10660000
                        control of block mode transmission.  Requires   10662000
                        user to position cursor before pressing ENTER.  10664000
                        Recommended for speeds exceeding 30 cps when    10666000
                        you expect to switch between character mode and 10668000
                        block/line mode.  May not be used in block/page 10670000
                        mode (10-240 cps).                              10672000
                                                                        10674000
                   12   HP 2645K  Katakana/Roman Data Terminal.         10676000
                                                                        10678000
                   13   Message switching network or other computer.    10680000
                                                                        10682000
                   14   Multi-Point Terminal.                           10684000
                                                                        10686000
                   15   HP 2635A Printing Terminal.  8-bit protocol     10688000
                        (for second character set).                     10690000
                                                                        10692000
                   16   HP 2635A Printing Terminal.  7-bit protocol     10694000
                        (standard character set).                       10696000
                                                                        10698000
                   Default:  For hardwired terminals, determined by     10700000
                   System Supervisor during system configuration.  No   10702000
                   default for terminals that are not hard wired.       10704000
                                                                        10706000
                   Required parameter to insure correct listings if your10708000
                   terminal is not hardwired or if your terminal is not 10710000
                   the default termtype.                                10712000
                                       NOTE                             10714000
                                                                        10716000
                   On Series 33, only term types 4, 6, 9, 10, 11        10718000
                   12, 15, and 16 may be used.  Any attempt to use      10720000
                   terminal types other than the above may result       10722000
                   in system failure.                                   10724000
                                                                        10726000
                                                                        10728000
cpusecs            Maximum CPU time that session can use, entered in    10730000
                   seconds.  When limit is reached, session is aborted. 10732000
                   Must be a value from 1 to 32767.  To specify no      10734000
                   limit, enter question mark (?) or UNLIM, or omit     10736000
                   parameter.  Default is no limit.                     10738000
                                                                        10740000
BS, CS, DS, ES     Execution priority class. BS is highest priority, ES 10742000
                   is lowest. If you specify a priority that exceeds the10744000
                   highest permitted for your account or user name by   10746000
                   the system, MPE assigns the highest priority possible10748000
                   below BS.  Default is CS.                            10750000
                                                                        10752000
                                       NOTE                             10754000
                                                                        10756000
                   DS and ES are used primarily for batch jobs; their   10758000
                   use for sessions is discouraged.                     10760000
                                                                        10762000
inputpriority      Relative input priority used in checking against     10764000
                   access restrictions imposed by the <jobfence>, if one10766000
                   exists.  Takes effect at logon time.  Must be a      10768000
                   value from 1 (lowest priority) to 13 (highest        10770000
                   priority).  If a value is specified that is less than10772000
                   or equal to current <jobfence> set by Console        10774000
                   Operator, session is denied access. Default is 8.    10776000
                                                                        10778000
HIPRI              Request for maximum session-selection input priority,10780000
                   causing session to be scheduled regardless of current10782000
                   <jobfence> or execution limit for sessions.  This    10784000
                   parameter can be specified only by users with System 10786000
                   Manager or System Supervisor capability.  Default is 10788000
                   the current <jobfence> and execution limit.          10790000
                                                                        10792000
\ITEM=OPERATION                                                         10794000
OPERATION                                                               10796000
                                                                        10798000
Initiates an interactive session.  MPE prompts with colon when it is    10800000
ready to accept commands.  :HELLO command must be entered from a        10802000
terminal, no other device can be used for this command.                 10804000
                                                                        10806000
If passwords are omitted, MPE prompts for each one individually.        10808000
When MPE initiates the session, it displays HP3000, the MPE             10810000
version, and the date and time, then prompts for commands with          10812000
a colon as follows:                                                     10814000
                                                                        10816000
     :HELLO ED.MPE                                                      10818000
     HP3000 / MPE IV C.00.00.  TUE, APR 10, 1979, 12:15 PM              10820000
                                                                        10822000
                                                                        10824000
\ITEM=EXAMPLE                                                           10826000
EXAMPLE                                                                 10828000
                                                                        10830000
To start a session named ALPHA, with the username MAC, accountname      10832000
TECHPUBS, group XGROUP, grouppass XPASS, enter:                         10834000
                                                                        10836000
    :HELLO ALPHA,MAC.TECHPUBS,XGROUP/XPASS                              10838000
                                                                        10840000
    HP3000 / MPE IV C.00.00.  FRI, APR  6, 1979,  9:11 AM               10842000
                                                                        10844000
    :    (MPE displays colon to prompt for command)                     10846000
                                                                        10848000
                                                                        10850000
                       NOTE                                             10852000
When the :HELLO command is issued from a session it will not            10854000
start another session if:                                               10856000
1)  Spaces precede the command.                                         10858000
2)  The command is executed using a :REDO command.                      10860000
3)  The command is issued in a user defined command (UDC).              10862000
                                                                        10864000
                                                                        10866000
\ENTRY=HELP,PARMS,OPERATION,EXAMPLE                                     10868000
    :HELP                                                               10870000
                                                                        10872000
Accesses the Help subsystem.                                            10874000
                                                                        10876000
SYNTAX                                                                  10878000
                                                                        10880000
    :HELP [HELP              ]                                          10882000
          [tablecontents     ]                                          10884000
          [command[,keyword] ]                                          10886000
          [ALL               ]                                          10888000
          [EXIT              ]                                          10890000
                                                                        10892000
\ITEM=PARMS                                                             10894000
PARAMETERS                                                              10896000
                                                                        10898000
HELP            Displays information for the HELP command.  Treated     10900000
                the same as entering :HELP with any other command       10902000
                (because HELP is a command).                            10904000
                                                                        10906000
tablecontents   Any of several items for which information may be       10908000
                obtained.  These items are:                             10910000
                                                                        10912000
                  SESSIONS                                              10914000
                  JOBS                                                  10916000
                  PROGRAMS                                              10918000
                  FILES                                                 10920000
                  MANAGE                                                10922000
                  OPERATOR                                              10924000
                  SPOOLER                                               10926000
                  UTILITY                                               10928000
                                                                        10930000
                Thus, if you want information on running sessions, you  10932000
                would enter:                                            10934000
                                                                        10936000
                  :HELP SESSIONS                                        10938000
                                                                        10940000
command         Any MPE command.  MPE displays the command name and     10942000
                syntax.  In addition, a list of keywords for that       10944000
                command is displayed.  Keywords for all commands except 10946000
                the :FILE command are:                                  10948000
                                                                        10950000
                  PARMS                                                 10952000
                  OPERATION                                             10954000
                  EXAMPLE                                               10956000
                                                                        10958000
                where                                                   10960000
                                                                        10962000
                  PARMS       lists all parameters of the specified     10964000
                              command.                                  10966000
                                                                        10968000
                  OPERATION   describes the use of the specified        10970000
                              command.                                  10972000
                                                                        10974000
                  EXAMPLE     displays an example showing usage of the  10976000
                              specified command.                        10978000
                                                                        10980000
                  The :FILE command has the additional keywords:        10982000
                                                                        10984000
                  NAME                                                  10986000
                  DEVICE                                                10988000
                  ACCESS                                                10990000
                  DISP                                                  10992000
                                                                        10994000
                  Entering :HELP command,ALL causes MPE to display all  10996000
                  information for that command (syntax, parameters,     10998000
                  operation, and example).                              11000000
                                                                        11002000
keyword           One of the keywords described under the command       11004000
                  parameter.  The keyword parameter can be entered      11006000
                  with a command, as in :HELP HELLO,PARMS.  In this     11008000
                  case, PARMS is a keyword and must be separated from   11010000
                  the command with a comma.  The keyword parameter also 11012000
                  can be entered alone if you are running the Help      11014000
                  subsystem in "subsystem" mode and have accessed       11016000
                  a command, then received the prompt (>) from Help.    11018000
                                                                        11020000
                  For example,                                          11022000
                                                                        11024000
                  :HELP DEBUG                                           11026000
                                                                        11028000
                      :DEBUG (Privileged Mode capability required)      11030000
                                                                        11032000
                  Invokes the Debug facility.                           11034000
                                                                        11036000
                  SYNTAX                                                11038000
                                                                        11040000
                     :DEBUG                                             11042000
                                                                        11044000
                  KEYWORDS: PARMS, OPERATION                            11046000
                                                                        11048000
                  >PARMS  (keyword entered by itself in response to     11050000
                           prompt)                                      11052000
                                                                        11054000
                                                                        11056000
ALL               Displays entire table of contents for :HELP command.  11058000
                  If entered with a command, as in                      11060000
                                                                        11062000
                      :HELP SPL,ALL                                     11064000
                                                                        11066000
                  displays all information for that command.            11068000
                                                                        11070000
EXIT              Exits Help subsystem.                                 11072000
                                                                        11074000
\ITEM=OPERATION                                                         11076000
OPERATION                                                               11078000
                                                                        11080000
The :HELP command accesses the Help subsystem.  If entered with no      11082000
parameters, as in                                                       11084000
                                                                        11086000
    :HELP                                                               11088000
                                                                        11090000
Help enters the "subsystem" mode, displays a table of contents, a       11092000
"greater than" (>) prompt, and awaits your input.  Entering any table   11094000
of contents item such as SESSIONS produces a listing of all the commands11096000
used in running sessions.  Entering any command name produces the syntax11098000
for that command and a list of keywords.  Entering a keyword, such as   11100000
PARMS produces a listing of all items for that keyword (all parameters  11102000
in this case).  Entering EXIT or pressing the BREAK key terminates the  11104000
Help subsystem.  Entering Control Y stops the display.  Entering Control11106000
S stops the display and entering Control Q resumes the display (useful  11108000
if the screen is full if using a CRT terminal).                         11110000
                                                                        11112000
Entering carriage return in "subsystem" mode causes MPE to display      11114000
information up to the next keyword or command.  For example, after      11116000
entering STORE, MPE displays STORE syntax, the leyword list (PARMS,     11118000
OPERATION, EXAMPLE) and prompts (>).  Entering carriage return again    11120000
causes MPE to display all PARMS information for the :STORE command.     11122000
Entering carriage return once more (after the prompt) causes MPE to     11124000
display all OPERATION information for the :STORE command, and so on.    11126000
(This is similar to page turning through a manual.)                     11128000
                                                                        11130000
Entering :HELP with a parameter causes Help to enter the "immediate"    11132000
mode.  Information pertaining to that parameter is displayed            11134000
immediately.  For example,                                              11136000
                                                                        11138000
    :HELP DEBUG                                                         11140000
                                                                        11142000
causes Help to display:                                                 11144000
                                                                        11146000
    :DEBUG (Privileged Mode capability required)                        11148000
                                                                        11150000
Invokes the MPE Debug facility.                                         11152000
                                                                        11154000
SYNTAX                                                                  11156000
                                                                        11158000
    :DEBUG                                                              11160000
                                                                        11162000
KEYWORDS: PARMS, OPERATION                                              11164000
                                                                        11166000
\ITEM=EXAMPLE                                                           11168000
EXAMPLE                                                                 11170000
                                                                        11172000
To obtain information concerning MPE utility functions, enter:          11174000
                                                                        11176000
    :HELP UTILITY                                                       11178000
                                                                        11180000
\starthelp                                                              11182000
\ENTRY=IF,PARMS,OPERATION,EXAMPLE                                       11184000
    :IF                                                                 11186000
                                                                        11188000
Used to control the execution sequence of a job.                        11190000
                                                                        11192000
SYNTAX                                                                  11194000
                                                                        11196000
    :IF [(]logexpr[)] THEN                                              11198000
         .                                                              11200000
         .                                                              11202000
         .                                                              11204000
    ELSE                                                                11206000
         .                                                              11208000
         .                                                              11210000
         .                                                              11212000
    ENDIF                                                               11214000
                                                                        11216000
\ITEM=PARMS                                                             11218000
PARAMETERS                                                              11220000
                                                                        11222000
logexpr       Logical expression, consisting of relational operators or 11224000
              combinations of relational operators.  The relational     11226000
              operators allowed are:                                    11228000
                                                                        11230000
               >   greater than                                         11232000
               <   less than                                            11234000
               >=  greater than or equal                                11236000
               <=  less than or equal                                   11238000
               =   equal                                                11240000
               <>  not equal                                            11242000
                                                                        11244000
               Compound logical expressions can be formed using the AND,11246000
               OR, and NOT logical operators and nesting with           11248000
               parentheses.                                             11250000
                                                                        11252000
               The allowed operands are JCW or CIERROR; any Job Control 11254000
               Word values saved in a name with the :SETJCW command; OK,11256000
               WARN, FATAL, or SYSTEM (as defined under the :SETJCW     11258000
               command); or integer constants.                          11260000
                                                                        11262000
\ITEM=OPERATION                                                         11264000
OPERATION                                                               11266000
                                                                        11268000
This statement is a block IF, used with an :ENDIF statement and,        11270000
optionally, an :ELSE statement to control the execution of a job.  An IF11272000
block consists of all the commands after the IF up to, but not          11274000
including, the next :ELSE or :ENDIF statement that has the same nesting 11276000
level as the IF statement.  Another similar block can follow the :ELSE  11278000
statement.  Nesting of blocks is allowed to any level.  The :ENDIF      11280000
statement ends the IF block.                                            11282000
                                                                        11284000
The logical expression is evaluated and, if true, the IF block is       11286000
executed; if false, the ELSE block (if one exists) is executed.         11288000
                                                                        11290000
\ITEM=EXAMPLE                                                           11292000
EXAMPLE                                                                 11294000
                                                                        11296000
    :RUN UPDATE1               (Run first data base update)             11298000
    :IF JCW<WARN THEN          (Continue if OK so far)                  11300000
    :  SETJCW UPDATE1JCW:=JCW  (Save that return code)                  11302000
    :  RUN UPDATE2             (Run second data base update)            11304000
    :  IF JCW<WARN THEN        (Continue if still OK)                   11306000
    :    SETJCW UPDATE2JCW:=JCW    (Save the second return code)        11308000
    :    RUN DBSTATUS              (Report current status of DB)        11310000
    :    IF (UPDATE1JCW < 50) AND (UPDATE2JCW < 50) THEN                11312000
    :      RUN DAILYRPT                                                 11314000
    :    ENDIF                                                          11316000
    :    IF ((UPDATE1JCW = 1) OR (UPDATE2JCW =1)) THEN                  11318000
    :      RUN WEEKLYRPT                                                11320000
    :    ENDIF                                                          11322000
    :  ELSE           (Second update program failed)                    11324000
    :    RUN FIXUP    (Repair data base and report)                     11326000
    :  ENDIF                                                            11328000
    :ENDIF                                                              11330000
\ENTRY=IMF,PARMS,OPERATION,EXAMPLE                                      11332000
    :IMF                                                                11334000
                                                                        11336000
A terminal user to whom the IMF manager has allowed access              11338000
in the configuration file can use this command to start the             11340000
IMF Pass - Thru Mode (PTM).                                             11342000
                                                                        11344000
SYNTAX                                                                  11346000
                   {0}                                         <<04667>>11348000
                   {1}                       {1}               <<04667>>11350000
    IMF [E[NHANCE]={2}][;B[LANKS]][;F[ORMAT]={2}]              <<04667>>11352000
                   {3}                       {3}               <<04667>>11354000
                                             {4}               <<04667>>11356000
        [;P[RIORITY]={ 1}]                                     <<04667>>11358000
                     { 2}                                      <<04667>>11360000
                     { 3}                                      <<04667>>11362000
                     { 4}                                      <<04667>>11364000
                     { 5}                                      <<04667>>11366000
                     { 6}                                      <<04667>>11368000
                     { 7}                                      <<04667>>11370000
                     { 8}                                      <<04667>>11372000
                     { 9}                                      <<04667>>11374000
                     {10}                                      <<04667>>11376000
                     {11}                                      <<04667>>11378000
                     {12}                                      <<04667>>11380000
                     {13}                                      <<04667>>11382000
                                                                        11384000
\ITEM=PARMS                                                             11386000
PARAMETERS                                                              11388000
                                                                        11390000
ENHANCE            This parameter is optional.  If not provided,        11392000
                   HP 264x terminal will display 3270 normal            11394000
                   intensity characters as 264x half-bright             11396000
                   characters, and 3270 enhanced characters as          11398000
                   264x full-bright (normal) characters.  Taking        11400000
                   option "0" will bring the same result as not         11402000
                   using ENHANCE at all.                                11404000
                   The 2626A terminal does not support the              11406000
                   half-bright feature.                                 11408000
                                                                        11410000
                   This table shows the display enhancements            11412000
                   provided by options 0,1,2, and 3:                    11414000
                                                                        11416000
                                                                        11418000
                   Option         3270 Normal         3270 High         11420000
                                   Intensity          Intensity         11422000
                                                                        11424000
                     0            264X/262X Half      264X/262X         11426000
                                  Bright or 2626A     Normal            11428000
                                  Normal                                11430000
                                                                        11432000
                     1            264X/262X Normal    264X/262X         11434000
                                                      Underline         11436000
                                                                        11438000
                     2            264X/262X Normal    264X/262X         11440000
                                                      Normal            11442000
                                                                        11444000
                     3            264X/262X Inverse   264X/262X         11446000
                                  Video               Normal            11448000
                                                                        11450000
                                                                        11452000
BLANKS             This parameter is optional.  If not provided,        11454000
                   PTM will convert leading blank input                 11456000
                   characters  in an unprotected field into             11458000
                   "nulls". If the parameter is provided, PTM           11460000
                   will not convert leading blanks into "nulls"         11462000
                   thus transmitting the field to the host with         11464000
                   leading blanks undisturbed.  This parameter          11466000
                   may be used to right-justify numeric input           11468000
                   data.  Embedded blanks are always treated as blanks  11470000
                   and trailing blanks are always treated as nulls.     11472000
FORMAT             This parameter is optional. Parameter                11474000
                   controls the format used for the PRINT               11476000
                   key (f7). The values mean:                           11478000
                                                                        11480000
                     1 -  print the internal screen image               11482000
                          in debug format whenever the                  11484000
                          PRINT (f7) key is pressed.                    11486000
                                                                        11488000
                     2 -  print the internal screen image               11490000
                          in clean format (*local print*)               11492000
                          when the PRINT key is pressed.                11494000
                          This is the default value.                    11496000
                                                                        11498000
                     3 -  do a continuous print of the                  11500000
                          internal screen image in debug                11502000
                          format. This print is started when            11504000
                          the print key is pressed and then             11506000
                          continues automatically until the             11508000
                          Pass Thru Sessions is ended. The              11510000
                          internal screen image is printed              11512000
                          each time Pass Thru Mode issues               11514000
                          a TRAN3270 or RECV3270 for this               11516000
                          terminal.                                     11518000
                                                                        11520000
                     4 -  do a continous print in clean                 11522000
                          format (local print), printing                11524000
                          once for every TRAN3270 or RECV 3270          11526000
                          issued by Pass Thru Mode for this             11528000
                          terminal. This printout is started            11530000
                          by pressing the PRINT key and                 11532000
                          continues until Pass Thru ends on             11534000
                          this terminal.                                11536000
                                                                        11538000
                     The debug format prints 2 screen images            11540000
                     per page to the spool file LOGIMF.                 11542000
                     Debug format includes a border labeling            11544000
                     the rows and the columns, overprints to            11546000
                     indicate attribute characters and distin-          11548000
                     guishes nulls from blanks by the use of            11550000
                     a ~ character. The clean (local print)             11552000
                     format prints one screen image per page,           11554000
                     without borders and prints the screen              11556000
                     exactly as the user sees it at the                 11558000
                     terminal.                                          11560000
                                                                        11562000
PRIORITY             This parameter is optional. It indicates           11564000
                     the MPE spool file priority desired for            11566000
                     the PRINT output spool file LOGIMF. The            11568000
                     default value is 8.                                11570000
                                                                        11572000
                                                                        11574000
\ITEM=OPERATION                                                         11576000
OPERATION                                                               11578000
                                                                        11580000
The IMF command is used by the terminal user to start the               11582000
operation of PTM at his terminal.  He responds to IMF prompts           11584000
to name a configuration file and a specific IBM device number for       11586000
emulation.                                                              11588000
                                                                        11590000
\ITEM=EXAMPLE                                                           11592000
EXAMPLE                                                                 11594000
                                                                        11596000
In the following example, the user wishes to have inverse video         11598000
displayed on his 264x terminal for 3270 high intensity characters       11600000
and wants leading blanks to be left as blanks.                          11602000
                                                                        11604000
    :IMF ENHANCE=2; BLANKS                                              11606000
    HP32229A.01.00 DSN/IMF (c) HEWLETT-PACKARD 1981                     11608000
    CONFIGURATION FILE NAME?  REMOTE1.PUB.SYS                           11610000
    DEVICE NUMBER? 26                                                   11612000
                                                                        11614000
REMOTE1 names a configuration file that defines a 3270 control          11616000
unit with attached terminals and printers.  DEVICE NUMBER 26            11618000
specifies which of the devices attached to the 3270 control             11620000
unit the user's terminal should emulate.                                11622000
                                                                        11624000
                                                                        11626000
                                                                        11628000
\ENTRY=IMFCONTROL,PARMS,OPERATION,EXAMPLE                               11630000
    :IMFCONTROL                                                         11632000
                                                                        11634000
                                                                        11636000
This command may be used by the console operator or any user            11638000
empowered thru the MPE ALLOW command to use it.  IMFCONTROL             11640000
is used to initiate IMF interaction with a host system, to shut         11642000
down the DSN/IMF subsystem, and to activate the CS/3000 trace           11644000
facility.                                                               11646000
                                                                        11648000
SYNTAX                                                                  11650000
                                                                        11652000
                                                                        11654000
                  {START configfilename [;TRACE ON [parmlist]] }        11656000
                  {STOP configfilename}                                 11658000
     :IMFCONTROL  {KILL configfilename}                                 11660000
                  {TRACE configfilename ON [parmlist] }                 11662000
                  {TRACE configfilename OFF}                            11664000
                                                                        11666000
     parmlist has the format:                                           11668000
                                                                        11670000
     [,[ALL] [,[mask] [,[numentries] [,[WRAP] [,filename]]]]]           11672000
                                                                        11674000
\ITEM=PARMS                                                             11676000
PARAMETERS                                                              11678000
                                                                        11680000
START              Used to initiate communications to the host          11682000
                   system.                                              11684000
                                                                        11686000
STOP               Used to initiate an orderly subsystem                11688000
                   shutdown.                                            11690000
                                                                        11692000
KILL               Disconnects the HP 3000 from a host system           11694000
                   without an orderly subsystem shutdown.  Normally,    11696000
                   used only in emergencies.                            11698000
                                                                        11700000
TRACE ON           Used to start the CS/3000 Trace troubleshoot-        11702000
                   ing facility.  Normally Trace is used only on        11704000
                   request from an HP representative.                   11706000
                                                                        11708000
TRACE OFF          Used to stop the Trace facility.                     11710000
                                                                        11712000
                   Names a particular IMF configuration file for        11714000
                   subsequent DSN/IMF communication activity.           11716000
                   The file defines the characteristics of the          11718000
                   IBM control unit IMF emulates, plus its              11720000
                   attached display stations and printers.  It          11722000
                   also defines the HP 3000 programs/users,             11724000
                   terminals, and printers that may conduct             11726000
                   DSN/IMF activity.                                    11728000
                                                                        11730000
ALL                generates a record of all line activity.             11732000
                   Within IMF, this parameter is not                    11734000
                   user selectable. IMF will always trace all of        11736000
                   the line activity.                                   11738000
                                                                        11740000
mask               is an octal number preceded by a percent             11742000
                   symbol, that specifices the type of events to        11744000
                   trace (refer to the following table).  The CS        11746000
                   default is %37; the largest recommended mask for     11748000
                   IMF is %277.                                         11750000
                                                                        11752000
                   bit                 meaning when ON                  11754000
                                                                        11756000
                    0 (leftmost)  IMF Control Unit STN entries          11758000
                                  (BSC only)                            11760000
                    1             INP IC entries (interconnect)         11762000
                    2             IMF protocol driver STN entries       11764000
                                  (BSC or SDLC)                         11766000
                    3             OPR entries (default=ON)              11768000
                    4             RCT entries (default=ON)              11770000
                    5             RTX entries (default=ON)              11772000
                    6             SCT,POL,SEL entries                   11774000
                                  (default=ON)                          11776000
                    7 (rightmost) STX entries (default=ON)              11778000
                                                                        11780000
                   not used by IMF, and value input will be             11782000
                   ignored.  IMF will produce 14 or 15 entries          11784000
                   per trace record.                                    11786000
                                                                        11788000
WRAP               causes trace entries that overflow the trace         11790000
                   record (greater than numentries) to overlay          11792000
                   the prior trace entries.  If omitted, overflow       11794000
                   entries are discarded. WRAP is recommended for       11796000
                   IMF.  This parameter refers to each record but       11798000
                   not to the file itself.  If the file                 11800000
                   overflows, CS will automatically start at the        11802000
                   beginning of the file and all previous data          11804000
                   will be lost.                                        11806000
                                                                        11808000
filename           is the name of the file where the trace              11810000
                   records are stored.  If omitted, the facility        11812000
                   will create a file in PUB.SYS with the name          11814000
                   CSTRACE.   If you specify a file within a            11816000
                   group and account other than PUB.SYS then that       11818000
                   file must already exist in order for the CS          11820000
                   trace facility to be able to open that file.         11822000
                                                                        11824000
                                                                        11826000
\ITEM=OPERATION                                                         11828000
OPERATION                                                               11830000
                                                                        11832000
This command may be used by the console operator or any user            11834000
empowered thru the MPE ALLOW command to use it. IMFCONTROL              11836000
is used to initiate IMF interaction with a host system, to shut         11838000
down the DSN/IMF subsystem, and to activate the CS/3000 trace           11840000
facility.                                                               11842000
                                                                        11844000
\ITEM=EXAMPLE                                                           11846000
EXAMPLE                                                                 11848000
                                                                        11850000
IMFCONTROL START MARKET.PUB.SYS;TRACE ON,,%245,,WRAP                    11852000
                                                                        11854000
In this example, IMF communication with the host is being               11856000
initiated using configuration file MARKET in the PUB group              11858000
of the SYS account.  The Trace facility has been turned on              11860000
with a mask of %245 and the instruction to overlay overflow             11862000
records on previous records.  The trace results will be                 11864000
written to the default file CSTRACE.PUB.SYS.                            11866000
                                                                        11868000
\ENTRY=IMFMGR,PARMS,OPERATION,EXAMPLE                                   11870000
    :IMFMGR (Requires OP capability.)                                   11872000
                                                                        11874000
Starts the interactive IMF Manager's Program.                           11876000
                                                                        11878000
SYNTAX                                                                  11880000
                                                                        11882000
    :IMFMGR                                                             11884000
                                                                        11886000
\ITEM=PARMS                                                             11888000
PARAMETERS                                                              11890000
                                                                        11892000
None.                                                                   11894000
                                                                        11896000
\ITEM=OPERATION                                                         11898000
OPERATION                                                               11900000
                                                                        11902000
(OP capability required.)                                               11904000
                                                                        11906000
This command starts the IMF Manager's Program, which                    11908000
makes available the IMF command that are used to                        11910000
verify IMF configuration files, display the names of IMF                11912000
configuration files and devices in use, start and stop the              11914000
Pass Thru Mode (PTM) on selected HP3000 terminals and                   11916000
printers, start and stop communications with one or more host           11918000
systems, and turn the CS/3000 Trace utility on and off.                 11920000
                                                                        11922000
After you type IMFMGR, you will be prompted with a ">" (rivet).         11924000
You may then type HELP to receive information about specific            11926000
manager commands.                                                       11928000
                                                                        11930000
\ITEM=EXAMPLE                                                           11932000
EXAMPLE                                                                 11934000
                                                                        11936000
To initiate the IMF Manager's Program, type:                            11938000
:IMFMGR                                                                 11940000
\ENTRY=IML                                                              11942000
                                                                        11944000
   The IML command has been replaced with the IMF command.              11946000
                                                                        11948000
\ENTRY=IMLCONTROL                                                       11950000
                                                                        11952000
   The IMLCONTROL command has been replaced with the IMFCONTROL         11954000
   command.                                                             11956000
                                                                        11958000
\ENTRY=IMLMGR                                                           11960000
                                                                        11962000
   The IMLMGR command has been replaced with the IMFMGR command.        11964000
                                                                        11966000
\ENTRY=JOB,PARMS,OPERATION,EXAMPLE                                      11968000
    :JOB                                                                11970000
                                                                        11972000
Initiates a batch job.                                                  11974000
                                                                        11976000
SYNTAX                                                                  11978000
                                                                        11980000
    :JOB  [jobname,]username[/userpass].acctname[/acctpass]             11982000
          [,groupname[/grouppass]]                                      11984000
                                                                        11986000
          [;TIME=cpusecs]                                               11988000
                                                                        11990000
                  BS                                                    11992000
                  CS                                                    11994000
          [;PRI={    }]                                                 11996000
                  DS                                                    11998000
                  ES                                                    12000000
                                                                        12002000
           ;INPRI=inputpriority                                         12004000
          [                     ]                                       12006000
           ;HIPRI                                                       12008000
                                                                        12010000
          [;RESTART]                                                    12012000
          [;OUTCLASS=[device][,outputpriority][,numcopies]]]            12014000
                                                                        12016000
\ITEM=PARMS                                                             12018000
PARAMETERS                                                              12020000
                                                                        12022000
jobname            Arbitrary name used with <username> and <acctname>   12024000
                   parameters to form a job identity. Contains from 1   12026000
                   to 8 alphanumeric characters, beginning with a       12028000
                   letter.  Default is no job name is assigned.         12030000
                                                                        12032000
username           User name, established by the Account Manager.       12034000
                   Contains from 1 to 8 alphanumeric characters,        12036000
                   beginning with a letter.  (REQUIRED PARAMETER)       12038000
                                                                        12040000
userpass           User password, optionally assigned by Account        12042000
                   Manager.  Contains from 1 to 8 alphanumeric          12044000
                   characters, beginning with a letter.                 12046000
                                                                        12048000
acctname           Account name, established by System Manager.         12050000
                   Contains from 1 to 8 alphanumeric characters,        12052000
                   beginning with a letter.  The <acctname> parameter   12054000
                   must be preceded by a period. (REQUIRED PARAMETER)   12056000
                                                                        12058000
acctpass           Account password, optionally assigned by System      12060000
                   Manager.  Contains from 1 to 8 alphanumeric          12062000
                   characters, beginning with a letter.                 12064000
                                                                        12066000
groupname          (Optional if home group assigned, required if not.)  12068000
                                                                        12070000
                   Name of group used for local file domain and for CPU 12072000
                   time charges, as established by Account Manager.     12074000
                   Contains from 1 to 8 alphanumeric characters,        12076000
                   beginning with a letter.  Default is home group if   12078000
                   one is assigned.                                     12080000
                                                                        12082000
grouppass          (Optional parameter if accessing MPE under home      12084000
                    group; required parameter if assigned and accessing 12086000
                    MPE under other than home group)                    12088000
                                                                        12090000
                   Group password, optionally assigned by Account       12092000
                   Manager.  Contains from 1 to 8 alphanumeric          12094000
                   characters, beginning with a letter.                 12096000
                                                                        12098000
cpusecs            Maximum CPU time allowed job, in seconds.  When this 12100000
                   limit is reached, job is aborted.  Must be value from12102000
                   1 to 32767.  To specify no limit, enter question mark12104000
                   or omit this limit. Default is no limit.             12106000
                                                                        12108000
BS,CS,DS,ES        Execution priority class. BS is highest priority, ES 12110000
                   is lowest. If a priority is specified that exceeds   12112000
                   the highest permitted for the account or user name by12114000
                   the system, MPE assigns the highest priority possible12116000
                   below BS.  Default is DS, unless CS is specified by  12118000
                   System Supervisor with the :JOBPRI command.          12120000
                                                                        12122000
inputpriority      Relative input priority used in checking against     12124000
                   access restrictions imposed by <jobfence> (if one    12126000
                   exists).  Takes effect when job is entered.  Must be 12128000
                   value from 1 (lowest priority) to 13 (highest        12130000
                   priority).  If value is less than or equal to        12132000
                   <jobfence> set by Console Operator, job is deferred. 12134000
                   Default is 8.                                        12136000
                                                                        12138000
HIPRI              Request for maximum input priority, causing job to be12140000
                   scheduled regardless of current <jobfence> or        12142000
                   execution limit for jobs.  Over rides                12144000
                   <inputpriority>.  You can specify this parameter only12146000
                   if you have System Manager or System Supervisor      12148000
                   capability.  Default is 8 or <inputpriority> if this 12150000
                   parameter is specified.                              12152000
                                                                        12154000
RESTART            Request to restart a spooled job interrupted by      12156000
                   system termination/restart.  Takes effect            12158000
                   automatically when system is subsequently restarted  12160000
                   with the WARMSTART option.                           12162000
                                                                        12164000
                   This parameter applies only to jobs initiated on     12166000
                   spooled input devices, and is ignored for other jobs.12168000
                   Default is spooled jobs are not restarted after      12170000
                   system termination/restart.                          12172000
                                                                        12174000
device             Class name or logical device number of device to     12176000
                   receive listing output.  Cannot specify a magnetic   12178000
                   tape unit.  Default is $STDLIST.                     12180000
                                                                        12182000
                                       NOTE                             12184000
                                                                        12186000
                   Non-sharable device (ND) file access attribute       12188000
                   is required in order to use this parameter.          12190000
                                                                        12192000
outputpriority     Output priority for job list file, if destined for   12194000
                   spooled line printer or card punch.  Used to select  12196000
                   next spooled devicefile (on disc) for output, among  12198000
                   all those contending for a specific printer or punch.12200000
                   Must be a value from 1 (lowest priority) to 13       12202000
                   (highest priority).  Note that when <outputpriority> 12204000
                   is 1, output always is deferred. Thus, you should use12206000
                   an <outputpriority> of 2 or greater if you wish      12208000
                   output written from disc.                            12210000
                                                                        12212000
                   This parameter applies only to output destined for   12214000
                   spooled output devices, and is ignored for other     12216000
                   output.  Default is 8 if logging enabled, 13 if      12218000
                   logging disabled.                                    12220000
                                                                        12222000
numcopies          Number of copies of job listing to be produced. This 12224000
                   parameter applies only when listing is directed to a 12226000
                   spooled device, and is ignored in other cases.  Must 12228000
                   be a value from 1 to 255. Default is 1.              12230000
                                                                        12232000
\ITEM=OPERATION                                                         12234000
OPERATION                                                               12236000
                                                                        12238000
Initiates a batch job by establishing contact with MPE.  When MPE begins12240000
the job, it displays the following information on the list device:      12242000
                                                                        12244000
    PRIORITY - (BS, CS, DS, or ES)                                      12246000
    INPRI                                                               12248000
    JOB NUMBER - as assigned by MPE to identify job.                    12250000
    date and time                                                       12252000
    HP3000 and the MPE Version level, in the form HP3000 / MPE IV       12254000
    v.uu.ff, where v is the version level (a letter), uu is the         12256000
    update level (a number), and ff is the fix level (a number).        12258000
                                                                        12260000
\ITEM=EXAMPLE                                                           12262000
EXAMPLE                                                                 12264000
                                                                        12266000
To start a job named BETA, username MAC, accountname TECHPUBS, groupname12268000
XGROUP, and grouppas XPASS, enter:                                      12270000
                                                                        12272000
    :JOB BETA,MAC.TECHPUBS,XGROUP/XPASS                                 12274000
                                                                        12276000
     PRIORITY=ES;  INPRI=8                                              12278000
     JOB NUMBER= #J1                                                    12280000
     WED, DEC 28, 1977, 1:59 PM                                         12282000
     HP3000 / MPE IV C.00.00                                            12284000
                                                                        12286000
Note that subsequent MPE commands must begin with a colon (:), entered  12288000
in column 1 of the input record.                                        12290000
                                                                        12292000
                                                                        12294000
\ENTRY=JOBFENCE,PARMS,OPERATION,EXAMPLE                                 12296000
    :JOBFENCE                                                           12298000
                                                                        12300000
Defines acceptable input priorities.                                    12302000
                                                                        12304000
SYNTAX                                                                  12306000
                                                                        12308000
     :JOBFENCE priorityfence                                            12310000
                                                                        12312000
\ITEM=PARMS                                                             12314000
PARAMETERS                                                              12316000
                                                                        12318000
priorityfence           A number between 0 and 14, inclusive            12320000
                        (large is more limiting).                       12322000
                                                                        12324000
\ITEM=OPERATION                                                         12326000
OPERATION                                                               12328000
                                                                        12330000
Jobs/sessions with inputpriority less than or equal to the              12332000
priority fence will not be considered for dispatching until             12334000
their input priority is raised (see :ALTJOB command) or the             12336000
jobfence is lowered.  The exception is the use of HIPRI by              12338000
System Managers and System Supervisors in JOB or HELLO                  12340000
commands.  HIPRI overrides any JOBFENCE setting.                        12342000
                                                                        12344000
\ITEM=EXAMPLE                                                           12346000
EXAMPLES                                                                12348000
                                                                        12350000
To set the jobfence to 14 (to defer all non-HIPRI jobs and              12352000
session), then return the jobfence to 0 (to allow the waiting           12354000
jobs to log on), enter:                                                 12356000
      :JOBFENCE 14                                                      12358000
       16:17/#S26/26/LOGON FOR:  MANAGER.SYS ON LDEV #20                12360000
       16:18/#J7/34/DEFERRED JOB INTRODUCED ON LDEV #10                 12362000
       16:18/#J8/35/DEFERRED JOB INTRODUCED ON LDEV #10                 12364000
      :SHOWJOB                                                          12366000
                                                                        12368000
 JOBNUM STATE IPRI  JIN  JLIST  INTRODUCED  JOB NAME                    12370000
                                                                        12372000
  #S26   EXEC       20    20    THU 4:17P   MANAGER.SYS                 12374000
  #J7    WAIT  D 8  10S   12    THU 4:18P   JOB1,FIELD SUPPORT          12376000
  #J8    WAIT  D 8  10S   12    THU 4:18P   JOB2,FIELD.SUPPORT          12378000
                                                                        12380000
  3 JOBS:                                                               12382000
      0 INTRO                                                           12384000
      2 WAIT; INCL 2 DEFERRED                                           12386000
      1 EXEC; INCL 1 SESSIONS                                           12388000
      0 SUSP                                                            12390000
  JOBFENCE= 14; JLIMIT= 5; SLMIT=16                                     12392000
                                                                        12394000
  :JOBFENCE 0                                                           12396000
  16:21/#J7/34/LOGON FOR:  JOB1,FIELD.SUPPORT ON LDEV#10                12398000
  16:21/#J8/35/LOGON FOR:  JOB2,FIELD.SUPPORT ON LDEV#l0                12400000
                                                                        12402000
                                                                        12404000
\ENTRY=JOBPRI,PARMS,OPERATION,EXAMPLE                                   12406000
    :JOBPRI (System Supervisor capability required)                     12408000
                                                                        12410000
Sets or changes the default execution priority for batch jobs and sets a12412000
maximum execution priority for both jobs and sessions.                  12414000
                                                                        12416000
SYNTAX                                                                  12418000
                                                                        12420000
    :JOBPRI [maxsubqueue][,defaultsubqueue]                             12422000
                                                                        12424000
\ITEM=PARMS                                                             12426000
PARAMETERS                                                              12428000
                                                                        12430000
maxsubqueue            The maximum priority at which batch jobs will be 12432000
                       allowed to run.  This is in spite of any job     12434000
                       priority a user may have requested on his :JOB   12436000
                       command.  This parameter may be ES, DS, CS, or 0.12438000
                       If 0 is specified, no limit is imposed on batch  12440000
                       jobs.  Default is DS.                            12442000
                                                                        12444000
defaultsubqueue        The default execution priority for batch jobs,   12446000
                       which may be ES, DS, or CS.  This takes effect if12448000
                       a user does not specify an execution priority on 12450000
                       his :JOB command.  Default is no change in       12452000
                       execution default.                               12454000
                                                                        12456000
\ITEM=OPERATION                                                         12458000
OPERATION                                                               12460000
                                                                        12462000
(System Supervisor capability required)                                 12464000
This command changes the default execution priority for batch jobs and  12466000
sets a maximum execution priority for both jobs and sessions.  The      12468000
<maxsubqueue> parameter takes precedence over the <defaultsubqueue>     12470000
parameter.  That is, if the default parameter is greater than the       12472000
maximum priority parameter, jobs will be initiated with the maximum     12474000
priority parameter.                                                     12476000
                                                                        12478000
\ITEM=EXAMPLE                                                           12480000
EXAMPLE                                                                 12482000
                                                                        12484000
To raise the maximum execution priority so that batch jobs can run in   12486000
any subqueue requested, enter:                                          12488000
                                                                        12490000
    :JOBPRI 0                                                           12492000
                                                                        12494000
                                                                        12496000
                                                                        12498000
\ENTRY=JOBSECURITY,PARMS,OPERATION,EXAMPLE                              12500000
     :JOBSECURITY                                                       12502000
                                                                        12504000
Controls jobs being run and the resources they require.                 12506000
                                                                        12508000
SYNTAX                                                                  12510000
                                                                        12512000
                  {HIGH}                                                12514000
     :JOBSECURITY {    }                                                12516000
                  {LOW }                                                12518000
                                                                        12520000
\ITEM=PARMS                                                             12522000
PARAMETERS                                                              12524000
                                                                        12526000
HIGH          Provides only the master operator with access to job      12528000
              control commands.                                         12530000
                                                                        12532000
LOW           Allows individual users to exercise control of            12534000
              their own jobs.                                           12536000
                                                                        12538000
\ITEM=OPERATION                                                         12540000
OPERATION                                                               12542000
                                                                        12544000
The HIGH parameter controls the security level by not allowing          12546000
the user to use the :ABORTJOB, :ALTJOB, :BREAKJOB, or :RESUMEJOB        12548000
commands on his own job; while the LOW parameter controls the           12550000
security level by allowing the user to use these commands on his        12552000
own or other's jobs with the appropriate capability.                    12554000
                                                                        12556000
The user's own jobs are jobs which match the user and account           12558000
names unless the user has account manager (AM) capability, in           12560000
which case only the account names must be the same.                     12562000
                                                                        12564000
\ITEM=EXAMPLE                                                           12566000
EXAMPLES                                                                12568000
                                                                        12570000
To give a user the capability to abort, alter, break, or resume         12572000
a job, enter:                                                           12574000
                                                                        12576000
     :JOBSECURITY LOW                                                   12578000
                                                                        12580000
\ENTRY=LDISMOUNT,PARMS,OPERATION,EXAMPLE                                12582000
     :LDISMOUNT                                                         12584000
                                                                        12586000
Logically dismounts a private volume set or class, thus making          12588000
it inaccessible to users.                                               12590000
                                                                        12592000
SYNTAX                                                                  12594000
                                                                        12596000
                {*      }                                               12598000
     :LDISMOUNT {       }.group.account                                 12600000
                {vcsname}                                               12602000
                                                                        12604000
\ITEM=PARMS                                                             12606000
PARAMETERS                                                              12608000
                                                                        12610000
*                 Specifies that the home volume set of the named       12612000
                  group and account is to be dismounted.                12614000
                                                                        12616000
vcsname           Volume class/set name, requests dismount of the       12618000
                  named private volume set.                             12620000
                                                                        12622000
group.account     Specifies the group and account under which the       12624000
                  volume set was created.                               12626000
                                                                        12628000
\ITEM=OPERATION                                                         12630000
OPERATION                                                               12632000
                                                                        12634000
Only discs in the non-system domain can be dismounted.                  12636000
                                                                        12638000
The command tells MPE that the specified set or class is no longer      12640000
needed and that member volumes should be logically dismounted, as       12642000
a unit, from the drive (or drives) on which they reside.                12644000
                                                                        12646000
If users are accessing files on the specified volume set/class,         12648000
your command remains in the pending state until after the last          12650000
user closes the file; then it executes.                                 12652000
                                                                        12654000
If the volume set/class specified in the command was not previously     12656000
mounted with a corresponding :LMOUNT command, you receive an            12658000
error message.                                                          12660000
                                                                        12662000
\ITEM=EXAMPLE                                                           12664000
EXAMPLES                                                                12666000
                                                                        12668000
To dismount a private volume set named DATABASE which was created in    12670000
the PAYROLL group of the ACCTNG account, enter:                         12672000
                                                                        12674000
     :LDISMOUNT DATABASE.PAYROLL.ACCTNG                                 12676000
                                                                        12678000
                                                                        12680000
                                                                        12682000
\ENTRY=LIMIT,PARMS,OPERATION,EXAMPLE                                    12684000
     :LIMIT                                                             12686000
                                                                        12688000
Limits the number of concurrently running jobs/sessions.                12690000
                                                                        12692000
SYNTAX                                                                  12694000
                                                                        12696000
             :LIMIT {[numberjobs] [numbersessions]}                     12698000
                :LIMIT {[numberjobs], [numbersessions]}                 12700000
                                                                        12702000
\ITEM=PARMS                                                             12704000
PARAMETERS                                                              12706000
                                                                        12708000
numberjobs         The number of jobs.                                  12710000
                                                                        12712000
numbersessions     The number of sessions.                              12714000
                                                                        12716000
\ITEM=OPERATION                                                         12718000
OPERATION                                                               12720000
                                                                        12722000
No new jobs or sessions (except HIPRI ones, specified by System         12724000
Managers and System Supervisors only) will be dispatched that would     12726000
cause either of these limits to be exceeded.  Note that jobs/sessions   12728000
can still be introduced when the limit is achieved, although only       12730000
HIPRI jobs/sessions can enter the executing state.  Note also that      12732000
the specified limits may be exceeded at the time the command is         12734000
issued.  Jobs/sessions executing at the time the command is issued      12736000
will continue to execute; however, no new jobs/sessions will be         12738000
allowed to enter the executing state.                                   12740000
                                                                        12742000
At least one parameter must be included in the :LIMIT command.          12744000
Omission of the other parameter (either numberjobs or numbersessions)   12746000
leaves the corresponding current limit unchanged.  These limits are     12748000
established initially as system creation.  The latest limits are        12750000
retained for WARMSTART but the values established at system creation    12752000
take effect for all other cold loads.                                   12754000
                                                                        12756000
\ITEM=EXAMPLE                                                           12758000
EXAMPLES                                                                12760000
                                                                        12762000
To limit the number of jobs to 2 and the number of sessions to 15,      12764000
enter:                                                                  12766000
                                                                        12768000
     :LIMIT 2,15                                                        12770000
     :SHOWJOB                                                           12772000
     NO SUCH JOB(S)                                                     12774000
     JOBFENCE=  0;  JLIMIT= 2;  SLIMIT= 15                              12776000
                                                                        12778000
\ENTRY=LISTACCT,PARMS,OPERATION,EXAMPLE                                 12780000
    :LISTACCT (System Manager or Account Manager capability required)   12782000
                                                                        12784000
Lists the attributes for one account (Account Manager capability) or all12786000
accounts (System Manager capability).                                   12788000
                                                                        12790000
SYNTAX                                                                  12792000
                                                                        12794000
    :LISTACCT [acctset][,listfile]                                      12796000
                                                                        12798000
\ITEM=PARMS                                                             12800000
PARAMETERS                                                              12802000
                                                                        12804000
acctset        Specifies the set of accounts to be listed.  This        12806000
               parameter can be entered in one of the following         12808000
               formats:                                                 12810000
                                                                        12812000
acctdesig      (Required parameter for Account Managers, optional       12814000
                parameter for System Manager)                           12816000
                                                                        12818000
               The name of the account whose attributes are to be       12820000
               listed.  Account Managers can specify only their own     12822000
               account.  Default is attributes of all accounts are      12824000
               listed.                                                  12826000
                                                                        12828000
                                    NOTE                                12830000
                                                                        12832000
               The characters @, #, and ? can be used as "wild card"    12834000
               characters in the acctset parameter.  These wild card    12836000
               characters have the following meanings:                  12838000
                                                                        12840000
               @ -- specifies zero or more alphanumeric characters.     12842000
                                                                        12844000
               # -- specifies one numeric character.                    12846000
                                                                        12848000
               ? -- specifies one alphanumeric character.               12850000
                                                                        12852000
               The characters can be used as follows:                   12854000
                                                                        12856000
               n@      List all accounts starting with the character n. 12858000
                                                                        12860000
               @n      List all accounts ending with the character n.   12862000
                                                                        12864000
               n@x     List all accounts starting with the character n  12866000
                       and ending with the character x.                 12868000
                                                                        12870000
               n##..#  List all accounts starting with the character n  12872000
                       followed by up to seven digits.                  12874000
                                                                        12876000
               ?n@     List all accounts whose second character is n.   12878000
                                                                        12880000
               n?      List all two-character accounts starting with    12882000
                       the character n.                                 12884000
                                                                        12886000
               ?n      List all two-character accounts ending with the  12888000
                       character n.                                     12890000
                                                                        12892000
listfile       Actual designator of file on which the attribute listing 12894000
               is produced.  This file is closed with SAVE disposition. 12896000
               Default is $STDLIST.                                     12898000
                                                                        12900000
\ITEM=OPERATION                                                         12902000
OPERATION                                                               12904000
                                                                        12906000
(Account Manager or System Manager capability required)                 12908000
This command lists the attributes for one account (Account Manager      12910000
capability) or all accounts (System Manager capability).  Private volume12912000
information (volume set names) also is listed.  The volume sets need not12914000
be mounted for this information to be listed.                           12916000
                                                                        12918000
\ITEM=EXAMPLE                                                           12920000
EXAMPLE                                                                 12922000
                                                                        12924000
To list the attributes of his own account, the Account Manager user     12926000
enters:                                                                 12928000
                                                                        12930000
    :LISTACCT MYACCT                                                    12932000
                                                                        12934000
                                                                        12936000
\ENTRY=LISTF,PARMS,OPERATION,EXAMPLE                                    12938000
    :LISTF                                                              12940000
                                                                        12942000
Lists descriptions of one or more permanent disc files.                 12944000
                                                                        12946000
SYNTAX                                                                  12948000
                                                                        12950000
                      0                                                 12952000
                      1                                                 12954000
    :LISTF [fileset][,  ][;listfile]                                    12956000
                      2                                                 12958000
                     -1                                                 12960000
                                                                        12962000
\ITEM=PARMS                                                             12964000
PARAMETERS                                                              12966000
                                                                        12968000
fileset                Specifies the set of files to be listed.  Default12970000
                       is @.  This parameter is of the form:            12972000
                                                                        12974000
         filedesignator[.groupdesignator[.acctdesignator]]              12976000
                                                                        12978000
                       Fileset can be entered in any of the             12980000
                       following formats and may use wild card          12982000
                       characters, in any order, as replacements.       12984000
                                                                        12986000
file.group.account     List file named in specified group and account.  12988000
                                                                        12990000
file.group             List file named in specified group.              12992000
                                                                        12994000
file                   List file named.                                 12996000
                                                                        12998000
@.group.account        List all files in specified group and account.   13000000
                                                                        13002000
@.@.account            List all files in all groups in specified        13004000
                       account.                                         13006000
                                                                        13008000
@.@.@                  List all files in system.                        13010000
                                                                        13012000
@.@                    List all files in all groups in logon account.   13014000
                                                                        13016000
@                      List all files in logon group.  Default.         13018000
                                                                        13020000
@.group                List all files in specified group.               13022000
                                                                        13024000
file.@.account         List specified file in any group of              13026000
                       specified account.                               13028000
                                                                        13030000
                                           NOTE                         13032000
                                                                        13034000
              The characters @, #, and ? can be used as "wild card"     13036000
              characters in the fileset parameter.  These wild card     13038000
              characters have the following meanings:                   13040000
                                                                        13042000
              @ -- specifies zero or more alphanumeric characters.      13044000
                                                                        13046000
              # -- specifies one numeric character.                     13048000
                                                                        13050000
              ? -- specifies one alphanumeric character.                13052000
                                                                        13054000
              The characters can be used as follows:                    13056000
                                                                        13058000
              n@      List all files starting with the character n.     13060000
                                                                        13062000
              @n      List all files ending with the character n.       13064000
                                                                        13066000
              n@x     List all files starting with the character n      13068000
                      and ending with the character x.                  13070000
                                                                        13072000
              n##..#  List all files starting with the character n      13074000
                      followed by up to seven digits (useful for        13076000
                      listing all EDIT/3000 temporary files).           13078000
                                                                        13080000
              ?n@     List all files whose second character is n.       13082000
                                                                        13084000
              n?      List all two-character files starting with the    13086000
                      character n.                                      13088000
                                                                        13090000
              ?n      List all two-character files ending with the      13092000
                      character n.                                      13094000
                                                                        13096000
0                      Display file name only.  Default.                13098000
                                                                        13100000
1                      Display file name, plus file code, record size (W13102000
                       indicates words, B indicates bytes), record      13104000
                       format (F, U, or V), whether ASCII (A) or binary 13106000
                       (B) records, R for relative I/O files,           13108000
                       whether carriage-control option is taken         13110000
                       (c if so), current end-of-file location, and     13112000
                       maximum number of records allowed in file.       13114000
                       Default is 0.                                    13116000
                                                                        13118000
2                      Display file name, file code, record size (W     13120000
                       indicates words, B indicates bytes), record      13122000
                       format (F, U, or V), whether ASCII (A) or binary 13124000
                       (B) records, whether carr- iage-control option is13126000
                       taken (C if so), current end-of-file location,   13128000
                       maximum number of records allowed in file,       13130000
                       blocking factor, number of disc sectors in use   13132000
                       (including those in use for file label and user  13134000
                       headers), number of extents currently allocated, 13136000
                       and maximum number of extents allowed.  Default  13138000
                       is 0.                                            13140000
                                                                        13142000
-1                     Display octal listing of file label.  This option13144000
                       can be requested only by users with System       13146000
                       Manager capability (all files) or Account Manager13148000
                       capability (all files in own account).  Default  13150000
                       is 0.  The first line of the listing is the      13152000
                       directory entry for the file being listed.       13154000
                       The remainder of the listing is the file         13156000
                       label.                                           13158000
                                                                        13160000
listfile               Name of output file on which descriptions are    13162000
                       written.  Automatically specified as new ASCII   13164000
                       file with variable-length records, user-supplied 13166000
                       carriage-control characters (CCTL), OUT access   13168000
                       mode, and EXC (exclusive access) option.  All    13170000
                       other characteristics are same as :FILE command  13172000
                       default specifications. Default is $STDLIST.     13174000
                                                                        13176000
                                         NOTE                           13178000
                                                                        13180000
                       If you specify the -1 option and direct          13182000
                       listing output to a non-spooled device           13184000
                       (such as a magnetic tape unit) that enters       13186000
                       the NOT READY state, the System Directory        13188000
                       will be locked down and the system may hang      13190000
                       up.  Avoid this combination of                   13192000
                       specifications if possible.                      13194000
                                                                        13196000
\ITEM=OPERATION                                                         13198000
OPERATION                                                               13200000
                                                                        13202000
Lists descriptions of one or more disc files at level of detail you     13204000
select.  You need not have access to a file to list a description of it,13206000
however, a file description will not be listed unless the file's home   13208000
volume set is mounted.  A standard user may list level 0, 1, and 2      13210000
information for any file in the system.  A user with Account Manager    13212000
capability may list level -1 data for files in his own account.  A user 13214000
with System Manager capability may list -1 data for any file in the     13216000
system.                                                                 13218000
                                                                        13220000
Note that this command applies only to permanent disc files in the      13222000
system file domain.                                                     13224000
                                                                        13226000
\ITEM=EXAMPLE                                                           13228000
EXAMPLE                                                                 13230000
                                                                        13232000
To list the names of all files in your logon group, enter:              13234000
                                                                        13236000
    :LISTF                                                              13238000
                                                                        13240000
To list the name, file code, record format, ASCII vs. binary code       13242000
information, carriage-control option, end-of-file location, and maximum 13244000
number of records for the file named BASE in the group USERGP in your   13246000
logon account, enter:                                                   13248000
                                                                        13250000
    :LISTF BASE.USERGP,1                                                13252000
                                                                        13254000
To list the names of all files in all groups in your logon account,     13256000
enter:                                                                  13258000
                                                                        13260000
    :LISTF @.@                                                          13262000
                                                                        13264000
                                                                        13266000
\ENTRY=LISTGROUP,PARMS,OPERATION,EXAMPLE                                13268000
    :LISTGROUP (System Manager or Account Manager capability required)  13270000
                                                                        13272000
Prints a list of attributes for groups.                                 13274000
                                                                        13276000
SYNTAX                                                                  13278000
                                                                        13280000
    :LISTGROUP [groupset][,listfile]                                    13282000
                                                                        13284000
\ITEM=PARMS                                                             13286000
PARAMETERS                                                              13288000
                                                                        13290000
groupset               Specifies the set of groups to be listed.        13292000
                       Default is @. This parameter can be entered in   13294000
                       one of the following formats:                    13296000
                                                                        13298000
groupdesig.acctdesig   Specifies the group and account. If an Account   13300000
                       Manager specifies an account, it must be his own.13302000
                                                                        13304000
groupdesig             Specifies the group (in the logon account).      13306000
                                                                        13308000
@.acctdesig            All groups in the specified account.  If an      13310000
                       Account Manager specifies an account, it must be 13312000
                       his own.                                         13314000
                                                                        13316000
@                      All groups in the logon account.  Default.       13318000
                                                                        13320000
@.@                    All groups in all accounts. Only System Managers 13322000
                       may specify this option.                         13324000
                                                                        13326000
                                     NOTE                               13328000
                                                                        13330000
               The characters @, #, and ? can be used as "wild card"    13332000
               characters in the groupset parameter.  These wild card   13334000
               characters have the following meanings:                  13336000
                                                                        13338000
               @ -- specifies zero or more alphanumeric characters.     13340000
                                                                        13342000
               # -- specifies one numeric character.                    13344000
                                                                        13346000
               ? -- specifies one alphanumeric character.               13348000
                                                                        13350000
               The characters can be used as follows:                   13352000
                                                                        13354000
               n@      List all groups starting with the character n.   13356000
                                                                        13358000
               @n      List all groups ending with the character n.     13360000
                                                                        13362000
               n@x     List all groups starting with the character n    13364000
                       and ending with the character x.                 13366000
                                                                        13368000
               n##..#  List all groups starting with the character n    13370000
                       followed by up to seven digits.                  13372000
                                                                        13374000
               ?n@     List all groups whose second character is n.     13376000
                                                                        13378000
               n?      List all two-character groups starting with      13380000
                       the character n.                                 13382000
                                                                        13384000
               ?n      List all two-character groups ending with the    13386000
                       character n.                                     13388000
                                                                        13390000
listfile               Actual designator of file on which attribute     13392000
                       listing is produced.  This file is closed with   13394000
                       SAVE disposition.  Default is $STDLIST.          13396000
                                                                        13398000
\ITEM=OPERATION                                                         13400000
OPERATION                                                               13402000
                                                                        13404000
(System Manager or Account Manager capability required)                 13406000
This command lists attributes for groups.  An Account Manager may       13408000
specify only his own group; the System Manager may specify all groups in13410000
all accounts on the system.  Private volume information (volume set     13412000
names) also is listed.  The volume sets need not be mounted for this    13414000
information to be listed.                                               13416000
                                                                        13418000
\ITEM=EXAMPLE                                                           13420000
EXAMPLE                                                                 13422000
                                                                        13424000
To list the attributes of all groups in the account named ACCT1, enter: 13426000
                                                                        13428000
    :LISTGROUP @.ACCT1                                                  13430000
                                                                        13432000
                                                                        13434000
\ENTRY=LISTLOG,PARMS,OPERATION,EXAMPLE                                  13436000
:LISTLOG                                                                13438000
                                                                        13440000
Lists the currently active logging identifiers on the system.           13442000
SYNTAX                                                                  13444000
                                                                        13446000
          LISTLOG [logid[;PASS]]                                        13448000
                                                                        13450000
\item=parms                                                             13452000
PARAMETERS                                                              13454000
                                                                        13456000
logid   The specific logging identifier to be listed.  Default          13458000
        is to list currently active logging identifiers on the system.  13460000
                                                                        13462000
PASS    Causes the password associated with the logging                 13464000
        identifier to be displayed.  Can be used only by the            13466000
        creator of the logging identifier.                              13468000
                                                                        13470000
\item=operation                                                         13472000
OPERATION                                                               13474000
                                                                        13476000
Lists the logging identifier specified with its associated              13478000
creator and destination file.  If the logid parameter is not entered,   13480000
all logging identifiers on the system are displayed with their          13482000
creators and logfiles.  The PASS parameter, which can be used           13484000
only by the creator of the logging identifier specified, causes         13486000
the password associated with the logging identifier to be listed.       13488000
                                                                        13490000
\item=example                                                           13492000
EXAMPLE                                                                 13494000
To list all logging identifiers on the system, enter:                   13496000
                                                                        13498000
        :LISTLOG                                                        13500000
                                                                        13502000
        LOGID       CREATOR            LOGFILE                          13504000
                                                                        13506000
        FINANCE     DATABASE.FINANCE   NEWDATA                          13508000
        INLOG       TOM.LAB            TEMP.TOM.LAB (disc file)         13510000
        ERRORS      TOM.LAB            OTHERLG      (tape file)         13512000
\ENTRY=LISTUSER,PARMS,OPERATION,EXAMPLE                                 13514000
    :LISTUSER (System Manager or Account Manager capability required)   13516000
                                                                        13518000
Lists attributes currently assigned to users.                           13520000
                                                                        13522000
SYNTAX                                                                  13524000
                                                                        13526000
    :LISTUSER [userset][,listfile]                                      13528000
                                                                        13530000
\ITEM=PARMS                                                             13532000
PARAMETERS                                                              13534000
                                                                        13536000
userset              Specifies the set of users to be listed.  Default  13538000
                     is @. This parameter is written in one of the      13540000
                     following formats:                                 13542000
                                                                        13544000
userdesig.acctdesig  The specified user in the spec- ified account.  If 13546000
                     Account Manager users specify acctdesig, it must be13548000
                     their own account.                                 13550000
                                                                        13552000
userdesig            The specified user in the logon account.           13554000
                                                                        13556000
@.acctdesig          All users in the specified account. Account        13558000
                     Managers may specify their own account only.       13560000
                                                                        13562000
@                    All users in the logon account.  Default.          13564000
                                                                        13566000
@.@                  All users in all accounts.  (The attributes of the 13568000
                     accounts also are listed.)  This option can only be13570000
                     specified by System Manager.                       13572000
                                                                        13574000
                                     NOTE                               13576000
                                                                        13578000
                The characters @, #, and ? can be used as "wild card"   13580000
                characters in the userset parameter.  These wild card   13582000
                characters have the following meanings:                 13584000
                                                                        13586000
                @ -- specifies zero or more alphanumeric characters.    13588000
                                                                        13590000
                # -- specifies one numeric character.                   13592000
                                                                        13594000
                ? -- specifies one alphanumeric character.              13596000
                                                                        13598000
                The characters can be used as follows:                  13600000
                                                                        13602000
                n@      List all users starting with the character n.   13604000
                                                                        13606000
                @n      List all users ending with the character n.     13608000
                                                                        13610000
                n@x     List all users starting with the character n    13612000
                        and ending with the character x.                13614000
                                                                        13616000
                n##..#  List all users starting with the character n    13618000
                        followed by up to seven digits.                 13620000
                                                                        13622000
                ?n@     List all users whose second character is n.     13624000
                                                                        13626000
                n?      List all two-character users starting with      13628000
                        the character n.                                13630000
                                                                        13632000
                ?n      List all two-character users ending with the    13634000
                        character n.                                    13636000
                                                                        13638000
listfile             Actual designator of file on which attribute       13640000
                     listing is produced.  This file is closed with SAVE13642000
                     disposition. Default is $STDLIST.                  13644000
                                                                        13646000
\ITEM=OPERATION                                                         13648000
OPERATION                                                               13650000
                                                                        13652000
(System Manager or Account Manager capability required)                 13654000
This command lists the attributes currently assigned to users.  An      13656000
Account Manager may list all users in his account only; the System      13658000
Manager may list all users in all accounts.  Private volume information 13660000
(volume set names) also is listed.  The volume sets need not be mounted 13662000
for this information to be listed.                                      13664000
                                                                        13666000
\ITEM=EXAMPLE                                                           13668000
EXAMPLE                                                                 13670000
                                                                        13672000
To list the attributes of the user named CLANCY in the account named    13674000
MGT, enter:                                                             13676000
                                                                        13678000
    :LISTUSER CLANCY.MGT                                                13680000
                                                                        13682000
Note that if the command is entered by an Account Manager, MGT must be  13684000
his own account.                                                        13686000
                                                                        13688000
                                                                        13690000
\ENTRY=LISTVS,PARMS,OPERATION,EXAMPLE                                   13692000
    :LISTVS                                                             13694000
                                                                        13696000
Produces a formatted listing of volume set definition information.      13698000
                                                                        13700000
SYNTAX                                                                  13702000
                                                                        13704000
                      0                                                 13706000
    :LISTVS [vslist][,1  ][;listfile]                                   13708000
                      2                                                 13710000
                                                                        13712000
\ITEM=PARMS                                                             13714000
PARAMETERS                                                              13716000
                                                                        13718000
vslist                 Specifies the volume set definitions to be       13720000
                       listed.  Default is @.  This parameter is of     13722000
                       the form:                                        13724000
                                                                        13726000
                       vsdesig[.groupdesig[.acctdesig]]                 13728000
                                                                        13730000
                       VSLIST can be entered in any of the              13732000
                       following formats and may use wild card          13734000
                       characters, in any order, as replacements.       13736000
                                                                        13738000
vsname.group.account   List information for volume set <vsname> in the  13740000
                       specified group and account.                     13742000
                                                                        13744000
@.group.account        List all home volume set definitions in the      13746000
                       specified group and account.                     13748000
                                                                        13750000
@.@.account            List all home volume set definitions for all     13752000
                       groups in the specified account.                 13754000
                                                                        13756000
@                      List all home volume set definitions in          13758000
                       logon group and account.                         13760000
                                                                        13762000
@.@                    List all home volume set definitions for all     13764000
                       groups in logon account.                         13766000
                                                                        13768000
@.@.@                  List all home volume set definitions in system.  13770000
                                                                        13772000
vsname.@.account       List information for volume set vsname           13774000
                       in any group of specified account.               13776000
                                                                        13778000
                               NOTE                                     13780000
                                                                        13782000
      The characters @, #, and ? can be used as "wild card"             13784000
      characters in the vslist parameter.  These wild card              13786000
      characters have the following meanings:                           13788000
                                                                        13790000
      @ -- specifies zero or more alphanumeric characters.              13792000
                                                                        13794000
      # -- specifies one numeric character.                             13796000
                                                                        13798000
      ? -- specifies one alphanumeric character.                        13800000
                                                                        13802000
      The characters can be used as follows:                            13804000
                                                                        13806000
      n@      List all volume set definitions starting with the         13808000
              character n.                                              13810000
                                                                        13812000
      @n      List all volume set definitions ending with the           13814000
              character n.                                              13816000
                                                                        13818000
      n@x     List all volume set definitions starting with the         13820000
              character n and ending with the character x.              13822000
                                                                        13824000
      n##..#  List all volume set definitions starting with the         13826000
              character n followed by up to seven digits.               13828000
                                                                        13830000
      ?n@     List all volume set definitions whose second character    13832000
              is n.                                                     13834000
                                                                        13836000
      n?      List all two-character volume set definitions starting    13838000
              with the character n.                                     13840000
                                                                        13842000
      ?n      List all two-character volume set definitions ending      13844000
              with the character n.                                     13846000
                                                                        13848000
                                                                        13850000
0     Display volume set name.                                          13852000
                                                                        13854000
1     Display volume set name, members, and types.                      13856000
                                                                        13858000
2     Display volume set names, members, types, logical device numbers  13860000
      of the devices on which the volumes are mounted, and the status   13862000
      of the volume set.                                                13864000
                                                                        13866000
      Default is 0.                                                     13868000
                                                                        13870000
listfile               Actual designator of output file to receive      13872000
                       listings.  This file must be named in a :FILE    13874000
                       command and back referenced as in the            13876000
                       following example:                               13878000
                                                                        13880000
                       :FILE LIST;DEV=LP                                13882000
                       :LISTVS @,1;*LIST                                13884000
                                                                        13886000
                       Default is $STDLIST.                             13888000
                                                                        13890000
\ITEM=OPERATION                                                         13892000
OPERATION                                                               13894000
                                                                        13896000
The :LISTV command produces a formatted listing of volume set definition13898000
information.  The listing can be sent to a device other than the        13900000
standard list device.                                                   13902000
                                                                        13904000
\ITEM=EXAMPLE                                                           13906000
EXAMPLE                                                                 13908000
                                                                        13910000
To display volume set definition information for volume sets in your    13912000
logon group and account, with the listing sent to a line printer,       13914000
enter:                                                                  13916000
                                                                        13918000
\ENTRY=LMOUNT,PARMS,OPERATION,EXAMPLE                                   13920000
     :LMOUNT                                                            13922000
                                                                        13924000
Logically mounts a private volume set.                                  13926000
                                                                        13928000
SYNTAX                                                                  13930000
                                                                        13932000
             {*      }.group.account [GEN=genindex]                     13934000
     :LMOUNT {vcsname}                                                  13936000
                                                                        13938000
\ITEM=PARMS                                                             13940000
PARAMETERS                                                              13942000
                                                                        13944000
*                 Specifies mounting of the home volume set belonging   13946000
                  to the named group and account.                       13948000
                                                                        13950000
vcsname           Volume class/set name specifies the mounting of a     13952000
                  previously-defined volume class name or volume set    13954000
                  name.                                                 13956000
                                                                        13958000
group.account     Specifies the group and account under which the       13960000
                  volume set was created.                               13962000
                                                                        13964000
genindex          A value from -1 to 32767 specifying which generation  13966000
                  of the volume set is to be mounted (-1 allows any     13968000
                  generation to be mounted).  If omitted, the system    13970000
                  does not check the generation version of the          13972000
                  specified volume set.                                 13974000
                                                                        13976000
\ITEM=OPERATION                                                         13978000
OPERATION                                                               13980000
                                                                        13982000
When a mount command executes, all disc devices containing members      13984000
of the specified volume set become ASSIGNED devices.  The specified     13986000
volume set becomes logically attached to the devices until a            13988000
subsequent :LDISMOUNT command, at which time the devices become         13990000
AVAILABLE.                                                              13992000
                                                                        13994000
System users issue mount requests implicitly through their programs     13996000
or explicitly with a user :MOUNT command.  User-initiates mount         13998000
requests cause the specified volume set to be linked into the           14000000
system's accounting structure at the group level.  This is called       14002000
"binding".  With the console command, no such binding occurs.           14004000
                                                                        14006000
After a volume set has been mounted by a user-initiated request,        14008000
you can issue a console :LMOUNT command to cause the same volume        14010000
set to remain mounted, even after the last requesting user has          14012000
relinquished the set.  In this way, a volume set remains mounted        14014000
from one job or session to the next.  (Note that if you want to         14016000
prohibit further user-initiated mounts for a currently mounted          14018000
volume set, :DOWN the device where the set's master volume is           14020000
physically mounted.)                                                    14022000
                                                                        14024000
If the Private Volumes Facility was enabled with :VMOUNT ON,AUTO,       14026000
then MPE automatically attempts to stisfy your mount request.  If       14028000
the specified volume set/class is physically present, it is             14030000
logically mounted.  If the specified volume set is not physically       14032000
present, the system looks for available drives of the types required    14034000
to satisfy the request.  If sufficient drives are available, the        14036000
system reserves them and prints a message for you to mount the          14038000
volume set on one or more ldn's and reply YES or NO.  If sufficient     14040000
drives are not available, the system reserves those which will          14042000
satisfy part of your request and prints a message with the type         14044000
and number of drives it requires.  If you can free the required         14046000
drive(s), reply YES after the drive is AVAILABLE.  A NO reply           14048000
cancels the original :LMOUNT request.                                   14050000
                                                                        14052000
\ITEM=EXAMPLE                                                           14054000
EXAMPLES                                                                14056000
                                                                        14058000
To mount a private volume set named DATABASE in the PAYROLL group       14060000
of the ACCTNG account, enter:                                           14062000
                                                                        14064000
     :LMOUNT DATABASE.PAYROLL.ACCTNG;GEN=8                              14066000
                                                                        14068000
                                                                        14070000
                                                                        14072000
\ENTRY=LOG,PARMS,OPERATION,EXAMPLE                                      14074000
     :LOG                                                               14076000
                                                                        14078000
Starts, restarts, or stops user logging.                                14080000
                                                                        14082000
SYNTAX                                                                  14084000
                                                                        14086000
                {,START  }                                              14088000
     :LOG logid {,RESTART}                                              14090000
                {,STOP   }                                              14092000
                                                                        14094000
\ITEM=PARMS                                                             14096000
PARAMETERS                                                              14098000
                                                                        14100000
logid          Identifies the User Logging Process.                     14102000
                                                                        14104000
START          Initiates a logging process.                             14106000
                                                                        14108000
RESTART        Restarts a logging process.                              14110000
                                                                        14112000
STOP           Terminates a logging process.                            14114000
                                                                        14116000
\ITEM=OPERATION                                                         14118000
OPERATION                                                               14120000
                                                                        14122000
None.                                                                   14124000
                                                                        14126000
\ITEM=EXAMPLE                                                           14128000
EXAMPLE                                                                 14130000
                                                                        14132000
To turn on the logging process identified by logid LOGPROCX,            14134000
enter:                                                                  14136000
                                                                        14138000
       :LOG LOGPROCX,START                                              14140000
                                                                        14142000
\ENTRY=MOUNT,PARMS,OPERATION,EXAMPLE                                    14144000
    :MOUNT                                                              14146000
                                                                        14148000
Requests the Console Operator to mount a volume set.                    14150000
                                                                        14152000
SYNTAX                                                                  14154000
                                                                        14156000
               *                                                        14158000
    :MOUNT {         }[.groupname[.acctname]]                           14160000
             vcsname                                                    14162000
                                                                        14164000
           [;GEN=[genindex]]                                            14166000
                                                                        14168000
\ITEM=PARMS                                                             14170000
PARAMETERS                                                              14172000
                                                                        14174000
*                    Specifies the home volume set for the group and    14176000
                     account specified, or the logon group and account  14178000
                     if <groupname.acctname> are not specified. Default.14180000
                                                                        14182000
vcsname              Volume class/set name, specifying a previously-    14184000
                     defined volume class name or volume set name.      14186000
                     Default is *.                                      14188000
                                                                        14190000
groupname.acctname   Specify the group and account under which the      14192000
                     volume set was created.  Default is logon group    14194000
                     and account.                                       14196000
                                                                        14198000
genindex             A value from 0 to 65535 specifying which generation14200000
                     of the home volume set is to be mounted.  If       14202000
                     omitted, the system will ignore the generation     14204000
                     when attempting to satisfy the :MOUNT request.     14206000
                                                                        14208000
\ITEM=OPERATION                                                         14210000
OPERATION                                                               14212000
                                                                        14214000
The :MOUNT command allows you to become attached to a                   14216000
specific volume set.  In addition, this command allows you to specify   14218000
that the volume set is to be treated as a home volume set and therefore 14220000
it is to be bound to the system's accounting structure with respect to a14222000
particular group.  The :MOUNT command is rejected if there is an        14224000
operator-initiated :LDISMOUNT command pending for the specified volume  14226000
set.  The requesting job is suspended until the mount is completed or   14228000
rejected.                                                               14230000
                                                                        14232000
\ITEM=EXAMPLE                                                           14234000
EXAMPLE                                                                 14236000
                                                                        14238000
To request the Console Operator to mount volume set MYSET, generation   14240000
index 43, enter:                                                        14242000
                                                                        14244000
    :MOUNT MYSET;GEN=43                                                 14246000
                                                                        14248000
\ENTRY=MPLINE,PARMS,OPERATION,EXAMPLE                                   14250000
     :MPLINE                                                            14252000
Controls execution of the Multipoint Terminal Software                  14254000
(MTS/3000) Subsystem.                                                   14256000
                                                                        14258000
SYNTAX                                                                  14260000
                                                                        14262000
                 { OPEN [,filename]                          }          14264000
                 { UP, upentry                               }          14266000
                 { DOWN, downentry                           }          14268000
   :MPLINE ldn,  { SHUT [,NOW]                               }          14270000
                 { MESSAGES, {ON|OFF}                        }          14272000
                 { TRACE,  ON [,[ALL][,[mask][,[numentries]             14274000
                                [,[WRAP][,filename]]]]]      }          14276000
                 { TRACE, OFF                                }          14278000
                                                                        14280000
\ITEM=PARMS                                                             14282000
PARAMETERS                                                              14284000
                                                                        14286000
ldn         The logical device number of the multipoint super-          14288000
            visor that is associated with the line you want to          14290000
            open, close, trace, etc.  Required parameter.               14292000
                                                                        14294000
OPEN        Initiates MTS/3000 execution, opens the communication       14296000
            line, and starts multipoint terminal activity.              14298000
                                                                        14300000
filename    Names an MTS configuration file in the PUB.SYS              14302000
            account.  Default: the line is opened with the line         14304000
            characteristics established by MPE configuration.           14306000
                                                                        14308000
UP          Activates the terminal(s) specified in the upentry.         14310000
            This places the terminal(s) logically online for MTS        14312000
            activity.                                                   14314000
                                                                        14316000
DOWN        Deactivates the terminal(s) specified in the down-          14318000
            entry parameter.  This places the device(s) logically       14320000
            offline and makes them unavailable for MTS activity.        14322000
                                                                        14324000
upentry     Up entries and down entries can be one of the               14326000
downentry   following:                                                  14328000
                                                                        14330000
            1.  The logical device number of a multipoint termi-        14332000
                nal as configured into MPE.                             14334000
            2.  A terminal ID, consisting of two letters that           14336000
                specify the group and device ID of a particular         14338000
                multipoint terminal.  (A terminal ID corresponds        14340000
                to the unit number assigned during MPE                  14342000
                configuration.)                                         14344000
            3.  The word GROUP followed by a space and one letter       14346000
                designating a particular group.  All terminals          14348000
                configured under MPE as members of the group will       14350000
                be activated or deactivated.                            14352000
                                                                        14354000
SHUT        Initiates an orderly MTS line closing procedure.  If        14356000
            multipoint terminals are currently in use, the line         14358000
            remains open and MTS execution continues.  The line         14360000
            will be closed when all users have finished.                14362000
                                                                        14364000
NOW         Immediately terminates MTS/3000 execution and closes        14366000
            the line without waiting for sessions to log off and        14368000
            applications to close the terminals they are using.         14370000
                                                                        14372000
MESSAGES    Controls the printing of MTS messages on the system         14374000
            console.                                                    14376000
                                                                        14378000
            ON  causes the messages that result from MTS commu-         14380000
                nication activity to be displayed. ON is default.       14382000
                                                                        14384000
            OFF stops the messages associated with MTS line             14386000
                activity from being displayed.  If OFF is speci-        14388000
                fied and system console logging is enabled, the         14390000
                messages will still be recorded in the log file.        14392000
                                                                        14394000
            Command Interpreter messages (for example, those gen-       14396000
            erated by syntax errors) are displayed regardless of        14398000
            whether MESSAGES is ON or OFF.                              14400000
                                                                        14402000
                                                                        14404000
TRACE,ON    Activates CS Trace.                                         14406000
                                                                        14408000
ALL         Generates trace records for all activity.  Default:         14410000
            trace records are written only when an error occurs.        14412000
                                                                        14414000
mask        An octal number preceded by a percent sign (%nn) to         14416000
            specify the type of trace entries.  Default: %37.           14418000
                                                                        14420000
numentries  An integer, a multiple of eight, not greater than           14422000
            248 (INP maximum is 24). Designates the maximum             14424000
            number of entries in a trace record.  If num-               14426000
            entries is not a multiple of eight, the system              14428000
            rounds your entry to comply.                                14430000
            If no trace file exists when you turn on the trace          14432000
            facility and you do not specify numentries, the             14434000
            system creates a file that will hold 24 entries.            14436000
            If the trace file already exists, and the record            14438000
            size is not compatible with the requested record            14440000
            size (based on the requested numentries), the old           14442000
            file is purged before a new, permanent file (with           14444000
            the old file's file limit and maximum number of             14446000
            entries) is created.  To change numentries, simply          14448000
            turn trace off and then turn it on again with the           14450000
            new number of entries.                                      14452000
                                                                        14454000
WRAP        Causes trace entries that overflow the trace record         14456000
            (greater than numentries) to overlay the prior trace        14458000
            entries.  Default: overflow entries are discarded.          14460000
                                                                        14462000
filename    The trace filename.  Default:  CSTRACE.PUB.SYS              14464000
                                                                        14466000
TRACE,OFF   Deactivates the CS trace facility.                          14468000
                                                                        14470000
\ITEM=OPERATION                                                         14472000
OPERATION                                                               14474000
                                                                        14476000
An MPLINE ldn,OPEN command opens a line, starts MTS/3000 execu-         14478000
tion, and initiates terminal polling.  If a configuration file          14480000
name is omitted from the command, the line is opened with the           14482000
characteristics established by MPE configuration, and individual        14484000
or group polling occurs as determined by each terminal's MPE sub-       14486000
type number.                                                            14488000
                                                                        14490000
You cannot initiate MTS activity if the line is already in use by       14492000
another data communications subsystem (such as DS/3000 or               14494000
MRJE/3000).  Thus it may be necessary to close the line for             14496000
another subsystem before you can open it for MTS.                       14498000
                                                                        14500000
If the filename parameter is included in an MPLINE command              14502000
(MPLINE ldn,OPEN,filename), the line is opened with the char-           14504000
acteristics established in the MTS configuration file and polling       14506000
begins only on the terminals specified in that file.                    14508000
                                                                        14510000
While the line is open, you can name a configuration file or            14512000
switch to a different file (if one is already being used) by            14514000
issuing another OPEN command.  That is, you need not close a line       14516000
when switching configuration files; MTS will automatically close        14518000
the line before reopening it.  When MTS reopens the line, the           14520000
system normally makes the line connection with no action on your        14522000
part.  Only with dialup modems will you need to dial a telephone        14524000
number, listen for the carrier tone, press the modem DATA button,       14526000
and respond at the console to make the connection.                      14528000
                                                                        14530000
The UP and DOWN parameters of the MPLINE command are used to con-       14532000
trol activity on specific MTS terminals.                                14534000
                                                                        14536000
When you DOWN a multipoint terminal, MTS refuses to write data to       14538000
it.  If the terminal is individually polled or is the only ter-         14540000
minal in its group, it is actually removed from the poll list.          14542000
If the terminal is a part of a group, it is deactivated and any         14544000
data received from it is saved until the terminal is reactivated.       14546000
                                                                        14548000
Conversely, when you UP a multipoint terminal, its address is           14550000
restored to the poll list at the same point where the address           14552000
existed previously, or it is reactivated, as the case may be.           14554000
                                                                        14556000
Any terminal you activate or deactivate must be properly con-           14558000
figured under MPE.                                                      14560000
                                                                        14562000
You can designate multipoint terminals to be UP or DOWN only            14564000
while the MTS line is open.  Note, however, that MTS auto-              14566000
matically closes and reopens the line each time you issue one of        14568000
these commands.  In a leased-line environment, this may tempo-          14570000
rarily delay communication with the other terminals on the line         14572000
but will not interfere significantly.  If a dialup line is in           14574000
use, the connection will be be broken and must be reestablished.        14576000
                                                                        14578000
The SHUT parameter initiates an orderly MTS line closing pro-           14580000
cedure.  If no sessions or applications are using the line when         14582000
you shut it, disconnection occurs immediately and MTS/3000 exe-         14584000
cution terminates.  Otherwise, the line remains connected, and          14586000
the following happens:                                                  14588000
                                                                        14590000
o  No new sessions may be initiated on HP 264x multipoint               14592000
   terminals.                                                           14594000
                                                                        14596000
o  No additional multipoint terminals may be opened by applica-         14598000
   tion programs.                                                       14600000
                                                                        14602000
o  Sessions on 264x multipoint terminals continue until users log       14604000
   off or the sessions are aborted by the console operator.             14606000
                                                                        14608000
o  Applications with open multipoint terminals continue until           14610000
   they terminate normally or are aborted by the operator.              14612000
                                                                        14614000
o  After all sessions end and all applications close all multi-         14616000
   point terminals, the line is automatically disconnected, and         14618000
   MTS/3000 execution terminates.                                       14620000
                                                                        14622000
The MPLINE ldn,SHUT,NOW command disconnects the line immediately        14624000
without waiting for sessions to log off and applications to close       14626000
their multipoint terminals.  Because the system automatically           14628000
aborts the sessions and closes the files, data may be lost              14630000
because of this command.                                                14632000
                                                                        14634000
\ITEM=EXAMPLE                                                           14636000
EXAMPLE                                                                 14638000
                                                                        14640000
To open the line for MTS activity and use a file named CONFIGA,         14642000
enter the following:                                                    14644000
                                                                        14646000
     :MPLINE 54,OPEN,CONFIGA                                            14648000
                                                                        14650000
To trace activity on the open line, enter the following:                14652000
                                                                        14654000
     :MPLINE 54,TRACE,ON,,,,,MYFILE                                     14656000
                                                                        14658000
                                                                        14660000
\ENTRY=MRJE,PARMS,OPERATION,EXAMPLE                                     14662000
    :MRJE                                                               14664000
                                                                        14666000
Initiates execution of the Multileaving Remote Job Entry (MRJE)         14668000
facility.                                                               14670000
                                                                        14672000
SYNTAX                                                                  14674000
                                                                        14676000
    :MRJE                                                               14678000
                                                                        14680000
\ITEM=PARMS                                                             14682000
PARAMETERS                                                              14684000
                                                                        14686000
None                                                                    14688000
                                                                        14690000
\ITEM=OPERATION                                                         14692000
OPERATION                                                               14694000
                                                                        14696000
The :MRJE command is used to initiate execution of the MRJE facility    14698000
for submitting jobs to, and retrieving output from, a host computer.    14700000
The host computer may be using either a HASP Version 3.1, HASP-II       14702000
Version 4.0 or later, JES2, JES3, or ASP job entry subsystem.           14704000
                                                                        14706000
\ITEM=EXAMPLE                                                           14708000
EXAMPLE                                                                 14710000
                                                                        14712000
    :MRJE                                                               14714000
                                                                        14716000
                                                                        14718000
\ENTRY=MRJECONTROL                                                      14720000
     :MRJECONTROL                                                       14722000
                                                                        14724000
Used to open and close the MRJE/3000 communications link                14726000
with one or more hosts, to change the number of error                   14728000
transmission retries, to turn on or off the CS/3000 TRACE diag-         14730000
nostic, and to check the internal fix level compatibility               14732000
of the MRJE modules.  Replaces the =MRJE console command.               14734000
                                                                        14736000
               {START   [,hostid] [;trace function] }                   14738000
               {SIGNOFF [,hostid] }                                     14740000
               {KILL    [,hostid] }                                     14742000
:MRJECONTROL   {RETRIES ,[hostid],retrynum }                            14744000
               {TRACE   ,[hostid], ON [trace options] }                 14746000
               {TRACE   ,[hostid], OFF }                                14748000
               {CHECK }                                                 14750000
                                                                        14752000
trace function  ::= {TRACE, ON [trace options] }                        14754000
                    {TRACE, OFF }                                       14756000
                                                                        14758000
trace options   ::= [,[ALL][,[mask][,[numentries]                       14760000
                      [,WRAP][,filename]]]]]                            14762000
                                                                        14764000
\ITEM=PARMS                                                             14766000
                                                                        14768000
                                                                        14770000
hostid              An alphanumeric name which identifies a host        14772000
                    machine.  MRJE uses only the first character        14774000
                    of the name in its message to users.                14776000
                                                                        14778000
START               Used to open the communications line to a host.     14780000
                                                                        14782000
SIGNOFF             Used to close the communications line in a          14784000
                    orderly fashion.                                    14786000
                                                                        14788000
KILL                Immediately disconnects the link to the host        14790000
                    system.  Should be used in emergencies only,        14792000
                    as error-free recovery is not certain.              14794000
                                                                        14796000
RETRIES             Used to regulate the number of times MRJE will      14798000
                    repeat a failed attempt to receive a block of       14800000
                    data from the host.                                 14802000
                                                                        14804000
retrynum            An integer 1 to 255, inclusive. Used by the         14806000
                    RETRIES command.                                    14808000
                                                                        14810000
CHECK               Prints a matrix of all MRJE modules and their       14812000
                    internal fix levels.                                14814000
                                                                        14816000
TRACE, ON           Activates the CS/3000 TRACE facility to provide     14818000
                    a record of communications activity.                14820000
                                                                        14822000
ALL                 Generate trace records for all line activity.       14824000
                    Default:  Records are written only for trans-       14826000
                    mission errors.                                     14828000
                                                                        14830000
mask                An octal number preceded by a percent sign (%nn).   14832000
                    Used to select type of trace entries generated.     14834000
                    Refer to MRJE/3000 Reference Manual for an ex-      14836000
                    planation of the mask bits.  Default:  %37, (all    14838000
                    except STN).                                        14840000
                                                                        14842000
numentries          Decimal integer for the maximum number of entries   14844000
                    in a trace record, maximum of 248.  Default: 24.    14846000
                                                                        14848000
WRAP                Causes trace entries that overflow the trace        14850000
                    record (that exceed "numentries") to overlay        14852000
                    the first entries written to that record.           14854000
                                                                        14856000
filename            Name of file where trace records are to be          14858000
                    written.  Default:  MRJETRCh.PUB.SYS, where "h"     14860000
                    is the first character of "hostid".                 14862000
                                                                        14864000
TRACE, OFF          Deactivates TRACE facility.                         14866000
                                                                        14868000
                                                                        14870000
\ITEM=OPERATION                                                         14872000
                                                                        14874000
Unless :MRJECONTROL is issued from the master console, users are        14876000
granted access only if they are ALLOWed to use the command.             14878000
                                                                        14880000
A user can open and close the MRJE/3000 communications link with        14882000
one or more hosts, change the number of transmission error retries,     14884000
turn on the CS/3000 TRACE diagnostic, and check the internal fix        14886000
levels of all the MRJE modules.                                         14888000
                                                                        14890000
                                                                        14892000
                                                                        14894000
\ITEM=EXAMPLE                                                           14896000
                                                                        14898000
  :MRJECONTROL START, B; TRACE, ON                                      14900000
                                                                        14902000
In this example, the MRJE line is being opened to the host spec-        14904000
ified by the hostid "B".  The TRACE facility has been activated         14906000
and will only trace transmission errors.  The trace records will        14908000
be written to the file MRJETRCB.PUB.SYS.                                14910000
                                                                        14912000
  :MRJECONTROL SIGNOFF                                                  14914000
                                                                        14916000
Here, a request is made to close down the MRJE line to the default      14918000
host as soon as all current activity is finished.                       14920000
                                                                        14922000
                                                                        14924000
                                                                        14926000
\ENTRY=NEWACCT,PARMS,OPERATION,EXAMPLE                                  14928000
    :NEWACCT (System Manager capability required)                       14930000
                                                                        14932000
Creates a new account and an associated Account Manager and Public      14934000
Group.                                                                  14936000
                                                                        14938000
SYNTAX                                                                  14940000
                                                                        14942000
    :NEWACCT acctname,mgrname                                           14944000
             [;PASS=[password]]                                         14946000
             [;FILES=[filespace]]                                       14948000
             [;CPU=[cpu]]                                               14950000
             [;CONNECT=[connect]]                                       14952000
             [;CAP=[capabilitylist]]                                    14954000
             [;ACCESS=[fileaccess]]                                     14956000
             [;MAXPRI=[subqueuename]]                                   14958000
             [;LOCATTR=[localattribute]]                                14960000
             [;VS=volset:SPAN]                                          14962000
                                                                        14964000
\ITEM=PARMS                                                             14966000
PARAMETERS                                                              14968000
                                                                        14970000
acctname         Name to be assigned to the new account. (REQUIRED      14972000
                 PARAMETER)                                             14974000
                                                                        14976000
mgrname          Name of the account manager; this is always the first  14978000
                 user created under the account.  He receives the       14980000
                 following attributes:                                  14982000
                                                                        14984000
                 User password                 No password.             14986000
                                                                        14988000
                 Capability list               Same as account's        14990000
                                               capabilities.            14992000
                                                                        14994000
                 Scheduling priority           Same as account's maximum14996000
                                               priority.                14998000
                                                                        15000000
                 Local attribute               Same as account's.       15002000
                                                                        15004000
\starthelp                                                              15006000
                 Home group                    PUB.                     15008000
                                                                        15010000
                 The attributes of an Account Manager may be changed    15012000
                 later with the :ALTUSER command.  In no case, however, 15014000
                 is this user granted effective attributes greater than 15016000
                 those of the account.  (REQUIRED PARAMETER)            15018000
                                                                        15020000
password         Account password, used for verifying logon access      15022000
                 only.  Default is no password assigned.                15024000
                                                                        15026000
filespace        Disc storage limit, in sectors, for the permanent files15028000
                 of the account.  The maximum value permitted is a      15030000
                 2,147,483,647 sectors.  Default is unlimited filespace.15032000
                                                                        15034000
cpu              Limit on total cpu time, in seconds, for this account. 15036000
                 This limit is checked only when a job/session is       15038000
                 initiated -- thus, the limit never causes a job/session15040000
                 to abort.  The maximum value permitted is 2,147,483,64715042000
                 seconds.  Default is no limit is assigned.             15044000
\starthelp                                                              15046000
                                                                        15048000
connect          Limit on total session connect time, in minutes,       15050000
                 allowed the account.  This limit is checked only at    15052000
                 logon time. The maximum value allowed is 2,147,483,647 15054000
                 minutes.  Default is no limit is assigned.             15056000
\starthelp                                                              15058000
                                                                        15060000
capabilitylist   List of capabilities, mutually separated by commas,    15062000
                 permitted this account.  Each capability is denoted by 15064000
                 a two-letter mnemonic, as follows:                     15066000
                                                                        15068000
                 System Manager          = SM                           15070000
                 Account Manager         = AM                           15072000
                 Account Librarian       = AL                           15074000
                 Group Librarian         = GL                           15076000
                 Diagnostician           = DI                           15078000
                 System Supervisor       = OP                           15080000
                                                                        15082000
                 Permanent Files         = SF                           15084000
                 Access of non-sharable                                 15086000
                 I/O devices             = ND                           15088000
                 Create Volumes          = CV                           15090000
                 Use Volumes             = UV                           15092000
                 Use Communications                                     15094000
                 Subsystems              = CS                           15096000
                                                                        15098000
                 Process Handling        = PH                           15100000
                 Extra Data Segments     = DS                           15102000
                 Multiple RINS           = MR                           15104000
                 Privileged Mode         = PM                           15106000
                 Interactive Access      = IA                           15108000
                 Local Batch Access      = BA                           15110000
                 User Logging            = LG                           15112000
                                                                        15114000
                 Default is AM, AL, GL, SF, ND, IA, BA.                 15116000
\starthelp                                                              15118000
                                                                        15120000
fileaccess           File security specifications, entered as follows:  15122000
                                                                        15124000
                      R                                                 15126000
                      L     ANY                                         15128000
                     {A} : {   }                                        15130000
                      W     AC                                          15132000
                      X                                                 15134000
\starthelp                                                              15136000
                                                                        15138000
                     where R, L, A, W, X specify modes of access by     15140000
                     types of users (ANY, AC) as follows:               15142000
\starthelp                                                              15144000
                                                                        15146000
                     R = Read                                           15148000
                     L = Lock (allows exclusive access to file)         15150000
                     A = Append (implicitly specifies L also)           15152000
                     W = Write (implicitly specifies A and L also)      15154000
                     X = Execute                                        15156000
\starthelp                                                              15158000
                                                                        15160000
                     Two or more modes may be specified if they are     15162000
                     separated by commas.                               15164000
                                                                        15166000
                     The user types are specified as follows:           15168000
                                                                        15170000
                     ANY = Any user                                     15172000
                     AC  = Member of this account only                  15174000
\stophelp                                                               15176000
                     AL  = Account librarian user only                  15178000
                     GL  = Group librarian user only                    15180000
\starthelp                                                              15182000
                                                                        15184000
                     Two or more user types may be specified if they are15186000
                     separated by commas.                               15188000
                                                                        15190000
                     The default is:                                    15192000
                        R, L, A, W, X: AC  (All accounts except SYS)    15194000
                        R, X: ANY; L, A, W: AC  (SYS account only)      15196000
                                                                        15198000
subqueuename     The name of the subqueue of highest priority that can  15200000
                 be requested by any process of any job in the account, 15202000
                 specified as xS, where x is A, B, C, D, or E.  Default 15204000
                 is CS.                                                 15206000
                                                                        15208000
localattribute   The local attribute of the user, as defined at the     15210000
                 installation site.  This is a double-word of arbitrary 15212000
                 meaning which might be used to further classify users. 15214000
                 Default is double-word 0.                              15216000
                                                                        15218000
volset:SPAN      Volset is a volume set or class reference which,       15220000
                 when fully qualified, is in the form                   15222000
                                                                        15224000
                 vcsid.groupname.acctname                               15226000
                                                                        15228000
                 where vcsid refers to a previously-defined volume      15230000
                 set or class definition.                               15232000
                                                                        15234000
                 SPAN indicates that the acctname is to be inserted     15236000
                 in the accounting directory of the specified volume    15238000
                 set (volset).  The specified volume set must have      15240000
                 been previously mounted (via a MOUNT command) for      15242000
                 the SPAN operation to succeed.                         15244000
                                                                        15246000
                 Note that the associated Account Manager and PUBLIC    15248000
                 group are not created in the accounting directory      15250000
                 of the specified volume set.                           15252000
                                                                        15254000
\ITEM=OPERATION                                                         15256000
OPERATION                                                               15258000
                                                                        15260000
(System Manager capability required)                                    15262000
This command creates a new account and an associated Account Manager and15264000
Public Group.                                                           15266000
                                                                        15268000
Default parameters are assigned to this command as follows:             15270000
                                                                        15272000
1.  When a keyword is included but its corresponding keyword parameter  15274000
    is omitted (as in ;PASS=).                                          15276000
                                                                        15278000
2.  When an entire keyword parameter grouping (such as ;PASS=password)  15280000
    is omitted.                                                         15282000
                                                                        15284000
After the System Manager enters the :NEWACCT command, the new Account   15286000
Manager then can redefine his own attributes, the Public Group, and new 15288000
users and groups.  Note that the Account Manager may only define groups 15290000
and users within the set of parameters assigned by the System Manager at15292000
account creation time.                                                  15294000
                                                                        15296000
The Public Group initially is assigned no password and the same         15298000
capability class attributes, permanent file space limit, cpu time limit,15300000
and connect time limit as the account.  Its initial security allows     15302000
reading and program-execute access to all users who can pass the        15304000
account's security, and appending, locking, and saving access to account15306000
librarian and group users only.  (These access provisions are R, X: ANY;15308000
A, W, L, S: AL, GU.)                                                    15310000
                                                                        15312000
\ITEM=EXAMPLE                                                           15314000
EXAMPLE                                                                 15316000
                                                                        15318000
To create an account with the account name ACI and the Account Manager  15320000
name SMYTHE, enter:                                                     15322000
                                                                        15324000
    :NEWACCT ACI,SMYTHE                                                 15326000
                                                                        15328000
All other parameters are assigned by default.                           15330000
\ENTRY=NEWGROUP,PARMS,OPERATION,EXAMPLE                                 15332000
    :NEWGROUP (Account Manager capability required)                     15334000
                                                                        15336000
Creates a new group within an account.                                  15338000
                                                                        15340000
SYNTAX                                                                  15342000
                                                                        15344000
    :NEWGROUP groupname                                                 15346000
              [;PASS=[password]]                                        15348000
              [;CAP=[capabilitylist]]                                   15350000
              [;FILES=[filespace]]                                      15352000
              [;CPU=[cpu]]                                              15354000
              [;CONNECT=[connect]]                                      15356000
              [;ACCESS=[fileaccess]]                                    15358000
              [;VS=[volset[:SPAN]]]                                     15360000
                                                                        15362000
\ITEM=PARMS                                                             15364000
PARAMETERS                                                              15366000
                                                                        15368000
groupname         The name of the new group, composed of up to eight    15370000
                  alphanumeric characters, beginning with a letter.     15372000
                  (REQUIRED PARAMETER)                                  15374000
                                                                        15376000
password          Group password, used for verifying logon access only. 15378000
                  Default is no password is assigned.                   15380000
                                                                        15382000
capabilitylist    A list of capability-class attributes, consisting of  15384000
                  any or all of the following:  IA, BA, PM, MR, DS, or  15386000
                  PH.                                                   15388000
                                                                        15390000
                  This list imposes a limit on program files belonging  15392000
                  to the group.  A capability cannot be defined if it is15394000
                  not presently possessed by the group's account.       15396000
                  Default is IA, BA.                                    15398000
\stophelp                                                               15400000
\starthelp                                                              15402000
                                                                        15404000
filespace         Disc storage limit, in sectors, for the permanent     15406000
                  files of the group.  A group's <filespace> cannot be  15408000
                  specified as greater than the corresponding limits    15410000
                  currently defined for the group's account. However, an15412000
                  account's <filespace> can be changed later so that    15414000
                  some of its groups are left with limits that exceed   15416000
                  the new account limits. Default is same as account's  15418000
                  filespace.                                            15420000
                                                                        15422000
cpu               Limit on total cpu time, in seconds, for the group.   15424000
                  This limit is checked only when a job/session is      15426000
                  initiated -- thus, the limit never causes a           15428000
                  job/session to abort. The maximum value permitted is  15430000
                  2,147,483,647 seconds.  A group's cpu limit cannot be 15432000
                  specified as greater than the corresponding limit     15434000
                  currently defined for the group's account.  However,  15436000
                  an account's cpu limit can be changed later so that   15438000
                  some of its groups are left with a limit that exceeds 15440000
                  the new account limits.  Default is account's cpu     15442000
                  limit.                                                15444000
                                                                        15446000
connect           Limit on total session connect time, in minutes,      15448000
                  allowed the group.  This limit is checked only at     15450000
                  logon time.  The maximum value allowed is             15452000
                  2,147,483,647 minutes.  A group's connect limit cannot15454000
                  be specified as greater than the corresponding limit  15456000
                  currently defined for the group's account.  However,  15458000
                  an account's connect can be changed later so that some15460000
                  of its groups can be left with a limit that exceeds   15462000
                  the new account limits.  Default is the account's     15464000
                  connect limit.                                        15466000
                                                                        15468000
fileaccess       File security specifications, entered as follows:      15470000
                                                                        15472000
                  R     ANY                                             15474000
                  L     AC                                              15476000
                 {A} : {GU }                                            15478000
                  W     AL                                              15480000
                  X     GL                                              15482000
                  S                                                     15484000
                                                                        15486000
                 where R, L, A, W, X, S specify modes of access by types15488000
                 of users (ANY, AC, GU, AL, GL) as follows:             15490000
                                                                        15492000
                 R = Read                                               15494000
                 L = Lock (allows exclusive access to file)             15496000
                 A = Append (implicitly specifies L also)               15498000
                 W = Write (implicitly specifies A and L also)          15500000
                 X = Execute                                            15502000
                 S = Save                                               15504000
                                                                        15506000
                 Two or more modes may be specified if they are         15508000
                 separated by commas.                                   15510000
                                                                        15512000
                 The user types are specified as follows:               15514000
                                                                        15516000
                 ANY = Any user                                         15518000
                 AC  = Member of this account only                      15520000
                 GU  = Member of this group only                        15522000
                 AL  = Account librarian user only                      15524000
                 GL  = Group librarian user only                        15526000
\starthelp                                                              15528000
                                                                        15530000
                 Two or more user types may be specified if they are    15532000
                 separated by commas.                                   15534000
                                                                        15536000
                 Default is R, A, W, L, X, S : GU (all groups except    15538000
                 PUB); or R, X : ANY; A, W, L, S : AL, GU (PUB group    15540000
                 only).                                                 15542000
                                                                        15544000
volset:SPAN      Volset is a volume set or class reference which, when  15546000
                 fully qualified, is in the form                        15548000
                                                                        15550000
                 vcsid.groupname.acctname                               15552000
                                                                        15554000
                 where vcsid refers to a previously-defined volume set  15556000
                 or class definition.                                   15558000
                                                                        15560000
                 SPAN indicates that groupname is to be inserted in     15562000
                 the accounting directory of the specified volume       15564000
                 set (volset).  The specified volume set must have      15566000
                 been previously mounted (via the MOUNT command) for    15568000
                 the span operation to succeed.                         15570000
                                                                        15572000
                 If volset is omitted from the VS= parameter, the group 15574000
                 will be assigned to the system volume set.  If volset  15576000
                 is specified and the SPAN keyword is omitted, the      15578000
                 group's home volume set will be the one specified by   15580000
                 the command, but an entry will not be made into its    15582000
                 accounting directory.   (This is useful when the       15584000
                 volume set is being transported from another system    15586000
                 to your system, and the group does not exist in the    15588000
                 system accounting directory but does exist in the      15590000
                 volume set's accounting directory.)                    15592000
                                                                        15594000
\ITEM=OPERATION                                                         15596000
OPERATION                                                               15598000
                                                                        15600000
(Account Manager capability required)                                   15602000
This command creates a new group within an account.                     15604000
                                                                        15606000
When a keyword parameter (such as ;PASS=) or keyword parameter group    15608000
(such as ;PASS=<password>) is omitted from the :NEWGROUP command, the   15610000
corresponding default value takes effect.                               15612000
                                                                        15614000
\ITEM=EXAMPLE                                                           15616000
EXAMPLE                                                                 15618000
                                                                        15620000
To create a new group named GROUP1, enter:                              15622000
                                                                        15624000
    :NEWGROUP GROUP1                                                    15626000
                                                                        15628000
Default values are taken for all parameters.                            15630000
\ENTRY=NEWUSER,PARMS,OPERATION,EXAMPLE                                  15632000
    :NEWUSER (Account Manager capability required)                      15634000
                                                                        15636000
Defines a new user.                                                     15638000
                                                                        15640000
SYNTAX                                                                  15642000
                                                                        15644000
    :NEWUSER username                                                   15646000
             [;PASS=[password]]                                         15648000
             [;CAP=[capabilitylist]]                                    15650000
             [;MAXPRI=[subqueuename]]                                   15652000
             [;LOCATTR=[localattribute]]                                15654000
             [;HOME=[homegroupname]]                                    15656000
                                                                        15658000
                                                                        15660000
\ITEM=PARMS                                                             15662000
PARAMETERS                                                              15664000
                                                                        15666000
username             The name of the user, composed of up to eight      15668000
                     alphanumeric characters, beginning with a letter.  15670000
                     (REQUIRED PARAMETER)                               15672000
                                                                        15674000
password             User password.  (This password is used for         15676000
                     verifying logon access only.)  Default is no       15678000
                     password is assigned.                              15680000
                                                                        15682000
capabilitylist       List of capabilities, mutually separated by commas,15684000
                     permitted this account.  Each capability is denoted15686000
                     by a two-letter mnemonic, as follows:              15688000
                                                                        15690000
                     System Manager          = SM                       15692000
                     Account Manager         = AM                       15694000
                     Account Librarian       = AL                       15696000
                     Group Librarian         = GL                       15698000
                     Diagnostician           = DI                       15700000
                     System Supervisor       = OP                       15702000
                                                                        15704000
                     Permanent Files         = SF                       15706000
                     Access of non-sharable                             15708000
                     I/O devices             = ND                       15710000
                     Create Volumes          = CV                       15712000
                     Use Volumes             = UV                       15714000
                                                                        15716000
                     Process Handling        = PH                       15718000
                     Extra Data Segments     = DS                       15720000
                     Multiple RINS           = MR                       15722000
                     Privileged Mode         = PM                       15724000
                     Interactive Access      = IA                       15726000
                     Local Batch Access      = BA                       15728000
                     User Logging            = LG                       15730000
                                                                        15732000
                     This parameter cannot specify capabilities that are15734000
                     not assigned to the user's account.  Default is    15736000
                     SF, ND, IA, BA.                                    15738000
\stophelp                                                               15740000
                     but, because the user's capabilities are always    15742000
                     verified to be a subset of the account's at logon  15744000
                     time, the user is never granted a capability not   15746000
                     possessed by the account.  Default is SF, ND, IA,  15748000
\starthelp                                                              15750000
                                                                        15752000
subqueuename         Name of the subqueue of highest priority that can  15754000
                     be requested by any process of any job/session in  15756000
                     the account, specified as "xS," where x is A, B, C,15758000
                     D, or E.  The priority specified in :NEWUSER cannot15760000
                     be greater than that specified in :NEWACCT or      15762000
                     :ALTACCT.  If the user's account is changed later, 15764000
                     however, the user may be left with excessive       15766000
                     limits.  The <subqueuename> defined for the user is15768000
                     checked against the <subqueuename> defined for his 15770000
                     account at logon time, and the lower priority of   15772000
                     the two is used as the maximum priority restricting15774000
                     all processes of the job/session.  Also, the       15776000
                     priority requested by the user when he logs on is  15778000
                     checked against the <subqueuename> defined for him,15780000
                     and he is granted the lower of these two values.   15782000
                     Default is CS.                                     15784000
                                                                        15786000
localattribute       The local attribute of the user, as defined at the 15788000
                     installation site.  This is a double-word of       15790000
                     arbitrary meaning which might be used to further   15792000
                     classify users.  Default is double-word 0.         15794000
                                                                        15796000
homegroupname        The name of an existing group to be assigned as the15798000
                     homegroup for this user. If no homegroup is        15800000
                     assigned, the user must always specify a group when15802000
                     logging on.  Default is no homegroup is assigned.  15804000
                                                                        15806000
\ITEM=OPERATION                                                         15808000
OPERATION                                                               15810000
                                                                        15812000
(Account Manager capability required)                                   15814000
This command defines a new user.                                        15816000
                                                                        15818000
\ITEM=EXAMPLE                                                           15820000
EXAMPLE                                                                 15822000
                                                                        15824000
To define a new user named LHSMITH, assign a password of SMITTY, and a  15826000
homegroup of HOMEGPX, enter:                                            15828000
                                                                        15830000
    :NEWUSER LHSMITH;PASS=SMITTY;HOME=HOMEGPX                           15832000
                                                                        15834000
\ENTRY=NEWVSET,PARMS,OPERATION,EXAMPLE                                  15836000
    :NEWVSET                                                            15838000
                                                                        15840000
(System Manager, or Account Manager with Volume Set Creation (CV)       15842000
capability required)                                                    15844000
                                                                        15846000
Defines private volume sets and classes.                                15848000
                                                                        15850000
SYNTAX                                                                  15852000
                                                                        15854000
    :NEWVSET vsname                                                     15856000
             [;MEMBERS=vname:type[,vname:type,...[vname:type]]          15858000
             [;CLASS=vcname:vname[,vname,...[,vname]]                   15860000
                                                                        15862000
\ITEM=PARMS                                                             15864000
PARAMETERS                                                              15866000
                                                                        15868000
vsname            Volume set name, consisting of from one to eight      15870000
                  alphanumeric characters, beginning with a letter.     15872000
                  This name is also given to the master volume of the   15874000
                  set.                                                  15876000
                  MPE will implicitly reference <vsname> as             15878000
                  <vsname.groupname.acctname>, where <groupname> and    15880000
                  <acctname> are the logon group and account. (REQUIRED 15882000
                  PARAMETER)                                            15884000
                                                                        15886000
vname:type        Names of members of the volume set and the types of   15888000
                  devices on which the members will reside.  A maximum  15890000
                  of eight volume names may be specified.  The list     15892000
                  of volumes names must include the master volume       15894000
                  set name.  The <type>                                 15896000
                  must be specified with each volume member to define   15898000
                  the type of disc required to accomodate the volume.   15900000
                  Types of discs that may be specified are HP7905,      15902000
                  HP7906, HP7920, HP7925, and HP7933.                   15904000
                                                                        15906000
                                                                        15908000
                                                                        15910000
vcname:vname      Volume class name, consisting of from one to eight    15912000
                  alphanumeric characters, beginning with a letter. Each15914000
                  volume class consists of a volume class name and an   15916000
                  associated list of volume names <vname>.  The list of 15918000
                  volume names must be a subset of the volumes          15920000
                  comprising the volume set, and one of the volume names15922000
                  must be that of the volume set's master volume.       15924000
                                                                        15926000
\ITEM=OPERATION                                                         15928000
OPERATION                                                               15930000
                                                                        15932000
(System Manager, or Account Manager with Volume Set Creation (CV)       15934000
capability required)                                                    15936000
The :NEWVSET command creates private volume sets and classes.           15938000
Once a volume set or volume class is defined, its                       15940000
definition is kept on disc in a volume set definition entry.  A physical15942000
volume set is not created at the time the volume set is defined, only   15944000
the members of the volume set and the corresponding storage types are   15946000
defined to MPE.                                                         15948000
                                                                        15950000
\ITEM=EXAMPLE                                                           15952000
EXAMPLE                                                                 15954000
                                                                        15956000
To define a volume set with <vsname> USERSET; with members USERSET      15958000
(master volume), MEM1, and <type> HP 7920; and class <vcname:vname>     15960000
CLASS1:USERSET,MEM1, enter:                                             15962000
                                                                        15964000
    :NEWVSET USERSET;MEMBERS=USERSET:HP7920,MEM1:HP7920&                15966000
    : ;CLASS=CLASS1:USERSET,MEM1                                        15968000
     :OUTFENCE outputpriority [;LDEV=ldn]                               15970000
                                                                        15972000
\ENTRY=OUTFENCE,PARMS,OPERATION,EXAMPLE                                 15974000
     :OUTFENCE                                                          15976000
                                                                        15978000
Defines acceptable priorities for output spooled files.                 15980000
                                                                        15982000
SYNTAX                                                                  15984000
                                                                        15986000
     :OUTFENCE outputpriority [;ldev=ldn]                               15988000
                                                                        15990000
\ITEM=PARMS                                                             15992000
PARAMETERS                                                              15994000
                                                                        15996000
outputpriority      A number between 1 and 14, inclusive (large is      15998000
                    more limiting).                                     16000000
                                                                        16002000
ldn                 Logical device number of an output device.          16004000
                    (Optional parameter.)                               16006000
\ITEM=OPERATION                                                         16008000
OPERATION                                                               16010000
                                                                        16012000
In order to enable deferred output spooled devicefiles to be processed  16014000
by a spooler, their outputpriority must be raised above the output      16016000
fence, or the output fence must be lowered.                             16018000
                                                                        16020000
\ITEM=EXAMPLE                                                           16022000
EXAMPLES                                                                16024000
                                                                        16026000
To set the global outfence to 14 and the outfence of ldev               16028000
6 to 8, enter:                                                          16030000
                                                                        16032000
     :OUTFENCE 14                                                       16034000
     :OUTFENCE 8;LDEV=6                                                 16036000
     :SHOWOUT                                                           16038000
                                                                        16040000
DEV/CL    DFID    JOBNUM  FNAME    STATE FRM SPACE  RANK PRI  #C        16042000
LP        #O999   #J19    $SDTLIST OPENED       512       I    1        16044000
LP        #O1030  #S77    EDTLIST  OPENED       512       8    1        16046000
SLOWLP    #O1029  #S'1153 OUT      READY        232   1   8    1        16048000
20        #O1001  #S60    $STDLIST OPENED                               16050000
47        #O1028  #S78    $STDLIST OPENED                               16052000
52        #O1019  #S72    $STDLIST OPENED                               16054000
54        #O1023  #S74    $STDLIST OPENED                               16056000
80        #O1026  #S76    $STDLIST OPENED                               16058000
101       #O1027  #S77    $STDLIST OPENED                               16060000
103       #O1025  #S75    $STDLIST OPENED                               16062000
11        #O1022  #S33    GALLIST  ACTIVE       768   1   8    1        16064000
                                                                        16066000
11 FILES:                                                               16068000
    1 ACTIVE                                                            16070000
    1 READY; INCLUDING 1 SPOOFLES, 0 DEFERRED                           16072000
    9 OPENED; INCLUDING 2 SPOOFLES                                      16074000
    0 LOCKED; INCLUDING 0 SPOOFLES                                      16076000
    4 SPOOFLES;  2024 SECTORS                                           16078000
OUTFENCE = 14                                                           16080000
OUTFENCE = 8 FOR LDEV 6                                                 16082000
                                                                        16084000
This will defer all output spooled files, except those                  16086000
going to ldev 6. To reset the outfence for all output                   16088000
devices to 4, enter:                                                    16090000
                                                                        16092000
                                                                        16094000
                                                                        16096000
\ENTRY=PASCAL,PARMS,EXAMPLE,OPERATION                                   16098000
    :PASCAL                                                             16100000
                                                                        16102000
Compiles a PASCAL program.                                              16104000
                                                                        16106000
SYNTAX                                                                  16108000
                                                                        16110000
 :PASCAL [textfile][,[uslfile][,[listfile]]][;INFO=quotedstring]        16112000
                                                                        16114000
\ITEM=PARMS                                                             16116000
PARAMETERS                                                              16118000
                                                                        16120000
textfile            Actual designator of input file from which source   16122000
                    program is read.  Can be any ASCII input file.      16124000
                    Formal designator is PASTEXT. Default is $STDIN.    16126000
                                                                        16128000
uslfile             Actual designator of user subprogram library (USL)  16130000
                    file on which object program is written. Can be     16132000
                    any binary output file with file code if USL (or    16134000
                    1024).  Formal designator is PASUSL.  If entered,   16136000
                    this parameter must indicate a file created in      16138000
                    one of four ways:                                   16140000
                                                                        16142000
                    1.  By saving a USL file (with the :SAVE command)   16144000
                        created by a previous compilation where the     16146000
                        default value was used for the <uslfile>        16148000
                        parameter.                                      16150000
                                                                        16152000
                    2.  By building the USL with the Segmenter command  16154000
                        -BUILDUSL.                                      16156000
                                                                        16158000
                    3.  By creating a new USL file with the MPE :BUILD  16160000
                        command and a <filecode> parameter of USL or    16162000
                        1024.                                           16164000
                                                                        16166000
                    4.  By specifying a non-exsistent <uslfile>         16168000
                        parameter, thereby creating a permanent file    16170000
                        of the correct size and type.                   16172000
                                                                        16174000
                    By default $NEWPASS is assigned.                    16176000
                                                                        16178000
listfile            Actual designator of file on which program listing  16180000
                    is written.  Can be any ASCII output file.  Formal  16182000
                    designator is PASLIST. Default is $STDLIST.         16184000
                                                                        16186000
qoutedstring        A string of ASCII characters delimited by a matching16188000
                    set of either 's or "s.  If the delimiting character16190000
                    is desired within the string it can be doubled as in16192000
                    most programming languages. This feature is used    16194000
                    for specifying compiler options, which will appear  16196000
                    in front of the source listing.                     16198000
                                                                        16200000
                            NOTE                                        16202000
                                                                        16204000
     The formal file designators used in this command                   16206000
     (PASTEXT, PASUSL, PASLIST) cannot be back                          16208000
     referenced as actual file designators in the command               16210000
     parameter list.  For futher information , see the disscusion       16212000
     of implied :FILE commands in Section I of the MPE                  16214000
     Commands Reference Manual.                                         16216000
                                                                        16218000
\ITEM=OPERATION                                                         16220000
OPERATION                                                               16222000
                                                                        16224000
Compiles PASCAL program onto USL file on disc.  If you do not specify a 16226000
source text file, MPE expects input from your standard input device.  If16228000
you create the USL prior to compilation, you must specify a <filecode>  16230000
of USL or 1024.  If you do not specify a <listfile>, MPE sends the      16232000
program listing to the current list device.                             16234000
                                                                        16236000
\ITEM=EXAMPLE                                                           16238000
EXAMPLE                                                                 16240000
                                                                        16242000
To compile a PASCAL program that you enter from your current input      16244000
device into an object program in the USL fiel $NEWPASS, and write the   16246000
listing to your current list device, enter:                             16248000
                                                                        16250000
    :PASCAL                                                             16252000
                                                                        16254000
If the next command is one to prepare an object program, $NEWPASS can be16256000
passed to that command by specifying $OLDPASS for the <uslfile>         16258000
parameter.                                                              16260000
                                                                        16262000
To compile a PASCAL program residing on the disc file PASCSRC into      16264000
an object program on the USL file PASCOBJ, with the program listing     16266000
to be sent to the disc file LISTFILE, enter:                            16268000
                                                                        16270000
    :BUILD PASCOBJ;CODE=USL                                             16272000
    :PASCAL PASCSRC,PASCOBJ,LISTFILE                                    16274000
                                                                        16276000
                                                                        16278000
\ENTRY PASCALGO=PARMS,OPERATION,EXAMPLE                                 16280000
     :PASCALGO                                                          16282000
                                                                        16284000
Compiles, prepares, and executes a PASCAL program.                      16286000
                                                                        16288000
SYNTAX                                                                  16290000
                                                                        16292000
    :PASCALGO [textfile][,[listfile]][;INFO=quotedstring]               16294000
                                                                        16296000
\ITEM=PARMS                                                             16298000
PARAMETERS                                                              16300000
                                                                        16302000
textfile            Actual designator of input file from which source   16304000
                    program is read.  Can be any ASCII input file.      16306000
                    Formal designator is PASTEXT. Default is $STDIN.    16308000
                                                                        16310000
listfile            Actual designator of file on which program listing  16312000
                    is written.  Can be any ASCII output file.  Formal  16314000
                    designator is PASTEXT.  Default is $STDLIST.        16316000
                                                                        16318000
quotedstring        A string of ASCII characters delimited by a matching16320000
                    set of either 's or "s.  If the delimiting character16322000
                    is desired within the string it can be doubled as in16324000
                    most programming languages. This feature is used    16326000
                    for specifying compiler options, which will appear  16328000
                    in front of the source listing.                     16330000
                                                                        16332000
                              NOTE                                      16334000
                                                                        16336000
      The formal file designators used in this command                  16338000
      (PASTEXT, PASLIST) cannot be back referenced as                   16340000
      actual file designators in the command parameter                  16342000
      list.  For futher information, see the disscusion                 16344000
      of the implied :FILE commands in Section I of the                 16346000
      MPE Commands Reference Manual.                                    16348000
                                                                        16350000
\ITEM=OPERATION                                                         16352000
OPERATION                                                               16354000
                                                                        16356000
Compiles, prepares, and executes a PASCAL program. If you do            16358000
not specify <textfile>, MPE expects input from your current             16360000
input device.  If you do not specify <listfile>, MPE writes the         16362000
listing to the current list device.  This command creates a             16364000
temporary USL file ($NEWPASS) that cannot be accessed, and a            16366000
temporary program file that can accessed under the name $OLDPASS.       16368000
                                                                        16370000
\ITEM=EXAMPLE                                                           16372000
EXAMPLE                                                                 16374000
                                                                        16376000
To compile, prepare, and execute a PASCAL program entered from          16378000
your current input device, with the program listing going to            16380000
the current list device, enter:                                         16382000
                                                                        16384000
    :PASCALGO                                                           16386000
                                                                        16388000
To compile, prepare, and execute a PASCAL program from the disc         16390000
file PASCSRC and send the program listing to the file LISTFILE          16392000
enter:                                                                  16394000
                                                                        16396000
    :PASCALGO PASCSRC,LISTFILE                                          16398000
                                                                        16400000
                                                                        16402000
\ENTRY=PASCALPREP,PARMS,OPERATION,EXAMPLE                               16404000
     :PASCALPREP                                                        16406000
                                                                        16408000
Compiles and prepares a PASCAL program.                                 16410000
                                                                        16412000
SYNTAX                                                                  16414000
                                                                        16416000
:PASCALPREP [textfile][,[progfile][,[listfile]]][;INFO=quotedstring]    16418000
                                                                        16420000
\ITEM=PARMS                                                             16422000
PARAMETERS                                                              16424000
                                                                        16426000
textfile            Actual designator of input file from which source   16428000
                    source program is read.  Can be any ASCII input     16430000
                    file.  Formal designator is PASTEXT. Default is     16432000
                    $STDIN.                                             16434000
                                                                        16436000
progfile            Actual designator of program file on which          16438000
                    prepared program segments are written.  Can be      16440000
                    any binary output file with <filecode> of PROG      16442000
                    or 1029.  If parameter is specified, it must        16444000
                    indicate a file created in one of two ways:         16446000
                                                                        16448000
                    1.  With  the MPE command :BUILD, specifying a      16450000
                        <filecode> of PROG or 1029 and a                16452000
                        <numextents> parameter value of 1.              16454000
                                                                        16456000
                    2.  By specifying a non-existent file in the        16458000
                        <progfile> parameter in which case a job        16460000
                        temporary file of the correct size and type     16462000
                        is created.                                     16464000
                                                                        16466000
                    By default $NEWPASS is assigned.                    16468000
                                                                        16470000
listfile            Actual designator of file on which program          16472000
                    listing is written.  Can be any ASCII output        16474000
                    file.  Formal designator is PASLIST. Default is     16476000
                    $STDLIST.                                           16478000
                                                                        16480000
quotedstring        A string of ASCII characters delimited by a matching16482000
                    set of either 's or "s.  If the delimiting character16484000
                    is desired within the string it can be doubled as in16486000
                    most programming languages. This feature is used    16488000
                    for specifying compiler options, which will appear  16490000
                    in front of the source listing.                     16492000
                                                                        16494000
                          NOTE                                          16496000
      The formal file designators used in this command                  16498000
      (PASTEXT, PASPROG, PASLIST) cannot be back referenced             16500000
      as actual file designators in the command parameter               16502000
      list.  For further information, see the discussion of             16504000
      implied :FILE commands in  Section I of the MPE                   16506000
      Commands Reference Manual.                                        16508000
                                                                        16510000
\ITEM=OPERATION                                                         16512000
OPERATION                                                               16514000
                                                                        16516000
Compiles and prepares a PASCAL program onto a program file on disc.     16518000
If you do not specify <textfile>, MPE expects input from the current    16520000
input device.  If you create the program file prior to compilation,     16522000
you must use the <filecode> parameter of PROG or 1029a and a            16524000
<numextents> parameter value of 1 on your :BUILD command. If you do     16526000
not specify <listfile>, MPE sends the listing output to your current    16528000
list device.  The USL file created during compilation is a temporary    16530000
file passed directly to the preparation mechanism.                      16532000
                                                                        16534000
\ITEM=EXAMPLE                                                           16536000
EXAMPLE                                                                 16538000
                                                                        16540000
To compile and prepare a PASCAL program entered through the curent      16542000
input device, onto the file $NEWPASS, with the listing printed on       16544000
the current list device, enter:                                         16546000
                                                                        16548000
    :PASCALPREP                                                         16550000
If the next command is one to execute a program, the file $NEWPASS      16552000
is referenced in the execute command under the name $OLDPASS.           16554000
                                                                        16556000
To compile and prepare a PASCAL source program from a source file       16558000
named PASCSRC into a program file named PASCPROG, with the resulting    16560000
listing sent to the current list device, enter:                         16562000
                                                                        16564000
    :PASCALPREP PASCSRC,PASCPROG                                        16566000
    :OUTFENCE 4                                                         16568000
                                                                        16570000
                                                                        16572000
\ENTRY=PREP,PARMS,OPERATION,EXAMPLE                                     16574000
    :PREP                                                               16576000
                                                                        16578000
Prepares program from a User Subprogram Library (USL) file onto a       16580000
program file.                                                           16582000
                                                                        16584000
SYNTAX                                                                  16586000
                                                                        16588000
    :PREP uslfile,progfile                                              16590000
          [;ZERODB]                                                     16592000
          [;PMAP]                                                       16594000
          [;MAXDATA=segsize]                                            16596000
          [;STACK=stacksize]                                            16598000
          [;DL=dlsize]                                                  16600000
          [;CAP=caplist]                                                16602000
          [;RL=filename]                                                16604000
          [;NOSYM]                                                      16606000
          [;FPMAP]                                                      16608000
                                                                        16610000
\ITEM=PARMS                                                             16612000
PARAMETERS                                                              16614000
                                                                        16616000
uslfile              Actual designator of USL file on which program has 16618000
                     been compiled.  (REQUIRED PARAMETER)               16620000
                                                                        16622000
progfile             Actual designator of program file on which prepared16624000
                     program segments are written.  Can be any binary   16626000
                     output file.  This program file must be created in 16628000
                     one of two ways:                                   16630000
                                                                        16632000
                     1.  By creating a new file with the MPE :BUILD     16634000
                         command with a <filecode> of PROG or 1029, and 16636000
                         a numextents parameter value of 1.             16638000
                                                                        16640000
                     2.  By specifying a non-existent file in the       16642000
                         <progfile> parameter, in which case a file of  16644000
                         the correct size and type is created. This file16646000
                         is a job temporary file. (REQUIRED PARAMETER)  16648000
                                                                        16650000
ZERODB               Request to initialize to zero the initially-       16652000
                     defined, user-managed (DL-DB) area, and unitialized16654000
                     portions of the DB-Q (initial).  Default is these  16656000
                     areas are not affected.                            16658000
                                                                        16660000
PMAP                 Request to produce a descriptive listing of the    16662000
                     prepared program on file whose formal designator is16664000
                     SEGLIST.  If no :FILE command is found referencing 16666000
                     SEGLIST, listing is produced on $STDLIST.  Default 16668000
                     is no listing.                                     16670000
                                                                        16672000
segsize              Maximum stack area (Z-DL) size permitted, in words.16674000
                     This parameter is included when it is expected that16676000
                     the size of DL-DB or Z-DB areas will be changed    16678000
                     during program execution. Default is that MPE      16680000
                     assumes that these areas will not change.          16682000
                                                                        16684000
stacksize            Size of initial local data area (Z-Q initial) in   16686000
                     stack, in words.  (This value, if specified, must  16688000
                     exceed 511 words.)  This parameter over rides      16690000
                     <stacksize> estimated by Segmenter. Default is     16692000
                     estimated by MPE Segmenter.                        16694000
                                                                        16696000
dlsize               DL-DB area to be initially assigned to stack. This 16698000
                     area is of interest mainly in programmatic         16700000
                     applications.  In all cases, the DL-DB area is     16702000
                     rounded upward so that the distance from the       16704000
                     beginning of the stack data segment to the DB-     16706000
                     address is a multiple of 128 words.  Default is    16708000
                     estimated by the MPE Segmenter.                    16710000
                                                                        16712000
caplist              Capability-class attributes associated with        16714000
                     program, specified as two-character mnemonics. If  16716000
                     more than one mnemonic is specified, each must be  16718000
                     separated from its neighbor by a comma.            16720000
                                                                        16722000
                     The mnemonics are:                                 16724000
                                                                        16726000
                     IA    Interactive access                           16728000
                     BA    Local batch access                           16730000
                     PH    Process handling                             16732000
                     DS    Data segment management                      16734000
                     MR    Multiple resource management                 16736000
                     PM    Privileged mode                              16738000
                                                                        16740000
                     Note that you can specify only those capabilities  16742000
                     that you possess (through assignment by the System 16744000
                     Manager or Account Manager). Default is IA, BA (if 16746000
                     you possess these capabilities).                   16748000
                                                                        16750000
filename             Actual designator of RL file to be searched to     16752000
                     satisfy external references during preparation.    16754000
                     This can be any permanent binary file of type RL.  16756000
                     It need not belong to logon group, nor have a      16758000
                     reserved, local name.  This file yields a single   16760000
                     segment that is incorporated into the segments of  16762000
                     the program file. See the MPE Segmenter Reference  16764000
                     Manual for a discussion of RL files. Default is no 16766000
                     library is searched.                               16768000
                                                                        16770000
NOSYM                Request to suppress Symbolic Item header informa-  16772000
                     tion and PMAP information from the resulting       16774000
                     program file.  This option is used in conjunction  16776000
                     with the HPTOOLSET Symbolic Item debugging option  16778000
                     Specifying this option can save file space but you 16780000
                     will not be able to do symbolic item debugging of  16782000
                     the program file created by the PREP.              16784000
                                                                        16786000
FPMAP                Request PMAP information be generated in the pro-  16788000
                     file created by the PREP.                          16790000
                                                                        16792000
\ITEM=OPERATION                                                         16794000
OPERATION                                                               16796000
                                                                        16798000
Prepares a compiled program onto a program file.  Unless this file is   16800000
explicitly created before issuing the :PREP command, a program file will16802000
be created by the command as a job/session temporary file.              16804000
                                                                        16806000
This command permits searching of a relocatable library (RL) to satisfy 16808000
references to external procedures required by the program.  When the    16810000
program is prepared, such procedures are linked to the program in the   16812000
resulting program file.                                                 16814000
                                                                        16816000
\ITEM=EXAMPLE                                                           16818000
EXAMPLE                                                                 16820000
                                                                        16822000
To prepare a program from the USL file named USEFILE and store it in a  16824000
program file named PROGFILE, enter:                                     16826000
                                                                        16828000
    :PREP USEFILE,PROGFILE                                              16830000
                                                                        16832000
To prepare a program from the USL file named USEFILE and store it in a  16834000
program file named PROGFILE, list the prepared program, assign a        16836000
stacksixe of 500 words, and assign batch-access capability only for the 16838000
program, enter:                                                         16840000
                                                                        16842000
    :PREP USEFILE,PROGFILE;PMAP;STACK=500;CAP=BA                        16844000
                                                                        16846000
                                                                        16848000
\ENTRY=PREPRUN,PARMS,OPERATION,EXAMPLE                                  16850000
    :PREPRUN                                                            16852000
                                                                        16854000
Prepares and executes a compiled program.                               16856000
                                                                        16858000
SYNTAX                                                                  16860000
                                                                        16862000
    :PREPRUN uslfile[,entrypoint]                                       16864000
             [;NOPRIV]                                                  16866000
             [;PMAP]                                                    16868000
             [;DEBUG]                                                   16870000
             [;LMAP]                                                    16872000
             [;ZERODB]                                                  16874000
             [;MAXDATA=segzixe]                                         16876000
             [;PARM=parameternum]                                       16878000
             [;STACK=stacksize]                                         16880000
             [;DL=dlsize]                                               16882000
                                                                        16884000
                     G                                                  16886000
             [;LIB= {P}]                                                16888000
                     S                                                  16890000
                                                                        16892000
             [;CAP=caplist]                                             16894000
             [;RL=filename]                                             16896000
             [;NOCB]                                                    16898000
                                                                        16900000
\ITEM=PARMS                                                             16902000
PARAMETERS                                                              16904000
                                                                        16906000
uslfile             Actual designator of USL file on which program has  16908000
                    been compiled.  (REQUIRED PARAMETER)                16910000
                                                                        16912000
entrypoint          Program entry point where execution is to begin. May16914000
                    be primary entry point of program, or any secondary 16916000
                    entry point in program's outer block. Default is    16918000
                    primary entry point.                                16920000
                                                                        16922000
NOPRIV              Declaration that program segments will be placed in 16924000
                    non-privileged (user) mode.  This parameter is      16926000
                    intended for programs prepared with privileged mode 16928000
                    capability.  Normally, program segments containing  16930000
                    privileged instructions are executed in privileged  16932000
                    mode only if program was prepared with privileged   16934000
                    mode (PM) capability class.  (A program containing  16936000
                    legally compiled privileged code, placed in         16938000
                    non-privileged mode, may abort when an atttempt is  16940000
                    made to execute it.)  If NOPRIV is specified, all   16942000
                    segments are placed in non-privileged mode. (Library16944000
                    segments are not affected because their mode is     16946000
                    determined independently.)  Default is segments of  16948000
                    privileged mode program will remain in privileged   16950000
                    mode.                                               16952000
                                                                        16954000
PMAP                Request to produce a descriptive listing of the     16956000
                    prepared program on file whose formal designator is 16958000
                    SEGLIST.  If no :FILE command referencing SEGLIST is16960000
                    found, listing is produced on current list device.  16962000
                    Default is no listing.                              16964000
                                                                        16966000
DEBUG               A request to set a breakpoint on the first          16968000
                    executable instruction of the program. Default is no16970000
                    breakpoint is set.                                  16972000
                                                                        16974000
LMAP                Request to produce a descriptive listing of the     16976000
                    allocated (loaded) program on file whose formal     16978000
                    designator is LOADLIST.  If no :FILE command        16980000
                    referencing LOADLIST is found, listing is produced  16982000
                    on $STDLIST.  Default is no listing.                16984000
                                                                        16986000
ZERODB              Request to initialize of zero initially-defined,    16988000
                    user-managed (DL-DB) area, and unitialized portions 16990000
                    of the DB-Q (initial) area.  Default is these areas 16992000
                    are not affected.                                   16994000
                                                                        16996000
segsize             Maximum stack area (Z-DL) area permitted, in words. 16998000
                    This parameter is included if it is expected that   17000000
                    sizes of DL-DB or Z-DB areas will be changed during 17002000
                    program execution. Default is MPE assumes that these17004000
                    areas will not be changed.                          17006000
                                                                        17008000
parameternum        Value that can be passed to program for             17010000
                    control or other purposes.  When program is         17012000
                    executed, this value can be retrieved from address  17014000
                    Q(initial)-4, where Q(initial) is Q- address for    17016000
                    outer block of program.  Value can be octal number  17018000
                    or signed or unsigned decimal number.  Default is   17020000
                    Q(initial)0-4 address is filled with zeros.         17022000
                                                                        17024000
stacksize           Size of local data area (Z-Q(initial)) in stack, in 17026000
                    words.  If specified, this value must exceed 511    17028000
                    words.  This parameter overrides <stacksize>        17030000
                    estimated by MPE Segmenter.  Default is estimated by17032000
                    MPE Segmenter.                                      17034000
                                                                        17036000
dlsize              DL-DB area to be initially assigned to stack. This  17038000
                    area is of interest mainly to programmatic          17040000
                    applications.  In all cases, the DL-DB area is      17042000
                    rounded upward so that the distance from the        17044000
                    beginning of the stack data segment to the DB-      17046000
                    address is a multiple of 128 words.  Default is     17048000
                    estimated by MPE Segmenter.                         17050000
                                                                        17052000
G                   Search segmented procedure libraries in the         17054000
                    following order:  group library, account library,   17056000
                    system library.  Default is S.                      17058000
                                                                        17060000
P                   Search segmented procedure libraries in the         17062000
                    following order:  account library, system library.  17064000
                    Default is S.                                       17066000
                                                                        17068000
S                   Search system library for external references to    17070000
                    segmented procedures.  Default.                     17072000
                                                                        17074000
caplist             Capability-class attributes associated with the     17076000
                    program, specified as two-character mnemonics. If   17078000
                    more than one mnemonic is specified, each must be   17080000
                    separated from its neighbor by a comma.             17082000
                                                                        17084000
                    The mnemonics are:                                  17086000
                                                                        17088000
                    IA    Interactive access                            17090000
                    BA    Local batch access                            17092000
                    PH    Process handling                              17094000
                    DS    Data segment management                       17096000
                    MR    Multiple resource management                  17098000
                    PM    Privileged mode                               17100000
                                                                        17102000
                    You can only specify those attributes that you      17104000
                    possess through assignment by the Account Manager or17106000
                    the System Manager.  Default is IA and BA (if you   17108000
                    possess these capabilities).                        17110000
                                                                        17112000
filename            Actual designator of RL file to be searched to      17114000
                    satisfy external references during preparation of   17116000
                    the program.  This can be any permanent file of type17118000
                    RL.  It need not belong to logon group nor does it  17120000
                    require a reserved, local name.  This file yields a 17122000
                    single segment that is incorporated into the        17124000
                    segments of the program file.  See the MPE Segmenter17126000
                    Reference Manual for a description of RL files.     17128000
                    Default is no library is searched.                  17130000
                                                                        17132000
NOCB                Request that file system not use stack segment      17134000
                    (PCBX) for its control blocks, even if sufficient   17136000
                    space is available.  This will permit you to expand 17138000
                    your stack (via the DLSIZE or ZSIZE intrinsics) to  17140000
                    the maximum possible limit at a later time, but will17142000
                    cause the File Management System to operate more    17144000
                    slowly for this program.                            17146000
                                                                        17148000
\ITEM=OPERATION                                                         17150000
OPERATION                                                               17152000
                                                                        17154000
Prepares and executes a program compiled in a User Subprogram Library   17156000
(USL).  Command prepares a temporary program file and then executes the 17158000
program in that file.  This command permits searching both relocatable  17160000
(RL) and segmented (SL) libraries to satisfy external references.       17162000
                                                                        17164000
\ITEM=EXAMPLE                                                           17166000
EXAMPLE                                                                 17168000
                                                                        17170000
To prepare and execute a program on the USL file USEF, with no special  17172000
parameters declared, enter:                                             17174000
                                                                        17176000
    :PREPRUN USEF                                                       17178000
                                                                        17180000
To prepare and execute a program on the USL file UBASE, beginning       17182000
execution at the entry point RESTART, declaring a stacksize of 800      17184000
words, and specifying that the library LIBA will be searched to satisfy 17186000
external references, enter:                                             17188000
                                                                        17190000
    :PREPRUN UBASE,RESTART:STACK=800;RL=LIBA                            17192000
                                                                        17194000
                                                                        17196000
\ENTRY=PTAPE,PARMS,OPERATION,EXAMPLE                                    17198000
    :PTAPE                                                              17200000
                                                                        17202000
Reads paper tape without X-OFF control.                                 17204000
                                                                        17206000
SYNTAX                                                                  17208000
                                                                        17210000
    :PTAPE filename                                                     17212000
                                                                        17214000
\ITEM=PARMS                                                             17216000
PARAMETERS                                                              17218000
                                                                        17220000
filename            Name of existing ASCII file on disc, to which input 17222000
                    data is to be written from a paper tape. Normally,  17224000
                    this is a file with variable-length records; the    17226000
                    record size specified must be large enough to       17228000
                    contain the longest paper tape record. (REQUIRED    17230000
                    PARAMETER)                                          17232000
                                                                        17234000
\ITEM=OPERATION                                                         17236000
OPERATION                                                               17238000
                                                                        17240000
Permits programs to read input originating from a terminal coupled to a 17242000
paper tape reader/punch, when the tape does not include the X-OFF       17244000
control character punched on the tape.  (The X-OFF character, when      17246000
encountered on a tape, turns the tape-reading mechanism off.  This      17248000
character normally appears following the carriage-return/line-feed      17250000
character combination used to delimit each record.)  The :PTAPE command 17252000
transfers all data from the tape to an ASCII file (named in the         17254000
<filename> parameter) on disc.  This operation stores all records onto  17256000
the disc file in the order read from the tape, but deletes all          17258000
carriage-return and line-feed characters.  (If the tape contains X-OFF  17260000
characters, the operation also deletes these.  The X-OFF characters are 17262000
not ignored by the tape reader, however, and so you must restart the    17264000
reader after each X-OFF is read.)  The input terminates when the CONTROL17266000
Y character is encountered on the tape or entered from the terminal,    17268000
returning control to the keyboard.  The input data now can be read from 17270000
the disc file by any program.                                           17272000
Note that the :PTAPE command is required ONLY for input from HP tape    17274000
readers associated with terminal keyboards.                             17276000
                                                                        17278000
You cannot use the :PTAPE command to copy tapes containing more than    17280000
32767 bytes of information.  If this is attempted, MPE reads only the   17282000
first 32767 bytes on the tape and then terminates the operation.        17284000
                                                                        17286000
\ITEM=EXAMPLE                                                           17288000
EXAMPLE                                                                 17290000
                                                                        17292000
To copy input from a paper tape onto a disc file named TAPEFILE, create 17294000
an appropriate file (with the MPE :BUILD command) and then enter the    17296000
following :PTAPE command:                                               17298000
                                                                        17300000
    :BUILD TAPEFILE;REC=-80,3,V,ASCII                                   17302000
    :PTAPE TAPEFILE                                                     17304000
                                                                        17306000
                                                                        17308000
\ENTRY=PURGE,PARMS,OPERATION,EXAMPLE                                    17310000
    :PURGE                                                              17312000
                                                                        17314000
Deletes file from system.                                               17316000
                                                                        17318000
SYNTAX                                                                  17320000
                                                                        17322000
    :PURGE filereference[,TEMP]                                         17324000
                                                                        17326000
\ITEM=PARMS                                                             17328000
PARAMETERS                                                              17330000
                                                                        17332000
filereference        Actual file designator of file to be deleted, in   17334000
                     this format:                                       17336000
                                                                        17338000
                     filename[/lockword][.groupname][.acctname]         17340000
                                                                        17342000
                     To delete the file, you must have write (W) access 17344000
                     to it.  (REQUIRED PARAMETER)                       17346000
                                                                        17348000
TEMP                 Indicates that the file is a temporary file in the 17350000
                     job/session temporary file domain.  You must enter 17352000
                     this parameter to delete a temporary file,         17354000
                     otherwise the appropriate domain is not searched   17356000
                     for the file. Default is permanent file is assumed.17358000
                                                                        17360000
\ITEM=OPERATION                                                         17362000
OPERATION                                                               17364000
                                                                        17366000
Deletes a disc file from the system.  Applies only to files on disc.    17368000
If the volume set on which the file resides is not mounted, this command17370000
will generate an implicit mount request.                                17372000
                                                                        17374000
If the file does not exist in the domain specified (temporary or        17376000
permanent (permanent is default)), the following message is displayed:  17378000
                                                                        17380000
    FILE <filename> NOT FOUND                                           17382000
                                                                        17384000
\ITEM=EXAMPLE                                                           17386000
EXAMPLE                                                                 17388000
                                                                        17390000
To delete the permanent file PFILE, enter:                              17392000
                                                                        17394000
    :PURGE PFILE                                                        17396000
                                                                        17398000
To delete the temporary file TFILE, enter:                              17400000
                                                                        17402000
    :PURGE TFILE,TEMP                                                   17404000
                                                                        17406000
                                                                        17408000
\ENTRY=PURGEACCT,PARMS,OPERATION,EXAMPLE                                17410000
    :PURGEACCT (System Manager capability required)                     17412000
                                                                        17414000
Removes an account and its groups (files) and users from the system's   17416000
or the specified volume set's directory.                                17418000
                                                                        17420000
SYNTAX                                                                  17422000
                                                                        17424000
    :PURGEACCT acctname[;VS=volset]                                     17426000
                                                                        17428000
\ITEM=PARMS                                                             17430000
PARAMETERS                                                              17432000
                                                                        17434000
acctname       Name of the account to be deleted.  (REQUIRED PARAMETER) 17436000
                                                                        17438000
volset         Volume set or class reference which, when fully          17440000
               qualified, is in the form                                17442000
                                                                        17444000
               vcsid.groupname.acctname                                 17446000
                                                                        17448000
               where vcsid refers to a previously-defined volume set    17450000
               or volume class definition.                              17452000
                                                                        17454000
               The volume set specified by volset must have been        17456000
               previously mounted (via the MOUNT command) or this       17458000
               command will fail.                                       17460000
                                                                        17462000
\ITEM=OPERATION                                                         17464000
OPERATION                                                               17466000
                                                                        17468000
(System Manager capability required)                                    17470000
This command removes an account (and its groups (files) and users) from 17472000
the system's or the specified volume set's directory.                   17474000
                                                                        17476000
When the :PURGEACCT command is entered in a session, MPE displays a     17478000
verification request.  This aids is ensuring that the wrong account is  17480000
not deleted accidentally.  The format of the verification request is:   17482000
                                                                        17484000
    ACCT <acctname> TO BE PURGED?                                       17486000
                                                                        17488000
Response is YES or NO.                                                  17490000
                                                                        17492000
No verification message is printed when the :PURGEACCT is entered in a  17494000
job.                                                                    17496000
                                                                        17498000
The :PURGEACCT command removes every user not currently logged on and   17500000
every group not in use, along with the files and volume set definitions 17502000
belonging to each group.  This could leave the account (containing      17504000
residual elements only) still in the system.  In such a case, if all    17506000
users were purged, the account would exist but would be inaccessible for17508000
log on.  To completely purge such an account, the :PURGEACCT command    17510000
must be entered when the account is inactive.  It is possible that the  17512000
system would require a restart in order to close files which were left  17514000
open.                                                                   17516000
                                                                        17518000
The system account, SYS, cannot be purged.  If such a command is        17520000
entered, however, all groups except PUB will be purged.  All users      17522000
except the System Manager user are purged and all files which are not   17524000
system files or not currently opened in the PUB group are purged.       17526000
                                                                        17528000
\ITEM=EXAMPLE                                                           17530000
EXAMPLE                                                                 17532000
                                                                        17534000
To remove an account named ACCT1, the following dialog occurs:          17536000
                                                                        17538000
    :PURGEACCT ACCT1                                                    17540000
    ACCT ACCT1 TO BE PURGED? YES                                        17542000
                                                                        17544000
                                                                        17546000
\ENTRY=PURGEGROUP,PARMS,OPERATION,EXAMPLE                               17548000
    :PURGEGROUP (Account Manager capability required)                   17550000
                                                                        17552000
Removes a group (and all files belonging to it) from the system's       17554000
or the specified volume set's directory.                                17556000
                                                                        17558000
SYNTAX                                                                  17560000
                                                                        17562000
    :PURGEGROUP groupname[;VS=volset]                                   17564000
                                                                        17566000
\ITEM=PARMS                                                             17568000
PARAMETERS                                                              17570000
                                                                        17572000
groupname    Name of group to be removed.  (REQUIRED PARAMETER)         17574000
                                                                        17576000
volset         Volume set or class reference which, when fully          17578000
               qualified, is in the form                                17580000
                                                                        17582000
               vcsid.groupname.acctname                                 17584000
                                                                        17586000
               where vcsid refers to a previously-defined volume set    17588000
               or volume class definition.                              17590000
                                                                        17592000
               The volume set specified by volset must have been        17594000
               previously mounted (via the MOUNT command) or this       17596000
               command will fail.                                       17598000
                                                                        17600000
\ITEM=OPERATION                                                         17602000
OPERATION                                                               17604000
                                                                        17606000
(Account Manager capability required)                                   17608000
This command removes a group (and all its files) from the appropriate   17610000
directory.                                                              17612000
                                                                        17614000
When this command is entered in a session, MPE prints the message:      17616000
                                                                        17618000
    GROUP <groupname> TO BE PURGED?                                     17620000
                                                                        17622000
Response is YES or NO.                                                  17624000
                                                                        17626000
No verification message is printed if the :PURGEGROUP command is entered17628000
in a job.  For this command to succeed, the group's home volume set must17630000
be mounted.                                                             17632000
                                                                        17634000
If no files in the group are in use, and the group itself is not in use,17636000
:PURGEGROUP removes the entire group.  Otherwise, :PURGEGROUP removes   17638000
every file not in use.  In such a case, the :PURGEGROUP command must be 17640000
entered again when neither the group nor any of its files are in use in 17642000
order to completely purge the group.  It is possible that the system    17644000
would require a restart in order to close files which were left open.   17646000
                                                                        17648000
The public group of the system account, PUB.SYS, cannot be purged. If   17650000
the command is entered, however, all files which are not system files   17652000
are purged.                                                             17654000
                                                                        17656000
\ITEM=EXAMPLE                                                           17658000
EXAMPLE                                                                 17660000
                                                                        17662000
To purge a group named GROUP1, the following dialog occurs:             17664000
                                                                        17666000
    :PURGEGROUP GROUP1                                                  17668000
    GROUP GROUP1 TO BE PURGED? YES                                      17670000
                                                                        17672000
                                                                        17674000
\ENTRY=PURGEUSER,PARMS,OPERATION,EXAMPLE                                17676000
    :PURGEUSER (Account Manager capability required)                    17678000
                                                                        17680000
Removes a user from an account.                                         17682000
                                                                        17684000
SYNTAX                                                                  17686000
                                                                        17688000
    :PURGEUSER username                                                 17690000
                                                                        17692000
\ITEM=PARMS                                                             17694000
PARAMETERS                                                              17696000
                                                                        17698000
username    Name of the user to be deleted.  (REQUIRED PARAMETER)       17700000
                                                                        17702000
\ITEM=OPERATION                                                         17704000
OPERATION                                                               17706000
                                                                        17708000
(Account Manager capability required)                                   17710000
This command purges a user from the account.                            17712000
                                                                        17714000
When :PURGEUSER is entered in a session, MPE displays the following     17716000
message:                                                                17718000
                                                                        17720000
    USER <username> TO BE PURGED?                                       17722000
                                                                        17724000
Response is YES or NO.                                                  17726000
                                                                        17728000
If entered from a job, the message is not displayed.                    17730000
                                                                        17732000
If the :PURGEUSER command references a user currently logged onto the   17734000
system, that user is not purged and a message is output indicating this 17736000
fact.                                                                   17738000
                                                                        17740000
The original system manager, MANAGER.SYS, cannot be purged.             17742000
                                                                        17744000
Purging a user may leave some files in an account without their         17746000
creators.  However, the Account Manager can access these files and      17748000
purge them.                                                             17750000
                                                                        17752000
\ITEM=EXAMPLE                                                           17754000
EXAMPLE                                                                 17756000
                                                                        17758000
To remove a user named USER1, the following dialog occurs:              17760000
                                                                        17762000
    :PURGEUSER USER1                                                    17764000
    USER USER1 TO BE PURGED? YES                                        17766000
                                                                        17768000
                                                                        17770000
\ENTRY=PURGEVSET,PARMS,OPERATION,EXAMPLE                                17772000
            users.                                                      17774000
    :PURGEVSET                                                          17776000
                                                                        17778000
(System Manager, or Account Manager with Volume Set Creation (CV)       17780000
capability required)                                                    17782000
                                                                        17784000
Deletes an existing volume set.                                         17786000
                                                                        17788000
SYNTAX                                                                  17790000
                                                                        17792000
    :PURGEVSET vsname                                                   17794000
                                                                        17796000
\ITEM=PARMS                                                             17798000
PARAMETERS                                                              17800000
                                                                        17802000
vsname        Volume set name of an existing volume set.                17804000
                                                                        17806000
\ITEM=OPERATION                                                         17808000
OPERATION                                                               17810000
                                                                        17812000
(System Manager, or Account Manager with Volume Set Creation (CV)       17814000
capability required)                                                    17816000
                                                                        17818000
The :PURGEVSET command deletes a previously-defined volume set.  A      17820000
volume set will not be purged if the volume set is currently in use     17822000
(a MOUNT, either explicit or implicit, has been issued for the          17824000
volume set definition).                                                 17826000
                                                                        17828000
When :PURGEVSET is entered during a session, MPE displays the following 17830000
message:                                                                17832000
                                                                        17834000
    :VOLUME SET/CLASS DEFINITION vsname TO BE PURGED?                   17836000
                                                                        17838000
\ITEM=EXAMPLE                                                           17840000
EXAMPLE                                                                 17842000
                                                                        17844000
To purge volume set USERSET, enter:                                     17846000
                                                                        17848000
    :PURGEVSET USERSET                                                  17850000
                                                                        17852000
                                                                        17854000
\ENTRY=QUANTUM                                                          17856000
    :QUANTUM (System Supervisor capability required)                    17858000
                                                                        17860000
This command has been replaced by the :TUNE command.                    17862000
                                                                        17864000
\STOPHELP                                                               17866000
                                                                        17868000
                                                                        17870000
PARAMETERS                                                              17872000
                                                                        17874000
quan        The new quantum, in milliseconds, for this subqueue. This   17876000
            value must be between 0 and 65,535 milliseconds. Default is 17878000
            quantum is not changed.                                     17880000
                                                                        17882000
tpri        The maximum priority limit (lowest priority number) for     17884000
            circular subqueues CS and DS.  Default is limit is not      17886000
            changed.                                                    17888000
                                                                        17890000
cpri        The minimum priority limit (highest priority number) for    17892000
            circular subqueue CS.  Default is limit is not changed.     17894000
                                                                        17896000
dpri        The minimum priority limit (highest priority number) for    17898000
            circular subqueue DS.  Default is limit is not changed.     17900000
                                                                        17902000
                                                                        17904000
OPERATION                                                               17906000
                                                                        17908000
(System Supervisor capability required)                                 17910000
This command changes the quantum or priority limits of a circular       17912000
subqueue and is used primarily in on-line tuning of the system to best  17914000
accomodate the current load.                                            17916000
                                                                        17918000
Misuse of this command can significantly degrade system operating       17920000
efficiency.                                                             17922000
                                                                        17924000
                                                                        17926000
EXAMPLE                                                                 17928000
                                                                        17930000
To change the quantum to 500 milliseconds, enter:                       17932000
                                                                        17934000
    :QUANTUM 500                                                        17936000
                                                                        17938000
\STARTHELP                                                              17940000
\ENTRY=RECALL,PARMS,EXAMPLE                                             17942000
     :RECALL                                                            17944000
                                                                        17946000
Displays all pending console messages.                                  17948000
                                                                        17950000
SYNTAX                                                                  17952000
                                                                        17954000
          :RECALL                                                       17956000
                                                                        17958000
\ITEM=PARMS                                                             17960000
PARAMETERS                                                              17962000
                                                                        17964000
None.                                                                   17966000
                                                                        17968000
\ITEM=EXAMPLE                                                           17970000
EXAMPLES                                                                17972000
                                                                        17974000
To display all pending console messages which require a :REPLY          17976000
response from you, enter:                                               17978000
                                                                        17980000
     :RECALL                                                            17982000
     REPLY(S) PENDING:                                                  17984000
     ?10:05/#J9/15/LDEV# FOR "LOO576" ON TAPE1600 (NUM)?                17986000
                                                                        17988000
If there are REPLYs pending, the text of the request(s) will appear     17990000
at the console, as shown above.  If there are no REPLYs pending the     17992000
following message will appear at the console:                           17994000
                                                                        17996000
     :RECALL                                                            17998000
     NO REPLIES PENDING                                                 18000000
                                                                        18002000
\ENTRY=REDO,PARMS,OPERATION,EXAMPLE                                     18004000
    :REDO                                                               18006000
                                                                        18008000
Allows you to edit a command entry.                                     18010000
                                                                        18012000
SYNTAX                                                                  18014000
                                                                        18016000
    :REDO                                                               18018000
                                                                        18020000
\ITEM=PARMS                                                             18022000
PARAMETERS                                                              18024000
                                                                        18026000
None                                                                    18028000
                                                                        18030000
\ITEM=OPERATION                                                         18032000
OPERATION                                                               18034000
                                                                        18036000
The :REDO command allows you to correct certain kinds of errors in an   18038000
incorrect command entry or to change a correct command entry.  The :REDO18040000
command only applies to the last command entered.  When the :REDO       18042000
command is entered, MPE enters a mode similar to the Editor and displays18044000
the command to be modified.  Pressing the BREAK key aborts              18046000
the REDO operation.                                                     18048000
                                                                        18050000
To modify the command output by MPE, position the cursor (using the     18052000
space bar on the terminal) under the character(s) to be modified, then  18054000
enter one of the following sub-commands:                                18056000
                                                                        18058000
D  -  Delete.  Deletes the character above the cursor.  If D is         18060000
      repeated, each character above each D is deleted.                 18062000
                                                                        18064000
I  -  Insert.  Inserts one or more characters immediately preceding the 18066000
      character above the cursor.  The D and I sub-commands can be used 18068000
      in conjunction to delete characters, then insert new characters.  18070000
                                                                        18072000
R  -  Replace.  Replaces the characters above the cursor with new       18074000
      characters.  If one character is entered, the character above the 18076000
      cursor is replaced; if two characters are entered, two characters,18078000
      (the character above the cursor and the character to the right)   18080000
      are replaced; and so forth for additional characters.  R is the   18082000
      default sub-command.                                              18084000
                                                                        18086000
U  -  Undo.  Cancels the effect of the previous D, I, or R sub-command. 18088000
      Entering a U, carriage return, then another U cancels all previous18090000
      sub-commands for this :REDO command and restores the line being   18092000
      corrected to its original form.                                   18094000
                                                                        18096000
\ITEM=EXAMPLE                                                           18098000
EXAMPLE                                                                 18100000
                                                                        18102000
    :FILE A;REC=..G;DISC=10000,16,1;SAVE                                18104000
                  ^                                                     18106000
    :ERR nnn EXPECTED F, V, OR U                                        18108000
    :REDO                        (Request to enter command string)      18110000
    :FILE A;REC=,,G;DISC=10000,16,1;SAVE  (MPE displays command)        18112000
                  RF                      (Replace G with F)            18114000
    :FILE A;REC=,,F;DISC=10000,16,1;SAVE  (Corrected command displayed) 18116000
                                                                        18118000
Note that the letter F can be entered without the sub-command R,        18120000
because R is the default sub-command.  For example,                     18122000
                                                                        18124000
    :FILE A;REC=,,G;DISC=10000,16,1;SAVE                                18126000
                  F                       (Replace G with F)            18128000
    :FILE A;REC=,,F;DISC=10000,16,1;SAVE  (Corrected command displayed) 18130000
                                                                        18132000
                                                                        18134000
\ENTRY=REFUSE,PARMS,OPERATION,EXAMPLE                                   18136000
     :REFUSE                                                            18138000
                                                                        18140000
Disallows jobs/sessions and/or data on a designated device.             18142000
                                                                        18144000
SYNTAX                                                                  18146000
                                                                        18148000
              [JOBS, ]                                                  18150000
     :REFUSE  [      ] ldn                                              18152000
              [DATA  ]                                                  18154000
                                                                        18156000
\ITEM=PARMS                                                             18158000
PARAMETERS                                                              18160000
                                                                        18162000
JOBS                    Disallows the :JOB (or :HELLO) command from     18164000
                        the designated device.                          18166000
                                                                        18168000
DATA                    Disallows the :DATA command from the desig-     18170000
                        nated device.                                   18172000
                                                                        18174000
ldn                     The logical device number of the device for     18176000
                        which :JOB (or :HELLO) and :DATA commands       18178000
                        are refused.                                    18180000
                                                                        18182000
\ITEM=OPERATION                                                         18184000
OPERATION                                                               18186000
                                                                        18188000
The parameter JOBS, in this command, refers to both jobs and sessions.  18190000
If the first parameter is omitted both :JOB (or :HELLO) and :DATA       18192000
commands are refused.                                                   18194000
                                                                        18196000
\ITEM=EXAMPLE                                                           18198000
EXAMPLES                                                                18200000
                                                                        18202000
To refuse data recognition from logical device number 35, enter:        18204000
                                                                        18206000
     :REFUSE DATA,35                                                    18208000
     :SHOWDEV 35                                                        18210000
     LDEV    AVAIL        OWNERSHIP      VOLID                          18212000
                                                                        18214000
      35  J  AVAIL                                                      18216000
                                                                        18218000
                                                                        18220000
To refuse jobs and data recognition from logical device number 35,      18222000
enter:                                                                  18224000
                                                                        18226000
     :REFUSE 35                                                         18228000
     :SHOWDEV 35                                                        18230000
     LDEV    AVAIL        OWNERSHIP      VOLID                          18232000
                                                                        18234000
      35     AVAIL                                                      18236000
                                                                        18238000
\ENTRY=RELEASE,PARMS,OPERATION,EXAMPLE                                  18240000
    :RELEASE                                                            18242000
                                                                        18244000
Temporarily suspends all security provisions for a file.                18246000
                                                                        18248000
SYNTAX                                                                  18250000
                                                                        18252000
    :RELEASE filereference                                              18254000
                                                                        18256000
\ITEM=PARMS                                                             18258000
PARAMETERS                                                              18260000
                                                                        18262000
filereference        Actual designator of file whose security provisions18264000
                     are to be suspended, written in this format:       18266000
                                                                        18268000
                     filename[/lockword][.groupname][.acctname]         18270000
                                                                        18272000
                     If the file has a lockword, it must be specified.  18274000
                     (REQUIRED PARAMETER)                               18276000
                                                                        18278000
\ITEM=OPERATION                                                         18280000
OPERATION                                                               18282000
                                                                        18284000
Temporarily suspends security provisions for file at all (file, group,  18286000
and account) levels, allowing any user in system unlimited access to the18288000
file.  Suspension remains in effect until a :SECURE command is entered  18290000
for this file to restore its previous security provisions.  Suspension  18292000
remains valid after job termination, or system failure followed by      18294000
coldload or reload.  (It can be negated, however, if system is reloaded 18296000
from a :SYSDUMP tape created before :RELEASE command was entered.)      18298000
Note that this command can be used only for permanent files on disc     18300000
whose labels identify you as the creator of the file.  In addition, the 18302000
:RELEASE command will fail if the group's home volume set is not        18304000
mounted.  When the normal (default) MPE security provisions are in      18306000
effect, the file must be in your logon account and must belong to your  18308000
logon or home group.                                                    18310000
                                                                        18312000
This command will not cause a volume set to be mounted.  If the file's  18314000
home volume set is not mounted at the time this command is issued, the  18316000
file will not be found and thus cannot be released.                     18318000
                                                                        18320000
The :RELEASE command does not affect the file's lockword, if any.       18322000
                                                                        18324000
\ITEM=EXAMPLE                                                           18326000
EXAMPLE                                                                 18328000
                                                                        18330000
To release all security provisions for the file named FILE1, enter:     18332000
                                                                        18334000
    :RELEASE FILE1                                                      18336000
                                                                        18338000
\ENTRY=RELLOG,PARMS,OPERATION,EXAMPLE                                   18340000
     :RELLOG                                                            18342000
                                                                        18344000
Removes a logging identifier from the system.                           18346000
                                                                        18348000
SYNTAX                                                                  18350000
                                                                        18352000
     :RELLOG logid                                                      18354000
                                                                        18356000
\ITEM=PARMS                                                             18358000
PARAMETERS                                                              18360000
                                                                        18362000
logid                 The logging identifier to be removed              18364000
                        from the system.  (REQUIRED PARAMETER)          18366000
                                                                        18368000
\ITEM=OPERATION                                                         18370000
OPERATION                                                               18372000
                                                                        18374000
The :RELLOG command removes a logging identifier from the system        18376000
by deleting it from the directory of logging identifiers.  This         18378000
command may be issued only by the user who created the logging          18380000
identifier specified in the logid parameter.                            18382000
                                                                        18384000
\ITEM=EXAMPLE                                                           18386000
EXAMPLE                                                                 18388000
                                                                        18390000
     :RELLOG DATALOG                                                    18392000
                                                                        18394000
\ENTRY=REMOTE,PARMS,OPERATION,EXAMPLE                                   18396000
    :REMOTE/:REMOTE HELLO                                               18398000
                                                                        18400000
Switches control to the Command Intrepreter of the remote               18402000
system, when a DS line has previously been opened.                      18404000
                                                                        18406000
SYNTAX                                                                  18408000
                                                                        18410000
    :REMOTE                                                             18412000
                                                                        18414000
System responds with a '#' prompt.  Remote commands are now             18416000
allowed.  Exit from the Remote system back to the local with            18418000
the ':' input.                                                          18420000
                                                                        18422000
                                                                        18424000
Establishes communication between a local computer and a remote         18426000
computer.                                                               18428000
                                                                        18430000
                                                                        18432000
SYNTAX                                                                  18434000
                                                                        18436000
    :REMOTE HELLO [sessionname,]username[/userpass].acctname[/acctpass] 18438000
                  [,groupname[/grouppass]]                              18440000
                                                                        18442000
                  [;TERM=termtype]                                      18444000
                  [;TIME=cpusecs]                                       18446000
                                                                        18448000
                  [;PRI={BS}]                                           18450000
                         CS                                             18452000
                         DS                                             18454000
                         ES                                             18456000
                                                                        18458000
                   [;INPRI=inputpriority]                               18460000
                   [;HIPRI]                                             18462000
                   [;DSLINE=dsdevice]                                   18464000
                                                                        18466000
\ITEM=PARMS                                                             18468000
PARAMETERS                                                              18470000
                                                                        18472000
sessionname         Arbitrary name used in conjunction with username    18474000
                    and acctname parameters to form a session           18476000
                    identity.  Contains from 1 to 8 alphanumeric        18478000
                    characters, beginning with a letter.  Default is    18480000
                    no session name is assigned.                        18482000
                                                                        18484000
username            A user name, established by Account Manager, that   18486000
                    allows you to log on under this account. Contains   18488000
                    from 1 to 8 alphanumeric characters, beginning      18490000
                    with a letter.  (REQUIRED PARAMETER)                18492000
                                                                        18494000
userpass            User password, optionally assigned by Account       18496000
                    Manager.  Contains from 1 to 8 alphanumeric         18498000
                    characters, beginning with a letter.                18500000
                                                                        18502000
acctname            Name of account, as established by Account Manager. 18504000
                    Contains from 1 to 8 alphanumeric characters,       18506000
                    beginning with a letter.  The acctname parameter    18508000
                    must be preceded by a period. (REQUIRED PARAMETER)  18510000
                                                                        18512000
acctpass            Account password, optionally assigned by System     18514000
                    Manager.  Contains from 1 to 8 alphanumeric         18516000
                    characters, beginning with a letter.                18518000
                                                                        18520000
groupname           Name of group to be used for local file domain and  18522000
                    CPU time charges.  Established by Account Manager.  18524000
                    Contains from 1 to 8 alphanumeric characters,       18526000
                    beginning with a letter.  Default is your home group18528000
                    if you are assigned one by Account Manager.         18530000
                    (Optional if you have a home group, required if home18532000
                    group not assigned.)                                18534000
                                                                        18536000
grouppass           (Required if assigned and you are logging on under  18538000
                     other than home group.  Not required if logging on 18540000
                     under home group.)                                 18542000
                                                                        18544000
                    Group password, optionally assigned by Account      18546000
                    Manager.  Contains from 1 to 8 alphanumeric         18548000
                    characters, beginning with a letter.                18550000
                                                                        18552000
 termtype           The term type for the local system is deter-        18554000
                    mined by the local logon ('HELLO U.A,G').           18556000
                    The remote system talks to the local terminal       18558000
                    through the MPE system and the ATC.  Thus, the      18560000
                    terminal type has no significance in the 'REMOTE    18562000
                    HELLO' command.                                     18564000
                                                                        18566000
cpusecs            Maximum CPU time that session can use, entered in    18568000
                   seconds.  When limit is reached, session is aborted. 18570000
                   Must be a value from 1 to 32767.  To specify no      18572000
                   limit, enter question mark (?) or UNLIM, or omit     18574000
                   parameter.  Default is no limit.                     18576000
                                                                        18578000
BS, CS, DS, ES     Execution priority class. BS is highest priority,    18580000
                   ES is lowest. If you specify a priority that exceeds 18582000
                   highest permitted for your account or user name by   18584000
                   the system, MPE assigns the highest priority         18586000
                   possible below BS.  Default is CS.                   18588000
                                                                        18590000
                                                                        18592000
                                       NOTE                             18594000
                                                                        18596000
                   DS and ES are used primarily for batch jobs; their   18598000
                   use for sessions is discouraged.                     18600000
                                                                        18602000
                                                                        18604000
inputpriority      Relative input priority used in checking against     18606000
                   access restrictions imposed by the jobfence, if one  18608000
                   exists.  Takes effect at logon time.  Must be a      18610000
                   value from 1 (lowest priority) to 13 (highest        18612000
                   priority).  If a value is specified that is less     18614000
                   than or equal to current jobfence set by Console     18616000
                   Operator, session is denied access. Default is 8.    18618000
                                                                        18620000
HIPRI             Request for maximum session-selection input prior-    18622000
                  ity, causing session to be seheduled regardless of    18624000
                  current jobfence or execution limit for session.s     18626000
                  This parameter can be specified only by users with    18628000
                  System Manager or System Supervisor capability.       18630000
                  Default is:  the current jobfence and execution       18632000
                  limit.                                                18634000
                                                                        18636000
dsdevice            The device class name or logical device number      18638000
                    assigned to the DS/3000 communications driver       18640000
                    IODS0 during system configuration.  This            18642000
                    parameter specifies what physical line you wish     18644000
                    to use.  Optional parameter if a line already is    18646000
                    open; otherwise it is required.                     18648000
                                                                        18650000
\ITEM=OPERATION                                                         18652000
OPERATION                                                               18654000
                                                                        18656000
The :REMOTE HELLO command is used with the :DSLINE command to obtain    18658000
access to a physical communications line and establish the              18660000
communications link to a remote HP 3000, or by itself (using the        18662000
DSLINE parameter) to perform the same functions.                        18664000
                                                                        18666000
\ITEM=EXAMPLE                                                           18668000
EXAMPLE                                                                 18670000
                                                                        18672000
To establish the communications line HDS2 and log on to System B from   18674000
System A, you could enter:                                              18676000
                                                                        18678000
    :HELLO USER.X                                                       18680000
    :REMOTE HELLO USER.X;DSLINE=HDS2                                    18682000
                                                                        18684000
                                                                        18686000
\ENTRY=RENAME,PARMS,OPERATION,EXAMPLE                                   18688000
    :RENAME                                                             18690000
                                                                        18692000
Changes identity (file name, lockword, and/or group name) of disc file. 18694000
                                                                        18696000
SYNTAX                                                                  18698000
                                                                        18700000
    :RENAME oldfilereference,newfilereference[,TEMP]                    18702000
                                                                        18704000
\ITEM=PARMS                                                             18706000
PARAMETERS                                                              18708000
                                                                        18710000
oldfilereference         Current name of file, written in the following 18712000
                         format:                                        18714000
                                                                        18716000
                     filename[/lockword][.groupname][.acctname]         18718000
                                                                        18720000
                         If <acctname> is specified, it must be that of 18722000
                         your logon account.  (REQUIRED PARAMETER)      18724000
                                                                        18726000
newfilereference         New name of file, in the same format as        18728000
                         <oldfilereference>.  If <acctname> is          18730000
                         specified, it must be that of your logon       18732000
                         account. If <groupname> is specified, it must  18734000
                         be one to which you have SAVE access. If       18736000
                         <acctname> and/or <groupname> are omitted, the 18738000
                         logon account and/or group are assumed.        18740000
                         (REQUIRED PARAMETER)                           18742000
                                                                        18744000
TEMP                     Indicates that old file was, and new file will 18746000
                         be, in temporary job/session file domain.      18748000
                         Default is permanent file is assumed.          18750000
                                                                        18752000
\ITEM=OPERATION                                                         18754000
OPERATION                                                               18756000
                                                                        18758000
Changes system file identification for permanent or temporary disc file.18760000
Effectively removes file with old name from system and creates another  18762000
file with identical contents and new name.  This command can be used to 18764000
change the name of a file, to move a file from one group to another (by 18766000
specifying a different <groupname> in the <newfilereference> parameter),18768000
or to change the lockword.                                              18770000
                                                                        18772000
The volume set must be mounted for the group in which this file is to   18774000
be renamed or this command will fail.  In addition, renaming is         18776000
confined to a volume set (i.e., a file cannot be renamed across         18778000
volume sets).                                                           18780000
                                                                        18782000
Note that this command can be used only for a file that you have        18784000
created.                                                                18786000
                                                                        18788000
\ITEM=EXAMPLE                                                           18790000
EXAMPLE                                                                 18792000
                                                                        18794000
To change the name of a temporary file from OLDFILE to NEWFILE, moving  18796000
it from your logon group to the group named NEWG, enter:                18798000
                                                                        18800000
    :RENAME OLDFILE,NEWFILE.NEWG,TEMP                                   18802000
                                                                        18804000
To change the lockword of the permanent file FILE2 from LOCKA to LOCKB, 18806000
enter:                                                                  18808000
                                                                        18810000
    :RENAME FILE2/LOCKA,FILE2/LOCKB                                     18812000
                                                                        18814000
                                                                        18816000
\ENTRY=REPLY,PARMS,OPERATION,EXAMPLE                                    18818000
     :REPLY                                                             18820000
                                                                        18822000
Replies to pending requests.                                            18824000
                                                                        18826000
SYNTAX                                                                  18828000
                                                                        18830000
     :REPLY PIN,reply [,param]                                          18832000
                                                                        18834000
\ITEM=PARMS                                                             18836000
PARAMETERS                                                              18838000
                                                                        18840000
PIN               The process identification number of the message      18842000
                  sender.  It is part of the message to which the       18844000
                  sender is REPLYing, such as,                          18846000
                                                                        18848000
                                                                        18850000
                  ?16:15/#S25/43/LDEV# FOR "CARDS" ON CARD (NUM)?       18852000
                               ^                                        18854000
                             PIN                                        18856000
                  (Required parameter.)                                 18858000
                                                                        18860000
reply             The reply type specified in the message, defined      18862000
                  by:                                                   18864000
                                                                        18866000
                  (NUM) - reply must be a logical device number         18868000
                                                                        18870000
                  (Y/N) - reply must be YES (or Y), or NO (or N)        18872000
                                                                        18874000
                  (Sxx) - reply must be a string not to exceed          18876000
                          xx characters in length                       18878000
                                                                        18880000
                  (YN#) - reply must be YES (or Y), NO (or N),          18882000
                          or a logical device number                    18884000
                                                                        18886000
param             The same as the reply parameter, excluding type       18888000
                  (YN#)                                                 18890000
                                                                        18892000
\ITEM=OPERATION                                                         18894000
OPERATION                                                               18896000
                                                                        18898000
User's programs that are WAITING for your REPLY remain suspended        18900000
indefinitely.  If for any reason you cannot reply as requested (for     18902000
example, a particular device is non-existent or a special form is       18904000
unavailable), then reply by assigning logical device number (ldn) 0.    18906000
This causes an immediate program failure.                               18908000
                                                                        18910000
                                                                        18912000
\ITEM=EXAMPLE                                                           18914000
EXAMPLES                                                                18916000
                                                                        18918000
To reply to a message from the MPE SYSTEM, enter:                       18920000
                                                                        18922000
     ?10:05/#J19/15/LDEV# FOR "NAS" ON TAPE1600 (NUM)?                  18924000
     :REPLY 15,7                                                        18926000
                                                                        18928000
\ENTRY=REPORT,PARMS,OPERATION,EXAMPLE                                   18930000
    :REPORT                                                             18932000
                                                                        18934000
Displays accounting information for specified groups and accounts.      18936000
                                                                        18938000
SYNTAX                                                                  18940000
                                                                        18942000
    :REPORT [groupset][,listfile][;VS=volset]                           18944000
                                                                        18946000
\ITEM=PARMS                                                             18948000
PARAMETERS                                                              18950000
                                                                        18952000
groupset       Specifies the accounts and groups for which information  18954000
               is to be listed.  The permissible entries and the        18956000
               capability required (shown in parentheses) are as        18958000
               follows:  Account Manager is shown as AM; System Manager 18960000
               is shown as SM.                                          18962000
                                                                        18964000
groupname      Reports on the specified group in the log-on account.    18966000
               Standard user can only specify his log-on group.         18968000
                                                                        18970000
@              Reports on all groups in the log-on account (AM or SM).  18972000
                                                                        18974000
groupname.     Reports on the specified group in the specified          18976000
acctname       account (SM).                                            18978000
                                                                        18980000
@.acctname     Reports on all groups in the specified account           18982000
               (AM or SM).                                              18984000
                                                                        18986000
@.@            Reports on all groups in all accounts (SM).              18988000
                                                                        18990000
groupname.@    Reports on specified group in any account (SM).          18992000
                                                                        18994000
               Default:                                                 18996000
                  For standard user:    his log-on group.               18998000
                  For Account Manager:  all groups in his own account.  19000000
                  For System Manager:   all groups in all accounts.     19002000
                                                                        19004000
\stophelp                                                               19006000
                                                                        19008000
                                     For System Manager:  All groups in 19010000
                                     all accounts.                      19012000
                                                                        19014000
groupname.@                Reports on specified group in any            19016000
                           account.                                     19018000
                                                                        19020000
\starthelp                                                              19022000
                                       NOTE                             19024000
                                                                        19026000
               The characters @, #, and ? can be used as "wild          19028000
               card" characters, in any order, in the groupset          19030000
               parameter. These wild card characters have the           19032000
               following message.                                       19034000
                                                                        19036000
               @ -- specifies zero or more alphanumeric characters.     19038000
                                                                        19040000
               # -- specifies one numeric character.                    19042000
                                                                        19044000
               ? -- specifies one alphanumeric character.               19046000
                                                                        19048000
               The characters can be used as follows:                   19050000
                                                                        19052000
               n@      Report on all groups starting with the           19054000
                       character n.                                     19056000
                                                                        19058000
               @n      Report on all groups ending with the character   19060000
                       n.                                               19062000
                                                                        19064000
               n@x     Report on all groups starting with the character 19066000
                       n and ending with the character x.               19068000
                                                                        19070000
               n##..#  Report on all groups starting with the character 19072000
                       n followed by up to seven digits.                19074000
                                                                        19076000
               ?n@     Report on all groups whose second character      19078000
                       is n.                                            19080000
                                                                        19082000
               n?      Report on all two-character groups starting      19084000
                       with the character n.                            19086000
                                                                        19088000
               ?n      Report on all two-character groups ending with   19090000
                       the character n.                                 19092000
                                                                        19094000
listfile       Actual file designator of output file to which           19096000
               information is to be written.  Output may be             19098000
               redirected with a :FILE back reference as follows:       19100000
                                                                        19102000
               :FILE LIST1;DEV=LP                                       19104000
               :REPORT ,*LIST1                                          19106000
                                                                        19108000
               Default is $STDLIST.                                     19110000
                                                                        19112000
volset         Directs the reporting of accounting information from     19114000
               the specified volume set.                                19116000
                                                                        19118000
\ITEM=OPERATION                                                         19120000
OPERATION                                                               19122000
                                                                        19124000
Outputs total accounting information logged against groups and accounts.19126000
For the standard user, this information covers his own group only; an   19128000
Account Manager may specify all groups in his account; and the System   19130000
Manager may specify all groups in all accounts.                         19132000
                                                                        19134000
The information includes usage counts and limits for permanent file     19136000
space (in sectors), cpu time (in seconds), and session connect time (in 19138000
minutes).  The file space usage count reflects file space used as of the19140000
present time, but the cpu time and connect time usage reflects these    19142000
counts as they were immediately prior to the start of the current job.  19144000
                                                                        19146000
When <volset> is used to specify a private volume set, the only         19148000
valid information contained in the report is the filespace counts       19150000
and limits.                                                             19152000
                                                                        19154000
The type of output written to <listfile> depends on the type of file    19156000
(ASCII or binary) specified or implied.  If <listfile> is an ASCII file,19158000
a standard ASCII listing is produced; on this listing, an unlimited     19160000
quantity is denoted by a double asterisk (**).  If <listfile> is a      19162000
binary file (typically used to help in automatic processing of the      19164000
report data), a 17-word record is written for each account/group.       19166000
                                                                        19168000
On both ASCII and binary listfiles, the entry for each account is       19170000
followed immediately by the entries for all of its groups.              19172000
                                                                        19174000
\ITEM=EXAMPLE                                                           19176000
EXAMPLE                                                                 19178000
                                                                        19180000
To obtain accounting information for your group, enter the :REPORT      19182000
command, as follows:                                                    19184000
                                                                        19186000
    :REPORT                                                             19188000
\ENTRY=RESET,PARMS,OPERATION,EXAMPLE                                    19190000
    :RESET                                                              19192000
                                                                        19194000
Cancels :FILE command.                                                  19196000
                                                                        19198000
SYNTAX                                                                  19200000
                                                                        19202000
            formaldesignator                                            19204000
    :RESET {                }                                           19206000
             @                                                          19208000
                                                                        19210000
\ITEM=PARMS                                                             19212000
PARAMETERS                                                              19214000
                                                                        19216000
formaldesignator          Formal file name of file on which :FILE       19218000
                          command will be cancelled.                    19220000
                                                                        19222000
@                         Directive to reset all formal file designators19224000
                          noted in all :FILE commands previously        19226000
                          encountered in this job session.              19228000
                                                                        19230000
\ITEM=OPERATION                                                         19232000
OPERATION                                                               19234000
                                                                        19236000
Resets the formal designator for a file to its original meaning,        19238000
negating the effect of any :FILE command that has referenced this formal19240000
designator up to this point in the job.  Applies to files on any device.19242000
                                                                        19244000
\ITEM=EXAMPLE                                                           19246000
EXAMPLE                                                                 19248000
                                                                        19250000
To cancel the effects of a previous :FILE command that specified        19252000
characteristics for a file programmatically referred to as ALPHA, enter:19254000
                                                                        19256000
    :RESET ALPHA                                                        19258000
                                                                        19260000
                                                                        19262000
\ENTRY=RESETACCT,PARMS,OPERATION,EXAMPLE                                19264000
    :RESETACCT (System Manager capability required)                     19266000
                                                                        19268000
Resets to zero the running counts of cpu time or connect time accum-    19270000
ulated by an account, and all groups within that account.               19272000
                                                                        19274000
SYNTAX                                                                  19276000
                                                                        19278000
                 @           ,CPU                                       19280000
    :RESETACCT [          ][          ]                                 19282000
                 acctname    ,CONNECT                                   19284000
                                                                        19286000
\ITEM=PARMS                                                             19288000
PARAMETERS                                                              19290000
                                                                        19292000
@            Specifies that counters for all accounts/groups are to be  19294000
             reset.  Default.                                           19296000
                                                                        19298000
acctname     Specifies the name of a particular account and group.      19300000
             Default is @.                                              19302000
                                                                        19304000
CPU          Specifies that only the cpu usage counter is to be reset.  19306000
             Default is both the cpu and connect time counters are      19308000
             reset.                                                     19310000
                                                                        19312000
CONNECT      Specifies that only the connect time usage counter is to be19314000
             reset.  Default is both the cpu and connect time usage     19316000
             counters are reset.                                        19318000
                                                                        19320000
\ITEM=OPERATION                                                         19322000
OPERATION                                                               19324000
                                                                        19326000
(System Manager capability required)                                    19328000
This command resets to zero the running counts of cpu or connect time   19330000
accumulated by an account, and all groups within that account.          19332000
                                                                        19334000
If all parameters are omitted, all counters for all accounts and their  19336000
groups are reset.                                                       19338000
                                                                        19340000
\ITEM=EXAMPLE                                                           19342000
EXAMPLE                                                                 19344000
                                                                        19346000
To reset the cpu use counter for all accounts in the system, enter:     19348000
                                                                        19350000
    :RESETACCT @,CPU                                                    19352000
                                                                        19354000
                                                                        19356000
\ENTRY=RESETDUMP,PARMS,OPERATION,EXAMPLE                                19358000
    :RESETDUMP                                                          19360000
                                                                        19362000
Disables Stackdump facility.                                            19364000
                                                                        19366000
SYNTAX                                                                  19368000
                                                                        19370000
    :RESETDUMP                                                          19372000
                                                                        19374000
\ITEM=PARMS                                                             19376000
PARAMETERS                                                              19378000
                                                                        19380000
None                                                                    19382000
                                                                        19384000
\ITEM=OPERATION                                                         19386000
OPERATION                                                               19388000
                                                                        19390000
Disarms MPE Stackdump facility (armed by :SETDUMP command), described in19392000
the MPE Debug/Stackdump Reference Manual.  When entered in BREAK, does  19394000
not modify state of processes already created.  If Stackdump facility is19396000
not enabled, :RESETDUMP command has no effect.                          19398000
                                                                        19400000
\ITEM=EXAMPLE                                                           19402000
EXAMPLE                                                                 19404000
                                                                        19406000
To disable the Stackdump facility, enter:                               19408000
                                                                        19410000
    :RESETDUMP                                                          19412000
                                                                        19414000
                                                                        19416000
\ENTRY=RESTORE,PARMS,OPERATION,EXAMPLE                                  19418000
    :RESTORE                                                            19420000
                                                                        19422000
Returns files (stored on magnetic tape or serial disc) to system.       19424000
                                                                        19426000
SYNTAX                                                                  19428000
                                                                        19430000
    :RESTORE restorefile[;[fileset][,. . .][,fileset]]                  19432000
                                                                        19434000
             [;KEEP][;DEV=device][;SHOW][;FILES=maxfiles][;OLDDATE]     19436000
                                                                        19438000
\ITEM=PARMS                                                             19440000
PARAMETERS                                                              19442000
                                                                        19444000
restorefile           Name of magnetic tape or serial disc file on      19446000
                      which files to be restored exist.  This file must 19448000
                      be referenced in the back-reference format by     19450000
                      using an asterisk.  (This format references a     19452000
                      previous :FILE command that has defined the       19454000
                      file as a magnetic tape or serial disc file.)     19456000
                                                                        19458000
                      A message is output on the system console         19460000
                      requesting the Console Operator to mount the      19462000
                      tape or serial disc platter identified by the     19464000
                      restorefile parameter, and allocate the device.   19466000
                      (REQUIRED PARAMETER)                              19468000
                                                                        19470000
fileset               Sets of files to be restored.  This parameter     19472000
                      is of the form:                                   19474000
                                                                        19476000
                      filedesig[.groupdesig[.acctdesig]]                19478000
                                                                        19480000
                      Fileset can be entered in any of the following    19482000
                      formats and may use wild card characters,         19484000
                      any order, as replacements:                       19486000
                                                                        19488000
file.groupdesig       Restore the specified file in the specified group 19490000
.acctdesig                                                              19492000
                      and account.                                      19494000
                                                                        19496000
filedesig.groupdesig  Restore specified file in specified group.        19498000
                                                                        19500000
filedesig             Restores the specified file.                      19502000
                                                                        19504000
@.group.account       Restore all files in specified group and account. 19506000
                                                                        19508000
@.group               Restore all files in specified group.             19510000
                                                                        19512000
@.@.account           Restore all files in all groups in specified      19514000
                      account.                                          19516000
                                                                        19518000
@                     Restore all files in logon group. Default for     19520000
                      users.                                            19522000
                                                                        19524000
@.@                   Restore all files in all groups in logon account. 19526000
                      Default for account manager.                      19528000
                                                                        19530000
@.@.@                 Restore all files in system. Default for system   19532000
                      manager and system supervisor.                    19534000
                                                                        19536000
file.@.account        Restore specified file in all groups of           19538000
                      specified account.                                19540000
                                                                        19542000
                                       NOTE                             19544000
                                                                        19546000
                      More than one fileset may be used with a single   19548000
                      :RESTORE command.  The number of filesets that may19550000
                      be specified with one :RESTORE command is limited 19552000
                      as follows: up to 10 by account name; up to 15 by 19554000
                      group name and account name; and up to 20 by file 19556000
                      name, group name, and account name.  The fileset  19558000
                      is a positional parameter.                        19560000
                                                                        19562000
                                      NOTE                              19564000
                                                                        19566000
               The characters @, #, and ? can be used as "wild card"    19568000
               characters in the fileset parameter.  These wild card    19570000
               characters have the following meanings:                  19572000
                                                                        19574000
               @ -- specifies zero or more alphanumeric characters.     19576000
                                                                        19578000
               # -- specifies one numeric character.                    19580000
                                                                        19582000
               ? -- specifies one alphanumeric character.               19584000
                                                                        19586000
               The characters can be used as follows:                   19588000
                                                                        19590000
               n@      Restore all files starting with the character n. 19592000
                                                                        19594000
               @n      Restore all files ending with the character n.   19596000
                                                                        19598000
               n@x     Restore all files starting with the character    19600000
                       n and ending with the character x.               19602000
                                                                        19604000
               n##..#  Restore all files starting with the character    19606000
                       n followed by up to seven digits (useful for     19608000
                       restoring all EDIT/3000 temporary files).        19610000
                                                                        19612000
               ?n@     Restore all files whose second character is n.   19614000
               n?      Restore all two-character files starting with    19616000
                       the character n.                                 19618000
                                                                        19620000
               ?n      Restore all two-character files ending with      19622000
                       the character n.                                 19624000
                                                                        19626000
                                                                        19628000
 KEEP                 Specifies that if a file referenced in the        19630000
                      :RESTORE command currently exists on disc, the    19632000
                      file on disc is kept and the corresponding tape   19634000
                      or serial disc                                    19636000
                      file is not copied into the system. Default:  If  19638000
                      an identically-named file exists in the system,   19640000
                      that file is replaced with the one on tape or     19642000
                      serial disc.  If                                  19644000
                      the identically-named file on disc is busy,       19646000
                      however, the disc file is kept and the tape or    19648000
                      serial disc file is not restored.                 19650000
                                                                        19652000
device                Specifies the device on which the file is to      19654000
                      reside, entered in one of the following forms:    19656000
                                                                        19658000
                      devclass                                          19660000
                      ldn                                               19662000
                                                                        19664000
                      The device class <devclass> specifies the type of 19666000
                      device.  If devclass is specified, the file is    19668000
                      allocated to any of the home volume set's volumes 19670000
                      that fall within that device class.               19672000
                                                                        19674000
                      The logical device number (ldn) specifies a       19676000
                      specific device.  If ldn is specified, the file   19678000
                      will be allocated to that device only if one of   19680000
                      volumes in the home volume set currently occupies 19682000
                      the device.                                       19684000
                                                                        19686000
                      Default:  MPE attempts to restore the file on a   19688000
                      logical device compatible with the type/sub-type  19690000
                      specified in the file's file label and the type/  19692000
                      sub-type of the mounted home volume set.  If this 19694000
                      fails, an attempt is made to restore the file on  19696000
                      the same device class as specified in the file's  19698000
                      file label and that of the mounted home volume    19700000
                      set.  If this fails, an attempt is made to restore19702000
                      the file on any member of the home volume set. If 19704000
                      this fails, the file is not restored.             19706000
                                                                        19708000
SHOW                  Request to list names of restored files. Default: 19710000
                      Only total number of files restored, list of files19712000
                      not restored, (and the reason each was not        19714000
                      restored), and the count of files not restored are19716000
                      listed.  The listing is sent to $STDLIST          19718000
                      (formal designator SYSLIST) unless a :FILE        19720000
                      command is entered to send the listing to some    19722000
                      other device.  For example,                       19724000
                                                                        19726000
                          :FILE SYSLIST;DEV=LP                          19728000
                                                                        19730000
                      entered before the :RESTORE command would send    19732000
                      the listing to a line printer.                    19734000
                                                                        19736000
maxfiles              Maximum number of files that may be restored.     19738000
                      Default is 4000.                                  19740000
OLDDATE               Keeps the accdate and moddate on files being      19742000
                      restored unchanged.  Default is to alter          19744000
                      these dates.                                      19746000
                                                                        19748000
                                                                        19750000
\ITEM=OPERATION                                                         19752000
OPERATION                                                               19754000
                                                                        19756000
Reads back into system, on disc, a file or files stored offline by      19758000
:STORE or :SYSDUMP commands.  If you have System Manager or System      19760000
Supervisor capability, you can restore any file from a :STORE tape      19762000
or serial disc,                                                         19764000
assuming the account and group to which the file belongs and the user   19766000
who created the file are defined in the system.  If you have Account    19768000
Manager capability, you can restore any file in your account (but cannot19770000
restore those with negative file codes unless you also have Privileged  19772000
Mode capability.  If you have standard user capability only, you can    19774000
restore any file in your logon account if you have SAVE access to the   19776000
group to which the file belongs; you cannot, however, restore those with19778000
negative file codes unless you have Privileged Mode capability.  If the 19780000
file to be restored is protected by a lockword, you must supply the     19782000
lockword                                                                19784000
the :RESTORE command unless you have System Manager, System Supervisor, 19786000
or Account Manager (and you are restoring within your own account)      19788000
capability.  If you are logged on in an interactive session, MPE prompts19790000
you for omitted lockwords.  However, if you are a System Manager,       19792000
System Supervisor, or Account Manager (restoring within your own        19794000
account), you are not required to provide lockwords.  Any file belonging19796000
to a group whose home volume set has not been pre-mounted will not be   19798000
restored.                                                               19800000
                                                                        19802000
The listing output by :RESTORE is sent to a file whose formal designator19804000
is SYSLIST.  If not specified, this file is equated by default to the   19806000
current list device ($STDLIST).                                         19808000
                                                                        19810000
Before entering :RESTORE, you must identify restorefile as a magnetic   19812000
tape or serial disc file with a :FILE command, as follows:              19814000
                                                                        19816000
    :FILE formaldesignator[=filereference};DEV=device[;REC=recsize]     19818000
                                                                        19820000
The device parameter must indicate the device class name or logical     19822000
unit number of a magnetic tape or serial disc unit.  The <recsize>      19824000
parameter needs to be entered if the record size of files being         19826000
:RESTOREd is larger than 4096 for either serial discs or 6250 BPI       19828000
labeled tapes.  All other parameters for the <restorefile> are          19830000
supplied by the :RESTORE command.  If you attempt to supply any of      19832000
of these parameters, MPE will reject the :RESTORE command.              19834000
                                                                        19836000
\ITEM=EXAMPLE                                                           19838000
EXAMPLE                                                                 19840000
                                                                        19842000
To restore all files belonging to your logon group from the restorefile 19844000
named BACKUP, enter:                                                    19846000
                                                                        19848000
    :FILE BACKUP;DEV=TAPE                                               19850000
    :RESTORE *BACKUP;@;KEEP;SHOW                                        19852000
                                                                        19854000
In response, the Console Operator receives a request to mount the tape  19856000
identified as BACKUP. If a serial device file satisfying the @          19858000
specification already exists in the system, it is not restored          19860000
because the keep parameter was specified.                               19862000
\ENTRY=RESUME,PARMS,OPERATION,EXAMPLE                                   19864000
    :RESUME                                                             19866000
                                                                        19868000
Resumes execution of a suspended operation.                             19870000
                                                                        19872000
SYNTAX                                                                  19874000
                                                                        19876000
    :RESUME                                                             19878000
                                                                        19880000
\ITEM=PARMS                                                             19882000
PARAMETERS                                                              19884000
                                                                        19886000
None                                                                    19888000
                                                                        19890000
\ITEM=OPERATION                                                         19892000
OPERATION                                                               19894000
                                                                        19896000
After a program or MPE command operation is suspended by pressing the   19898000
BREAK key or by using the CAUSEBREAK intrinsic, the :RESUME command     19900000
resumes execution of the operation at the point where the execution was 19902000
suspended.                                                              19904000
                                                                        19906000
Note that the :RESUME command is legitimate only during a BREAK.  Many  19908000
MPE commands are aborted rather than suspended by a BREAK, and thus     19910000
cannot be resumed.                                                      19912000
                                                                        19914000
\ITEM=EXAMPLE                                                           19916000
EXAMPLE                                                                 19918000
                                                                        19920000
    :RESUME                                                             19922000
                                                                        19924000
                                                                        19926000
\ENTRY=RESUMEJOB,PARMS,OPERATION,EXAMPLE                                19928000
     :RESUMEJOB                                                         19930000
                                                                        19932000
Resumes a suspended job.                                                19934000
                                                                        19936000
SYNTAX                                                                  19938000
                                                                        19940000
     :RESUMEJOB #Jnnn                                                   19942000
                                                                        19944000
\ITEM=PARMS                                                             19946000
PARAMETERS                                                              19948000
                                                                        19950000
#Jnnn          A job number.                                            19952000
                                                                        19954000
\ITEM=OPERATION                                                         19956000
OPERATION                                                               19958000
                                                                        19960000
                                                                        19962000
When a suspended job is resumed, it will continue execution from        19964000
the point at which it was suspended.  No message is issued when         19966000
a suspended job is resumed.                                             19968000
                                                                        19970000
\ITEM=EXAMPLE                                                           19972000
EXAMPLES                                                                19974000
                                                                        19976000
To resume suspended job number 68, enter:                               19978000
                                                                        19980000
     :RESUMEJOB #J68                                                    19982000
                                                                        19984000
\ENTRY=RESUMELOG,PARMS,OPERATION,EXAMPLE                                19986000
    :RESUMELOG (System Supervisor capability required)                  19988000
                                                                        19990000
Resumes logging following suspension caused by an error.                19992000
                                                                        19994000
SYNTAX                                                                  19996000
                                                                        19998000
    :RESUMELOG                                                          20000000
                                                                        20002000
\ITEM=PARMS                                                             20004000
PARAMETERS                                                              20006000
                                                                        20008000
None                                                                    20010000
                                                                        20012000
\ITEM=OPERATION                                                         20014000
OPERATION                                                               20016000
                                                                        20018000
(System Supervisor capability required)                                 20020000
This command resumes logging following suspension caused by an error.   20022000
                                                                        20024000
When logging resumes, a special Log Record is displayed that denotes the20026000
number of log events (and corresponding records) missed, total records  20028000
missed, total job initiation records missed, and total job session      20030000
termination records missed.                                             20032000
                                                                        20034000
\ITEM=EXAMPLE                                                           20036000
EXAMPLE                                                                 20038000
                                                                        20040000
Assume the system is on line and running with logging enabled.  An error20042000
of a recoverable type occurs, resulting in the following error message  20044000
to the system console:                                                  20046000
                                                                        20048000
    ST/10:43/LOG FILE NUMBER 104 ERROR #46. LOGGING SUSPENDED           20050000
                                                                        20052000
After the error is corrected, :RESUMELOG is entered:                    20054000
                                                                        20056000
    :RESUMELOG                                                          20058000
                                                                        20060000
In response, the following messages are displayed on the system console:20062000
                                                                        20064000
   ST/10:45/LOG FILE NUMBER 104.  LOGGING RESUMED.                      20066000
   ST/10:45/LOG FILE NUMBER 104 ON.                                     20068000
                                                                        20070000
                                                                        20072000
\ENTRY=RESUMESPOOL,PARMS,OPERATION,EXAMPLE                              20074000
     :RESUMESPOOL                                                       20076000
                                                                        20078000
Initiates resuming a spooled device.                                    20080000
                                                                        20082000
SYNTAX                                                                  20084000
                                                                        20086000
     :RESUMESPOOL ldn [;{BACK     }          nnn FILES    ]             20088000
                      [;{FORWARD  }         {          }  ]             20090000
                      [                      nnn PAGES    ]             20092000
                                                                        20094000
                      [;{BEGINNING}                       ]             20096000
\ITEM=PARMS                                                             20098000
PARAMETERS                                                              20100000
                                                                        20102000
ldn          The logical device number of a spooled device.             20104000
                                                                        20106000
BACK         Allows operator to backspace files or pages.               20108000
                                                                        20110000
FORWARD      Allows operator forward spacing of files or pages.         20112000
                                                                        20114000
BEGINNING    Allows operator to space to beginning of file.             20116000
             (Beginning of file will be the first non-purged            20118000
              extent).                                                  20120000
                                                                        20122000
nnn FILES    Number of files operator wishes to back or forward         20124000
             space.  The number must be between 1 and 256.              20126000
                                                                        20128000
nnn PAGES    Number of pages operator wishes to back or forward         20130000
             space.  The number must be between 1 and 256.              20132000
                                                                        20134000
                                                                        20136000
\ITEM=OPERATION                                                         20138000
OPERATION                                                               20140000
                                                                        20142000
:RESUMESPOOL can be used after :SUSPENDSPOOL has occured.               20144000
                                                                        20146000
                                                                        20148000
\ITEM=EXAMPLE                                                           20150000
EXAMPLES                                                                20152000
                                                                        20154000
                                                                        20156000
To resume spooling on logical device number 6, enter:                   20158000
                                                                        20160000
     :RESUMESPOOL 6                                                     20162000
                                                                        20164000
To resume spooling on logical device number 6, backspacing              20166000
5 pages, enter:                                                         20168000
                                                                        20170000
     :RESUMESPOOL 6;BACK 5 PAGES                                        20172000
                                                                        20174000
                                                                        20176000
\ENTRY=RJE,PARMS,OPERATION,EXAMPLE                                      20178000
    :RJE                                                                20180000
                                                                        20182000
Calls HP 2780/3780 Emulator.                                            20184000
                                                                        20186000
SYNTAX                                                                  20188000
                                                                        20190000
   :RJE [commandfile][,[inputfile][,[listfile][,punchfile]]]            20192000
                                                                        20194000
\ITEM=PARMS                                                             20196000
PARAMETERS                                                              20198000
                                                                        20200000
commandfile         Actual designator of file from which Emulator reads 20202000
                    its directives.  Can be any ASCII input file.       20204000
                    Formal designator is RJECOM.  Default is $STDIN.    20206000
                                                                        20208000
inputfile           Actual designator of file from which Emulator reads 20210000
                    input data to be transmitted to the remote computer.20212000
                    Can be any ASCII input file. Formal designator is   20214000
                    RJEIN.  Default is $STDIN.                          20216000
                                                                        20218000
listfile            Actual designator of file to receive listed output  20220000
                    obtained from remote computer.  Can be any ASCII    20222000
                    output file.  Formal designator is RJELIST.  Because20224000
                    this file usually is a line printer, it is          20226000
                    defined in a :FILE command and back referenced      20228000
                    as follows:                                         20230000
                                                                        20232000
                    :FILE LP;DEV=LP                                     20234000
                    :RJE CFILE,INFILE,*LP                               20236000
                                                                        20238000
                    Default is $STDLIST.                                20240000
                                                                        20242000
punchfile           Actual designator of file to receive punched output 20244000
                    obtained from remote computer.  Can be any output   20246000
                    file.  Formal designator is RJEPUNCH.  Because this 20248000
                    file usually is a non-disc file, it is defined      20250000
                    in a :FILE command and back referenced as follows:  20252000
                                                                        20254000
                    :FILE PUNFILE;DEV=PTPUNCH                           20256000
                    :RJE CFILE,INFILE,,*PUNFILE                         20258000
                                                                        20260000
                    Default is $OLDPASS (if $OLDPASS exists) or $NEWPASS20262000
                    if $OLDPASS does not exist.                         20264000
                                                                        20266000
                                NOTE                                    20268000
                                                                        20270000
      The formal file designators used in this command                  20272000
      (RJECOM, RJEIN, RJELIST, RJEPUNCH)                                20274000
      cannot be back referenced as actual file designators              20276000
      in the command parameter list.  For further information,          20278000
      see the discussion of implied :FILE commands in                   20280000
      Section VII of the MPE Commands Reference Manual.                 20282000
                                                                        20284000
\ITEM=OPERATION                                                         20286000
OPERATION                                                               20288000
                                                                        20290000
Invokes the HP 2780/3780 Emulator.  The Emulator permits transfer of    20292000
data between an HP 3000 Computer System and a variety of remote         20294000
processors in a full multiprogramming environment.  The Emulator makes  20296000
the HP 3000 Computer System appear to a remote processor as either an   20298000
IBM 2780 or 3780 Data Transmission Terminal.                            20300000
                                                                        20302000
\ITEM=EXAMPLE                                                           20304000
EXAMPLE                                                                 20306000
                                                                        20308000
To invoke the Emulator in a session, enter directives to it via your    20310000
current input device, and input data via the disc file MYDATA, with     20312000
listing output directed to a line printer (LISTFL) and punched output to20314000
a card punch (PUNCHFL), enter:                                          20316000
                                                                        20318000
    :FILE LISTFL;DEV=LP                                                 20320000
    :FILE PUNCHFL;DEV=PTPUNCH                                           20322000
    :RJE ,MYDATA,*LISTFL,*PUNCHFL                                       20324000
                                                                        20326000
                                                                        20328000
\ENTRY=RPG,PARMS,OPERATION,EXAMPLE                                      20330000
    :RPG                                                                20332000
                                                                        20334000
Compiles an RPG program.                                                20336000
                                                                        20338000
SYNTAX                                                                  20340000
                                                                        20342000
    :RPG [textfile][,[uslfile][,[listfile][,[masterfile][,newfile]]]]   20344000
                                                                        20346000
\ITEM=PARMS                                                             20348000
PARAMETERS                                                              20350000
                                                                        20352000
textfile           Actual designator of input file from which source    20354000
                   program is read.  Can be any ASCII input file. Formal20356000
                   designator is RPGTEXT.  Default is $STDIN.           20358000
                                                                        20360000
uslfile            Actual designator of USL file on which object program20362000
                   is written.  Can be any binary input file with a     20364000
                   filecode of USL or 1024. Formal designator is RPGUSL.20366000
                   If this parameter is specified, it must indicate a   20368000
                   file previously created in one of four ways:         20370000
                                                                        20372000
                   1.  By saving a USL file, with the MPE :SAVE command,20374000
                       created by a previous compilation where the      20376000
                       default value was used for the <uslfile>         20378000
                       parameter.                                       20380000
                                                                        20382000
                   2.  By building the USL with the MPE Segmenter       20384000
                       -BUILDUSL command.  (See the MPE Segmenter       20386000
                       Reference Manual.)                               20388000
                                                                        20390000
                   3.  By creating a new USL file with the MPE :BUILD   20392000
                       command with a <filecode> of USL or 1024.        20394000
                                                                        20396000
                   4.  By specifying a non-existent <uslfile> parameter,20398000
                       thereby creating a permanent file of the correct 20400000
                       size and type.                                   20402000
                                                                        20404000
                   Default is $NEWPASS is assigned.                     20406000
                                                                        20408000
listfile           Actual designator of file on which program listing is20410000
                   written.  Can be any ASCII output file.  Formal      20412000
                   designator is RPGLIST.  Default is $STDLIST.         20414000
                                                                        20416000
masterfile         Actual designator of master file to be merged against20418000
                   <textfile> to produce composite source. Can be any   20420000
                   ASCII input file.  Formal designator is RPGMAST.     20422000
                   Default is master file is not read, input is read    20424000
                   from <textfile>.                                     20426000
                                                                        20428000
newfile            Actual designator of merged <textfile> and           20430000
                   <masterfile>.  Can be any ASCII output file. Formal  20432000
                   designator is RPGNEW.  Default is no file is written.20434000
                                                                        20436000
                                 NOTE                                   20438000
                                                                        20440000
      The formal file designators used in this command                  20442000
      (RPGTEXT, RPGUSL, RPGLIST, RPGMAST, RPGNEW)                       20444000
      cannot be back referenced as actual file designators              20446000
      in the command parameter list.  For further information,          20448000
      see the discussion of implied :FILE commands in                   20450000
      Section VII of the MPE Commands Reference Manual.                 20452000
                                                                        20454000
\ITEM=OPERATION                                                         20456000
OPERATION                                                               20458000
                                                                        20460000
Compiles RPG program onto a User Subprogram Library (USL) file on disc. 20462000
If you do not specify <textfile>, MPE expects input from your current   20464000
job input device.  If the USL file is created prior to compilation, it  20466000
must have a <filecode> of USL or 1024.                                  20468000
                                                                        20470000
\ITEM=EXAMPLE                                                           20472000
EXAMPLE                                                                 20474000
                                                                        20476000
To compile an RPG program entered from the current input device into an 20478000
object program in the USL file $NEWPASS, and write the listing to the   20480000
current list device, enter:                                             20482000
                                                                        20484000
    :RPG                                                                20486000
                                                                        20488000
If the next command is one to prepare an object program, $NEWPASS can be20490000
passed to that command by referencing $OLDPASS.                         20492000
                                                                        20494000
To compile an RPG program residing on the disc file SOURCE into an      20496000
object program on the USL file OBJECT, with the program listing sent to 20498000
the disc file LISTFL, enter:                                            20500000
                                                                        20502000
    :BUILD OBJECT;CODE=USL                                              20504000
    :RPG SOURCE,OBJECT,LISTFL                                           20506000
                                                                        20508000
                                                                        20510000
\ENTRY=RPGGO,PARMS,OPERATION,EXAMPLE                                    20512000
    :RPGGO                                                              20514000
                                                                        20516000
Compiles, prepares, and executes an RPG program.                        20518000
                                                                        20520000
SYNTAX                                                                  20522000
                                                                        20524000
    :RPGGO [textfile][,[listfile][,[masterfile][,newfile]]]             20526000
                                                                        20528000
\ITEM=PARMS                                                             20530000
PARAMETERS                                                              20532000
                                                                        20534000
textfile           Actual designator of input file from which source    20536000
                   program is read.  Can be any ASCII input file. Formal20538000
                   designator is RPGTEXT.  Default is $STDIN.           20540000
                                                                        20542000
listfile           Actual designator of file on which program listing is20544000
                   written.  Can be any ASCII output file.  Formal      20546000
                   designator is RPGLIST.  Default is $STDLIST.         20548000
                                                                        20550000
masterfile         Actual designator of master file which is merged     20552000
                   against <textfile> to produce composite source. Can  20554000
                   be any ASCII input file. Formal designator is        20556000
                   RPGLIST. If masterfille is not designated,           20558000
                   input is read from textfile.                         20560000
                                                                        20562000
newfile            Actual designator fo merged <textfile> and           20564000
                   <masterfile>.  Can be any ASCII output file. Formal  20566000
                   designator is RPGNEW. Default is that no file        20568000
                   is written.                                          20570000
                                                                        20572000
                              NOTE                                      20574000
                                                                        20576000
      The formal file designators used in this command                  20578000
      (RPGTEXT, RPGLIST, RPGMAST, RPGNEW)                               20580000
      cannot be back referenced as actual file designators              20582000
      in the command parameter list.  For further information,          20584000
      see the discussion of implied :FILE commands in                   20586000
      Section VII of the MPE Commands Reference Manual.                 20588000
                                                                        20590000
\ITEM=OPERATION                                                         20592000
OPERATION                                                               20594000
                                                                        20596000
Compiles, prepares, and executes an RPG program.  If you do not specify 20598000
a source file, MPE expects input from your current input device.  This  20600000
command creates a temporary User Subprogram Library (USL) file          20602000
($NEWPASS) that you cannot access, and a temporary program file that you20604000
can access under the name $OLDPASS.                                     20606000
                                                                        20608000
\ITEM=EXAMPLE                                                           20610000
EXAMPLE                                                                 20612000
                                                                        20614000
To compile, prepare, and execute an RPG program entered from the current20616000
input device, with the program listing sent to your current list device,20618000
enter:                                                                  20620000
                                                                        20622000
    :RPGGO                                                              20624000
                                                                        20626000
To compile, prepare, and execute an RPG program read from the disc file 20628000
SOURCE and send the resulting program listing to the disc file LISTFL,  20630000
enter:                                                                  20632000
                                                                        20634000
    :RPGGO SOURCE,LISTFL                                                20636000
\ENTRY=RPGPREP,PARMS,OPERATION,EXAMPLE                                  20638000
    :RPGPREP                                                            20640000
                                                                        20642000
Compiles and prepares an RPG program.                                   20644000
                                                                        20646000
SYNTAX                                                                  20648000
                                                                        20650000
 :RPGPREP [textfile][,[progfile][,[listfile][,masterfile][,newfile]]]]  20652000
                                                                        20654000
\ITEM=PARMS                                                             20656000
PARAMETERS                                                              20658000
                                                                        20660000
textfile           Actual designator of input file from which source    20662000
                   program is read.  Can be any ASCII input file. Formal20664000
                   designator is RPGTEXT.  Default is $STDIN.           20666000
                                                                        20668000
progfile           Actual designator of program file on which prepared  20670000
                   program segments are written.  Can be any binary     20672000
                   input file with <filecode> of PROG or 1029.  If      20674000
                   entered, this parameter must indicate a file created 20676000
                   in one of two ways:                                  20678000
                                                                        20680000
                   1.  By creating a new program file with the MPE      20682000
                       :BUILD command with a <filecode> of PROG or 1029 20684000
                       and a numextents parameter value of 1.           20686000
                                                                        20688000
                   2.  By specifying a non-existent file in the         20690000
                       <progfile> parameter, in which case a job session20692000
                       temporary file of the correct size and type is   20694000
                       created.                                         20696000
                                                                        20698000
                   Default is $NEWPASS is assigned.                     20700000
                                                                        20702000
listfile           Actual designator of file on which program listing is20704000
                   written.  Can be any ASCII output file.  Formal      20706000
                   designator is RPGLIST.  Default is $STDLIST.         20708000
                                                                        20710000
masterfile         Actual designator of master file which is merged     20712000
                   against <textfile> to produce composite source.  Can 20714000
                   be any ASCII input file.  Formal designator is       20716000
                   RPGMAST.  Default is master file is not read, input  20718000
                   is read from <textfile>.                             20720000
                                                                        20722000
newfile            Actual designator of merged <textfile> and           20724000
                   <masterfile>.  Can be any ASCII output file. Formal  20726000
                   designator is RPGNEW.  Default is no file is written.20728000
                                                                        20730000
                             NOTE                                       20732000
                                                                        20734000
      The formal file designators used in this command                  20736000
      (RPGTEXT, RPGPROG, RPGLIST, RPGMAST, RPGNEW)                      20738000
      cannot be back referenced as actual file designators              20740000
      in the command parameter list.  For further information,          20742000
      see the discussion of implied :FILE commands in                   20744000
      Section VII of the MPE Commands Reference Manual.                 20746000
                                                                        20748000
\ITEM=OPERATION                                                         20750000
OPERATION                                                               20752000
                                                                        20754000
Compiles and prepares an RPG program onto a program file on disc.  If   20756000
you do not specify a source file, MPE expects input from your current   20758000
input device.  The User Subprogram Library (USL) file created during    20760000
compilation is a temporary file passed to the preparation mechanism; you20762000
can access it with the name $OLDPASS only if the program file is not    20764000
$NEWPASS.                                                               20766000
                                                                        20768000
\ITEM=EXAMPLE                                                           20770000
EXAMPLE                                                                 20772000
                                                                        20774000
To compile and prepare an RPG program entered through the current input 20776000
device, onto the file $NEWPASS, with the listing printed on the current 20778000
list device, enter:                                                     20780000
                                                                        20782000
    :RPGPREP                                                            20784000
                                                                        20786000
If the next command is one to execute the program, the file $NEWPASS is 20788000
referenced in the execute command under the name $OLDPASS.              20790000
                                                                        20792000
To compile and prepare an RPG program input from a source file named    20794000
SFILE into a program file named MYPROG, with the resulting listing sent 20796000
to the current list device, enter:                                      20798000
                                                                        20800000
    :RPGPREP SFILE,MYPROG                                               20802000
    :SAVE MYPROG                                                        20804000
                                                                        20806000
                                                                        20808000
\ENTRY=RUN,PARMS,OPERATION,EXAMPLE                                      20810000
    :RUN                                                                20812000
                                                                        20814000
Executes a prepared program.                                            20816000
                                                                        20818000
SYNTAX                                                                  20820000
                                                                        20822000
    :RUN progfile[,entrypoint]                                          20824000
                                                                        20826000
         [;NOPRIV]                                                      20828000
         [;LMAP]                                                        20830000
         [;DEBUG]                                                       20832000
         [;MAXDATA=segsize]                                             20834000
         [;PARM=parameternum]                                           20836000
         [;STACK=stacksize]                                             20838000
         [;DL=dlsize]                                                   20840000
                                                                        20842000
                 G                                                      20844000
         [;LIB={ P }]                                                   20846000
                 S                                                      20848000
                                                                        20850000
         [;NOCB]                                                        20852000
         [;INFO=quotedstring]                                           20854000
                                                                        20856000
                 [$NULL              ]]                                 20858000
         [;STDIN=[*formaldesignator  ]]                                 20860000
                 [filereference      ]]                                 20862000
                                                                        20864000
                   [$NULL              ]]                               20866000
         [;STDLIST=[*formaldesignator  ]]                               20868000
                   [filereference[,NEW]]]                               20870000
                                                                        20872000
\ITEM=PARMS                                                             20874000
PARAMETERS                                                              20876000
                                                                        20878000
progfile           Actual designator of program file that contains      20880000
                   prepared program.  (REQUIRED PARAMETER)              20882000
                                                                        20884000
entrypoint         Program entry point where execution is to begin. May 20886000
                   be primary entry point of program or any secondary   20888000
                   entry point in program's outer block. Default is     20890000
                   primary entry point.                                 20892000
                                                                        20894000
NOPRIV             Declaration that program segments will be placed in  20896000
                   non-privileged (user) mode.  This parameter is       20898000
                   intended for programs prepared with privileged mode  20900000
                   capability.  Normally, programs containing privileged20902000
                   instructions are executed in privileged mode only if 20904000
                   program was prepared with privileged mode (PM)       20906000
                   capability class.  (A program containing legally     20908000
                   compiled privileged code, placed in non-privileged   20910000
                   mode, may abort when an attempt is made to execute   20912000
                   it.)  If NOPRIV is specified in the :RUN command, all20914000
                   program segments are placed in non-privileged mode.  20916000
                   (Library segments are not affected because their mode20918000
                   is determined independently.)                        20920000
                                                                        20922000
                   Note that NOPRIV produces the same effect as omitting20924000
                   the $OPTION PRIVILEGED and OPTION PRIVILEGED entries 20926000
                   in SPL source input. Default is privileged mode      20928000
                   programs will remain in privileged mode.             20930000
                                                                        20932000
LMAP               Request to produce a descriptive listing of the      20934000
                   allocated (loaded) program on file whose formal      20936000
                   designator is LOADLIST.  If no :FILE command is found20938000
                   that references LOADLIST, listing is sent to         20940000
                   $STDLIST.  Default is no listing.                    20942000
                                                                        20944000
DEBUG              Request to issue a Debug call before the first       20946000
                   executable instruction of the program.  This         20948000
                   parameter is ignored when a non-privileged user runs 20950000
                   a program having privileged mode capability. This    20952000
                   parameter also is ignored if user does not have read 20954000
                   and write access to program file.  Default is debug  20956000
                   call is not issued.                                  20958000
                                                                        20960000
segsize            Maximum stack area (Z-DL) size permitted, in words.  20962000
                   This parameter is included if it is expected that    20964000
                   size of DL-DB or Z-DB areas will be changed during   20966000
                   program execution. Default is MPE assumes areas will 20968000
                   not be changed.                                      20970000
                                                                        20972000
parameternum       Value that can be passed to program as a general     20974000
                   parameter for control or other purposes.  When       20976000
                   program is executed, this value can be retrieved from20978000
                   address Q(initial)-4, where Q(initial) is Q address  20980000
                   for outer block of program.  Value can be octal      20982000
                   number or signed or unsigned decimal number. Default 20984000
                   is Q(initial)-4 address is filled with zeros.        20986000
                                                                        20988000
stacksize          Size of initial local data area (Z-Q(initial)) in    20990000
                   stack.  This value must exceed 511 words, and        20992000
                   overrides <stacksize> estimated by MPE Segmenter.    20994000
                   Default is estimated by Segmenter.                   20996000
                                                                        20998000
dlsize             DL-DB area to be initially assigned to stack. This   21000000
                   area is of interest mainly in programmatic           21002000
                   applications.  In all cases, the DL-DB area is       21004000
                   rounded upward so that the distance from the         21006000
                   beginning of the stack data segment to the DB address21008000
                   is a multiple of 128 words.  Default is estimated by 21010000
                   Segmenter.                                           21012000
                                                                        21014000
G                  Search segmented procedure libraries to satisfy      21016000
                   external references during allocation in the         21018000
                   following order:  group library, account public      21020000
                   library, system library.  Default is S.              21022000
                                                                        21024000
P                  Search segmented procedure libraries to satisfy      21026000
                   external references during allocation in the         21028000
                   following order:   account public                    21030000
                   library, system library.  Default is S.              21032000
                                                                        21034000
S                  Search system library only to satisfy external       21036000
                   references during allocation.  Default.              21038000
                                                                        21040000
NOCB               Request that file system not use stack segment (PCBX)21042000
                   for its control blocks, even if sufficient space is  21044000
                   available.  This permits expansion of the stack (with21046000
                   the DLSIZE and ZSIZE intrinsics) to the maximum      21048000
                   possible limit at a later time, but causes the File  21050000
                   Management System to operate more slowly for this    21052000
                   program.                                             21054000
                                                                        21056000
quotedstring       A string of ASCII characters delimited by a matching 21058000
                   set of either 's or "s.  If the delimiting character 21060000
                   is desired within the string, it can be doubled as   21062000
                   in most programming languages.  This value can be    21064000
                   retrieved from address Q(initial-6) and Q(initial-5),21066000
                   where Q(initial-6) contains the string length and    21068000
                   Q(initial-5) is byte pointer to the string.  Default 21070000
                   is no string passed (Q-6 and Q-5 are equal to zero). 21072000
                                                                        21074000
STDIN              Allow the $STDIN for the created process to be       21076000
                   other than the default of the $STDIN of its father.  21078000
                                                                        21080000
STDLIST            Allow the $STDLIST for the created process to be     21082000
                   other than the default of the $STDLIST of its father.21084000
                                                                        21086000
$NULL              ALLOWS THE SETTING OF $STDIN OR $STDLIST TO BE THE   21088000
                   system designator $NULL.                             21090000
                                                                        21092000
filereference      Allows the setting of $STDIN or $STDLIST             21094000
                   to an old permanent disc file.  If NEW is specified  21096000
                   with STDLIST, then it is set to a job/session        21098000
                   temporary file with system defaults.                 21100000
                                                                        21102000
formaldesignator   Allows the setting of $STDIN or $STDLIST             21104000
                   to the formal file designator for a file previously  21106000
                   specified in a file equation.                        21108000
                                                                        21110000
\ITEM=OPERATION                                                         21112000
OPERATION                                                               21114000
                                                                        21116000
Executes a program prepared in a program file.  This command permits    21118000
searching of segmented libraries (SL's) but not relocatable libraries   21120000
(RL's) to satisfy external references.                                  21122000
                                                                        21124000
If the volume set containing the file to be run is not mounted, this    21126000
command implicitly causes that volume set to be mounted.                21128000
                                                                        21130000
\ITEM=EXAMPLE                                                           21132000
EXAMPLE                                                                 21134000
                                                                        21136000
To run a program stored in the program file PROG3, enter:               21138000
                                                                        21140000
    :RUN PROG3                                                          21142000
                                                                        21144000
To run a program stored in the program file PROG4, beginning at the     21146000
entry point SECLAB, enter:                                              21148000
                                                                        21150000
    :RUN PROG4,SECLAB                                                   21152000
                                                                        21154000
                                                                        21156000
\ENTRY=SAVE,PARMS,OPERATION,EXAMPLE                                     21158000
    :SAVE                                                               21160000
                                                                        21162000
Saves file in system file domain.                                       21164000
                                                                        21166000
SYNTAX                                                                  21168000
                                                                        21170000
            $OLDPASS,newfilereference                                   21172000
    :SAVE {                           }                                 21174000
            tempfilereference                                           21176000
                                                                        21178000
\ITEM=PARMS                                                             21180000
PARAMETERS                                                              21182000
                                                                        21184000
$OLDPASS               FILE CURRENTLY BEING PASSED.  AFTER THIS FILE IS 21186000
                       saved, no file in the job/session temporary file 21188000
                       domain can be referenced by the name $OLDPASS.   21190000
                                                                        21192000
newfilereference       New actual file designator to be assigned        21194000
                       $OLDPASS when it is made permanent, written in   21196000
                       the format:                                      21198000
                                                                        21200000
                       filename[/lockword][.groupname][.acctname]       21202000
                                                                        21204000
                                                                        21206000
                       If <acctname> is used, this must indicate the    21208000
                       logon account.  If <groupname> is used, this     21210000
                       must indicate a group to which you have SAVE     21212000
                       access, as defined by your Account Manager.  If  21214000
                       <groupname> is omitted, logon group is assigned. 21216000
                       <newfilereference> is required as a parameter if 21218000
                       $OLDPASS is used.                                21220000
                                                                        21222000
tempfilereference      Actual designator of temporary file to be made   21224000
                       permanent under the same designator. The file is 21226000
                       deleted from job/session temporary file domain   21228000
                       and entered in system file domain.  This         21230000
                       parameter is written in the format:              21232000
                                                                        21234000
                       filename[/lockword][.groupname][.acctname]       21236000
                                                                        21238000
                       If <acctname> is used, this must indicate the    21240000
                       logon account.  If <groupname> is used, this     21242000
                       must indicate a group to which you have SAVE     21244000
                       access, as defined by your Account Manager.  If  21246000
                       <groupname> is omitted, logon group is assigned. 21248000
                       <newfilereference> is required as a parameter if 21250000
                       $OLDPASS is used.                                21252000
                                                                        21254000
\ITEM=OPERATION                                                         21256000
OPERATION                                                               21258000
                                                                        21260000
Saves temporary file currently in temporary file domain by converting it21262000
to permanent file in system file domain.  Frequently used to save       21264000
temporary $OLDPASS files produced by compilation or preparation.        21266000
                                                                        21268000
The volume set must be mounted for the group in which the file is to be 21270000
saved or this command will fail  (i.e., a file cannot be saved across   21272000
volume sets).                                                           21274000
                                                                        21276000
This command applies only to temporary files on disc.                   21278000
                                                                        21280000
\ITEM=EXAMPLE                                                           21282000
EXAMPLE                                                                 21284000
                                                                        21286000
To save the temporary file $OLDPASS, containing an object program, onto 21288000
the program file PROGFILE, enter:                                       21290000
                                                                        21292000
    :SAVE $OLDPASS,PROGFILE                                             21294000
                                                                        21296000
To save the temporary file TEMPFL as a permanent file of the same name, 21298000
enter:                                                                  21300000
                                                                        21302000
    :SAVE TEMPFL                                                        21304000
                                                                        21306000
                                                                        21308000
\ENTRY=SECURE,PARMS,OPERATION,EXAMPLE                                   21310000
    :SECURE                                                             21312000
                                                                        21314000
Restores security provisions for a file that were suspended by a        21316000
:RELEASE command.                                                       21318000
                                                                        21320000
SYNTAX                                                                  21322000
                                                                        21324000
    :SECURE {filereference}                                             21326000
                                                                        21328000
\ITEM=PARMS                                                             21330000
PARAMETERS                                                              21332000
                                                                        21334000
filereference        Actual designator of the disc file whose security  21336000
                     provisions are to be restored, written in the      21338000
                     format:                                            21340000
                                                                        21342000
                     filename[/lockword][.groupname][.acctname]         21344000
                                                                        21346000
                     (REQUIRED PARAMETER)                               21348000
                                                                        21350000
\ITEM=OPERATION                                                         21352000
OPERATION                                                               21354000
                                                                        21356000
Restores all security provisions for a file that were suspended         21358000
previously by a :RELEASE command in this or another job.                21360000
                                                                        21362000
This command can be used only for a permanent disc file whose file label21364000
identifies the user as the creator of that file.  In addition, the      21366000
:SECURE command will fail if the group's home volume set is not mounted.21368000
When the normal (default) MPE security provisions are in effect, the    21370000
file must belong to the logon account and group.                        21372000
                                                                        21374000
\ITEM=EXAMPLE                                                           21376000
EXAMPLE                                                                 21378000
                                                                        21380000
To restore the security provisions previously in effect for the file    21382000
named FILE1, enter:                                                     21384000
                                                                        21386000
    :SECURE FILE1                                                       21388000
                                                                        21390000
                                                                        21392000
\ENTRY=SEGMENTER,PARMS,OPERATION,EXAMPLE                                21394000
    :SEGMENTER                                                          21396000
                                                                        21398000
Calls MPE Segmenter.                                                    21400000
                                                                        21402000
SYNTAX                                                                  21404000
                                                                        21406000
    :SEGMENTER [listfile]                                               21408000
                                                                        21410000
\ITEM=PARMS                                                             21412000
PARAMETERS                                                              21414000
                                                                        21416000
listfile         Actual designator of file to receive listable output   21418000
                 from Segmenter.  Can be any ASCII output file. Formal  21420000
                 designator is SEGLIST.  Because this file usually is a 21422000
                 line printer, it is defined in a :FILE command and     21424000
                 back referenced as follows:                            21426000
                                                                        21428000
                 :FILE LISTFL;DEV=LP                                    21430000
                 :SEGMENTER *LISTFL                                     21432000
                                                                        21434000
                 Default is $STDLIST.                                   21436000
                                                                        21438000
                                 NOTE                                   21440000
                                                                        21442000
      The formal file designators used in this command                  21444000
      (SEGLIST)                                                         21446000
      cannot be back referenced as actual file designators              21448000
      in the command parameter list.  For further information,          21450000
      see the discussion of implied :FILE commands in                   21452000
      Section VII of the MPE Commands Reference Manual.                 21454000
                                                                        21456000
\ITEM=OPERATION                                                         21458000
OPERATION                                                               21460000
                                                                        21462000
Calls MPE Segmenter.                                                    21464000
                                                                        21466000
\ITEM=EXAMPLE                                                           21468000
EXAMPLE                                                                 21470000
                                                                        21472000
To call the Segmenter from a session and transmit the listable output to21474000
a line printer instead of the current list device, enter:               21476000
                                                                        21478000
    :FILE LISTFL;DEV=LP                                                 21480000
    :SEGMENTER *LISTFL                                                  21482000
                                                                        21484000
                           NOTE                                         21486000
                                                                        21488000
           To use a Relocatable Library (RL) via                        21490000
           the :SEGMENTER command, the user is                          21492000
           required to have READ and LOCK                               21494000
           capability.                                                  21496000
                                                                        21498000
                                                                        21500000
\ENTRY=SET                                                              21502000
    :SET                                                                21504000
                                                                        21506000
Allows a job or a session to manipulate its environment in              21508000
various ways depending on the option specified.                         21510000
                                                                        21512000
SYNTAX                                                                  21514000
                                                                        21516000
    :SET option [; option [; ...]]                                      21518000
                                                                        21520000
         Where option=                                                  21522000
                                                                        21524000
                       STDLIST = {SAVE|DELETE}                          21526000
NOTE                                                                    21528000
                                                                        21530000
Whenever the command string contains multiple commands, the             21532000
commands are parsed and executed left to right, one at a time.          21534000
There is no check for redundancy or commands that will                  21536000
overide those previous.                                                 21538000
                                                                        21540000
\ITEM=PARMS                                                             21542000
PARAMETERS                                                              21544000
                                                                        21546000
                                                                        21548000
option                                                                  21550000
                                                                        21552000
      STDLIST = {SAVE|DELETE}                                           21554000
                                                                        21556000
        where                                                           21558000
                                                                        21560000
            SAVE       Cancels the effect of a previous                 21562000
                       SET STDLIST=DELETE.                              21564000
                                                                        21566000
            DELETE     Flags the job's STDLIST for deletion at          21568000
                       job termination.                                 21570000
                                                                        21572000
\ITEM=STDLIST                                                           21574000
STDLIST OPERATION                                                       21576000
                                                                        21578000
    This option will allow a job to mark its $STDLIST for               21580000
    deletion upon job termination.  Only jobs with a spooled            21582000
    $STDLIST will be allowed to use this option.                        21584000
                                                                        21586000
STDLIST EXAMPLE                                                         21588000
                                                                        21590000
    !JOB EXAMPLE, MARIE.OSE,WESTON                                      21592000
    !CONTINUE                                                           21594000
    !RUN UPDATE.PUB.SYS;PARM=1;MAXDATA=16000                            21596000
    !IF JCW < FATAL THEN                                                21598000
    !  SET STDLIST=DELETE                                               21600000
    !ENDIF                                                              21602000
    !EOJ                                                                21604000
                                                                        21606000
                                                                        21608000
\ENTRY=SETCATALOG,PARMS,OPERATION,EXAMPLE                               21610000
    :SETCATALOG                                                         21612000
                                                                        21614000
Causes the Command Interpreter to search a catalog of user-defined      21616000
commands and to establish a directory entry for each command            21618000
in the catalog.                                                         21620000
                                                                        21622000
SYNTAX                                                                  21624000
                                                                        21626000
    :SETCATALOG [catfilename[,catfilename[,...[,catfilename]]]][;SHOW]  21628000
                [;ACCOUNT] [;SYSTEM]                                    21630000
                                                                        21632000
\ITEM=PARMS                                                             21634000
PARAMETERS                                                              21636000
                                                                        21638000
catfilename      Catalog file name.                                     21640000
                 Normally, this file would be prepared using the Editor.21642000
                 When more than one user-defined command resides in the 21644000
                 catalog file, each command must be separated from its  21646000
                 neighbors by one or more lines and the first character 21648000
                 of each command must be an asterisk (*).               21650000
                                                                        21652000
SHOW             Lists catalogs and UDC's as user-defined commands are  21654000
                 initialized.  This parameter is useful for additional  21656000
                 information if there is an error in UDC initialization.21658000
                 SHOW lists each UDC as it is checked.  If an error     21660000
                 occurs, it is listed after the erroneous UDC.          21662000
                                                                        21664000
ACCOUNT          Specifies that the catalog file being defined or       21666000
                 reset is at the account level.  Requires AM            21668000
                 capability.                                            21670000
                                                                        21672000
SYSTEM           Specifies that the catalog file being defined or       21674000
                 reset is at the system level.  Requires SM             21676000
                 capability.                                            21678000
\ITEM=OPERATION                                                         21680000
OPERATION                                                               21682000
                                                                        21684000
The :SETCATALOG command causes the Command Interpreter to search a      21686000
specially-prepared disc file for user-defined commands.  The Command    21688000
Interpreter then establishes a directory entry for each                 21690000
command in the file.                                                    21692000
                                                                        21694000
                                                                        21696000
\ITEM=EXAMPLE                                                           21698000
EXAMPLE                                                                 21700000
                                                                        21702000
To create a user-defined command (UDC) and have the Command Interpreter 21704000
establish a directory entry for it in the file MYCMNDS, enter:          21706000
                                                                        21708000
    :EDITOR                                                             21710000
                                                                        21712000
    /ADD                                                                21714000
        1  S                   (UDC name)                               21716000
        2  SHOWJOB             (MPE command)                            21718000
        3  **                  (Separates UDC's)                        21720000
        4  R                   (UDC name)                               21722000
        5  RESUME              (MPE command)                            21724000
        6  //                                                           21726000
    /KEEP MYCMNDS                                                       21728000
    /END                                                                21730000
                                                                        21732000
    :SETCATALOG MYCMNDS                                                 21734000
                                                                        21736000
Thus, S and R are established as user-defined commands.  If you enter   21738000
S, the :SHOWJOB MPE command will execute; if you enter R, :RESUME will  21740000
execute.                                                                21742000
                                                                        21744000
Example for altering catalog:                                           21746000
                                                                        21748000
    :SETCATALOG         (Closes existing UDC file)                      21750000
    :EDITOR                                                             21752000
                                                                        21754000
     /TEXT MYCMNDS                                                      21756000
     /ADD                                                               21758000
        6  **                                                           21760000
        7  E                                                            21762000
        8  EDITOR                                                       21764000
        9  //                                                           21766000
     /KEEP MYCMNDS                                                      21768000
     /END                                                               21770000
                                                                        21772000
    :SETCATALOG MYCMNDS                                                 21774000
                                                                        21776000
                                                                        21778000
\ENTRY=SETDUMP,PARMS,OPERATION,EXAMPLE                                  21780000
    :SETDUMP                                                            21782000
                                                                        21784000
Enables Stackdump facility on abort.                                    21786000
                                                                        21788000
SYNTAX                                                                  21790000
                                                                        21792000
                DB [,ST] [,QS]                                          21794000
    :SETDUMP [{ ST [,DB]       } [;ASCII]]                              21796000
                QS [,DB]                                                21798000
                                                                        21800000
\ITEM=PARMS                                                             21802000
PARAMETERS                                                              21804000
                                                                        21806000
DB            Dump memory from DL to Q(initial) address. Default is     21808000
              settings of all registers at time of abort and stack      21810000
              marker trace are displayed.                               21812000
                                                                        21814000
ST            Dump memory from Q(initial) to S address. Default is      21816000
              settings of all registers at time of abort and stack      21818000
              marker trace are displayed.                               21820000
                                                                        21822000
QS            Dump memory from Q-63 to S address.  This parameter is    21824000
              ignored if ST parameter is used.  Default is settings of  21826000
              all registers at time of abort and stack marker trace are 21828000
              displayed.                                                21830000
                                                                        21832000
ASCII         Display ASCII conversion of octal values requested by DB, 21834000
              ST, or QS parameters (along with octal display).  Default 21836000
              is octal.                                                 21838000
                                                                        21840000
\ITEM=OPERATION                                                         21842000
OPERATION                                                               21844000
                                                                        21846000
Arms Stackdump Facility as described in the MPE Debug/Stackdump         21848000
Reference Manual.                                                       21850000
                                                                        21852000
In an interactive session, all parameters of the :SETDUMP command are   21854000
ignored and the only effect is the arming of the Stackdump Facility in  21856000
order for the process to call Debug if an abort occurs.                 21858000
                                                                        21860000
\ITEM=EXAMPLE                                                           21862000
EXAMPLE                                                                 21864000
                                                                        21866000
To arm the Stackdump Facility to display the memory area from the       21868000
Q(initial) to S address, with accompanying ASCII convers of the octal   21870000
data, enter:                                                            21872000
                                                                        21874000
    :SETDUMP ST;ASCII                                                   21876000
                                                                        21878000
                                                                        21880000
\ENTRY=SETJCW,PARMS,OPERATION,EXAMPLE                                   21882000
    :SETJCW                                                             21884000
                                                                        21886000
Scans JCW table for a specified JCW name and updates the value of this  21888000
JCW.                                                                    21890000
                                                                        21892000
SYNTAX                                                                  21894000
                                                                        21896000
    :SETJCW jcwname char value [ {+|-} value ]                          21898000
                                                                        21900000
\ITEM=PARMS                                                             21902000
PARAMETERS                                                              21904000
                                                                        21906000
jcwname      The name of a Job Control Word (JCW).  If jcwname is that  21908000
             of an existing JCW, the JCW table is scanned for this name.21910000
             If a name matching jcwname is not found in the JCW table,  21912000
             jcwname is added to the table.  Each job/session has       21914000
             two predefined job control words, JCW and CIERROR.         21916000
             A valid jcwname must start with an alphabetic character    21918000
             and cannot be a valid jcwvalue i.e. FATAL4,SYSTEM,OK2345   21920000
             and WARN56 are all examples of jcw values and therefore    21922000
             are not allowed as jcwnames.                               21924000
                                                                        21926000
char         Any special character except % and -, used as a delimeter. 21928000
                                                                        21930000
value        One of the following:                                      21932000
                                                                        21934000
             1.  Octal number between 0 and %177777.                    21936000
                                                                        21938000
             2.  Decimal number between 0 and 65535.                    21940000
                                                                        21942000
             3.  A name which has been defined as being equivalent to   21944000
                 certain numeric values, as follows:                    21946000
                                                                        21948000
                 OK    = 0                                              21950000
                 OK1   = OK + 1 = 1                                     21952000
                 OK100 = OK + 100 = 100 = %144                          21954000
                                                                        21956000
                 WARN    = 16384 = %40000 (= OK16384)                   21958000
                 WARN100 = WARN + 100 = 16484 = %40144                  21960000
                                                                        21962000
                 FATAL   = 32768 = %100000 (= WARN16384 = OK32768)      21964000
                 FATAL85 = FATAL + 85 = 32853 = %100125                 21966000
                                                                        21968000
                 SYSTEM    = 49152 = %140000                            21970000
                 SYSTEM200 = SYSTEM + 200 = 49352 = %140310             21972000
                                                                        21974000
             4.  The name of an existing JCW.                           21976000
                                                                        21978000
\ITEM=OPERATION                                                         21980000
OPERATION                                                               21982000
                                                                        21984000
The :SETJCW command scans the JCW table for a specified jcwname.  If    21986000
found, jcwname is set equal to the value passed with :SETJCW.  If       21988000
jcwname is not found, it is inserted in the JCW table.                  21990000
                                                                        21992000
\ITEM=EXAMPLE                                                           21994000
EXAMPLE                                                                 21996000
                                                                        21998000
To set the Job Control Word CURR1 to                                    22000000
100, enter:                                                             22002000
                                                                        22004000
    :SETJCW CURR1,100                                                   22006000
                                                                        22008000
To set CURR1 to WARN, enter:                                            22010000
                                                                        22012000
    :SETJCW CURR1/WARN                                                  22014000
                                                                        22016000
To set CURR1 to CURR1 plus 512, enter:                                  22018000
                                                                        22020000
    :SETJCW CURR1=CURR1+512                                             22022000
                                                                        22024000
                                                                        22026000
\ENTRY=SETMSG,PARMS,OPERATION,EXAMPLE                                   22028000
    :SETMSG                                                             22030000
                                                                        22032000
Disables or re-enables receipt of user or operator messages at standard 22034000
list device.                                                            22036000
                                                                        22038000
SYNTAX                                                                  22040000
                                                                        22042000
              OFF                                                       22044000
    :SETMSG {     }                                                     22046000
              ON                                                        22048000
                                                                        22050000
\ITEM=PARMS                                                             22052000
PARAMETERS                                                              22054000
                                                                        22056000
OFF        Sets job or session to refuse :TELL command messages from    22058000
           other users.                                                 22060000
                                                                        22062000
ON         Re-enables message operation.                                22064000
                                                                        22066000
\ITEM=OPERATION                                                         22068000
OPERATION                                                               22070000
                                                                        22072000
Allows job or session to run in quiet mode, such that :TELL messages    22074000
from other users are refused. :WARN messages from the Console           22076000
Operator override quiet mode and are accepted.                          22078000
                                                                        22080000
\ITEM=EXAMPLE                                                           22082000
EXAMPLE                                                                 22084000
                                                                        22086000
To prevent messages, enter:                                             22088000
                                                                        22090000
    :SETMSG OFF                                                         22092000
                                                                        22094000
To re-enable message reception, enter:                                  22096000
                                                                        22098000
    :SETMSG ON                                                          22100000
                                                                        22102000
                                                                        22104000
\ENTRY=SHOWALLOW,PARMS,OPERATION,EXAMPLE                                22106000
    :SHOWALLOW                                                          22108000
                                                                        22110000
Shows which operator commands have been ALLOWed to which                22112000
users.  (See also :ALLOW.)                                              22114000
                                                                        22116000
SYNTAX                                                                  22118000
                                                                        22120000
                 username     acctname                                  22122000
    :SHOWALLOW [{        } . {        }]                                22124000
                     @            @                                     22126000
                                                                        22128000
\ITEM=PARMS                                                             22130000
PARAMETERS                                                              22132000
                                                                        22134000
username            a specific user                                     22136000
                                                                        22138000
acctname            a specific account                                  22140000
                                                                        22142000
@                   all users when used to the left of the              22144000
                    period (.); all accounts when used to               22146000
                    the right of the period                             22148000
                                                                        22150000
\ITEM=OPERATION                                                         22152000
                                                                        22154000
OPERATION                                                               22156000
                                                                        22158000
This command will display which operator commands have been             22160000
ALLOWed to specified users. If no parameters are specified,             22162000
then only the logged on user's ALLOWs are listed. Account               22164000
manager capability or system manager capability or master operator      22166000
status is required to specify "@" for user name and system manager      22168000
capability or master operator status is required to specify "@"         22170000
                                                                        22172000
for acctname.                                                           22174000
Additionally, after listing the ALLOWs for the specified                22176000
users, the command lists separately the operator commands               22178000
which have been globally ALLOWed. If used with no parameters,           22180000
only the ALLOWs related to the logged-on user are displayed.            22182000
                                                                        22184000
\ITEM=EXAMPLE                                                           22186000
                                                                        22188000
EXAMPLES                                                                22190000
                                                                        22192000
:SHOWALLOW @.@                                                          22194000
                                                                        22196000
MANAGER.SYS                                                             22198000
     USER HAS THE FOLLOWING COMMANDS ALLOWED:                           22200000
REPLY              ALLOW             CONSOLE                            22202000
                                                                        22204000
LARRY.MPE                                                               22206000
     USER HAS THE FOLLOWING COMMANDS ALLOWED:                           22208000
REPLY              ABORTJOB                                             22210000
                                                                        22212000
DAN.TP                                                                  22214000
     USER HAS THE FOLLOWING COMMANDS ALLOWED:                           22216000
REPLY              ABORTIO                                              22218000
                                                                        22220000
THE FOLLOWING COMMANDS HAVE BEEN GLOBALLY ALLOWED:                      22222000
REPLY                                                                   22224000
                                                                        22226000
                                                                        22228000
\ENTRY=SHOWCATALOG,PARMS,OPERATION,EXAMPLE                              22230000
    :SHOWCATALOG                                                        22232000
                                                                        22234000
Lists user-defined command (UDC) files.                                 22236000
                                                                        22238000
SYNTAX                                                                  22240000
                                                                        22242000
    :SHOWCATALOG [listfile]                                             22244000
                                                                        22246000
\ITEM=PARMS                                                             22248000
PARAMETERS                                                              22250000
                                                                        22252000
listfile         An arbitrary file name, causing the listing to be sent 22254000
                 to a line printer.  Default:  If omitted, the listing  22256000
                 is sent to $STDLIST.  If specified, the listing        22258000
                 is sent to device class LP (line printer) unless       22260000
                 directed elsewhere with a prior :FILE command.         22262000
                                                                        22264000
\ITEM=OPERATION                                                         22266000
OPERATION                                                               22268000
The :SHOWCATALOG command lists user-defined command (UDC) files         22270000
and specifies at which levels (USER, ACCOUNT, SYSTEM) the               22272000
files have been defined.                                                22274000
                                                                        22276000
                                                                        22278000
\ITEM=EXAMPLE                                                           22280000
EXAMPLE                                                                 22282000
                                                                        22284000
To list UDC files and have the listing appear on the                    22286000
standard list device, enter:                                            22288000
                                                                        22290000
    :SHOWCATALOG                                                        22292000
                                                                        22294000
To have the listing sent to the line printer, enter:                    22296000
                                                                        22298000
    :SHOWCATALOG LFILE                                                  22300000
                                                                        22302000
To have the listing sent to a tape device, enter:                       22304000
                                                                        22306000
    :FILE LFILE;DEV=TAPE                                                22308000
    :SHOWCATALOG LFILE                                                  22310000
                                                                        22312000
\ENTRY=SHOWCOM,PARMS,OPERATION,EXAMPLE                                  22314000
                                                                        22316000
     :SHOWCOM                                                           22318000
                                                                        22320000
Displays the status information about a communication device.           22322000
                                                                        22324000
SYNTAX                                                                  22326000
                                                                        22328000
     :SHOWCOM  ldn  [;ERROR;RESET]                                      22330000
                                                                        22332000
\ITEM=PARMS                                                             22334000
                                                                        22336000
PARAMETERS                                                              22338000
                                                                        22340000
ldn       The logical device number of a communication system           22342000
          device.                                                       22344000
                                                                        22346000
ERROR     A request for the full status list. If it is not              22348000
          specified, and abbreviated list is displayed.                 22350000
                                                                        22352000
RESET     A request to reset all status information to zero             22354000
          after it has been displayed.                                  22356000
                                                                        22358000
\ITEM=OPERATION                                                         22360000
                                                                        22362000
OPERATION                                                               22364000
                                                                        22366000
The status information from this command can be used to                 22368000
determine communication line activity and quality. The                  22370000
status information provided includes the:                               22372000
                                                                        22374000
o   Number of messages sent and received.                               22376000
                                                                        22378000
o   Last recoverable and irrecoverable errors.                          22380000
                                                                        22382000
o   Number of recoverable and irrecoverable errors.                     22384000
                                                                        22386000
o   Number of transmissions, response timeouts, clear to                22388000
    send losses, and underruns.                                         22390000
                                                                        22392000
o   Number of check character (BCC/CRC) errors, receive                 22394000
    timeouts, carrier losses, and overruns.                             22396000
                                                                        22398000
o   Line state (closed, connected or disconnected).                     22400000
                                                                        22402000
                                                                        22404000
                      NOTE                                              22406000
                                                                        22408000
    Clear to send losses and carrier losses will only                   22410000
    be valid for communication lines configured as                      22412000
    full duplex.                                                        22414000
                                                                        22416000
When the line is in the open state, either connected or                 22418000
disconnected, the status information displayed is a                     22420000
duplicate of the statistics generated from the last                     22422000
open of the line to the point in time the SHOWCOM                       22424000
command is invoked. When the line state is closed, the                  22426000
status information obtained at the close of the line                    22428000
reflects the statistics generated over the last                         22430000
open/close sequence.                                                    22432000
                                                                        22434000
\ITEM=EXAMPLE                                                           22436000
                                                                        22438000
EXAMPLES                                                                22440000
                                                                        22442000
To display the status of logical device 55, enter:                      22444000
                                                                        22446000
:SHOWCOM 55                                                             22448000
                                                                        22450000
                                                                        22452000
                                                                        22454000
To display the full status of logical device 55, enter:                 22456000
                                                                        22458000
:SHOWCOM 55;ERRORS                                                      22460000
                                                                        22462000
                                                                        22464000
                                                                        22466000
                      NOTE                                              22468000
                                                                        22470000
       The last irrecoverable and recoverable                           22472000
       error codes are specified in the Data                            22474000
       Communications Handbook.                                         22476000
                                                                        22478000
                                                                        22480000
\ENTRY=SHOWDEV,PARMS,OPERATION,EXAMPLE                                  22482000
    :SHOWDEV                                                            22484000
                                                                        22486000
Reports status of input/output devices.                                 22488000
                                                                        22490000
SYNTAX                                                                  22492000
                                                                        22494000
               ldev                                                     22496000
    :SHOWDEV [           ]                                              22498000
               classname                                                22500000
                                                                        22502000
\ITEM=PARMS                                                             22504000
PARAMETERS                                                              22506000
                                                                        22508000
ldev              Logical device number of device for which status      22510000
                  information is to be displayed.  Unique for each      22512000
                  individual device.  Default is if both <ldev> and     22514000
                  <classname> are omitted, status information for all   22516000
                  devices on the system is displayed.                   22518000
                                                                        22520000
classname         Device class name of device(s) for which status       22522000
                  information is to be displayed.  May apply to several 22524000
                  devices.  Default is if both <ldev> and <classname>   22526000
                  are omitted, status information for all devices on the22528000
                  system is displayed.                                  22530000
                                                                        22532000
\ITEM=OPERATION                                                         22534000
OPERATION                                                               22536000
                                                                        22538000
Displays status information for any input/output device on the system.  22540000
The following items may appear in the listing, always displayed on the  22542000
standard list device:                                                   22544000
                                                                        22546000
Logical device number.                                                  22548000
                                                                        22550000
Input type allowed:                                                     22552000
                                                                        22554000
    J   Accepts jobs.                                                   22556000
                                                                        22558000
    D   Accepts data.                                                   22560000
                                                                        22562000
    A   Accepts jobs and data.                                          22564000
                                                                        22566000
Availability:                                                           22568000
                                                                        22570000
    AVAIL     Available as a real, non-sharable device.                 22572000
                                                                        22574000
    SPOOLED   Available via input or output spooling.                   22576000
                                                                        22578000
    UNAVAIL   Not available (owned by job or session).                  22580000
                                                                        22582000
    DISC      Device is a disc, always available.                       22584000
                                                                        22586000
Device ownership (if applicable):                                       22588000
                                                                        22590000
    SYS           Owned by system.  If #nnn appears, it specifies       22592000
                  Process Identification Number (PIN) of the owning     22594000
                  process (running program).                            22596000
                                                                        22598000
    SPOOLER IN    Input spooling in effect, owned by spooler.           22600000
                                                                        22602000
    SPOOLER OUT   Output spooling in effect, owned by spooler.          22604000
                                                                        22606000
    #Jnnn         Owned by indicated job.                               22608000
                                                                        22610000
    #Snnn         Owned by indicated session.                           22612000
                                                                        22614000
    DIAG          Allocated to diagnostic testing by Console Operator   22616000
                  via :GIVE command.                                    22618000
                                                                        22620000
    nn FILES      Indicates number of extents currently in use on a     22622000
                  disc.                                                 22624000
                                                                        22626000
    DOWN          Device is offline, requested by Console Operator via  22628000
                  :DOWN command.                                        22630000
                                                                        22632000
    DP            Device is being taken offline (:DOWN command operation22634000
                  pending).                                             22636000
                                                                        22638000
Volume identification:                                                  22640000
                                                                        22642000
    IBM          The named magnetic tape volume has a label             22644000
                 written in the IBM format.                             22646000
                                                                        22648000
    ANSI         The named magnetic tape voulme has a label             22650000
                 written in the ANSI format.                            22652000
                                                                        22654000
    NOLABEL      The named magnetic tape volume has no label.           22656000
                                                                        22658000
Density Information (Only for variable density tape drives):            22660000
                                                                        22662000
    6250         Mounted tape has a density of 6250 BPI.                22664000
                                                                        22666000
    1600         Mounted tape either has a density of 1600 BPI          22668000
                 or the density of the tape is unrecognizable.          22670000
                                                                        22672000
Device association (if applicable):                                     22674000
                                                                        22676000
\STARTHELP                                                              22678000
\STARTHELP                                                              22680000
\STARTHELP                                                              22682000
    #Snnn        The indicated session the device is associated         22684000
                 under.                                                 22686000
                                                                        22688000
    deviceclass  The device class the device is asssociated             22690000
                 under.                                                 22692000
                                                                        22694000
\ITEM=EXAMPLE                                                           22696000
EXAMPLE                                                                 22698000
                                                                        22700000
To display the status of the device identified by logical device number 22702000
12, enter:                                                              22704000
                                                                        22706000
    :SHOWDEV 12                                                         22708000
                                                                        22710000
To display the status of all devices of the device class name LP, enter:22712000
                                                                        22714000
    :SHOWDEV LP                                                         22716000
                                                                        22718000
To display the status of all input/output devices on the system, enter: 22720000
                                                                        22722000
    :SHOWDEV                                                            22724000
                                                                        22726000
                                                                        22728000
\ENTRY=SHOWIN,PARMS,OPERATION,EXAMPLE                                   22730000
    :SHOWIN                                                             22732000
                                                                        22734000
Reports status of input devicefiles.                                    22736000
                                                                        22738000
SYNTAX                                                                  22740000
                                                                        22742000
              #Innn                                                     22744000
              STATUS                                                    22746000
    :SHOWIN [                    ]                                      22748000
              SP                                                        22750000
              item[;item[;item]]                                        22752000
                                                                        22754000
\ITEM=PARMS                                                             22756000
PARAMETERS                                                              22758000
                                                                        22760000
#Innn           Identifier of particular input devicefile for which     22762000
                information is to be displayed.  The information appears22764000
                in following format:                                    22766000
                                                                        22768000
DEV/CL  DFID  JOBNUM  FNAME     STATE    FRM  SPACE  RANK  PRI  #C      22770000
                                                                        22772000
45      #I25  #S16    $STDIN    OPENED                                  22774000
                                                                        22776000
                Default is MPE displays information for all input       22778000
                devicefiles used by this job.                           22780000
                                                                        22782000
STATUS          Request to summarize status information for all current 22784000
                input devicefiles.  The information appears in following22786000
                format:                                                 22788000
                                                                        22790000
                8 FILES:                                                22792000
                    0 ACTIVE                                            22794000
                    0 READY; INCL 0 SPOOFLES, 0 DEFERRED                22796000
                    8 OPENED; INCL 0 SPOOFLES                           22798000
                    0 SPOOFLES; O SECTORS                               22800000
                                                                        22802000
                Default is MPE displays information for all input       22804000
                devicefiles used by this job.                           22806000
                                                                        22808000
item            Request to display status of current input devicefiles  22810000
                as identified by the following subparameters:           22812000
                                                                        22814000
                [DEV=ldev]                                              22816000
                                                                        22818000
                        @S                                              22820000
                        @J                                              22822000
                [JOB= { @     }]                                        22824000
                        [#]Snnn                                         22826000
                        [#]Jnnn                                         22828000
                                                                        22830000
                  ACTIVE                                                22832000
                [ READY  ]                                              22834000
                  OPENED                                                22836000
                                                                        22838000
                Each set of brackets, above, defines an item.  You      22840000
                cannot use the same item more than once in the parameter22842000
                list.  The subparameters are:                           22844000
                                                                        22846000
                ldev      Display status of input devicefile residing on22848000
                          device identified by logical device number    22850000
                          ldev.                                         22852000
                                                                        22854000
                @S        Display status of input devicefiles for all   22856000
                          sessions.                                     22858000
                                                                        22860000
                @J        Display status of input devicefiles for all   22862000
                          jobs.                                         22864000
                                                                        22866000
                #Snnn     Display status of all input devicefiles for   22868000
                          session indicated.                            22870000
                                                                        22872000
                #Jnnn     Display status of all input devicefiles for   22874000
                          job indicated.                                22876000
                                                                        22878000
                ACTIVE    Display status of ACTIVE devicefiles.         22880000
                                                                        22882000
                READY     Display status of READY devicefiles.          22884000
                                                                        22886000
                OPENED    Display status of OPENED devicefiles.         22888000
                                                                        22890000
                Do not use duplicate item keywords in this command. That22892000
                is, you can specify :SHOWIN DEV=25;ACTIVE;@J but not    22894000
                :SHOWIN DEV=25;ACTIVE;OPENED.                           22896000
                                                                        22898000
                Default is MPE displays status information for all input22900000
                devicefiles used by this job.                           22902000
                                                                        22904000
\ITEM=OPERATION                                                         22906000
OPERATION                                                               22908000
                                                                        22910000
Displays status information about one or more currently-defined input   22912000
devicefiles.  This information reflects the status at the time the      22914000
command is entered, and always appears on the standard list device. The 22916000
information includes:                                                   22918000
                                                                        22920000
    Logical device number of device.                                    22922000
                                                                        22924000
    Devicefile identification in the form #Innn.                        22926000
                                                                        22928000
    Job/session number (jsnum) of job/session using the devicefile, if  22930000
    not used for READY or ACTIVE data; otherwise, job/session name      22932000
    appears on line following standard device information.              22934000
                                                                        22936000
    Filename associated with the devicefile.                            22938000
                                                                        22940000
    State:                                                              22942000
                                                                        22944000
        ACTIVE    Input being read from spooled device to disc.         22946000
                                                                        22948000
        READY     Input spooling completed, and file is now ready for   22950000
                  use by a program.                                     22952000
                                                                        22954000
        OPENED    File is being accessed by a program.                  22956000
                                                                        22958000
    Approximate disc space currently used (in sectors), for spooled     22960000
    input devicefiles only.                                             22962000
                                                                        22964000
    Rank, indicating the order in which the file is entered in the      22966000
    system with respect to other files.                                 22968000
                                                                        22970000
    Input priority requested by user (1 = lowest, 13 = highest, blank = 22972000
    current default priority).                                          22974000
                                                                        22976000
\ITEM=EXAMPLE                                                           22978000
EXAMPLE                                                                 22980000
                                                                        22982000
To display the status of the input devicefile with the identifier #I796,22984000
enter:                                                                  22986000
                                                                        22988000
    :SHOWIN #I796                                                       22990000
                                                                        22992000
To display the status of all spooled input devicefiles, enter:          22994000
                                                                        22996000
    :SHOWIN SP                                                          22998000
                                                                        23000000
To request summarized information about all input devicefiles, enter:   23002000
                                                                        23004000
    :SHOWIN STATUS                                                      23006000
\ENTRY=SHOWJCW,PARMS,OPERATION,EXAMPLE                                  23008000
    :SHOWJCW                                                            23010000
                                                                        23012000
Displays current state of Job Control Word.                             23014000
                                                                        23016000
SYNTAX                                                                  23018000
                                                                        23020000
    :SHOWJCW [jcwname]                                                  23022000
                                                                        23024000
\ITEM=PARMS                                                             23026000
PARAMETERS                                                              23028000
                                                                        23030000
jcwname      The name of a Job Control Word (JCW).  If omitted, the     23032000
             status of all JCW's is displayed.                          23034000
                                                                        23036000
\ITEM=OPERATION                                                         23038000
OPERATION                                                               23040000
                                                                        23042000
The :SHOWJCW command is used to display the current state of any or     23044000
all Job Control Words.  If no particular JCW is specified, all JCW's    23046000
are shown.                                                              23048000
                                                                        23050000
\ITEM=EXAMPLE                                                           23052000
EXAMPLE                                                                 23054000
                                                                        23056000
To display the current state of JCW named JCW1, enter:                  23058000
                                                                        23060000
    :SHOWJCW JCW1                                                       23062000
                                                                        23064000
                                                                        23066000
\ENTRY=SHOWJOB,PARMS,OPERATION,EXAMPLE                                  23068000
    :SHOWJOB                                                            23070000
                                                                        23072000
Displays status information about jobs/sessions.                        23074000
                                                                        23076000
SYNTAX                                                                  23078000
                                                                        23080000
               [#]Snnn                                                  23082000
               [#]Jnnn                                                  23084000
    :SHOWJOB [ STATUS     ]                                             23086000
               id[;state]                                               23088000
               state[;id]                                               23090000
                                                                        23092000
\ITEM=PARMS                                                             23094000
PARAMETERS                                                              23096000
                                                                        23098000
#Snnn         The session number (assigned by MPE) of the session for   23100000
              which status information is to be displayed.  The         23102000
              information appears in Type I format, described under     23104000
              OPERATION.  Default is status information for all jobs/   23106000
              sessions is displayed.                                    23108000
                                                                        23110000
#Jnnn         The job number (assigned by MPE) of the job for which     23112000
              status information is to be displayed.  The infor- mation 23114000
              appears in Type I format, described under OPERATION.      23116000
              Default is status information for all jobs/sessions is    23118000
              displayed.                                                23120000
                                                                        23122000
STATUS        A request to display a summary of status information for  23124000
              all jobs/sessions.The information is in Type II format,   23126000
              described under OPERATION.  Default is status information 23128000
              for all jobs/sessions is displayed.                       23130000
                                                                        23132000
id            A list of jobs/sessions/session whose status information  23134000
              is to be displayed.  This parameter is written in this    23136000
              format:                                                   23138000
                                                                        23140000
                       @                                                23142000
                       @J                                               23144000
                       @S                                               23146000
              [JOB= {  [jsname,]username.acctname } ]                   23148000
                       @,username.acctname                              23150000
                       [@,]@.acctname                                   23152000
                                                                        23154000
              The symbol @ indcates all.  Thus @S means all sessions, @J23156000
              means all jobs, and @,@.acctname means all sessions and   23158000
              jobs for all users in the specified account.  If only one 23160000
              job/session is displayed, output appears in Type I format;23162000
              if more than one job/sessionis displayed, the output      23164000
              appears in Type III format. (Format types are described   23166000
              under OPERATION.)  Default is status information for all  23168000
              jobs/sessions is displayed.                               23170000
                                                                        23172000
state         A particular job/session state, specified as a further    23174000
              restriction on which jobs/sessions are to be displayed.   23176000
              The format of this parameter is:                          23178000
                                                                        23180000
                INTRO                                                   23182000
                        ,N                                              23184000
              [ WAIT   [   ] ]                                          23186000
                        ,D                                              23188000
                EXEC                                                    23190000
                                                                        23192000
             N and D, which are requests for only non-deferred or       23194000
             deferred jobs/sessions, respectively, apply only to the    23196000
             WAIT state.                                                23198000
                                                                        23200000
             If only one job/session is displayed, output appears in    23202000
             Type I format; if more than one job/session is displayed,  23204000
             output appears in Type III format.  (Format types are      23206000
             described under OPERATION.)  Default is status information 23208000
             for all jobs/sessions is displayed.                        23210000
                                                                        23212000
\ITEM=OPERATION                                                         23214000
OPERATION                                                               23216000
                                                                        23218000
Obtains status information about any currently-defined jobs/sessions.   23220000
                                                                        23222000
Output appears in three possible formats:                               23224000
                                                                        23226000
Type I                                                                  23228000
                                                                        23230000
JOBNUM   STATE   IPRI   JIN   JLIST   INTRODUCED   JOB   NAME           23232000
                                                                        23234000
#S16     EXEC            45   45      TUE  7:08A   TEST.PUBS            23236000
                                                                        23238000
JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16                                      23240000
                                                                        23242000
Type II:                                                                23244000
                                                                        23246000
7 JOBS:                                                                 23248000
    0 INTRO                                                             23250000
    0 WAIT; INCL 0 DEFERRED                                             23252000
    7 EXEC; INCL 7 SESSIONS                                             23254000
JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16                                      23256000
                                                                        23258000
NOTE:  The #EXEC jobs/sessions equals the sum of #EXEC and the          23260000
       #EXEC* (EXEC* -  denotes that  job or session is in the          23262000
       state of initialization).                                        23264000
                                                                        23266000
Type III:                                                               23268000
                                                                        23270000
(Type I followed by Type II.)                                           23272000
                                                                        23274000
\ITEM=EXAMPLE                                                           23276000
EXAMPLE                                                                 23278000
                                                                        23280000
To display the status of all sessions, enter:                           23282000
                                                                        23284000
    :SHOWJOB JOB=@S                                                     23286000
                                                                        23288000
To display the status of session number S16, enter:                     23290000
                                                                        23292000
    :SHOWJOB #S16                                                       23294000
                                                                        23296000
To display summary information for all jobs/sessions, enter:            23298000
                                                                        23300000
    :SHOWJOB STATUS                                                     23302000
                                                                        23304000
To display the status of all jobs in the INTRO state, enter:            23306000
                                                                        23308000
    :SHOWJOB JOB=@J;INTRO                                               23310000
                                                                        23312000
                                                                        23314000
\ENTRY=SHOWLOG,PARMS,OPERATION,EXAMPLE                                  23316000
    :SHOWLOG  (System Supervisor capability required)                   23318000
                                                                        23320000
Displays the current Log File's number and the amount (percentage) of   23322000
available disc space currently used.                                    23324000
                                                                        23326000
SYNTAX                                                                  23328000
                                                                        23330000
    :SHOWLOG                                                            23332000
                                                                        23334000
\ITEM=PARMS                                                             23336000
PARAMETERS                                                              23338000
                                                                        23340000
None                                                                    23342000
                                                                        23344000
\ITEM=OPERATION                                                         23346000
OPERATION                                                               23348000
                                                                        23350000
(System Supervisor capability required)                                 23352000
This command displays the current Log File's number and the amount      23354000
(percentage) of available file space currently used.                    23356000
                                                                        23358000
The information displayed appears in the following format:              23360000
                                                                        23362000
    LOGFILE LOGxxxx IS yy% FULL                                         23364000
                                                                        23366000
where xxxx is the Log File number and yy is the percentage of file space23368000
used.                                                                   23370000
                                                                        23372000
If the Logging System is disabled, MPE outputs the message:             23374000
                                                                        23376000
    NO LOGGING                                                          23378000
                                                                        23380000
If logging is enabled but currently suspended as a result of a          23382000
managerial error, both messages appear.                                 23384000
                                                                        23386000
\ITEM=EXAMPLE                                                           23388000
EXAMPLE                                                                 23390000
                                                                        23392000
To display the number and percent of file space used for the current Log23394000
File, enter:                                                            23396000
                                                                        23398000
    :SHOWLOG                                                            23400000
\ENTRY=SHOWLOGSTATUS,PARMS,OPERATION,EXAMPLE                            23402000
    :SHOWLOGSTATUS                                                      23404000
                                                                        23406000
Displays status information of the currently opened logging             23408000
files.                                                                  23410000
                                                                        23412000
SYNTAX                                                                  23414000
                                                                        23416000
    :SHOWLOGSTATUS  logid                                               23418000
                                                                        23420000
\ITEM=PARMS                                                             23422000
PARAMETERS                                                              23424000
                                                                        23426000
logid         The logging identifier created by the :GETLOG             23428000
              command.                                                  23430000
                                                                        23432000
\ITEM=OPERATION                                                         23434000
OPERATION                                                               23436000
                                                                        23438000
This command is used to list the status of currently running            23440000
logging processes.  The status includes the total number of             23442000
records written by the process and the current number of users          23444000
accessing the logging file.                                             23446000
                                                                        23448000
This command gives the following information about all current-         23450000
ly opened logging files:                                                23452000
                                                                        23454000
     LOGID    - The identifier of the logging process.                  23456000
     USERS    - The number of users                                     23458000
     STATE    - Active or inactive.                                     23460000
     RECORDS  - The number of records in the log file                   23462000
                                                                        23464000
\ITEM=EXAMPLE                                                           23466000
EXAMPLE                                                                 23468000
                                                                        23470000
The display the status of an open log file, (LEN) enter:                23472000
                                                                        23474000
    :SHOWLOGSTATUS                                                      23476000
                                                                        23478000
         LOGID          USERS     STATE      RECORDS                    23480000
                                                                        23482000
         LEN              0       INACT      160                        23484000
                                                                        23486000
                                                                        23488000
\ENTRY=SHOWME,PARMS,OPERATION,EXAMPLE                                   23490000
    :SHOWME                                                             23492000
                                                                        23494000
Reports job/session status.                                             23496000
                                                                        23498000
                                                                        23500000
SYNTAX                                                                  23502000
                                                                        23504000
    :SHOWME                                                             23506000
                                                                        23508000
                                                                        23510000
\ITEM=PARMS                                                             23512000
PARAMETERS                                                              23514000
                                                                        23516000
None                                                                    23518000
                                                                        23520000
\ITEM=OPERATION                                                         23522000
OPERATION                                                               23524000
                                                                        23526000
The :SHOWME command reports the following information pertaining to     23528000
your job or session:                                                    23530000
                                                                        23532000
  Job/session number.                                                   23534000
                                                                        23536000
  User job/session identity.                                            23538000
                                                                        23540000
  MPE version.                                                          23542000
                                                                        23544000
  Current welcome message.                                              23546000
                                                                        23548000
  Current time.                                                         23550000
                                                                        23552000
  Log-on time.                                                          23554000
                                                                        23556000
  Central processor time used by this job/session.                      23558000
                                                                        23560000
  Amount of time job/session has been connected.                        23562000
                                                                        23564000
  Standard input device number.                                         23566000
                                                                        23568000
  Standard list device number.                                          23570000
                                                                        23572000
\ITEM=EXAMPLE                                                           23574000
EXAMPLE                                                                 23576000
                                                                        23578000
    :SHOWME                                                             23580000
                                                                        23582000
    USER: #S95,ED.MPE,SUPPORT      (NOT IN BREAK)                       23584000
    MPE VERSION: HP32002C.00.00                                         23586000
    CURRENT:  THU, OCT 13, 1977, 12:50 PM                               23588000
    LOGON:    THU, OCT 13, 1977, 11:37 AM                               23590000
    CPU SECONDS: 2          CONNECT MINUTES: 73                         23592000
    $STDIN LDEV: 20          $STDLIST LDEV: 20                          23594000
                                                                        23596000
                                                                        23598000
\ENTRY=SHOWOUT,PARMS,OPERATION,EXAMPLE                                  23600000
    :SHOWOUT                                                            23602000
                                                                        23604000
Reports status of output devicefiles.                                   23606000
                                                                        23608000
SYNTAX                                                                  23610000
                                                                        23612000
               #Onnn                                                    23614000
               STATUS                                                   23616000
    :SHOWOUT [                    ]                                     23618000
               SP                                                       23620000
               item[;item[;item]]                                       23622000
                                                                        23624000
\ITEM=PARMS                                                             23626000
PARAMETERS                                                              23628000
                                                                        23630000
#Onnn         Identifies particular output devicefile for which         23632000
              information is to be displayed.  The information is       23634000
              displayed in Type I format, described under OPERATION.    23636000
              Default is a display of status information for            23638000
              all output device files.                                  23640000
                                                                        23642000
STATUS        Request to summarize status information for all current   23644000
              output devicefiles.  The information is displayed in Type 23646000
              II format, described under OPERATION. Default is          23648000
              a display of status information for all output            23650000
              device files.                                             23652000
                                                                        23654000
SP            Request to display status information for currently       23656000
              spooled output devicefiles associated with the logon      23658000
              job or session.  The information is displayed in Type     23660000
              III format, described under OPERATION.  Default is        23662000
              a display of status information for all output            23664000
              device files.                                             23666000
                                                                        23668000
item          Request to display status of all current output           23670000
              devicefiles.  This parameter is written in the following  23672000
              format:                                                   23674000
                                                                        23676000
                      ldev                                              23678000
              [DEV= {           } ]                                     23680000
                      classname                                         23682000
                                                                        23684000
                      @J                                                23686000
                      @S                                                23688000
              [JOB= { @     } ]                                         23690000
                      [#]Jnnn                                           23692000
                      [#]Snnn                                           23694000
                                                                        23696000
                ACTIVE                                                  23698000
                         ,N                                             23700000
                READY  [    ]                                           23702000
                         ,D                                             23704000
               [              ]                                         23706000
                OPENED                                                  23708000
                LOCKED                                                  23710000
                                                                        23712000
               Each set of brackets defines an item.  You cannot        23714000
               use the same item more than once in the parameter list.  23716000
               The subparameters are:                                   23718000
                                                                        23720000
               ldev         Display status of output devicefile residing23722000
                            on device identified by logical device      23724000
                            number <ldev>.                              23726000
                                                                        23728000
               classname    Display status of output devicefiles        23730000
                            residing on all devices having device class 23732000
                            name <classname>.                           23734000
                                                                        23736000
               @J           Display status of output devicefiles for all23738000
                            jobs.                                       23740000
                                                                        23742000
               @S           Display status of output devicefiles for all23744000
                            sessions.                                   23746000
                                                                        23748000
               #Jnnn        Display status of all output devicefiles for23750000
                            specified job.                              23752000
                                                                        23754000
               #Snnn        Display status of all output devicefiles for23756000
                            session indicated.                          23758000
                                                                        23760000
               ACTIVE       Display status of output devicefiles in     23762000
               READY        specified state.                            23764000
               OPENED                                                   23766000
               LOCKED                                                   23768000
                                                                        23770000
               N            Display status of non-deferred READY        23772000
                            devicefiles only.                           23774000
                                                                        23776000
               D            Display status of deferred READY device-    23778000
                            files only.                                 23780000
                                                                        23782000
               If information for only one devicefile is displayed,     23784000
               output is in Type I format; if information for more than 23786000
               one devicefile is displayed, output is in Type III       23788000
               format.  (Format types are described under OPERATION.)   23790000
                                                                        23792000
\ITEM=OPERATION                                                         23794000
OPERATION                                                               23796000
                                                                        23798000
Displays status information for one or more currently-defined output    23800000
devicefiles.  The information reflects the status at the time the       23802000
command is entered and always appears on the standard list device.  The 23804000
information includes:                                                   23806000
                                                                        23808000
    Logical device number or device class name of device.               23810000
                                                                        23812000
    Devicefile identification, in form #Onnn.                           23814000
                                                                        23816000
    Job/session number (jsnum) of job/session using devicefile, if not  23818000
    used for READY or ACTIVE data.  Otherwise, job/session name appears 23820000
    on line following standard device information.                      23822000
                                                                        23824000
    Filename assigned to devicefile.                                    23826000
                                                                        23828000
    State:                                                              23830000
                                                                        23832000
        ACTIVE    Spooled devicefile on disc is actually being written  23834000
                  to a printer, plotter, or card punch.                 23836000
                                                                        23838000
        READY     Devicefile on disc is ready for output.               23840000
                                                                        23842000
        LOCKED    READY, but system is using file with exclusive access.23844000
                                                                        23846000
        OPENED    Devicefile on disc is being accessed by a program.    23848000
                                                                        23850000
    Forms message indicator (the letter F) appearing only if a forms    23852000
    alignment message applies to this devicefile.                       23854000
                                                                        23856000
    Approximate disc space currently used (in sectors), for spooled     23858000
    output devicefiles only.                                            23860000
                                                                        23862000
    Rank, indicating the order in which the file is entered in the      23864000
    system with respect to other files.                                 23866000
                                                                        23868000
    D, indicating a deferred file, for spooled devicefiles only.        23870000
                                                                        23872000
    Outputpriority, requested by user, for spooled devicefiles only (1 =23874000
    lowest, 13 = highest, blank = current default priority).            23876000
                                                                        23878000
    Number of copies needed (#C), for spooled devicefiles only.         23880000
                                                                        23882000
Output may appear in three possible formats:                            23884000
                                                                        23886000
Type I:                                                                 23888000
                                                                        23890000
DEV/CL   DFID   JOBNUM   FNAME     STATE   FRM   SPACE   RANK  PRI  #C  23892000
                                                                        23894000
45       #O32   #S16     $STDLIST  OPENED                               23896000
                                                                        23898000
Type II:                                                                23900000
                                                                        23902000
    7 FILES:                                                            23904000
        0 ACTIVE                                                        23906000
        0 READY; INCL 0 SPOOFLES, 0 DEFERRED                            23908000
        7 OPENED; INCL 0 SPOOFLES                                       23910000
        0 SPOOFLES: 0 SECTORS                                           23912000
                                                                        23914000
    OUTFENCE= 0                                                         23916000
                                                                        23918000
Type III:                                                               23920000
                                                                        23922000
(Type I followed by Type II.)                                           23924000
                                                                        23926000
\ITEM=EXAMPLE                                                           23928000
EXAMPLE                                                                 23930000
                                                                        23932000
To display the status of the output devicefile with the identifier      23934000
#O977, enter:                                                           23936000
                                                                        23938000
    :SHOWOUT #O977                                                      23940000
                                                                        23942000
To display the status of all output devicefiles associated with         23944000
the logon job or session.                                               23946000
                                                                        23948000
    :SHOWOUT SP                                                         23950000
                                                                        23952000
To request summarized information about all output devicefiles, enter:  23954000
                                                                        23956000
    :SHOWOUT STATUS                                                     23958000
                                                                        23960000
                                                                        23962000
\ENTRY=SHOWQ,PARMS,OPERATION,EXAMPLE                                    23964000
    :SHOWQ (System Supervisor capability required)                      23966000
                                                                        23968000
Displays information about the scheduling of processes and the contents 23970000
of various scheduling subqueues or the master queue.                    23972000
                                                                        23974000
SYNTAX                                                                  23976000
                                                                        23978000
    :SHOWQ                                                              23980000
                                                                        23982000
\ITEM=PARMS                                                             23984000
PARAMETERS                                                              23986000
                                                                        23988000
None                                                                    23990000
                                                                        23992000
\ITEM=OPERATION                                                         23994000
OPERATION                                                               23996000
                                                                        23998000
(System Supervisor capability required)                                 24000000
This command displays information about the scheduling of processes and 24002000
the contents of various scheduling subqueues or the master queue.       24004000
                                                                        24006000
The information displayed is divided into three major columns.  In the  24008000
right column, the processes are listed in high-to-low priority order.   24010000
These processes currently (or will immediately) require the cpu in order24012000
to continue.  The cpu will be given automatically to the first process  24014000
which is able to use it.                                                24016000
                                                                        24018000
In the center column, also listed in order of high-to-low priority, the 24020000
processes are willing to yield their main memory resources to other     24022000
processes.  Memory is taken automatically (segment by segment) from     24024000
lower priority processes first.  These processes are displayed when the 24026000
process does not require the cpu for a relatively long time.  Note also 24028000
that processes which are neither main or user processes are system      24030000
processes.                                                              24032000
                                                                        24034000
In the left column, the processes are listed in numerical order and have24036000
no main memory resources.  These processes are waiting on longer- term  24038000
events, and will again contend for the cpu when those events occur.     24040000
                                                                        24042000
After displaying the process queues, :SHOWQ prints the number of        24044000
processes and the scheduling parameters currently in effect.            24046000
                                                                        24048000
On occasion, a process will appear in the right column as well as in one24050000
of the columns to the left.  This indicates that the process was being  24052000
moved to the right during the execution of :SHOWQ.                      24054000
                                                                        24056000
The following information is displayed for each process:                24058000
                                                                        24060000
    L                                                                   24062000
    C    M          J                                                   24064000
   { } [{ }] pin [#{ } jobnum]                                          24066000
    D    U          S                                                   24068000
    E                                                                   24070000
                                                                        24072000
where                                                                   24074000
                                                                        24076000
L - is a linearly scheduled process on the AS, BS, or master queue.     24078000
                                                                        24080000
C - is a circularly scheduled process on the CS queue.                  24082000
                                                                        24084000
D - is a circularly scheduled process on the DS queue.                  24086000
                                                                        24088000
E - is a circularly scheduled process on the ES queue.                  24090000
                                                                        24092000
M - is a job main process.                                              24094000
                                                                        24096000
U - is a user process.                                                  24098000
                                                                        24100000
pin - is the process identification number for this process.            24102000
                                                                        24104000
J - is the process executing in a batch job.                            24106000
                                                                        24108000
S - is the process executing from a session.                            24110000
                                                                        24112000
jobnum - is the job or session number.                                  24114000
                                                                        24116000
\ITEM=EXAMPLE                                                           24118000
EXAMPLE                                                                 24120000
                                                                        24122000
To display the queues of processes within MPE, enter:                   24124000
                                                                        24126000
    :SHOWQ                                                              24128000
\ENTRY=SHOWTIME,PARMS,OPERATION,EXAMPLE                                 24130000
    :SHOWTIME                                                           24132000
                                                                        24134000
Prints current time and date.                                           24136000
                                                                        24138000
SYNTAX                                                                  24140000
                                                                        24142000
    :SHOWTIME                                                           24144000
                                                                        24146000
\ITEM=PARMS                                                             24148000
PARAMETERS                                                              24150000
                                                                        24152000
None                                                                    24154000
                                                                        24156000
\ITEM=OPERATION                                                         24158000
OPERATION                                                               24160000
                                                                        24162000
Prints current time and date, as indicated by system clock,             24164000
in the following format:                                                24166000
                                                                        24168000
          |---------------------------|                                 24170000
          |WWW, MMM DD, YYYY, HH:MM AM| (or PM)                         24172000
          |---------------------------|                                 24174000
                                                                        24176000
                                                                        24178000
\ITEM=EXAMPLE                                                           24180000
EXAMPLE                                                                 24182000
                                                                        24184000
To display the time and date, enter:                                    24186000
                                                                        24188000
    :SHOWTIME                                                           24190000
                                                                        24192000
MPE responds with a message as follows:                                 24194000
                                                                        24196000
   TUE, JAN 18, 1977,  1:46 PM                                          24198000
                                                                        24200000
                                                                        24202000
\ENTRY=SPEED,PARMS,OPERATION,EXAMPLE                                    24204000
    :SPEED                                                              24206000
                                                                        24208000
Changes terminal operating speed.                                       24210000
                                                                        24212000
SYNTAX                                                                  24214000
                                                                        24216000
    :SPEED {newinspeed,newoutspeed}                                     24218000
                                                                        24220000
\ITEM=PARMS                                                             24222000
PARAMETERS                                                              24224000
                                                                        24226000
newinspeed      New input speed, in characters per second.  Must be 10, 24228000
                14, 15, 30, 60, 120, 240, 480, or 960.                  24230000
                                                                        24232000
newoutspeed     New output speed, in characters per second.  Must be 10,24234000
                14, 15, 30, 60, 120, 240, 480, or 960.                  24236000
                                                                        24238000
                                                                        24240000
                             NOTE                                       24242000
                                                                        24244000
      Newinspeed and newoutspeed must be the same.                      24246000
                                                                        24248000
\ITEM=OPERATION                                                         24250000
OPERATION                                                               24252000
                                                                        24254000
MPE automatically senses the input/output speed of a terminal when you  24256000
log on at that terminal.  If your terminal has speed-adjustment         24258000
controls, you can change the input and output speeds after log on with  24260000
the :SPEED command.                                                     24262000
Note that this command is not valid for terminals that operate on one   24264000
speed only.                                                             24266000
                                                                        24268000
When the command is entered, MPE outputs the following message at the   24270000
old output speed:                                                       24272000
                                                                        24274000
    CHANGE SPEED AND INPUT "MPE"                                        24276000
                                                                        24278000
Manually change the speed control on the terminal and verify the new    24280000
speed by entering:                                                      24282000
                                                                        24284000
    MPE                                                                 24286000
                                                                        24288000
If the characters "MPE" cannot be verified, the system assumes that the 24290000
terminal is to continue at the old speed.  (To continue, you must       24292000
reset the terminal to the old speed.)                                   24294000
                                                                        24296000
NOTE:  480 and 960 are not available to SERIES II or III users.         24298000
                                                                        24300000
                                                                        24302000
\ITEM=EXAMPLE                                                           24304000
EXAMPLE                                                                 24306000
                                                                        24308000
To change the input and output speeds to 240 cps, enter:                24310000
                                                                        24312000
    :SPEED 240,240                                                      24314000
                                                                        24316000
MPE outputs:                                                            24318000
                                                                        24320000
    CHANGE SPEED AND INPUT "MPE"                                        24322000
                                                                        24324000
Manually change the speed and input MPE.                                24326000
                                                                        24328000
                                                                        24330000
\ENTRY=SPL,PARMS,OPERATION,EXAMPLE                                      24332000
    :SPL                                                                24334000
                                                                        24336000
Compiles an SPL program.                                                24338000
                                                                        24340000
SYNTAX                                                                  24342000
                                                                        24344000
 :SPL [textfile][,[uslfile][,[listfile][,[masterfile][,newfile]]]]      24346000
                                                                        24348000
\ITEM=PARMS                                                             24350000
PARAMETERS                                                              24352000
                                                                        24354000
textfile             Actual designator of input file from which source  24356000
                     program is read.  Can be any ASCII input file.     24358000
                     Formal designator is SPLTEXT. Default is $STDIN.   24360000
                                                                        24362000
uslfile              Actual designator of USL file on which object      24364000
                     program is written.  Can be any binary output file.24366000
                     Formal designator is SPLUSL.  If entered, this     24368000
                     parameter must indicate a file created previously  24370000
                     in one of four ways:                               24372000
                                                                        24374000
                     1.  By saving a USL file (with the MPE :SAVE       24376000
                         command) which was created by a previous       24378000
                         compilation where the default value was used   24380000
                         for the <uslfile> parameter.                   24382000
                                                                        24384000
                     2.  By building the USL with the MPE Segmenter     24386000
                         -BUILDUSL command.  (See the MPE Segmenter     24388000
                         Reference Manual.)                             24390000
                                                                        24392000
                     3.  By creating a new USL file with the MPE :BUILD 24394000
                         command with a <filecode> of USL or 1024.      24396000
                                                                        24398000
                     4.  By specifying a non-existent <uslfile>         24400000
                         parameter, thereby creating a permanent file of24402000
                         the correct size and type.                     24404000
                                                                        24406000
                     Default is $NEWPASS is assigned.                   24408000
                                                                        24410000
listfile             Actual designator of file on which program listing 24412000
                     is written.  Can be any ASCII output file.  Formal 24414000
                     designator is SPLLIST.  Default is $STDLIST.       24416000
                                                                        24418000
masterfile           Actual designator of master file which is merged   24420000
                     against <textfile> to produce composite source. Can24422000
                     be any ASCII input file.  Formal designator is     24424000
                     SPLMAST.  Default is master file is not read, input24426000
                     is read from <textfile>.                           24428000
                                                                        24430000
newfile              Actual designator of merged <textfile> and         24432000
                     <masterfile>.  Can be any ASCII output file. Formal24434000
                     designator is SPLNEW.  Default is no file is       24436000
                     written.                                           24438000
                                                                        24440000
                                 NOTE                                   24442000
                                                                        24444000
      The formal file designators used in this command                  24446000
      (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, SPLNEW)                       24448000
      cannot be back referenced as actual file designators              24450000
      in the command parameter list.  For further information,          24452000
      see the discussion of implied :FILE commands in                   24454000
      Section VII of the MPE Commands Reference Manual.                 24456000
                                                                        24458000
\ITEM=OPERATION                                                         24460000
OPERATION                                                               24462000
                                                                        24464000
Compiles SPL program onto a User Subprogram Library (USL) file on disc. 24466000
If <textfile> is not specified, MPE expects input from your standard    24468000
input device.                                                           24470000
                                                                        24472000
\ITEM=EXAMPLE                                                           24474000
EXAMPLE                                                                 24476000
                                                                        24478000
To compile an SPL program entered from the job input device into an     24480000
object program in the USL file $NEWPASS, and write the listing to your  24482000
standard list device, enter:                                            24484000
                                                                        24486000
    :SPL                                                                24488000
                                                                        24490000
If the next command is one to prepare an object program, $NEWPASS can be24492000
passed to that command by referencing $OLDPASS.                         24494000
                                                                        24496000
To compile an SPL program residing on the disc file SOURCE into an      24498000
object program on the USL file OBJECT, with program listing generated on24500000
the disc file LISTFL, enter:                                            24502000
                                                                        24504000
    :SPL SOURCE,OBJECT                                                  24506000
    :SAVE OBJECT                                                        24508000
                                                                        24510000
                                                                        24512000
\ENTRY=SPLGO,PARMS,OPERATION,EXAMPLE                                    24514000
    :SPLGO                                                              24516000
                                                                        24518000
Compiles, prepares, and executes an SPL program.                        24520000
                                                                        24522000
SYNTAX                                                                  24524000
                                                                        24526000
    :SPLGO [textfile][,[listfile][,[masterfile][,newfile]]]             24528000
                                                                        24530000
\ITEM=PARMS                                                             24532000
PARAMETERS                                                              24534000
                                                                        24536000
textfile            Actual designator of input file from which source   24538000
                    program is read.  Can be any ASCII input file.      24540000
                    Formal designator is SPLTEXT.  Default is $STDIN.   24542000
                                                                        24544000
listfile            Actual designator of file on which program listing  24546000
                    is written.  Can be any ASCII output file.  Formal  24548000
                    designator is SPLLIST.  Default is $STDLIST.        24550000
                                                                        24552000
masterfile          Actual designator of master file which is merged    24554000
                    against <textfile> to produce composite source.  Can24556000
                    be any ASCII input file.  Formal designator is      24558000
                    SPLMAST.  Default is master file is not read, input 24560000
                    is read from <textfile>.                            24562000
                                                                        24564000
newfile             Actual designator of merged <textfile> and          24566000
                    <masterfile>.  Can be any ASCII output file. Formal 24568000
                    designator is SPLNEW.  Default is no file is        24570000
                    written.                                            24572000
                                                                        24574000
                                 NOTE                                   24576000
                                                                        24578000
      The formal file designators used in this command                  24580000
      (SPLTEXT, SPLLIST, SPLMAST, SPLNEW)                               24582000
      cannot be back referenced as actual file designators              24584000
      in the command parameter list.  For further information,          24586000
      see the discussion of implied :FILE commands in                   24588000
      Section VII of the MPE Commands Reference Manual.                 24590000
                                                                        24592000
\ITEM=OPERATION                                                         24594000
OPERATION                                                               24596000
                                                                        24598000
Compiles, prepares, and allocates/executes an SPL program.  If          24600000
<textfile> is omitted, MPE expects input from your standard input       24602000
device.  This command creates a temporary User Subprogram Library (USL) 24604000
file ($NEWPASS) that you cannot access, and a temporary program file    24606000
that you can access under the name $OLDPASS.                            24608000
                                                                        24610000
\ITEM=EXAMPLE                                                           24612000
EXAMPLE                                                                 24614000
                                                                        24616000
To compile, prepare, and execute an SPL program entered from your       24618000
standard input device, with the program listing sent to your standard   24620000
list device, enter:                                                     24622000
                                                                        24624000
    :SPLGO                                                              24626000
                                                                        24628000
To compile, prepare, and execute an SPL program read from the disc file 24630000
SOURCE and send the resulting program listing to the disc file LISTFL,  24632000
enter:                                                                  24634000
                                                                        24636000
    :SPLGO SOURCE,LISTFL                                                24638000
\ENTRY=SPLPREP,PARMS,OPERATION,EXAMPLE                                  24640000
    :SPLPREP                                                            24642000
                                                                        24644000
Compiles and prepares an SPL program.                                   24646000
                                                                        24648000
SYNTAX                                                                  24650000
                                                                        24652000
 :SPLPREP [textfile][,[progfile][,[listfile][,[masterfile][,newfile]]]] 24654000
                                                                        24656000
\ITEM=PARMS                                                             24658000
PARAMETERS                                                              24660000
                                                                        24662000
textfile            Actual designator of input file from which source   24664000
                    program is read.  Can be any ASCII input file.      24666000
                    Formal designator is SPLTEXT.  Default is $STDIN.   24668000
                                                                        24670000
progfile            Actual designator of program file on which program  24672000
                    segments are written.  Can be any binary output file24674000
                    with <filecode> of PROG or 1029.  If entered, this  24676000
                    parameter must indicate a file created on one of two24678000
                    ways:                                               24680000
                                                                        24682000
                    1.  By creating a new program file with the MPE     24684000
                        :BUILD command with a <filecode> of PROG or 102924686000
                        and a <numextents> parameter value of 1.        24688000
                                                                        24690000
                    2.  By specifying a non-existent file in the        24692000
                        <progfile> parameter, in which case a           24694000
                        job/session temporary file of the correct size  24696000
                        and type is created.                            24698000
                                                                        24700000
                    Default is $NEWPASS is assigned.                    24702000
                                                                        24704000
listfile            Actual designator of file on which program listing  24706000
                    is written.  Can be any ASCII output file.  Formal  24708000
                    designator is SPLLIST.  Default is $STDLIST.        24710000
                                                                        24712000
masterfile          Actual designator of master file which is merged    24714000
                    against <textfile> to produce composite source.  Can24716000
                    be any ASCII input file.  Formal designator is      24718000
                    SPLMAST.  Default is master file is not read, input 24720000
                    is read from <textfile>.                            24722000
                                                                        24724000
newfile             Actual designator of merged <textfile> and          24726000
                    <masterfile>.  Can be any ASCII output file. Formal 24728000
                    designator is SPLNEW.  Default is no file is        24730000
                    written.                                            24732000
                                                                        24734000
                                  NOTE                                  24736000
                                                                        24738000
      The formal file designators used in this command                  24740000
      (SPLTEXT, SPLPROG, SPLLIST, SPLMAST, SPLNEW)                      24742000
      cannot be back referenced as actual file designators              24744000
      in the command parameter list.  For further information,          24746000
      see the discussion of implied :FILE commands in                   24748000
      Section VII of the MPE Commands Reference Manual.                 24750000
                                                                        24752000
\ITEM=OPERATION                                                         24754000
OPERATION                                                               24756000
                                                                        24758000
Compiles and prepares an SPL program onto a program on disc.  If        24760000
<textfile> is not specified, MPE expects input from your standard job/  24762000
session input device.  The User Subprogram Library (USL) file created   24764000
during compilation is a temporary file passed directly to the prepar-   24766000
ation mechanism; you can access it under the name $OLDPASS only if the  24768000
program file is not $NEWPASS.                                           24770000
                                                                        24772000
\ITEM=EXAMPLE                                                           24774000
EXAMPLE                                                                 24776000
                                                                        24778000
To compile and prepare an SPL program entered through the job input     24780000
device, onto the file $NEWPASS, with the listing printed on the job list24782000
device, enter:                                                          24784000
                                                                        24786000
    :SPLPREP                                                            24788000
                                                                        24790000
If the next command is one to execute the program, the file $NEWPASS can24792000
be passed to this command by referencing $OLDPASS.                      24794000
                                                                        24796000
To compile and prepare an SPL source program from a source file named   24798000
SFILE into a program named MYPROG, with the resulting listing sent to   24800000
the job/session list device, enter:                                     24802000
                                                                        24804000
    :SPLPREP SFILE,MYPROG                                               24806000
                                                                        24808000
                                                                        24810000
\ENTRY=STARTSPOOL,PARMS,OPERATION,EXAMPLE                               24812000
     :STARTSPOOL                                                        24814000
                                                                        24816000
Initiates spooling of a device.                                         24818000
                                                                        24820000
                                                                        24822000
SYNTAX                                                                  24824000
                                                                        24826000
     :STARTSPOOL {ldn     } [;SHUTQ]                                    24828000
                 {devclass}                                             24830000
                                                                        24832000
\ITEM=PARMS                                                             24834000
PARAMETERS                                                              24836000
                                                                        24838000
ldn               The logical device number of a spooled device.        24840000
                                                                        24842000
devclass          The device class specified at SYSDUMP.                24844000
                                                                        24846000
SHUTQ             The spool queue has been shut for the                 24848000
                  specified logical device.  Default is                 24850000
                  OPENQ.                                                24852000
                                                                        24854000
\ITEM=OPERATION                                                         24856000
OPERATION                                                               24858000
                                                                        24860000
The :STARTSPOOL command causes the spooler to own a specified device,   24862000
and the spooler then is able to determine whether the device is an      24864000
input or output spooling device.                                        24866000
                                                                        24868000
If a devclass is spooled but the device is not, then any reference      24870000
to the devclass is spooled.                                             24872000
                                                                        24874000
When devclass is used in a :STARTSPOOL command, the                     24876000
effect is to open the spool queue for the device.                       24878000
                                                                        24880000
The SHUTQ parametera corresponds only to ldn; it is                     24882000
meaningless to the devclass.                                            24884000
                                                                        24886000
                      NOTE                                              24888000
                                                                        24890000
       If the ldn referenced in a :STARTSPOOL                           24892000
       command is a 2894 Printer/Reader/Punch,                          24894000
       the following message will be generated                          24896000
       on the system console:                                           24898000
                                                                        24900000
       IS THIS AN INPUT OR OUTPUT SPOOLER (IN/OUT)?                     24902000
                                                                        24904000
       You must then enter the appropriate reply;                       24906000
       IN if cards are to be read; OUT if cards                         24908000
       are to be punched.                                               24910000
                                                                        24912000
\ITEM=EXAMPLE                                                           24914000
EXAMPLES                                                                24916000
                                                                        24918000
To start spooling on logical device 6, enter:                           24920000
                                                                        24922000
     :STARTSPOOL 6                                                      24924000
                                                                        24926000
To start spooling on devclass LP, enter:                                24928000
                                                                        24930000
     :STARTSPOOL LP                                                     24932000
                                                                        24934000
\ENTRY=STOPSPOOL,PARMS,OPERATION,EXAMPLE                                24936000
                                                                        24938000
     :STOPSPOOL                                                         24940000
                                                                        24942000
Terminates spooling of a device.                                        24944000
                                                                        24946000
SYNTAX                                                                  24948000
                                                                        24950000
     :STOPSPOOL {ldn     }  [;OPENQ]                                    24952000
                {devclass}                                              24954000
                                                                        24956000
\ITEM=PARMS                                                             24958000
PARAMETERS                                                              24960000
                                                                        24962000
ldn               The logical device number of a spooled device.        24964000
                                                                        24966000
devclass          The device class specified during SYSDUMP.            24968000
                                                                        24970000
OPENQ             The spool queue has been opened for the               24972000
                  specified logical device. Default is SHUTQ.           24974000
                                                                        24976000
\ITEM=OPERATION                                                         24978000
OPERTION                                                                24980000
                                                                        24982000
The :STOPSPOOL command causes the specified logical device to stop      24984000
immediately, return the active spoolfile to the READY state, and        24986000
to be owned by the system, not the spooler.  Any FOPENs to a            24988000
particular device (either by ldn or devclass reference) results         24990000
in the device being allocated or a file system error message if         24992000
the device is already allocated.                                        24994000
                                                                        24996000
When devclass is used in a :STOPSTPOOL command, the effect              24998000
is to shut the spool queue for the device.                              25000000
                                                                        25002000
The OPENQ parameter corresponds only to ldn; it is                      25004000
meaningless to the devclass.                                            25006000
                                                                        25008000
                                                                        25010000
\ITEM=EXAMPLE                                                           25012000
EXAMPLES                                                                25014000
                                                                        25016000
To terminate spooling to logical device number 6, enter:                25018000
                                                                        25020000
     :STOPSPOOL 6                                                       25022000
                                                                        25024000
To terminate spooling to device class LP, enter:                        25026000
                                                                        25028000
     :STOPSPOOL LP                                                      25030000
                                                                        25032000
\STOPHELP                                                               25034000
                                                                        25036000
    :STORE                                                              25038000
                                                                        25040000
Stores disc files onto magnetic tape or serial disc.                    25042000
                                                                        25044000
SYNTAX                                                                  25046000
                                                                        25048000
    :STORE [fileset][. . .][fileset];storefile                          25050000
           [;SHOW][;FILES=maxfiles][; DATE<=accdate]                    25052000
                                    ; DATE>=moddate                     25054000
                                                                        25056000
PARAMETERS                                                              25058000
                                                                        25060000
fileset                Specifies a set of files to be stored.  Default  25062000
                       is @.  This parameter is of the form:            25064000
                                                                        25066000
                       filedesig[.groupdesig[.acctdesig]]               25068000
                                                                        25070000
                       Fileset can be entered in any of the following   25072000
                       formats and may use wild card characters, in     25074000
                       any order, as replacements:                      25076000
                                                                        25078000
file.group.account     Store specified file in specified group and      25080000
                       account.                                         25082000
                                                                        25084000
file.group             Store specified file in specified group under    25086000
                       logon account.                                   25088000
                                                                        25090000
file                   Store specified file under logon group.          25092000
                                                                        25094000
@.group.account        Store all files in specified group and account.  25096000
                                                                        25098000
@.group                Store all files in specified group under log- on 25100000
                       account.                                         25102000
                                                                        25104000
@.@.account            Store all files in all groups in specified       25106000
                       account.                                         25108000
                                                                        25110000
@                      Store all files in logon group.  Default.        25112000
                                                                        25114000
@.@                    Store all files in all groups under logon        25116000
                       account.                                         25118000
                                                                        25120000
@.@.@                  Store all files in system.                       25122000
                                                                        25124000
file.@.account         Store specified file in any group of             25126000
                       specified account.                               25128000
                                                                        25130000
                                                                        25132000
                                      NOTE                              25134000
                                                                        25136000
              The characters @, #, and ? can be used as "wild card"     25138000
              characters in the fileset parameter.  These wild card     25140000
              characters have the following meanings:                   25142000
                                                                        25144000
              @ -- specifies zero or more alphanumeric characters.      25146000
                                                                        25148000
              # -- specifies one numeric character.                     25150000
                                                                        25152000
              ? -- specifies one alphanumeric character.                25154000
                                                                        25156000
              The characters can be used as follows:                    25158000
                                                                        25160000
              n@      Store all files starting with the character n.    25162000
                                                                        25164000
              @n      Store all files ending with the character n.      25166000
                                                                        25168000
              n@x     Store all files starting with the character n     25170000
                      and ending with the character x.                  25172000
                                                                        25174000
              n##..#  Store all files starting with the character n     25176000
                      followed by up to seven digits (useful for        25178000
                      storing all EDIT/3000 temporary files).           25180000
                                                                        25182000
              ?n@     Store all files whose second character is n.      25184000
                                                                        25186000
              n?      Store all two-character files starting with       25188000
                      the character n.                                  25190000
                                                                        25192000
              ?n      Store all two-character files ending with         25194000
                      the character n.                                  25196000
                                                                        25198000
storefile              Name of designation tape or serial disc file     25200000
                       onto which the stored files are to be written.   25202000
                       can be any magnetic tape or serial disc from     25204000
                       the output set.  This file must be named in a    25206000
                       file statement with the following format and     25208000
                       options:                                         25210000
                                                                        25212000
                           FILE storefile[=filereference][;DEV=device]  25214000
                                [;REC=recordsize][;BUF  ]               25216000
                                                  ;NOBUF                25218000
                                                                        25220000
                       DEV      Specify TAPE or SDISC                   25222000
                                                                        25224000
           REC        Specifies the tape or serial disc record          25226000
                      size.  May be any number which is a multiple      25228000
                      of 256 words (between 256 and 4096 words for      25230000
                      tape or 8192 words for serial disc.)  The         25232000
                      default for non-programmatic calls to STORE       25234000
                      is 4096 words.  For programmatic calls the        25236000
                      default is 1024 words to accomodate programs      25238000
                      written with the old version of STORE.            25240000
                                                                        25242000
                       BUF      User specification on whether buffered  25244000
                                I/O is used to do the store.  For serial25246000
                                disc it is recommended that NOBUF is    25248000
                                used because the system automatically   25250000
                                buffers the transfer.  For tape trans-  25252000
                                fers the default of BUF should be used. 25254000
                                                                        25256000
SHOW                   Request to list names of files stored. Default is25258000
                       total number of files stored, names of files not 25260000
                       stored, and number of files not stored are       25262000
                       listed.  The listing is sent to $STDLIST         25264000
                       (formal designator is SYSLIST) unless a :FILE    25266000
                       command is entered to send the listing to some   25268000
                       other device.  For example,                      25270000
                                                                        25272000
                       :FILE SYSLIST;DEV=LP                             25274000
                                                                        25276000
                       entered before the :STORE command would send the 25278000
                       listing to a line printer.                       25280000
                                                                        25282000
maxfiles               Maximum number of files that may be stored.      25284000
                       Default is 4000.                                 25286000
                                                                        25288000
moddate, accdate       Restricts the files stored to those modified     25290000
                       on or after (>=) or accessed on or before        25292000
                       (<=) the specified date.  The date is ex-        25294000
                       pressed mm/dd/yy.                                25296000
                                                                        25298000
                                                                        25300000
                                                                        25302000
OPERATION                                                               25304000
                                                                        25306000
Stores one or more disc files onto magnetic tape or serial disc.  The   25308000
:STORE command will store only those files whose home volume sets have  25310000
been pre-mounted.                                                       25312000
                                                                        25314000
Users with System Manager or System Supervisor capability can store any 25316000
user file in the system.  Users with Account Manager capability can     25318000
store any file in the account (but cannot dump those with negative file 25320000
codes unless they have Privileged Mode capability also).                25322000
                                                                        25324000
Before entering a :STORE command, you must identify storefile as a      25326000
magnetic tape or serial disc file with a :FILE command written in the   25328000
following format:                                                       25330000
                                                                        25332000
    :FILE formaldesignator[=filereference];DEV=device[REC=recsize]      25334000
     [;BUF]                                                             25336000
     [;NOBUF]                                                           25338000
                                                                        25340000
device          Must indicate the device class name or logical unit     25342000
                number of a magnetic tape or serial disc unit.          25344000
                                                                        25346000
recsize         Sets the size of the blocks on the store tape.  For     25348000
                1600 BPI tapes, the record size may be any multiple     25350000
                of 256 words between 256 and 4096 words.  For serial    25352000
                discs and 6250 BPI tapes, the record size may be any    25354000
                multiple of 256 between 256 and 8192 words.  The        25356000
                default record size for all tapes, except 6250 BPI      25358000
                unlabeled tapes, and for serial discs is 4096.  The     25360000
                default record size for 6250 BPI unlabeled tapes is     25362000
                8192 words.  The directory portion of magnetic tapes    25364000
                is never written larger than 4096 words.                25366000
                                                                        25368000
                                                                        25370000
NOBUF           Will not allow the tape and disc I/O to overlap.  It    25372000
                is suggested that BUF always be used with tape and      25374000
                that NOBUF always be used with serial disc.  Default    25376000
                is BUF.  For unlabeled tapes on the HP 7976A tape       25378000
                drive, NOBUF will be ignored.                           25380000
BUF             Causes the tape and disc I/O to overlap.                25382000
                                                                        25384000
Other parameters for storefile are supplied by the :STORE command.      25386000
If you attempt to supply them, MPE will reject the :STORE               25388000
command.                                                                25390000
                                                                        25392000
If the BREAK key is pressed during a store operation, the operation     25394000
stops after storing the current file and further output is suppressed.  25396000
                                                                        25398000
                                                                        25400000
EXAMPLE                                                                 25402000
                                                                        25404000
To copy all files in the group GP4X in your logon account, to a tape    25406000
file named BACKUP, enter:                                               25408000
                                                                        25410000
    :FILE BACKUP;DEV=TAPE                                               25412000
    :STORE @.GP4X;*BACKUP;SHOW                                          25414000
                                                                        25416000
The console operator receives a request to mount the tape identified as 25418000
BACKUP.  A listing of the files copied appears on your standard list    25420000
device.                                                                 25422000
                                                                        25424000
If a file is in use by the system, the file name is displayed, along    25426000
                                                                        25428000
\STARTHELP                                                              25430000
\ENTRY=STORE,PARMS,OPERATION,EXAMPLE                                    25432000
    :STORE                                                              25434000
                                                                        25436000
Stores disc files onto magnetic tape or serial disc.                    25438000
                                                                        25440000
SYNTAX                                                                  25442000
                                                                        25444000
    :STORE [filesetlist] ; storefile                                    25446000
           [;SHOW[=showparmlist]]                                       25448000
           [;ONERROR=recoverytype]                                      25450000
           [;FILES=maxfiles][; DATE<=accdate]                           25452000
                             ; DATE>=moddate                            25454000
\ITEM=PARMS                                                             25456000
PARAMETERS                                                              25458000
                                                                        25460000
filesetlist            Specifies the set of files to be stored.  Default25462000
                       is @.  This parameter is of the form:            25464000
                                                                        25466000
                                 !indirectfilename                      25468000
                                         or                             25470000
                                 fileset [,fileset] [...] [,fileset]    25472000
                                                                        25474000
indirectfilename       A filename that may be backreferenced to a disc  25476000
                       file.  This file includes both the filesets and  25478000
                       options to STORE.                                25480000
                                                                        25482000
fileset                Specifies a set of files to be stored.  All files25484000
                       that match filestostore will be stored unless    25486000
                       the file also matches the filesnottostore.  The  25488000
                       syntax is:                                       25490000
                                                                        25492000
                              filestostore [ - filesnottostore]         25494000
                                                                        25496000
                       where filestostore and filesnottostore are file  25498000
                       designators.                                     25500000
                                                                        25502000
filedesignator         Describes one or many files.  Wild cards are     25504000
                       permitted for any of the three parts.  The       25506000
                       syntax is:                                       25508000
                                                                        25510000
                          filedesig[.groupdesig[.acctdesig]]            25512000
                                                                        25514000
                                      NOTE                              25516000
                                                                        25518000
              The characters @, #, and ? can be used as "wild card"     25520000
              characters in the fileset parameter.  These wild card     25522000
              characters have the following meanings:                   25524000
                                                                        25526000
              @ -- specifies zero or more alphanumeric characters.      25528000
                                                                        25530000
              # -- specifies one numeric character.                     25532000
                                                                        25534000
              ? -- specifies one alphanumeric character.                25536000
                                                                        25538000
storefile              Name of destination tape or serial disc file     25540000
                       onto which the stored files are to be written.   25542000
                       This can be any magnetic tape or serial disc from25544000
                       the output set.                                  25546000
                                                                        25548000
SHOW                   If the SHOW parameter is present then information25550000
                       is reported for every file that is stored.  If   25552000
                       the SHOW parameter is not present then only the  25554000
                       names of files not stored, and the number of     25556000
                       files stored and not stored are listed.  The     25558000
                       listing is sent to $STDLIST (formal designator is25560000
                       SYSLIST) unless a :FILE command is entered to    25562000
                       send the listing to some other device.  For      25564000
                       example,                                         25566000
                                                                        25568000
                       :FILE SYSLIST;DEV=LP                             25570000
                                                                        25572000
                       entered before the :STORE command would send the 25574000
                       listing to a line printer.                       25576000
                                                                        25578000
showparmlist           Tells store what information to display for      25580000
                       files stored.  If show is present, but           25582000
                       showparmlist is not then the default is          25584000
                       SHORT if the recordsize of SYSLIST is less       25586000
                       than 99 characters, and LONG otherwise.          25588000
                       The format for showparmlist is                   25590000
                                                                        25592000
                            showparm [,showparm][. . .][,showparm]      25594000
                                                                        25596000
showparm               May be one of SHORT, LONG, DATES, SECURITY,      25598000
                       or OFFLINE.  If neither SHORT or LONG are        25600000
                       selected then the base information is SHORT      25602000
                       if SYSLIST is less than 99 characters, and       25604000
                       LONG otherwise.                                  25606000
                                                                        25608000
SHORT                  Overrides default of LONG, and displays filename,25610000
                       groupname, acctname, logical device number,      25612000
                       sector address, reel number, and file size       25614000
                       in sectors.                                      25616000
                                                                        25618000
LONG                   Overrides default of SHORT, and displays all     25620000
                       information that SHORT does and additional       25622000
                       displays record size, filetype, eof, file record 25624000
                       limit, blocking factor, extents allocated and    25626000
                       maximum number of extents.                       25628000
                                                                        25630000
DATES                  Additionally displays creation date, last access 25632000
                       date, and last modification date.                25634000
                                                                        25636000
SECURITY               Additionally displays file creator, and file     25638000
                       security matrix.                                 25640000
                                                                        25642000
OFFLINE                Sends an additional copy to the file OFFLINE,    25644000
                       which defaults to device LP.                     25646000
                                                                        25648000
ONERROR                Tells STORE what to do in the case of a tape     25650000
                       write error.  If not present then the default is 25652000
                       QUIT for labeled tapes and REDO for unlabeled    25654000
                       tapes.  ONERR is a synonym for ONERROR.          25656000
                                                                        25658000
recoverytype           Is either QUIT or REDO.                          25660000
                                                                        25662000
QUIT                   Tells STORE to abort after a tape write error.   25664000
                                                                        25666000
REDO                   Tells STORE to do error recovery on a tape write 25668000
                       error.  First the tape is rewound, and a bad     25670000
                       record is written to the beginning of tape. The  25672000
                       tape is then unloaded and a new tape begins at   25674000
                       the same point that the tape with the error did. 25676000
                                                                        25678000
                                                                        25680000
maxfiles               Maximum number of files that may be stored.      25682000
                       Default is 4000.                                 25684000
                                                                        25686000
moddate, accdate       Restricts the files stored to those modified     25688000
                       on or after (>=) or accessed on or before        25690000
                       (<=) the specified date.  The date is ex-        25692000
                       pressed mm/dd/yy.                                25694000
                                                                        25696000
                                                                        25698000
\ITEM=OPERATION                                                         25700000
OPERATION                                                               25702000
                                                                        25704000
Stores one or more disc files onto magnetic tape or serial disc.  The   25706000
:STORE command will store only those files whose home volume sets have  25708000
been pre-mounted.                                                       25710000
                                                                        25712000
Users with System Manager or System Supervisor capability can store any 25714000
user file in the system.  Users with Account Manager capability can     25716000
store any file in the account (but cannot dump those with negative file 25718000
codes unless they have Privileged Mode capability also).                25720000
                                                                        25722000
Before entering a :STORE command, you must identify storefile as a      25724000
magnetic tape or serial disc file with a :FILE command written in the   25726000
following format:                                                       25728000
                                                                        25730000
    :FILE formaldesignator[=filereference];DEV=device[REC=recsize]      25732000
     [;BUF]                                                             25734000
     [;NOBUF]                                                           25736000
                                                                        25738000
device          Must indicate the device class name or logical unit     25740000
                number of a magnetic tape or serial disc unit.          25742000
                                                                        25744000
recsize         Sets the size of the blocks on the store tape.  For     25746000
                1600 BPI tapes, the record size may be any multiple     25748000
                of 256 words between 256 and 4096 words.  For serial    25750000
                discs and 6250 BPI tapes, the record size may be any    25752000
                multiple of 256 between 256 and 8192 words.  The        25754000
                default record size for all tapes, except 6250 BPI      25756000
                unlabeled tapes, and for serial discs is 4096.  The     25758000
                default record size for 6250 BPI unlabeled tapes is     25760000
                8192 words.  The directory portion of magnetic tapes    25762000
                is never written larger than 4096 words.                25764000
                                                                        25766000
                                                                        25768000
NOBUF           Will not allow the tape and disc I/O to overlap.  It    25770000
                is suggested that BUF always be used with tape and      25772000
                that NOBUF always be used with serial disc.  Default    25774000
                is BUF.  For unlabeled tapes on the HP 7976A tape drive,25776000
                NOBUF will be ignored.  Recommended for Serial Disc.    25778000
                                                                        25780000
BUF             Causes the tape and disc I/O to overlap.  Recommended   25782000
                for Magnetic Tape.                                      25784000
                                                                        25786000
Other parameters for storefile are supplied by the :STORE command.      25788000
If you attempt to supply them, MPE will reject the :STORE               25790000
command.                                                                25792000
                                                                        25794000
If the BREAK key is pressed during a store operation, the operation     25796000
stops after storing the current file and further output is suppressed.  25798000
                                                                        25800000
\ITEM=EXAMPLE                                                           25802000
EXAMPLE                                                                 25804000
                                                                        25806000
To store all files in the group GP4X in your logon account, to a tape   25808000
file named BACKUP, enter:                                               25810000
                                                                        25812000
    :FILE BACKUP;DEV=TAPE                                               25814000
    :STORE @.GP4X;*BACKUP;SHOW                                          25816000
                                                                        25818000
The console operator receives a request to mount the tape identified as 25820000
BACKUP.  A listing of the files stored appears on your standard list    25822000
device.                                                                 25824000
                                                                        25826000
                                                                        25828000
To store all files on the system except the files in the SYS            25830000
account, enter:                                                         25832000
                                                                        25834000
    :FILE TAP;DEV=TAPE                                                  25836000
    :STORE @.@.@-@.@.SYS;*TAP;SHOW=SECURITY,DATES,LONG,OFFLINE          25838000
                                                                        25840000
The console operator receives a request to mount the tape identified as 25842000
TAP.  A listing of the files stored appears on both standard list and   25844000
at the system lineprinter.  The listing will include all information    25846000
available from STORE.                                                   25848000
                                                                        25850000
                                                                        25852000
To store from indirect file INDFILE which contains:                     25854000
                                                                        25856000
               FILE1,FILE2;SHOW                                         25858000
               FILE3,@.PUB.SYS                                          25860000
               ;DATE>=6/1/83                                            25862000
enter:                                                                  25864000
                                                                        25866000
    :FILE T;DEV=TAPE                                                    25868000
    :STORE !INDFILE;*T                                                  25870000
                                                                        25872000
The console operator receives a request to mount the tape identified as 25874000
T.  Files FILE1, FILE2, FILE3 and all files in PUB.SYS will be stored   25876000
if they have been modified since June 1, 1983.  A listing of the files  25878000
stored appears on your standard list device.                            25880000
\ENTRY=STREAM,PARMS,OPERATION,EXAMPLE                                   25882000
    :STREAM                                                             25884000
                                                                        25886000
Spools batch jobs or data from session or job.                          25888000
                                                                        25890000
SYNTAX                                                                  25892000
                                                                        25894000
    :STREAM [inputfile][,character]                                     25896000
                                                                        25898000
\ITEM=PARMS                                                             25900000
PARAMETERS                                                              25902000
                                                                        25904000
inputfile        File designator of ASCII input file from which jobs or 25906000
                 data are spooled to disc.  May be a disc file created  25908000
                 with the Editor and containing commands or data; or a  25910000
                 file input from a card reader, tape unit, or terminal. 25912000
                 Records in this file cannot exceed 255 characters.  All25914000
                 character positions within each record are significant.25916000
                 Default is $STDIN.                                     25918000
                                                                        25920000
character        Character used in place of colon (:) to identify MPE   25922000
                 commands within <inputfile>.  When <inputfile> is      25924000
                 entered on device configured to accept jobs sessions or25926000
                 data input via the :DATA command, this character can be25928000
                 any ASCII special (non-alphanumeric) character except a25930000
                 colon.  Default is exclamation point (!).              25932000
                                                                        25934000
\ITEM=OPERATION                                                         25936000
OPERATION                                                               25938000
                                                                        25940000
Spools batch jobs and data from inputfile to disc, and schedules each   25942000
job independently.  Most commonly used for initiating batch jobs from   25944000
sessions.                                                               25946000
                                                                        25948000
For this command to take effect, the Console Operator must first enable 25950000
streaming with the :STREAMS command.                                    25952000
                                                                        25954000
When you enter :STREAM with the terminal as the default input device,   25956000
whether during a session or job, MPE prompts you for input by displaying25958000
a greater than (>) character.  When you enter :STREAM for another input 25960000
device, MPE does not print the prompt character.  In any case, you      25962000
terminate <inputfile> by entering the :EOD command.  At the terminal,   25964000
this halts prompting for job input and returns control to your job/     25966000
session.                                                                25968000
                                                                        25970000
Begin each job in <inputfile> with the JOB command and terminate it with25972000
the EOJ command.  Begin each data file with the DATA command and        25974000
terminate this file with the EOD command.  Begin all commands with an   25976000
appropriate substitute (other than colon) character, as in !JOB or      25978000
#DATA.  When <inputfile> is spooled to disc, MPE replaces the substitute25980000
command identifier with a colon so that command reports are properly    25982000
interpreted when executed.                                              25984000
                                                                        25986000
MPE assigns each job a unique job number, and prints this number on the 25988000
standard list device.  MPE also assigns each job a preset priority      25990000
unless you specify otherwise in the JOB command, and processes the job  25992000
independent of the initiating job.  Regardless of which device you use  25994000
to submit the <inputfile>, all jobs in that file are treated as though  25996000
they originated on a unique streaming device designated by the Console  25998000
Operator (with the :STREAMS command).  The listing for each spooled job 26000000
is written to the standard list device that corresponds to the streaming26002000
device, unless you use the OUTCLASS= parameter of the JOB command to    26004000
direct the listing to another device.                                   26006000
                                                                        26008000
Pressing the BREAK key aborts the :STREAM command and any job currently 26010000
being entered through the command.                                      26012000
                                                                        26014000
\ITEM=EXAMPLE                                                           26016000
EXAMPLE                                                                 26018000
                                                                        26020000
To initiate, from a session, a batch job that compiles, prepares, and   26022000
executes the FORTRAN program MYPROG, enter:                             26024000
                                                                        26026000
    :STREAM                                                             26028000
    >!JOB SOFT.PUBS                                                     26030000
    >!FORTGO MYPROG                                                     26032000
    >!EOJ                                                               26034000
     #J73  (Job number returned by MPE)                                 26036000
    >!EOD                                                               26038000
                                                                        26040000
                                                                        26042000
\ENTRY=STREAMS,PARMS,OPERATION,EXAMPLE                                  26044000
     :STREAMS                                                           26046000
                                                                        26048000
Enables or disables the user's ability to submit job/session and/or     26050000
data streams.                                                           26052000
                                                                        26054000
SYNTAX                                                                  26056000
                                                                        26058000
              {ldn}                                                     26060000
     :STREAMS {   }                                                     26062000
              {OFF}                                                     26064000
                                                                        26066000
\ITEM=PARMS                                                             26068000
PARAMETERS                                                              26070000
                                                                        26072000
ldn          The logical device number of the device being enabled.     26074000
             Any accepting input device can be used, except termi-      26076000
             nals or the system console.                                26078000
                                                                        26080000
OFF          Disables the stream facility.                              26082000
                                                                        26084000
\ITEM=OPERATION                                                         26086000
OPERATION                                                               26088000
                                                                        26090000
This command enables users to designate any file containing jobs        26092000
(or data) which is then spooled in as if it came from a normal          26094000
accepting device.  The device is in no way affected (its state          26096000
is unaltered; a spooler is not created for it, etc.).  The state        26098000
of the device also is not relevant - it can be job and/or data-         26100000
accepting.                                                              26102000
                                                                        26104000
STREAMS is disabled on all cold loads.                                  26106000
                                                                        26108000
\ITEM=EXAMPLE                                                           26110000
EXAMPLES                                                                26112000
                                                                        26114000
To enable jobs and data streams on logical device number 5, enter:      26116000
                                                                        26118000
     :STREAMS 5                                                         26120000
                                                                        26122000
To disable data streams, enter:                                         26124000
                                                                        26126000
     :STREAMS OFF                                                       26128000
                                                                        26130000
                                                                        26132000
\ENTRY=SUSPENDSPOOL,PARMS,OPERATION,EXAMPLE                             26134000
     :SUSPENDSPOOL                                                      26136000
                                                                        26138000
Causes a spooled device to stop operation.                              26140000
                                                                        26142000
SYNTAX                                                                  26144000
                                                                        26146000
     :SUSPENDSPOOL ldn [;FINISH]                                        26148000
                                                                        26150000
\ITEM=PARMS                                                             26152000
PARAMETERS                                                              26154000
                                                                        26156000
ldn          The logical device number of a particular device.          26158000
                                                                        26160000
FINISH       Causes a spooled device to continue to completion          26162000
             of the currently active spool file, and then stop.         26164000
                                                                        26166000
\ITEM=OPERATION                                                         26168000
OPERATION                                                               26170000
                                                                        26172000
None.                                                                   26174000
                                                                        26176000
                                                                        26178000
                                                                        26180000
                                                                        26182000
                                                                        26184000
\ITEM=EXAMPLE                                                           26186000
EXAMPLES                                                                26188000
                                                                        26190000
To cause logical device number 6 (a line printer) to stop printing,     26192000
enter:                                                                  26194000
                                                                        26196000
     :SUSPENDSPOOL 6                                                    26198000
                                                                        26200000
To cause logical device number 6 (a line printer) to continue to        26202000
print and stop when completed, enter:                                   26204000
                                                                        26206000
     :SUSPENDSPOOL 6;FINISH                                             26208000
                                                                        26210000
\ENTRY=SWITCHLOG,PARMS,OPERATION,EXAMPLE                                26212000
    :SWITCHLOG (System Supervisor capability required)                  26214000
                                                                        26216000
Closes the current Log File, and creates and opens a new Log File.      26218000
                                                                        26220000
SYNTAX                                                                  26222000
                                                                        26224000
    :SWITCHLOG                                                          26226000
                                                                        26228000
\ITEM=PARMS                                                             26230000
PARAMETERS                                                              26232000
                                                                        26234000
None                                                                    26236000
                                                                        26238000
\ITEM=OPERATION                                                         26240000
OPERATION                                                               26242000
                                                                        26244000
(System Supervisor capability required)                                 26246000
This command closes the current Log File, and creates and opens a new   26248000
Log File.  The new Log File becomes the current Log File.               26250000
                                                                        26252000
If logging is disabled when :SWITCHLOG is entered, no action is taken.  26254000
                                                                        26256000
MPE displays the following information when :SWITCHLOG is entered:      26258000
                                                                        26260000
    LOGFILE LOGxxxx IS yy% FULL                                         26262000
    LOG FILE NUMBER zzzz ON                                             26264000
                                                                        26266000
where                                                                   26268000
                                                                        26270000
    xxxx - is the previous Log File number.                             26272000
                                                                        26274000
    yy - is the percentage of file space used.                          26276000
                                                                        26278000
    zzzz - current log file now opened (increment of 1 over last Log    26280000
           File number).                                                26282000
                                                                        26284000
If logging is enabled but not currently suspended, MPE displays the     26286000
message:                                                                26288000
                                                                        26290000
    NO LOGGING                                                          26292000
                                                                        26294000
\ITEM=EXAMPLE                                                           26296000
EXAMPLE                                                                 26298000
                                                                        26300000
To switch logging to a new Log File, enter:                             26302000
                                                                        26304000
    :SWITCHLOG                                                          26306000
                                                                        26308000
                                                                        26310000
\ENTRY=SYSDUMP,PARMS,OPERATION,EXAMPLE                                  26312000
    :SYSDUMP (System Supervisor capability required)                    26314000
                                                                        26316000
Starts Configurator dialog and copies MPE to tape.                      26318000
                                                                        26320000
SYNTAX                                                                  26322000
                                                                        26324000
    :SYSDUMP dumpfile[,auxlistfile]                                     26326000
                                                                        26328000
\ITEM=PARMS                                                             26330000
PARAMETERS                                                              26332000
                                                                        26334000
dumpfile        A back reference to a previous :FILE command that       26336000
                defines the file on which the modified or duplicate     26338000
                system is to be written.  This back reference must      26340000
                indicate a magnetic tape file.  Formal designator is    26342000
                DUMPTAPE.  Use the following file statement form:       26344000
                                                                        26346000
                    FILE dumpfile[=filereference][;DEV=device]          26348000
                         [;REC=recordsize][;BUF  ]                      26350000
                                           ;NOBUF                       26352000
                                                                        26354000
                       REC      Specifies the tape record size.  May    26356000
                                be any number which is a multiple of    26358000
                                256 words between 256 and 8192 words.   26360000
                                The default for non-programmatic calls  26362000
                                to SYSDUMP is 4096 words.  For pro-     26364000
                                grammatic calls the default is 1024     26366000
                                words to accomodate programs written    26368000
                                with the old version of SYSDUMP.        26370000
                                                                        26372000
                       BUF      User specification on whether buffered  26374000
                                I/O is used to do the store.  For serial26376000
                                disc it is recommended that NOBUF is    26378000
                                used because the system automatically   26380000
                                buffers the transfer.  For tape trans-  26382000
                                fers the default of BUF should be used. 26384000
                                                                        26386000
                                                                        26388000
auxlistfile     Actual file designator of the output file (device) to   26390000
                which all listings requested during the Configur-       26392000
                ator/User dialog are written.  The formal file          26394000
                designator used by the :SYSDUMP command executor for    26396000
                this file is SYSLIST; the formal file designator used by26398000
                the MPE Segmenter (when it is invoked to add or replace 26400000
                SL segments) for this file is SEGLIST.  Default is      26402000
                $STDLIST.                                               26404000
                                                                        26406000
\ITEM=OPERATION                                                         26408000
OPERATION                                                               26410000
                                                                        26412000
(System Supervisor capability required)                                 26414000
This command starts the Configurator/User dialog and copies MPE to      26416000
magnetic tape.                                                          26418000
                                                                        26420000
In addition to the names of the files to be used for <dumpfile> and     26422000
<auxlistfile> output, you must specify what types of devices these files26424000
are to reside on.  You do this by preceding the :SYSDUMP command with   26426000
MPE :FILE commands defining each of the two files.  Then, in the        26428000
:SYSDUMP command, you precede each <filename> with an asterisk (*) to   26430000
indicate a back reference to the definitions in the :FILE commands.     26432000
                                                                        26434000
\ITEM=EXAMPLE                                                           26436000
EXAMPLE                                                                 26438000
                                                                        26440000
To begin dialog with the MPE Configurator, the :SYSDUMP command is      26442000
entered.  At the end of the dialog, the MPE configuration requested is  26444000
copied to the file named DUMP.  Any listings requested  during the      26446000
dialog are output to the file named LIST.  The first :FILE command      26448000
specifies that DUMP is a magnetic tape file; the second :FILE command   26450000
defines LIST as a line printer.  (In the :FILE commands, the TAPE and LP26452000
parameters are device class names arbitrarily defined by a user during  26454000
the previous configuration.)                                            26456000
                                                                        26458000
    :FILE DUMP;DEV=TAPE                                                 26460000
    :FILE LIST;DEV=LP                                                   26462000
    :SYSDUMP *DUMP,*LIST                                                26464000
                                                                        26466000
                                                                        26468000
\ENTRY=TAKE,PARMS,OPERATION,EXAMPLE                                     26470000
     :TAKE                                                              26472000
                                                                        26474000
De-assigns a :GIVEn device from diagnostics.                            26476000
                                                                        26478000
SYNTAX                                                                  26480000
                                                                        26482000
     :TAKE ldn                                                          26484000
                                                                        26486000
\ITEM=PARMS                                                             26488000
PARAMETERS                                                              26490000
                                                                        26492000
ldn          The logical device number of the device taken from         26494000
             diagnostics but left :DOWNed.                              26496000
                                                                        26498000
\ITEM=OPERATION                                                         26500000
OPERATION                                                               26502000
                                                                        26504000
None.                                                                   26506000
                                                                        26508000
\ITEM=EXAMPLE                                                           26510000
EXAMPLES                                                                26512000
                                                                        26514000
To take logical device number 35 from diagnostics, enter:               26516000
                                                                        26518000
     :TAKE 35                                                           26520000
     :SHOWDEV 35                                                        26522000
     LDEV   AVAIL      OWNERSHIP      VOLID                             26524000
                                                                        26526000
      35  A UNAVAIL    DOWN                                             26528000
     :UP 35                                                             26530000
     :SHOWDEV 35                                                        26532000
     LDEV   AVAIL      OWNERSHIP      VOLID                             26534000
                                                                        26536000
      35  A AVAIL                                                       26538000
                                                                        26540000
\ENTRY=TELL,PARMS,OPERATION,EXAMPLE                                     26542000
    :TELL                                                               26544000
                                                                        26546000
Sends a message to another job or session.                              26548000
                                                                        26550000
SYNTAX                                                                  26552000
                                                                        26554000
\starthelp                                                              26556000
\STARTHELP                                                              26558000
            [#]Snnn                                                     26560000
            [sname,]username.acctname                                   26562000
    :TELL {  @                           };[text]                       26564000
             @.acctname                                                 26566000
\STARTHELP                                                              26568000
             @S                                                         26570000
\STARTHELP                                                              26572000
                                                                        26574000
                                                                        26576000
\ITEM=PARMS                                                             26578000
PARAMETERS                                                              26580000
                                                                        26582000
\STARTHELP                                                              26584000
\STARTHELP                                                              26586000
                                                                        26588000
#Snnn              Session number (as assigned by MPE) of the session   26590000
                   that is to receive the message.                      26592000
                                                                        26594000
sname,username.    Names of the session and user to receive the         26596000
acctname           message, and the account name under which they are   26598000
                   running.  (This parameter is the same as the job     26600000
                   identity entered with the :HELLO command to          26602000
                   initiate the session.)                               26604000
\starthelp                                                              26606000
                                                                        26608000
                   If several users are running under the same          26610000
                   session identity, MPE will send the message to all   26612000
                   users.                                               26614000
                                                                        26616000
@                  All users.                                           26618000
                                                                        26620000
@.acctname         All users under acctname.                            26622000
                                                                        26624000
\STARTHELP                                                              26626000
\STARTHELP                                                              26628000
@S                 All sessions.                                        26630000
                                                                        26632000
text               Message text, consisting of any string of ASCII      26634000
                   characters.  Default is no message is transmitted;   26636000
                   however, MPE prints the FROM message as follows:     26638000
                                                                        26640000
                       FROM/sessionid/                                  26642000
                                                                        26644000
\starthelp                                                              26646000
\ITEM=OPERATION                                                         26648000
OPERATION                                                               26650000
                                                                        26652000
Transmits a message from the senders session to one or more             26654000
sessions running currently.  The message appears on the receiving       26656000
session list device.                                                    26658000
                                                                        26660000
If a message is sent to a terminal that is currently interacting with a 26662000
program, MPE queues the message as high as possible among the current   26664000
input/output requests but does not interrupt reading or writing in      26666000
progress.  If the session or user designated to receive the message     26668000
is not running, the transmitting session receives a system message      26670000
indicating this.  MPE rejects the :TELL command if the receiving        26672000
device is operating in the QUIET mode (see :SETMSG command).  MPE       26674000
also rejects attempts to do a TELL to a JOB.                            26676000
                                                                        26678000
\ITEM=EXAMPLE                                                           26680000
EXAMPLE                                                                 26682000
                                                                        26684000
To send a message to a user identified as BROWN, logged on under account26686000
A, running a session named BROWNSES, enter:                             26688000
                                                                        26690000
    :TELL BROWNSES,BROWN.A; message text                                26692000
                                                                        26694000
To send a message to all users logged on in account A:                  26696000
                                                                        26698000
    :TELL @.A;message text                                              26700000
                                                                        26702000
                                                                        26704000
\ENTRY=TELLOP,PARMS,OPERATION,EXAMPLE                                   26706000
    :TELLOP                                                             26708000
                                                                        26710000
Sends message to Console Operator.                                      26712000
                                                                        26714000
SYNTAX                                                                  26716000
                                                                        26718000
    :TELLOP [text]                                                      26720000
                                                                        26722000
\ITEM=PARMS                                                             26724000
PARAMETERS                                                              26726000
                                                                        26728000
text            Message text, consisting of any string of ASCII         26730000
                characters. Default is                                  26732000
                no message is sent.                                     26734000
                                                                        26736000
\ITEM=OPERATION                                                         26738000
OPERATION                                                               26740000
                                                                        26742000
Sends a message from the sender's job/session to the operator's console.26744000
The message appears in this format:                                     26746000
                                                                        26748000
\ITEM=EXAMPLE                                                           26750000
EXAMPLE                                                                 26752000
                                                                        26754000
To send a message to the operator instructing him to mount a tape, you  26756000
could enter:                                                            26758000
                                                                        26760000
    :TELLOP PLS MOUNT MYTAPE, VERSION I                                 26762000
                                                                        26764000
                                                                        26766000
\ENTRY=TUNE                                                             26768000
     :TUNE                                                              26770000
                                                                        26772000
Changes the filter and/or priority limits of the circular subqueues.    26774000
                                                                        26776000
SYNTAX                                                                  26778000
                            CQ                                          26780000
    :TUNE [minclockcycle][;{DQ} = [base][,[limit][,[min][,[max]]]]]     26782000
                            EQ                                          26784000
                                                                        26786000
                                                                        26788000
\ITEM=PARMS                                                             26790000
PARAMETERS                                                              26792000
                                                                        26794000
minclockcycle       Minimum value (in milliseconds) for replacement     26796000
                    algorithm cycle through memory.  If algorithm       26798000
                    cycles through memory in less time than this value, 26800000
                    memory allocation is delayed.  (thrash prevention   26802000
                    mechanism.)                                         26804000
                                                                        26806000
base                Priority at which C, D, or E processes will begin   26808000
                    in queue.                                           26810000
                                                                        26812000
limit               Worst (highest number) priority C, D, or E processes26814000
                    can attain.                                         26816000
                                                                        26818000
min                 The minimum value indicating the length of time     26820000
                    (filter value) in milliseconds which a process can  26822000
                    have the CPU before its priority is reduced.        26824000
                                                                        26826000
max                 The maximum value indicating the length of time     26828000
                    (filter value) in milliseconds which a process can  26830000
                    have the CPU before its priority is reduced.        26832000
\STOPHELP                                                               26834000
\STARTHELP                                                              26836000
                                                                        26838000
NOTE:  Currently min must equal max for D and E subqueues.  Also, the   26840000
       following relationships must hold:                               26842000
       base<=limit and min<=max.                                        26844000
                                                                        26846000
\ITEM=OPERATION                                                         26848000
OPERATION                                                               26850000
                                                                        26852000
This command changes the filter or priority limits of a circular        26854000
subqueue, and is used primarily in on-line tuning of the system         26856000
to best accomodate the current load.                                    26858000
                                                                        26860000
CAUTION! MISUSE OF THIS COMMAND CAN SIGNIFICANTLY DEGRADE SYSTEM        26862000
         OPERATING EFFICIENCY!                                          26864000
                                                                        26866000
A CS process is given a priority of CBASE when it begins.  When a       26868000
process stops (for disc I/O, terminal I/O, preemption, etc.), a         26870000
new priority is determined so that it may be re-queued for the cpu.     26872000
If the process has completed a transaction ( a transaction is defined   26874000
as the time between terminal reads), the priority become CBASE.  The    26876000
value of an "average short transaction" is then recalculated.  If the   26878000
CS process has not completed a transaction, and if the process has      26880000
exceeded the average short transaction filter value since its priority  26882000
was last reduced, the priority is decreased by 2.  Also, if the process 26884000
stopped because it needed memory resources, its priority is decreased by26886000
1.                                                                      26888000
                                                                        26890000
DS and ES processes begin at DBASE and EBASE respectively, and are re-  26892000
scheduled according to the same criteria as used for CS processes, with 26894000
the exception that a fixed value (the value of max which has been       26896000
specified for the subqueue) is used in place of the average short       26898000
transaction value, which is used for CS processes only.                 26900000
                                                                        26902000
If the values specified for max in the CS, DS, and ES queues are        26904000
too large, system response may become erratic.  If they are too         26906000
small, excessive swapping may result because process-swapping occurs    26908000
too frequently.  In either case, system performance is degraded.        26910000
Recommended settings for min and max for the CS subqueue are 0 and      26912000
300, as it is desirable to favor short transactions in most cases.  A   26914000
value for min and max of 10,000 usually produces efficient system       26916000
operation for the DS and ES subqueues.                                  26918000
                                                                        26920000
The minclockcycle parameter is used by the memory manager to determine  26922000
when thrashing (excessive memory management activity) is occuring.      26924000
Making this value smaller increases the probability of thrasing.        26926000
Recommended value for this parameter is 1000.                           26928000
                                                                        26930000
\ITEM=EXAMPLE                                                           26932000
EXAMPLE                                                                 26934000
                                                                        26936000
   To set the minimum clock cycle to 1000 and CQ base to 152, and       26938000
   DQ minimum and maximum filter to 10000, enter:                       26940000
                                                                        26942000
   :TUNE 1000;CQ=152;DQ=,,10000,10000                                   26944000
                                                                        26946000
\ENTRY=UP,PARMS,OPERATION,EXAMPLE                                       26948000
     :UP                                                                26950000
                                                                        26952000
Allows a :DOWNed device to function again.                              26954000
                                                                        26956000
SYNTAX                                                                  26958000
                                                                        26960000
     :UP ldn                                                            26962000
                                                                        26964000
\ITEM=PARMS                                                             26966000
PARAMETERS                                                              26968000
                                                                        26970000
ldn          The logical device number of a particular device being     26972000
             placed on-line.                                            26974000
                                                                        26976000
\ITEM=OPERATION                                                         26978000
OPERATION                                                               26980000
                                                                        26982000
This command allows a previously DOWNed device to function again,       26984000
but does not change ownership of the device.                            26986000
                                                                        26988000
\ITEM=EXAMPLE                                                           26990000
EXAMPLES                                                                26992000
                                                                        26994000
To allow logical device number 10 to function again, enter:             26996000
                                                                        26998000
     :UP 10                                                             27000000
     :SHOWDEV 10                                                        27002000
     LDEV   AVAIL      OWNERSHIP      VOLID                             27004000
                                                                        27006000
      10  A AVAIL                                                       27008000
                                                                        27010000
                              NOTE                                      27012000
                                                                        27014000
              When this device was :DOWNed, it was owned by             27016000
              the system and remains unchanged by the :UP               27018000
              command.                                                  27020000
                                                                        27022000
\ENTRY=VFC                                                              27024000
     VERTICAL FORMAT CONTROL (VFC)                                      27026000
                                                                        27028000
If your system has an HP 2608 line printer, you may receive a           27030000
forms message requesting specific forms, and the Vertical               27032000
Format Control (VFC) needed for printing a particular job/session.      27034000
                                                                        27036000
The file containing the VFC image consists of at least one record       27038000
and is an ASCII file.                                                   27040000
                                                                        27042000
If a margin setting is desired then the first record consists of        27044000
a record containing the string "MARGIN=nn" where "nn" is between        27046000
1 and 16 inclusive; the next (or first if no MARGIN) record             27048000
identifies the following records of the file as a VFC image and         27050000
contains a record of 80 bytes with the string "VFC" in columns          27052000
1 through 3.  Column 5 contains either a 6, 8, or a blank,              27054000
indicating the number of lines per inch.  (The default is 6 lines       27056000
per inch.)  Following the lines per inch is the number of print         27058000
lines per page.  This number must be between 0 and 127 inclusive.       27060000
If "0" is specified then the printer resets its internal VFC to         27062000
the default state.  All parameters are separated by commas.             27064000
                                                                        27066000
The following records contain an ASCII representation of the VFC        27068000
image of 1 to 127 records at least 16 bytes each.  A blank              27070000
or a zero in a column indicates a 0 or no-punch; Column 1               27072000
of the record corresponds to channel 1, column 2 is channel 2,          27074000
and so on up to channel 16.  Each record corresponds to a line          27076000
position on the page.                                                   27078000
                                                                        27080000
Channel 3 is the single space channel.  Channel 3 must be defined       27082000
in order to single space, otherwise, the line printer will advance      27084000
the paper one page length for each line printed.  Additionally,         27086000
it is recommended that Channel 1 be defined.  If Channel 1 is not       27088000
defined a warning will be issued to the operator's console              27090000
stating the top of form must be alligned.                               27092000
                                                                        27094000
                           NOTE                                         27096000
                                                                        27098000
          If a selected VFC channel is blank, the paper                 27100000
          will advance one page length; and the next                    27102000
          print line will be the same but on the next                   27104000
          page.  The page length also is defaulted to                   27106000
          11 inches if not specifically programmed to                   27108000
          another value.                                                27110000
                                                                        27112000
The examples, which follow, illustrate this format:                     27114000
                                                                        27116000
o A standard vfc for 6 lines per inch called VFC6.                      27118000
                                                                        27120000
                               1111111                                  27122000
            column    1234567890123456                                  27124000
                                                                        27126000
                      VFC,6,0                                           27128000
                                                                        27130000
                                                                        27132000
o A special vfc for 6 lines per inch setting the margin to 4.           27134000
  Channel 1 is the top of the page and there are 66 lines per           27136000
  page.  Channel 2 is defined for lines 12 and 24.                      27138000
                                                                        27140000
                      MARGIN=4                                          27142000
                      VFC,6,66                                          27144000
                      1                                                 27146000
                      0                                                 27148000
                      0                                                 27150000
                      0                                                 27152000
                      0                                                 27154000
                      0                                                 27156000
                      0                                                 27158000
                      0                                                 27160000
                      0                                                 27162000
                      0                                                 27164000
                      0                                                 27166000
          (line 12)   01                                                27168000
                      0                                                 27170000
                      0                                                 27172000
                      0                                                 27174000
                      0                                                 27176000
                      0                                                 27178000
                      0                                                 27180000
                      0                                                 27182000
                      0                                                 27184000
                      0                                                 27186000
                      0                                                 27188000
                      0                                                 27190000
          (line 24)   01                                                27192000
                                                                        27194000
  Note:  If no channel specifications appear below line 24 then         27196000
         an EOF can occur after record 24 in this example.  Also,       27198000
         blanks and zeros are interchangeable.                          27200000
                                                                        27202000
o A special vfc for 8 lines per inch.  Channel 1 is top of page.        27204000
  There are 88 lines per page, and channel 9 is line 13.                27206000
                                                                        27208000
                      VFC,8,88                                          27210000
                      1                                                 27212000
                      0                                                 27214000
                      0                                                 27216000
                      0                                                 27218000
                      0                                                 27220000
                      0                                                 27222000
                      0                                                 27224000
                      0                                                 27226000
                      0                                                 27228000
                      0                                                 27230000
                      0                                                 27232000
                      0                                                 27234000
                      000000001                                         27236000
                                                                        27238000
Note:  Refer to DOWNLOAD command for use of VFC files.                  27240000
                                                                        27242000
\ENTRY=VINIT,PARMS,OPERATION,EXAMPLE                                    27244000
                                                                        27246000
    :VINIT (System Supervisor capability required)                      27248000
                                                                        27250000
Accesses the Vinit subsystem.                                           27252000
                                                                        27254000
SYNTAX                                                                  27256000
                                                                        27258000
    :VINIT [listdevice]                                                 27260000
                                                                        27262000
\ITEM=PARMS                                                             27264000
PARAMETERS                                                              27266000
                                                                        27268000
listdevice       Device name of a device to receive output generated    27270000
                 by the Vinit subsystem.  If specified, this parameter  27272000
                 must be in the back-reference format.  Default is      27274000
                 $STDLIST.                                              27276000
                                                                        27278000
\ITEM=OPERATION                                                         27280000
OPERATION                                                               27282000
                                                                        27284000
(System Supervisor capability required)                                 27286000
The :VINIT command accesses the Vinit subsystem, which is used for      27288000
disc volume conditioning.                                               27290000
                                                                        27292000
\ITEM=EXAMPLE                                                           27294000
EXAMPLE                                                                 27296000
                                                                        27298000
To access the Vinit subsystem and have the output sent to the line      27300000
printer, enter:                                                         27302000
                                                                        27304000
    :FILE LISTD;DEV=LP                                                  27306000
    :VINIT *LISTD                                                       27308000
                                                                        27310000
                                                                        27312000
\ENTRY=VMOUNT,PARMS,OPERATION,EXAMPLE                                   27314000
     :VMOUNT                                                            27316000
                                                                        27318000
Enables or disables the Private Volumes Facility of MPE.                27320000
                                                                        27322000
SYNTAX                                                                  27324000
                                                                        27326000
             {ON [,AUTO]}                                               27328000
     :VMOUNT {          } [;ALL]                                        27330000
             {OFF       }                                               27332000
                                                                        27334000
\ITEM=PARMS                                                             27336000
PARAMETERS                                                              27338000
                                                                        27340000
ON          Specifies Private Volumes mount and dismount requests       27342000
            be accepted.                                                27344000
                                                                        27346000
AUTO        Allows the system to approve or disapprove users' mount     27348000
            and dismount requests without your intervention.  If        27350000
            not specified, you will be required to reply at the         27352000
            console to all mount requests, even those that request      27354000
            you to mount an already mounted volume set.                 27356000
                                                                        27358000
OFF         Specifies that requests involving the private volumes       27360000
            facility will be rejected.                                  27362000
                                                                        27364000
ALL         Causes all private volumes mount-related console messages,  27366000
            including those not requiring your intervention, to be      27368000
            printed on the system console.                              27370000
                                                                        27372000
\ITEM=OPERATION                                                         27374000
OPERATION                                                               27376000
                                                                        27378000
If the Private Volumes Facility is in use when you issue a VMOUNT OFF   27380000
command, users with currently mounted volume sets will be unaffected;   27382000
the command will be satisfied when the last access is complete.         27384000
                                                                        27386000
Once the facility has been enabled, you can determine what volumes      27388000
are actually mounted and which users are using particular volume        27390000
sets with the :DSTAT and :VSUSER commands respectively.                 27392000
                                                                        27394000
Immediately following a system cold load, the private volumes           27396000
facility is disabled.  However, you still receive console messages      27398000
concerning private volumes mount requests.  The setting after a cold    27400000
load is equivalent to the following:                                    27402000
                                                                        27404000
                        :VMOUNT OFF;ALL                                 27406000
                                                                        27408000
The command that gives you the most interaction with, and control       27410000
over, private volumes use is:                                           27412000
                                                                        27414000
                        :VMOUNT ON;ALL                                  27416000
                                                                        27418000
The command that provides the least interruption to you during          27420000
private volumes use is:                                                 27422000
                                                                        27424000
                        :VMOUNT ON,AUTO                                 27426000
                                                                        27428000
\ITEM=EXAMPLE                                                           27430000
EXAMPLES                                                                27432000
                                                                        27434000
The follwoing example disables the private volumes facility.  By        27436000
default, the example requests that no messages be sent to the console   27438000
when users attempt to use the facility.                                 27440000
                                                                        27442000
     :VMOUNT OFF                                                        27444000
                                                                        27446000
The next example disables the private volumes facility but specifies    27448000
messages should be sent to the console when users attempt to mount      27450000
private volumes.                                                        27452000
                                                                        27454000
     :VMOUNT OFF;ALL                                                    27456000
                                                                        27458000
\ENTRY=VSUSER,PARMS,OPERATION,EXAMPLE                                   27460000
    :VSUSER                                                             27462000
                                                                        27464000
Prints a listing of all users of a currently mounted volume set.        27466000
                                                                        27468000
SYNTAX                                                                  27470000
                                                                        27472000
    :VSUSER [vsname]                                                    27474000
                                                                        27476000
\ITEM=PARMS                                                             27478000
PARAMETERS                                                              27480000
                                                                        27482000
vsname      A fully-qualified volume set name.                          27484000
                                                                        27486000
\ITEM=OPERATION                                                         27488000
OPERATION                                                               27490000
                                                                        27492000
The :VSUSER command lists all users who have explicitly or implicitly   27494000
mounted a volume set.                                                   27496000
                                                                        27498000
\ITEM=EXAMPLE                                                           27500000
EXAMPLE                                                                 27502000
                                                                        27504000
    :VSUSER                                                             27506000
\ENTRY=WARN,PARMS,OPERATION,EXAMPLE                                     27508000
     :WARN                                                              27510000
                                                                        27512000
Sends an urgent message to jobs/sessions.                               27514000
                                                                        27516000
SYNTAX                                                                  27518000
                                                                        27520000
             @                                                          27522000
     :WARN { #Jnnn                       }[;]message                    27524000
             #Snnn                                                      27526000
             [jsname,]username.acctname                                 27528000
                                                                        27530000
\ITEM=PARMS                                                             27532000
PARAMETERS                                                              27534000
                                                                        27536000
@                 Requests the message be sent to all sessions          27538000
                  (QUIET and non-/quiet).                               27540000
                                                                        27542000
#Jnnn             A job number.  Only jobs submitted on interactive     27544000
                  devices can receive messages; although syntactically  27546000
                  correct in this command, messages are rarely sent     27548000
                  to jobs.                                              27550000
                                                                        27552000
#Snnn             A session number.                                     27554000
                                                                        27556000
jsname            The name of the job or session to which the message   27558000
                  is to be sent.                                        27560000
                                                                        27562000
username          A user name.                                          27564000
                                                                        27566000
acctname          An account name.                                      27568000
                                                                        27570000
message           An ASCII string; the length of the string must not    27572000
                  be greater than 67 characters.  The message is        27574000
                  terminated by a carriage return.                      27576000
                                                                        27578000
\ITEM=OPERATION                                                         27580000
OPERATION                                                               27582000
                                                                        27584000
An urgent message (:WARN), interrupting any current pending read --     27586000
or write in progress, will appear on the list devices of all            27588000
sessions (even QUIET) as:                                               27590000
                                                                        27592000
                    OPERATOR WARNING:  message                          27594000
                                                                        27596000
WARN messages will be received by jobs only if the job was submitted    27598000
on an interactive device.                                               27600000
                                                                        27602000
The user has the option of running his session in QUIET mode, wherein   27604000
:TELL messages from other users and :TELL messages from the Console     27606000
Operator will be refused.  (:WARN messages from the Console Operator,   27608000
however, will override the QUIET mode condition.)                       27610000
                                                                        27612000
\ITEM=EXAMPLE                                                           27614000
EXAMPLES                                                                27616000
                                                                        27618000
To send a WARN message to all sessions followed by a WARN message       27620000
to session #S51, enter:                                                 27622000
                                                                        27624000
     :WARN @;THE SYSTEM WILL SHUTDOWN IN 5 MINUTES..PLS LOG-OFF         27626000
     :WARN #S51;LAST CHANCE TO LOG-OFF GRACEFULLY..                     27628000
                                                                        27630000
\ENTRY=WELCOME,PARMS,OPERATION,EXAMPLE                                  27632000
    :WELCOME                                                            27634000
                                                                        27636000
Defines the welcome message.                                            27638000
                                                                        27640000
SYNTAX                                                                  27642000
                       :WELCOME  return                                 27644000
                       #message return                                  27646000
                       #message return                                  27648000
                       #return                                          27650000
                                                                        27652000
\ITEM=PARMS                                                             27654000
PARAMETERS                                                              27656000
                                                                        27658000
message      An ASCII string.                                           27660000
                                                                        27662000
\ITEM=OPERATION                                                         27664000
OPERATION                                                               27666000
                                                                        27668000
Unlike other console commands which are restricted to one line,         27670000
the :WELCOME command can be entered on multiple lines in an             27672000
interactive fashion.  The first line contains only the =WELCOME         27674000
command followed by a carriage return.  You are then prompted           27676000
with a # to begin each line of the message.  Any number of lines        27678000
may be used for the welcome message.  The message is terminated         27680000
and the command completed when a carriage return is entered in          27682000
response to the # prompt character.  When the response to the           27684000
first prompt is a carriage return, the old welcome message (if          27686000
any) is deleted.                                                        27688000
                                                                        27690000
The welcome message is preserved when the WARMSTART,COOLSTART,          27692000
and UPDATE system restart options are used.                             27694000
                                                                        27696000
The WELCOME message will be printed on the $STDLIST device of           27698000
each job or session as it goes into execution.                          27700000
                                                                        27702000
\ITEM=EXAMPLE                                                           27704000
EXAMPLE                                                                 27706000
                                                                        27708000
To create a multi-line welcome message, enter:                          27710000
                                                                        27712000
      :WELCOME                                                          27714000
      #HEWLETT-PACKARD DEMONSTRATION CENTER                             27716000
      #WELCOME TO THE HP#3000 COMPUTER SYSTEM.                          27718000
      #NOTE:  FILES WILL BE STORED EACH DAY BETWEEN 6AM AND 7AM.        27720000
      #                                                                 27722000
\ALL                                                                    27724000
                                                                        27726000
                                                                        27728000
                                                                        27730000
                                                                        27732000
                                                                        27734000
                                                                        27736000
                                                                        27738000
                                                                        27740000
                                                                        27742000
                                                                        27744000
                                                                        27746000
                                                                        27748000
                                                                        27750000
                                                                        27752000
                                                                        27754000
                                                                        27756000
                                                                        27758000
                                                                        27760000
                                                                        27762000
