Google
 

Trailing-Edge - PDP-10 Archives - bb-x130a-sb - cojob.doc
There are 4 other files named cojob.doc in the archive. Click here to see a list.


                               UNIVERSITY OF YORK



                                  MIC - COJOBS


                             Concurrent JOB facility



                            USERS' GUIDE EDITION 3.1
                              (for GALAXY systems)


                                   April 1983





            This guide relects features of version 11C(1223) of MIC.
     MIC COJOBS - CONCURRENT JOB FACILITY                                 Page 2
     University of York - April 1983


                                     Contents


     Section      Contents                            page

     1.  Introduction

     2.  Log Specification

     3.  COJOB switches

         1.  TIME switch

         2.  TAG switch

         3.  [NO]OPTION switch

         4.  [NO]LOPTION switch


     4.  COJOB request (continued from section l)

     5.  COJOB messages

     6.  COJOB control

     7.  COJOB commands

     8.  "IF" extension for COJOB users

     9.  MIC SET command



     Index


     Appendices


     A    ERROR MESSAGES


     A.1  COJOB command - fatal errors
     A.2  COJOB command - non fatal errors


     Index of Error Codes
     MIC COJOBS - CONCURRENT JOB FACILITY                                 Page 3
     University of York - April 1983


 1   Introduction

     The COJOB  facility  gives  the  user  the  ability  to  request  immediate
     execution  of  a  MIC macro as a separate job.  The COJOB is logged in on a
     PTY by the MIC  master  process  under  the  same  PPN  as  the  requestor.
     Transactions on the PTY are written to the specified log file.

     A COJOB request is entered by a command of the form

     .COJOB LOGSPEC/SWITCHES=<MACRO-SPEC> <ARGUMENTS>

     where

     LOGSPEC     is the specification of the MIC log file
                 (see section 2)

     SWITCHES    control the various COJOB options
                 (see section 3)

     MACRO-SPEC  is the specification of the MIC command file in the
                 usual format
                 (see MIC documentation)

     ARGUMENTS   are the arguments to the MIC command file
                 (see MIC documentation)

     The description of the COJOB request is continued in section 4.



 2   Log Specification

     The specification of the log file for a COJOB is of the form

     DEV:FILNAM.EXT[PATH]

     where any or all of these may be omitted,  and  a  standard  default  value
     used.  The standard defaults are

     DEV      DSK
     FILNAM   the same as the macro file
     EXT      Lnn - where nn is a two digit number
              forming a unique filename.ext
     PATH     the initiator of the COJOBS project
              programmer number

     Example

     To run the macro command file "FRED.MIC" the user could use the command

     .COJOB=FRED

     and use all defaults.
     MIC COJOBS - CONCURRENT JOB FACILITY                                 Page 4
     University of York - April 1983


     This is equivalent to using

     .COJOB DSK:FRED.L00/TIME:60=FRED

     Note:  A convenient way of running a COJOB and producing no log file
     is:

     COJOB NUL:=MACROFILE



 3   COJOB switches

     The switches given in a COJOB control the running  of  the  COJOB  and  the
     disposal of the log file.  Currently the switches available are

     TIME   Time limit for cojob
     TAG    Start COJOB at a label
     [NO]OPTION  select a SWITCH.INI option
     [NO]LOPTION select a SWITCH.INI option at LOGIN.

     Note:  COJOB switches may be included in a SWITCH.INI line labelled thus:

     COJOB   /switches
     or
     COJOB:optionname/switches
     if a /OPTION:optionname switch is used.
                 

     3.1   TIME switch

     This switch controls the run-time for the COJOB, and has the format

     /TIME:n

     where

     n is the run-time for the COJOB given in the form

     n = s seconds                           e.g. /TIME:5
     n = mm:ss - minutes:seconds             e.g. /TIME:3:30
     n = hh:mm:ss - hours:minutes:seconds    e.g. /TIME:1:30:25
     n = sk - s*1000 seconds                 e.g. /TIME:5k

     The default run-time is currently 60 secs, though this may change.

     The system operator may also set a maximum value for this switch, which the
     user  may  not exceed.  If he attempts to exceed this value he will receive
     the message described in Appendix A.2 and his switch value will be reset to
     the maximum value.


     3.2 TAG Switch This switch specifies that the COJOB is to  start  execution
     at the label given as argument to the switch.  The format is -

        /TAG:labelname
     MIC COJOBS - CONCURRENT JOB FACILITY                                 Page 5
     University of York - April 1983


     3.3 [NO]OPTION switch This is the usual switch that controls the processing
     of SWITCH.INI entries.


                                        NOTE

         The COJOB SWITCH.INI line is labelled COJOB.




     3.4 [NO]LOPTION switch This switch controls the option  to  be  selected  a
     COJOB  LOGIN,  thus  the  switch  /NOLOPTION  would  cause the LOGIN switch
     /NOOPTION to be used.




 4   COJOB request - contd.

     If a COJOB request is successful the user will be informed thus

     [COJOB <name> (macroname) started, log file is DEV:NAME.EXT[PATH]]

     where

     <name> is a one letter  name  assigned  to  the  COJOB  for  identification
     purposes.

     (macroname) is the COJOB job name, normally the same as the FILNAME part of
     the <macro-spec>.

     If a COJOB request is unsuccessful the user will receive

     [No COJOBS available]

     or an appropriate error message.



 5   COJOB messages

     When a COJOB finishes its run the user is informed by

     [COJOB <name> (macroname) complete]

     and a record of what was performed  by  the  COJOB  may  be  found  in  the
     logfile.

     Other messages which may be output during the running of the COJOB are

     [COJOB <name> (macroname)[ABORT]] If the user  has  included  a  MIC  ABORT
     statement in the command file.

     [COJOB <name> (macroname)[ABORT ON ERROR]] If an error condition  has  been
     detected.
     MIC COJOBS - CONCURRENT JOB FACILITY                                 Page 6
     University of York - April 1983


     [COJOB <name> (macroname).PLEASE<MESSAGE>] If a  PLEASE  command  has  been
     included.

     [COJOB <name> (macroname)[BREAK]] If a MIC BREAK has been performed.
     (To proceed after this message see COJOB control commands)

     [COJOB <name> (macroname)[PROCEED]] If a COJOB has been proceeded  after  a
     break.

     [COJOB <name> (macroname) waiting ...] This message  is  output  every  two
     minutes  (approx.)  after  a MIC BREAK has been performed and the COJOB has
     not been PROCEEDed
     (N.B.  A similar comment appears in the log file.)

     [COJOB <name> (macroname)[?time limit exceeded]]
     This message is output when a COJOB  has  run  out  of  time.   After  this
     message has been output the COJOB is allocated 10% of its original time and
     allowed to proceed as if any error had occurred.

     [COJOB <name> (message) - Enter Parameter B]
     The message reflects the prompt which the use  has  used  in  a  MIC  INPUT
     statement.  The COJOB suspends until the user replies using a TYPE or ENTER
     command.

     These messages all have a correspondence with normal MIC  messages  and  in
     fact the normal MIC message will normally appear in the log file.


     Note

     1   If a COJOB owner logs off while his COJOB  is  still  running  no  more
     messages  will  be  sent  to  the  owner's  TTY  by the COJOB.  Instead the
     following message will be inserted in his log file

     [COJOB owner not available - continuing]

     and execution of the COJOB will continue.

     Also, should the owner log out the COJOB will be  prevented  from  entering
     "break" mode.

     2   Similarly, if a COJOB owner logs off while his COJOB is in BREAK  mode,
     this  will  be  detected  at  the "Waiting ..." stage and the COJOB will be
     continued as in note 1.



 6   COJOB control

     The COJOB owner (or the operator) may issue control commands to a
     COJOB using the following command string

     .COJOB <name>-<CONTROL-COMMAND>

     where
     MIC COJOBS - CONCURRENT JOB FACILITY                                 Page 7
     University of York - April 1983


     <name> is the COJOB as section 5.

     <control-command> is one of the following

     WHAT           - to receive information of the status of the
                      COJOB.

     CANCEL         - to kill the COJOB i.e. cause it to log out.

     BREAK          - to cause the COJOB to enter break mode.
                      (cf. MIC BREAK and ^B for normal MIC's)

     PROCEED        - to cause a COJOB to continue after a break.
                      (cf. MIC PROCEED and ^P)

     ABORT          - to stop the currently running mic process.
                      (cf. MIC ABORT and ^A)

     PLEASE message - to display the "message" on the COJOB
                      owner's terminal.

     If an invalid <CONTROL-COMMAND> has been given, or the user  has  tried  to
     issue  a  <CONTROL-COMMAND>  to  a  COJOB  that  does not belong to him the
     message

     %CONTROL COMMAND "<CONTROL-COMMAND>" NOT VALID FOR COJOB <NAME>

     will be output.


     Note

     1   <CONTROL-COMMANDS> are not valid when a cojob  is  in  the  process  of
     logging out or logging in.

     2   The system operator may give  any  of  the  <CONTROL-COMMANDS>  to  any
     COJOB, even those not owned by him.



 7   COJOB commands

     As well as the COJOB control commands, a COJOB owner may  issue  any  other
     MIC command on behalf of the COJOB.  Example

     .COJOB A-LET C="ABCDE"

     sets the parameter C in the COJOB to contain the string "ABCDE"

     Similarly, most other MIC commands may be given to a COJOB.
     MIC COJOBS - CONCURRENT JOB FACILITY                                 Page 8
     University of York - April 1983


 8   IF extensions for the COJOB user

     The IF command has been extended to provide a means  whereby  a  MIC  macro
     command may determine if it is a COJOB or not.

     The command has the format

     .IF (COJOB).ANY MONITOR OR MIC COMMAND

     and the interpretation of the command is the  same  as  in  the  normal  IF
     command.  (See MIC documentation.)



 9   MIC SET command

     There is a separate set of MIC SET commands whose action  applies  only  to
     COJOBS.

     This command is described in the MIC documentation.

     The command format is

     .MIC SET <no> <action>

     where the available actions are

     .MIC SET NO TIMESTAMP
     Turns off timestamping of the log file.

     .MIC SET TIMESTAMP
     Turns timestamping on.

     .MIC SET LOGNONE
     Stops MIC logging COJOB activity.

     .MIC SET LOGALL
     Restarts logging (and timestamping)

     Note

     1   the two commands

     .MIC SET NO LOGNONE
     .MIC SET NO LOGALL

     do have the expected effect, but are normally not necessary.

     2   the default settings are

     .MIC SET TIMESTAMP
     .MIC SET LOGALL
                                                                    Page Index-1



                                        INDEX




     ABORT . . . . . . . . . . . . . . . . 5
     ABORT ON ERROR  . . . . . . . . . . . 5
     ARGUMENTS . . . . . . . . . . . . . . 3

     BREAK . . . . . . . . . . . . . . . . 6

     COJOB commands  . . . . . . . . . . . 7
     COJOB control . . . . . . . . . . . . 6
     COJOB messages  . . . . . . . . . . . 5

     Default logspec . . . . . . . . . . . 3

     IF command  . . . . . . . . . . . . . 8

     LOGSPEC . . . . . . . . . . . . . . . 3

     MACRO-SPEC  . . . . . . . . . . . . . 3
     MIC SET command . . . . . . . . . . . 8

     PLEASE  . . . . . . . . . . . . . . . 6
     PPN . . . . . . . . . . . . . . . . . 3
     PROCEED . . . . . . . . . . . . . . . 6
     PTY . . . . . . . . . . . . . . . . . 3

     SWITCHES  . . . . . . . . . . . . . . 3
     Switches  . . . . . . . . . . . . . . 4

     TAG switch  . . . . . . . . . . . . . 4
     TIME switch . . . . . . . . . . . . . 4

     Waiting . . . . . . . . . . . . . . . 6
     WHAT command  . . . . . . . . . . . . 7

     [NO]LOPTION . . . . . . . . . . . . . 5
     [NO]OPTION switch . . . . . . . . . . 5

     }abort command  . . . . . . . . . . . 7
     }break command  . . . . . . . . . . . 7
     }cancel command . . . . . . . . . . . 7
     }please command . . . . . . . . . . . 7
     }proceed command  . . . . . . . . . . 7











                                  APPENDIX A

                                 ERROR MESSAGES



COJOB command

As well as all the error messages which may be generated during a  "/"  command,
the following are specific to the COJOB command.

A.1   Fatal error messages


?MICCJN COJOBS not available at this time
The system operator has said that COJOBs are not available for remote users.

?MICCLD cannot INIT log device
The logging device specified by the user is in error.

?MICCLF cannot LOOKUP log file
A LOOKUP UUO performed on the user's specified log file failed for  some  reason
other than the file not existing.

?MICELF cannot ENTER log file
The specified log file could not be created.

?MICELS error in log file spec
The specification of the log file given by a user was invalid.   Normally,  this
error is due to incorrect syntax.

?MICECR error in COJOB request
A syntax error was detected in the "COJOB" command, most probably in one of  the
user's switches.

?MICNCA No COJOBS available
All the COJOB slots are in use


A.2   Non-fatal error messages

%MICSAE switch value exceeds maximum value
A switch (e.g.  the TIME switch) has an argument larger than some preset maximum
value  (defined  by the system).  The user's argument is replaced by the mimimum
value.

Note
ERROR MESSAGES                                                           Page A-2



Some switches e.g.  the TIME switch, may have their limit value changed  by  the
operator dependant on system loading.
                                                                    Page Index-1



                                     INDEX




MICCJN . . . . . . . . . . . . . . . . . A-1
MICCLD . . . . . . . . . . . . . . . . . A-1
MICCLF . . . . . . . . . . . . . . . . . A-1
MICECR . . . . . . . . . . . . . . . . . A-1
MICELF . . . . . . . . . . . . . . . . . A-1
MICELS . . . . . . . . . . . . . . . . . A-1
MICNCA . . . . . . . . . . . . . . . . . A-1
MICSAE . . . . . . . . . . . . . . . . . A-1