ICL 1900 Series George 3 Operating System Commands

INSTPARA (IP)

Function

  1. Lists on the operator's console the maximum, minimum and current value of each installation parameter.
  2. Sets or reports the value of one of the dynamically variable installation parameters.

Format

  1. INSTPARA ALL

  2. INSTPARA parameter name,new value
    Where parameter name has the format of a local file name and new value is optional. (The parameter name mustbe one of the names listed in the table below). If no new value is given, the command acts as a request to print out the current value of the named parameter. If new value is included, it must be within the range specified by the maximum and minimum values held in the file :SYSTEM.PARAMINDEX (GEORGE 3) or :SYSTEM.PARAMINDEXG4 (GEORGE 4). Alternatively, new value may be UNSET, in which case maximum and minimum checks do not apply; this option applies to CLUSTERBACK and CLUSTERMOP, and possibly to MANAGERn and any other parameters used solely by local subject programs.

    For installation parameters JOBTRACE, MOPTRACE, MINTRACE and OPTRACE new value specifies a set of monitoring file categories. For CONTEXT, new value is any combination of A, B, and C.

Forbidden contexts

USER, MOP, REMOTE

Execution

  1. The system file containing details of the installation parameters (:SYSTEM.PARAMINDEX or :SYSTEM.PARAMINDEXG4) is opened and read. The required information is output to the operator's console under the heading:-

        NAME  MAX  MIN   VALUE

  2. GEORGE finds the named parameter in :SYSTEM.PARAMINDEX or :SYSTEM.PARAMINDEXG4 and checks that it refers to an installation parameter within GEORGE's internal table of parameters. If this value is outside the specified range, a command error message is given.

    If new value is included in the INSTPARA command, the named parameter is given this new value provided that the value is within the range permitted in the file :SYSTEM.PARAMINDEX or :SYSTEM.PARAMINDEXG4. For CONTEXT, JOBTRACE, MINTRACE, MOPTRACE and OPTRACE, the checks are that only recognised contexts or monitoring file categories are given, and that all in the minimum list and none not in the maximum list are given. In no new value is given, the current value of the named parameter is output on the operator's console in the form:-

        INSTALLATION PARAMETER 'parameter name' = decimal integer

    This message will also be output when new value is included in the INSTPARA command, and decimal integer will then report the new value of the parameter.

Examples

INSTPARA COREOBJECT,#40000
INSTPARA JOBLIMIT
INSTPARA ALL

Error Messages

INSTALLATION PARAMETER z DOES NOT EXIST
INSTALLATION PARAMETER z MAY NOT BE ALTERED
PARAMETER NAME IS MISSING
VALUE OUT OF RANGE: MAX=x MIN=y
z IS NOT A CORRECTLY FORMED NAME

The following table lists the installation parameters in alphabetical order, giving the initial setting of each parameter with its maximum and minimum values and the units used. The function of each parameter is described briefly.

Parameter Name Issued Values Units Meaning
Default Max. Min.
BACKCP 30 60 1 Priority Core priority for central background jobs.
BACKGROUND 1 200 0 Jobs Maximum number of background jobs which may be fully started.
BACKJAM 90 99 50 % The proportion of a backing store residence that must be occupied before the backing store unjammer takes action on the residence.
BACKJOBS 1 1 0 Jobs Maximum number of background jobs which may be started.
BACKTHRESH 10 50 0 % Threshhold to which the backing store unjammer should clear the non-special residences.
BSINTERVAL 2048 223-1 0 Mins. The ideal interval between entries to the backing store unjammer.
CHAPTERQUOTA 15360 0 0 Words The chapter quota (calculated at Early Morning Start).
CLUSBACKCP 30 60 1 Priority Core priority for cluster background jobs.
CLUSMOPCP 30 60 1 Priority Core priority for cluster MOP jobs.
CLUSTERBACK UNSET 0 0 Jobs If CLUSTERBACK is set, cluster background jobs are started out of the well in preference to central jobs until CLUSTERBACK is reached.
CLUSTERMOP UNSET 0 0 Jobs If CLUSTERMOP is set, cluster MOP jobs are started out of the well in preference to central jobs until CLUSTERMOP is reached.
CONTEXT 0 A, B, C 0 Context bits The context privileges that are currently in force.
COREOBJECT 6144 6144 0 Words The maximum core that can be given to an object program by CORE, SIZE, LOAD, GIVE/4 etc. In GEORGE 3 the value of this parameter is limited by the core size of the machine.
CPIRATIO 120 500 100 % Weighting factor used by HLS to calculate wait times for background jobs of various urgencies waiting to be made fully started.
DATE 10 1440 1 Mins. The interval between date printouts on the operator's console.
DATINTERVAL 5 223-1 1 Mins. The intervals at which data is collected by the system measurement package and stored in the file :SYSTEM.PERFORMANCE.
DEFAULTBS 500 10000 10 Blocks Limit on amount of on-line backing store a job may have.
DUMPTAPES 2 3 1 Tapes The number of copies of filestore dumps taken and maintained.
DUMPTIME 40 2000 0 Mins. The maximum time interval between successive incremental dumps of the filestore.
FORMULA 5000 1000000 0 Minute blocks Factor used by the backing store unjammer and reset by it in accordance with BSINTERVAL.
HLSREVIEW 1 20 1 Mins. Maximum time interval between entries to the HLS to review job progress.
HOLDUP 300 10000 1 Secs. The number of seconds to be added to the fair waiting time for a program which cannot be swapped in and is larger than the program quota.
IDIV 2 100 1   Dividing factor in algorithm used to calculate cost of mill time used. Only relevant if BILA (Built-in Log Analysis is used.
IMULT 1 100 0   Dividing factor in algorithm used to calculate cost of mill time used. Only relevant if BILA (Built-in Log Analysis is used.
IPAGE 1 50 1 Pages The maximum number of pages that can be repeated if an error restart occurs on a line printer while listing a file.
IPLIMIT 128 256 0   Not used in standard system
JOBLIMIT 2 2 0 Jobs The maximum number of jobs that may be introduced to the system.
JOBTIME 300 3600 50 Secs. The default value of the present mill time for any job.
JOBTRACE FULL ALL LOGGING Monitoring file categories The initial setting for a background job's TRACEing to the monitoring file.
L 1 223-1 0 Money Minimum charge used in the algorithm that calculates the cost of mill time used. Only relevant if BILA is used.
LPSTIME 30 2000 0 Mins. Sets the time between runs of the LPS14 subject program #XKNP.
LPSVALUE 0 5 0   Controls the running of he LPS14 subject program #XKNP.
MANAGER0 UNSET 223-1 0   User definable installation parameter.
MANAGER1 UNSET 223-1 0   User definable installation parameter.
MANAGER2 UNSET 223-1 0   User definable installation parameter.
MANAGER3 UNSET 223-1 0   User definable installation parameter.
MANAGER4 UNSET 223-1 0   User definable installation parameter.
MANAGER5 UNSET 223-1 0   User definable installation parameter.
MANAGER6 UNSET 223-1 0   User definable installation parameter.
MANAGER7 UNSET 223-1 0   User definable installation parameter.
MESSAGETIME 60 400 1 Secs The factor used to regulate the time interval between printouts of system messages on the operator's console.
MINTRACE LOGGING
and
BROADCAS		 ALL LOGGING Monitoring
file
categories		 The minimum setting of categories of monitoring file output which may be requested by the TRACE command.
MOPCP 30 60 1 Priority Core priority for central MOP jobs.
MOPCPI 50 100 0 % Percentage of mill time which should be devoted to MOP jobs.
MOPJOBS 1 1 0 Jobs Maximum number of MOP jobs which may be started.
MOPLIMIT 1 1 0 Jobs Number of MOP jobs which may be made fully started.
MOPTOTAL 1 223-1 0 Jobs The maximum number of MOP jobs that may be introduced to the system.
MOPTRACE LOGGING
and
BROADCAS		 ALL LOGGING Monitoring
file
categories		 The initial setting for a MOP job's TRACEing to the monitoring file.
MOPWAITTIME 5 223-1 1 Mins. Length of time allowed for a MOP user to restart his MOP console after it has timed out.
OBJECTQUOTA 0 0 0 Words The object program quota (reset by EMS). In GEORGE 3 this parameter controls the amount of core GEORGE uses to hold object programs.
OPTRACE NONE ALL NONE Monitoring
file
categories		 Monitoring file categories that will be output to the central operator's console in addition to operator messages.
PAGEWAIT 0 600 0   Only effective under DME.
PERFWAIT 720 223-1 10   The time interval between successive iniations of the job which lists :SYSTEM.PERFORMANCE.
PROGTIME 10 600 1 Secs. Default value of TIME for object programs (overwritten by any TIME commands in the job).
RELOAD 1 1 0   Controls the action of GEORGE at the end of a GEORGE postmortem.
REPORTTIME 30 223-1 1 Mins. Time interval between the output of program and peripheral report messages to the System Journal.
SIZEDEFAULT 6144 6144 0 Words The maximum size which can be given to a core image by GIVE/4 if no MAXSIZE command has been issued. If the HLS is being used, the size for CORE, SIZE and LOAD is also limited.
SLOTTIME 250 32K-1 10 Milli. secs. per K Controls relationship between the size of an object program and the length of its time slot.
TIME 1 1440 1 Mins. The interval between time printouts on the operator's console.
VOLUME 8192 223-1 1   Default setting of the LIMIT qualifier (the number of PERIs that a program may issue to an ASSIGNed file.
WAITTIME 30 90 0 Mins. The time for which an unterminated MOP or background job remains in the waiting state before it is terminated by an internally issued ENDJOB.
WAITWEIGHT 120 500 100 % Factor used by HLS to calculate CPIs of jobs of various urgencies