Function
Introduces the name of a peripheral property to the system.
Format
PROPERTY property name(qualifiers),CONSOLE console description
The property name is a string of up to 12 characters (letters, digits, hyphens and spaces). The character string must commence with a letter (that is, in local name format) and spaces are significant.
The qualifiers which may be specified in full or in shortened form are, PERMANENT (PERM), TEMPORARY (TEMP), INCLUSIVE (INCL) and EXCLUSIVE (EXCL).
A maximum of two qualifiers may be given. Either PERM or TEMP may be given (TEMP is assumed unless PERM is given) and either INCL or EXCL (EXCL is assumed unless INCL is given).
If the PERMANENT qualifier is given, a command requesting the property while it is not ATTRIBUTEd will generate a command error. This is because a permanent property will not be the sort of thing that an operator can attribute or cancel on demand.
If the TEMPORARY qualifier is given, a command requesting the property while it is not ATTRIBUTEd will generate a a request to the operator to ATTRIBUTE the property to a particular peripheral.
If the INCLUSIVE qualifier is given, a command requesting the property will use only units to which the property has been ATTRIBUTEd but the unit may also be used by other commands.
If the EXCLUSIVE qualifier is given, a unit to which the property has been ATTRIBUTEd may not be used by commands not requesting the property.
The CONSOLE parameter is optional, and if present causes the property name given to be classed as a console property and used as a cluster name. The CONSOLE parameter defines a cluster console and may have one of two forms:
In the current mark, console properties are assumed to be PERMANENT and PERMANENT/TEMPORARY qualifiers are therefore ignored in PROPERTY commands that include a CONSOLE parameter.
Forbidden contexts
NOT OPERATOR
Execution
If the property name is not known to the system and is not the special property CENTRAL, then it, together with its qualifier, is added to the list in :SYSTEM.PROPERTY. If the property is to be a CONSOLE property then details of the console are entered in :SYSTEM.IDF.
If the property name is known to the system and is not a console property, a command error is generated.
If the property name is known to the system but is a console property, the command is assumed to be defining a replacement cluster console. Details of the previous cluster console are therefore removed from :SYSTEM.IDF and the new console's details are inserted. Subsequently, the new console will be used for cluster messages.
Examples
PROPERTY GASBILL(TEMP,EXCL)
PROPERTY AST(PERMANENT,INCLUSIVE)
PROPERTY STEVENAGE(PERM,EXCL),CONSOLE U30.L10.IAA
Error Messages
PROPERTY NAME PARAMETER MISSING
DELIMITERS MUST BE PAIRED
THIS COMBINATION OF QUALIFIERS IS ILLEGAL
ONLY ONE SET OF QUALIFIERS MAY BE GIVEN
z IS NOT A CORRECTLY FORMED NAME
PROPERTY z EXISTS
PROPERTY NAME 'CENTRAL' EXISTS AND MAY NOT BE CANCELLED
UNIT z IS NOT A CONSOLE
PARAMETER MISSING
PARAMETER FORMAT ERROR: z
ILLEGAL UNIT NUMBER: z
ILLEGAL LINE NUMBER: z
ILLEGAL IDENTIFIER: z
7020 TERMINAL/INTERFACE NOT DEFINED IN IDF
Function
A property name is removed from the system
Format
CANCEL PROPERTY property name
Forbidden contexts
NOT OPERATOR
Execution
The record of the property is removed from :SYSTEM.PROPERTY (and from :SYSTEM.IDF if it is a CONSOLE property). If it was ATTRIBUTEd to or ASSOCIATEd with any unit, then the attribution or association is removed.
The message is output on the operator's console:
PROPERTY z HAS BEEN CANCELLED
Example
CANCEL PROPERTY GASBILLS
Error Messages
PROPERTY NAME PARAMETER MISSING
PROPERTY NAME z UNKNOWN
z IS NOT A CORRECTLY FORMED NAME