ICL 1900 Series George 3 Operating System Commands

ASSOCIATE (AE)

Function

Set up an association between commands issued from a remote device and a property attributed throughout the installation, and is used to route information from remote jobs to suitable destinations.

Format

ASSOCIATE peripheral description,PR property name,command parameter

Forbidden contexts

NOT (local) OPERATOR

Execution

The following checks are made before the association is made:

  1. The command has the correct format.
  2. The peripheral description is valid and is known to the Installation Description File.
  3. The property name exists.
  4. The command parameter contains a valid verb and any peripheral type parameters are valid for the verb specified.
  5. The association does not exist. Normally, if, for the peripheral specified, all or part of the command specified in the command parameter is already associated with a property, a command error will be generated by the ASSOCIATE. However, no error will be generated if the command parameter and the property parameter specify an extension to an already existing association. Thus, in the examples below, if a user were to issue the first example followed by the second a command error would result, but the third example followed by the fourth would not result in a command error.

When the ASSOCIATE command has been successfully executed, the following message is output to the operator's console:

    ASSOCIATION z NOW EXISTS

where z is the parameter string of the ASSOCIATE command.

Example

ASSOCIATE U29.L10.IAA5,PR OXFORD,LF *TP *LP
ASSOCIATE U29.L10.IAA5,PR OXFORD,LF
ASSOCIATE U29.I200.IAA5,PR BRACKNELL,LF *LP
ASSOCIATE U29.I200.IAA5,PR BRACKNELL,LF

Notes

The following restrictions exist:

  1. LISTFILE is the only verb allowed in a command parameter.
  2. The maximum number of associations permitted for any one peripheral is 3.
  3. Normally it will only be useful for input terminal peripherals and CONSOLE properties to be associated with commands, but the command is not restricted to these purposes.

Note that a CONSOLE property is ATTRIBUTEd to each peripheral in a remote cluster. When an ONLINE or LISTFILE command is issued, the CONSOLE property name may be included as a parameter. Output will then be directed to an appropriate peripheral in the cluster sharing the CONSOLE property name.

Error Messages

COMMAND PARAMETER MISSING
verb IS NOT A VALID COMMAND PARAMETER
PERIPHERAL peripheral type NOT ALLOWED
PROPERTY property name UNKNOWN
ASSOCIATION ALREADY DEFINED
ONLY z ASSOCIATIONS ALLOWED
PARAMETER MISSING
PARAMETER FORMAT ERROR: n
ILLEGAL UNIT NUMBER: n
ILLEGAL LINE NUMBER: n
ILLEGAL IDENTIFIER NUMBER: n
7020 TERMINAL/INTERFACE NOT DEFINED IN IDF

CANCEL ASSOCIATE

Removes an association from the system.

Format

CANCEL ASSOCIATE peripheral description,PR property name,command parameter

where the parameters are as described above.

Forbidden contexts

NOT (local) OPERATOR

Execution

The specified association is removed, if it exists, and the following message is output on the operator's console:

    ASSOCIATION z NOW NON-EXISTENT

where z is the parameter string of the ASSOCIATE command.

Error Messages

As for the ASSOCIATE COMMAND