Function
Enables a user to find out which privileges or how much of any budget type he or one of his immediate inferiors has at his disposal.
Format
BUDGETQUERY username,budget type
The username specified must be the name of the proper user or one of his immediate inferiors. A null parameter in place of the username is taken to mean the proper user. The budget type may be either a privilege or a quantative budget (see table below). The parameters may be given in any order.
| Privileges and Budget Types | Explanation | Unit Size |
|---|---|---|
| Privileges | ||
| NEWUSER | Required to create a real user's directory | Not applicable |
| TRUSTED | Required to perform extracodes which require a trusted program status for the object program issuing them | Not applicable |
| CONTEXTA CONTEXTB CONTEXTC |
Required to govern the use of commands forbidden by the GIN macro FORBID and enforced by the Installation Parameter CONTEXT | Not applicable |
| NOTOWNER | Required to perform extracodes which require a trusted program status for the object program issuing them | Not applicable |
| FREEZE | A user with the FREEZE privilege is able to issue a FREEZE command and also access user-frozen entrants (provided that he also has the required traps) | Not applicable |
| ALLACC | A user with the ALLACC privilege is able to perform any operations within a directory that are restricted to the proper user anywhere within the filestore, except :MASTER | Not applicable |
| INFACC | A user with the ALLACC privilege is able to perform any operations within a directory that are restricted to the proper user, in a directory inferior to him | Not applicable |
| NOWELL | A user with NOWELL privilege may use a NOWELL parameter in a job starting command (JOB, RUNJOB, LOGIN, DISCONNECT) to ensure that the job is started immediately, without being held in the well | Not applicable |
| ACTIVOP | Enables a user to use the OPERATOR command to perform certain active operator commands | Not applicable |
| PASSIVOP | Enables a user to use the OPERATOR command to perform certain passive operator commands | Not applicable |
| HLSEXT | Required to use the ACCESS command and to use HLS extracodes | Not applicable |
| BUDGEXT | Required for a user to use budget extracodes | Not applicable |
| SJMESS | Required for a user to send messages to the System Journal | Not applicable |
| ASSIDIR | Required for a user to be able to ASSIGN a filehandler to a directory | Not applicable |
| Stable Budget Types | ||
| SPACEMT | Space on magnetic tape | A tape |
| REALTIME | Core space for realtime object programs | A word of core |
| Transient Budget Types | ||
| 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 appropriate reply is sent to the monitoring file system. The format of the reply is:
Examples
BUDGETQUERY :FRED,SPACEMT
Reply RATION 5; 3 BEING USED; 10 CONSUMED
BUDGETQUERY ,TIME(M)
Reply RATION 40; ALLOWANCE 40; CONSUMED 20
BUDGETQUERY :BILL,NEWUSER
Reply NO
BUDGETQUERY MONEY
Reply RATION 30; ALLOWANCE 30; CONSUMED 5
Note
The user :MANAGER is permitted to access the budgets of his siblings as if they were his immediate inferiors. Thus, he may enquire about the privileges and budgets held by the user :SYSTEM.
Error Messages
NO SUCH BUDGET TYPE AS z
THE USER MUST BE YOURSELF OR AN IMMEDIATE INFERIOR
z IS A PSEUDO USER
TRACING AND REPORTING ARE SUCH THAT YOU WILL GET NO OUTPUT FROM THIS
COMMAND