Function
Edits the file containing the installation parameters. The installation parameters for GEORGE 3 are held in :SYSTEM.PARAMINDEX and those for GEORGE 4 are held in :SYSTEM.PARAMINDEXG4 which is created the first time an installation runs GEORGE 4. This macro may only be used by user :SYSTEM.
Format
IPEDIT *CRfile description,*LPfile description,ERlabel ,GEORGEnumber
All the parameters are optional.
The *CRfile description parameter defines the source of the steering information as a card file with the file description given. If it is omitted, or if the file description is omitted, steering information will be read from the job source (job description file or MOP terminal).
The *LPfile description parameter defines the file to which the listing is to be written. If it is omitted, of if the file description is omitted, listings will be sent to the monitoring file system.
The ERlabel parameter defines the a label to which control is to be passed in the event of a failure duringthe run, or a parameter error. If it omitted, control is passed to the instruction following the line which caused the error.
The GEORGEnumber parameter determines whether :SYSTEM.PARAMINDEX or :SYSTEM.PARAMINDEXG4 is edited. If the parameter is present, the number must be either 3 or 4. If the parameter is omitted, the file corresponding to the system currently running is edited.
The command causes any number of lines of steering information to be read. See Editing Instructions, below for the format of these lines.
Forbidden contexts
NO USER, PROGRAM, BREAK-IN
Execution
The IPEDIT is a command macro that loads and enters a program #XK69. If the steering lines are read from a file, that file is ASSIGNed to the program, otherwise the job source is made ONLINE to the program. If output is not required to besent to a particular file, a card punch is ONLINEd to the program to allow output to be sent to the monitorin file system. The system file PARAMINDEX or PARAMINDEXG4 is ASSIGNed to the program in READ mode. The steering lines are analysed and implemented one at a time until the terminator is read, signifying the end of the amendments. The program then HALTs:-OK and PARAMINDEX or PARAMINDEXG4 is released and reASSIGNed to the program in WRITE mode. The old PARAMINDEX or PARAMINDEXG4 file is overwritten with the new amended file and the program DELETEs:-HH.
Note: Though there is a current value held in the file, GEORGE keeps current values in its FIXED CORE, and only references the file at Early Morning Start to obtain the current values. At such time GEORGE changes its version of the parameter to agree with that in the file. Thus, though this macro may be used to change the current values, the new values and a change of name only become effective when GEORGE is next reloaded. Maximum and minimum values are, however, immediately effective, in that future INSTPARA commands will be tested against these.
Using this command, it is possible to insert new parameters into the file. However, the current mark of GEORGE only allows for a fixed number of parameters. The extra parameters will only be effective if the file is used with a mark of GEORGE which allows for them.
Editing Instructions
Editing instructions consist of a verb of which only the first character is significant. The verb is terminated by at least one space. Where there are parameters, these are seperated by commas.
Instructions may be given in any order except that the END instruction terminates the editing.
The relevant installation parameter may be referenced by name or by number or both except in the case of inserting a new installation parameter into the file, when both name and number must be given.
Any errors that are detected cause a message to be output to the monitoring file system. When this happens, the instruction will be completely ignored.
Format of Editing Instructions
ALTER (A)
Function
Alters the name, maximum, minimum and current value of an installation
parameter.
Format
ALTER n1,n2,MAX=n3,
MIN=n4,VAL=n5,NAM=n6
n1 is the name (not more than 12 characters) of the
installation parameter.
n2 is the number (not more than 4 digits) of the installation
parameter. Either n1 or n2 must be
specified. If both are specified (in which case n1 must
precede n2) they will be checked for consistency.
n3 is the new value for the maximum
n4 is the new value for the minimum
n5 is the new value for the current value
n6 is the new name of the installation parameter (not more
than 12 characters). In the name of an installation parameter is changed and
nothing else, the parameter will retain its original maximum, etc.
n3 to n6 may be positive or negative numbers. Octal values are represented by a # before the number. The maximum value that may be used is #37777777, that is 8388607.
The parameters n3 to n6 are optional and may be in any order.
When altering one of the parameters MOPTRACE, OPTRACE, JOBTRACE, or MINTRACE, the values are specified as an appropriate string of monitoring file category identifiers, enclosed in single quotes.
The identifiers are as follows:-
ALL or AL
ALLBUT or AB
BROADCAS or BC
CENTRAL or CN
CLUSTER or CL
COMERR or CE
COMMENT or CT
COMMANDS or CM
DISPLAY or DP
ENGINEER or EN
FILES or FL
FULL or FU
FULLBUT or FB
JOURNAL or JL
LISTING or LS
LOGGING or LG
NONE or NO
OBJECT or OJ
ONLINE or OL
OPERATOR or OP
POSTMORT or PM
Either the full or the abbreviated forms may be used. The meanings of the categories are given under the TRACE command.
When altering the parameter CONTEXT, the values which may be specified are A, B, C, some combinations of A, B and C, or 0. An appropriate string is given enclosed in single quotes as for the TRACE parameters.
Note that any attempt to alter the name fo one of the parameters MOPTRACE, JOBTRACE, MINTRACE, OPTRACE or CONTEXT from PARAMINDEX or PARAMINDEXG4 will be unsuccessful, and an error message will result.
DELETE (D)
Function
Deletes a parameter from the file which is then closed.
Format
DELETE n1,n2
n1 is the installation parameter name (not more than 12
characters).
n2 is the installation parameter number (not more than 4
digits). Either n1 or n2 must be
specified. If both are specified they must be checked for consistency.
Note that any attempt to delete one of the parameters MOPTRACE, JOBTRACE, MINTRACE, OPTRACE or CONTEXT from PARAMINDEX or PARAMINDEXG4 will be unsuccessful.
INSERT (I)
Function
Inserts a new installation parameter after the last parameter in the file.
Format
INSERT n1,n2,MAX=n3,
MIN=n4,VAL=n5
n1 is the installation parameter name (not more than 12
characters).
n2 is the installation parameter number (not more than 4
digits).
Parameters n1 and n2 are mandatory.
Parameters n3, n4 and n5
are optional and may be in any order. If they are omitted, the program
allocates a value of #40000000, meaning NOT SET.
PRINT (P)
Function
Outputs the entry in PARAMINDEX or PARAMINDEXG4 specified by
n1 to the monitoring file system, interpreting the maximum,
minimum and current values as positive or negative numbers, monitoring file
categories for the TRACE parameters
or combinations of A, B and C for CONTEXT.
Format
PRINT n1,n2
n1 is the installation parameter name (not more than 12
characters).
n2 is the installation parameter number (not more than 4
digits).
If both n1 and n2 are specified, they
will be checked for consistency. If both are omitted, the whole file will
be output to the monitoring file system. If a value contains #40000000, NOT
SET is output to the monitoring file system.
END (E)
Function
Signifies the end of the amendments. The new values are written to PARAMINDEX
or PARAMINDEXG4 and the job returns to command level.
Format
END
Example
IPEDIT
A TIME,MAX=100
D 3
I NEWPARAM,40,MAX=100,MIN=1,VAL=10
A 4,NAM=NEWNAME
P
E
This sequence of instructions will change the maximum value of TIME to 100, and delete the entry associated with installation parameter 3. A new parameter, NEWPARAM, is inserted into the file with parameter number 40, maximum value 100, minimum value 1, and current value 10. Parameter number 4 is amended to have the name NEWNAME, and contents of the amended file are output to the monitoring file or the MOP terminal.
Error Messages
Any of a large number of error messages can be output, and all messages are self-explanatory. When an error message is output, the next instruction will be read in and the instruction causing the error message will be abandoned.