ICL 1900 Series George 3 Operating System Commands

ALLOWANCE (AW)

Function

Increases a transient budget allowance for a named user or reduces a transient budget allowance ration of an immediate inferior of the proper user.

Format

ALLOWANCE username, transient budget type, number

The number is the number of units which are to be added to the allowance of the named user. It may be positive or negative. If it is positive, it must not be greater than the allowance at present available to the proper user. If it is negative, it must not be greater than the allowance at present available to the named user. Since no conversion of units is carried out, it must be given in whatever units are conventional through the rest of the system for the budget type specified.

If the number is positive, the named user may be any user known to the system. If it is negative, the named user must be an immediate inferior of the proper user. In neither case may the named user by a pseudo user.

Transient Budget Types Explanation Unit Size
TIME(u)
Where u is an URGENCY		 Mill time A second
MONEY Money to be spent on time and/or space At the installation manager's discretion

Forbidden contexts

NO USER

Execution

The named user's allowance is increased (or reduced) by the stated number of units and the proper user's allowance is reduced (or increased) by the same number. On successful completion of the transfer one or two messages are sent to the monitoring file system (COMMENT category). They are as follows:

    username OVERDRAWN BY number; NEW ALLOWANCE number

where the new allowance is the total allowance (consumed and unconsumed) of the user after the transfer has taken place. This message is sent if, after the transfer, the budget allowance of either the proper user or the named user is insufficient to cover the amount consumed. A transfer will never be permitted if it causes an overdraft. However, it may occur that a user has an overdraft even after his allowance has been increased. The above message will only be output if the user in question is either the proper user or an immediate inferior of the proper user.

    OK. YOUR ALLOWANCE IS NOW number: CONSUMED number

This message is sent if, after the transfer, the proper user is not overdrawn.

Examples

ALLOWANCE :FRED,TIME(M),20
Reply 1   FRED OVERDRAWN BY 10; NEW ALLOWANCE 30
Reply 2   OK. YOUR ALLOWANCE IS NOW 40: CONSUMED 10

ALLOWANCE :BILL,MONEY,-150
Reply   OK. YOUR ALLOWANCE IS NOW 250: CONSUMED 20

Notes

  1. The user :MANAGER is permitted to access the budgets of his siblings as if they were his immediate inferiors. Thus, he may reduce a transient budget allowance belonging to :SYSTEM.
  2. The ALLOWANCE command differs from the BUDGET command in the following respects:
    1. It affects allowances, not rations.
    2. Consequently it is applied to only transient budgets.
    3. If the ammountbeing transferred is positive, the named user need not be the immediate superior or an immediate inferior of the proper user.

Error Messages

NO SUCH BUDGET TYPE AS z
YOU MAY NOT CHANGE YOUR OWN ALLOWANCES
YOU MAY REDUCE ALLOWANCES OF ONLY YOUR IMMEDIATE INFERIORS
z IS A PSEUDO USER
z IS NOT A TRANSIENT BUDGET
RESULT WOULD BE NEGATIVE