ICL 1900 Series George 3 Operating System Commands

JOBDATA (JD)

Function

Stores the scheduling requirements of a job in a file, which is consulted by the High Level Scheduler. This command is only for use in installations with a user written High Level Scheduler.

Format

JOBDATA decimal integer,scheduling parameter

The decimal integer indicates to GEORGE how the scheduling parameter is to be handled. The table below gives the possible values of the decimal integer and the scheduling parameter that must be specified in each instance.

Decimal Integer Format of Scheduling Parameter Standard Significance Examples
1 mill time
If no alphabetic characters are given 'SECS' is assumed		 Maximum Job Time JOBDATA 1,4
JOBDATA 1,SECS4
JOBDATA 1,2MINS
3 date Earliest start date as day/month/year JOBDATA 3,25/12/68
4 time Earliest start time in
hours and minutes or in
hours, minutes and seconds		 JOBDATA 4,10.40
JOBDATA 4,12.11.20
5 A string of up to four alphabetic characters, preceeded or followed by a decimal integer less than 64 On-line peripheral needs JOBDATA 5,4CR
JOBDATA 5,MT11
6 decimal number Maximum core size allowed for job JOBDATA 6,33000

Forbidden contexts

NO USER

Execution

The decimal integer in used to index a table held in the first record of the :SYSTEM.JOBLIST file. This table provides a key indicating which built-in routines are to be used in processing the scheduling parameter(s). The table also gives the position in the relevant job entry in :SYSTEM.JOBLIST in which the scheduling data is to be stored. The data is stored in the following way:

  1. The maximum job time is stored in a word of the job entry as a number of seconds.
  2. Not used.
  3. The earliest start date is converted into the number of days since 1/1/1900 and is stored in a word of the job entry.
  4. The earliest start time is converted into a quantity of the smallest units given and is stored in a word of the job entry.
  5. The aplabetic characters are used to index a subsidiary table in the first record of :SYSTEM.JOBLIST. For each recognised character string a corresponding character address is found. The integer specified is stored in this address provided that it is less than 64,
  6. The maximum core size is stored in a word of the job entry as a number of words.

The information stored by the JOBDATA command is used by the High Level Scheduler subject program in deciding which jobs to activate.

Notes

  1. Since high level scheduling is controlled by a subject program, the program may be changed to suit the special requirements of a particular installation. Other forms of the JOBDATA command may well be used by installation written subject programs. Full descriptions of how to do this may be found in the manual GEORGE 3 and 4 OPERATION MANAGEMENT.

  2. The facilities of the JOBDATA command are used by a number of system macro commands. The macro commands that correspond to the different facilities of the JOBDATA command are as follows:
    Macro Command    JOBDATA Decimal Integer
    STARTTIME    3 and 4
    NEEDS    5
    MAXSIZE    6

  3. JOBTIME is equivalent to JOBDATA with a first parameter of 1.

Error Messages

THERE IS NO SUCH JOBDATA COMMAND
z NOT RECOGNISED
PARAMETER FORMAT ERROR
PARAMETER NULL
z CONTAINS AN UNPAIRED DELIMITER
PARAMETER MISSING