PRIORITY command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (remove Sys Man guide)
 
(One intermediate revision by the same user not shown)
Line 7: Line 7:
</dl>
</dl>
==Syntax==
==Syntax==
<p class="syntax">PRIORITY [<span class="term">usernumber</span> [,LOW | ,STANDARD | , HIGH]]
<p class="syntax">PRIORITY [<span class="term">usernumber</span> [,LOW | ,STANDARD | ,HIGH]]
</p>
</p>
<p>
<p>
Line 97: Line 97:


==Example==
==Example==
The following example requests priority information about all active users. The SERV column is either a server number OUT for swapped out. Note that the column labeled MAX below is SLCMAX.
The following example requests priority information about all active users. The <code>SERV</code> column is either a server number or <code>OUT</code> for swapped out. Note that the column labeled <code>MAX</code> below is <var>SLCMAX</var>.
<p class="code"><b>PRIORITY </b>
<p class="code"><b>PRIORITY </b>
USER USERID  P CUR,MIN-MAX  SLICE  IOSLICE CPUSLIC MAX SLCWAIT SERV    CPU
USER USERID  P CUR,MIN-MAX  SLICE  IOSLICE CPUSLIC MAX SLCWAIT SERV    CPU
Line 112: Line 112:
   11 LUGO    S 079,032-079  0.000I  0.070  0.100  50  0.00    2    0.112
   11 LUGO    S 079,032-079  0.000I  0.070  0.100  50  0.00    2    0.112
</p>
</p>
<p>The following example requests priority information about user number 112:</p>
<p>
The following example requests priority information about user number 112:</p>
<p class="code">PRIORITY 112  
<p class="code">PRIORITY 112  
</p>
</p>
<p>The following example assigns a HIGH priority to user number 2: </p>
<p>
The following example assigns a <var>HIGH</var> priority to user number 2: </p>
<p class="code">PRIORITY 2, HIGH  
<p class="code">PRIORITY 2, HIGH  
</p>
</p>
==Usage notes==
==Usage notes==
<p>The PRIORITY command allows <var class="product">Model&nbsp;204</var> resources to be allocated to individual users or applications based upon their relative service requirements. This is done by placing users in one of three priority classes (LOW, STANDARD, or HIGH) or by assigning a number to indicate the user's priority. </p>
<p>
<p>In general, HIGH priority users receive prompter service than STANDARD priority users, and STANDARD priority users receive prompter service than LOW priority users. A detailed presentation of priority scheduling is included in the <var>Model&nbsp;204 System Manager's Guide.</var></p>
The <var>PRIORITY</var> command allows <var class="product">Model&nbsp;204</var> resources to be allocated to individual users or applications based upon their relative service requirements. This is done by placing users in one of three priority classes (<var>LOW</var>, <var>STANDARD</var>, or <var>HIGH</var>) or by assigning a number to indicate the user's priority. </p>
<p>Once a priority has been assigned, that priority remains in effect until it is changed by another PRIORITY command or until you log out of <var class="product">Model&nbsp;204</var>.</p>
<p>
<p>The output of the PRIORITY command displays the information listed in the following table.</p>
In general, <var>HIGH</var> priority users receive prompter service than <var>STANDARD</var> priority users, and <var>STANDARD</var> priority users receive prompter service than <var>LOW</var> priority users. A detailed presentation of priority scheduling is included in [[Controlling system operations (CCAIN)#Dynamic dispatching|Dynamic dispatching]].</p>
<p>
Once a priority has been assigned, that priority remains in effect until it is changed by another <var>PRIORITY</var> command or until you log out of <var class="product">Model&nbsp;204</var>.</p>
<p>
The output of the <var>PRIORITY</var> command displays the information listed in the following table.</p>
<table>
<table>
<caption> PRIORITY command output formats</caption>
<caption> PRIORITY command output formats</caption>
      
      
<tr> <th>
<tr class="head"> <th><p>Header</p></th>  
<p>Header</p>
<th><p>Description</p></th> </tr>
</th> <th>
<p>Description</p>
</th> </tr>
    
    
<tr> <th><var>
<tr> <th><var><p>USER </p></var></th>  
<p>USER </p>
<td><p>User number</p></td> </tr>
</var></th> <td>
<p>User number</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>USERID</p></var></th>  
<p>USERID</p>
<td><p>User ID as supplied at login</p></td> </tr>
</var></th> <td>
<p>User ID as supplied at login</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>P</p></var></th>  
<p>P</p>
<td><p>Current priority class. L-Low, S-Standard, H-High, *-Set by PRIORITY Command, Z-Sleeping (priority 0), ? - Priority change in progress</p></td> </tr>
</var></th> <td>
<p>Current priority class. L-Low, S-Standard, H-High, *-Set by PRIORITY Command, Z-Sleeping (priority 0), ? - Priority change in progress</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>CUR </p></var></th>  
<p>CUR </p>
<td><p>Current priority</p></td> </tr>
</var></th> <td>
<p>Current priority</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>MIN</p></var></th>  
<p>MIN</p>
<td><p>Minimum priority</p></td> </tr>
</var></th> <td>
<p>Minimum priority</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>MAX</p></var></th>  
<p>MAX</p>
<td><p>Maximum priority</p></td> </tr>
</var></th> <td>
<p>Maximum priority</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>SLICE</p></var></th>  
<p>SLICE</p>
<td><p>I for I/O bound or C for CPU bound.</p></td> </tr>
</var></th> <td>
<p>I for I/O bound or C for CPU bound.</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>IOSLICE</p></var></th>  
<p>IOSLICE</p>
<td><p>CPU milliseconds allowed while user is I/O bound.</p></td> </tr>
</var></th> <td>
<p>CPU milliseconds allowed while user is I/O bound.</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>CPUSLIC</p></var></th>  
<p>CPUSLIC</p>
<td><p>CPU milliseconds allowed while user is CPU bound.</p></td> </tr>
</var></th> <td>
<p>CPU milliseconds allowed while user is CPU bound.</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>MAX</p></var></th>  
<p>MAX</p>
<td><p><var>SLCMAX</var>. Number of Stop-Loop-Checks (SLCs) before <var>CSLICE</var> invoked (max=65535).</p></td> </tr>
</var></th> <td>
<p>SLCMAX. Number of Stop-Loop-Checks (SLCs) before CSLICE invoked (max=65535).</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>SLCWAIT</p></var></th>  
<p>SLCWAIT</p>
<td><p>Sleep time in milliseconds, invoked each time a user reaches minimum priority level.</p></td> </tr>
</var></th> <td>
<p>Sleep time in milliseconds, invoked each time a user reaches minimum priority level.</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>SERV</p></var></th>  
<p>SERV</p>
<td><p>Server number the user currently occupies. <var>OUT</var> if not in-server.</p></td> </tr>
</var></th> <td>
<p>Server number the user currently occupies. OUT if not in-server.</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var><p>CPU</p></var></th>  
<p>CPU</p>
<td><p>Amount of CPU time consumed by this user.</p></td> </tr>  
</var></th> <td>
<p>Amount of CPU time consumed by this user.</p>
</td> </tr>
 
</table>
</table>
[[Category: System administrator commands]]
[[Category: System administrator commands]]
[[Category: System manager commands]]
[[Category: System manager commands]]
[[Category: Operator commands]]
[[Category: Operator commands]]
[[Category:Commands]]
[[Category:Commands]]

Latest revision as of 19:50, 17 November 2014

Summary

Privileges
System manager, system administrator, or operator
Function
Assigns a user to a priority class or displays information about priority assignments

Syntax

PRIORITY [usernumber [,LOW | ,STANDARD | ,HIGH]]

or

PRIORITY usernumber [,cur | (cur,min,max)] [,keyword=value]

or

PRIORITY usernumber, CANCEL

Where:

usernumber is the number of the user whose priority is being assigned or displayed.

If specifying...

Then Model 204 lists priority information...

Neither usernumber nor the priority

For all active users (see the format below).

Only usernumber

For only that user.

Both usernumber and the priority

Specified to that user.

  • If no further parameters are specified, only usernumber is displayed.

  • If further parameters are specified, a comma must separate usernumber as well as the subsequent parameter values.

  • cur specifies new current priority for specified user (0-253)

  • min specifies the new minimum priority for specified user (1-253)

  • max specifies the new maximum priority for specified user (1-253)

  • keyword=value is used to change the value of one of the parameters in the table below.

    To change user 8's IOSLICE to 66 and their cur,min,max to 104,80,127, use the following:

    PRIORITY 8,(104,80,127),IOSLICE=66

    To reset user 8's IOSLICE value back to the system default, specify a null value as follows:

    PRIORITY 8,,IOSLICE=,

    Note: keyword=value must be preceded by the value of cur, min, max or by double commas (,,) to indicate that the values do not change. The comma following the equal sign is used to represent a null value.

    PRIORITY command keywords

    Keyword

    Meaning

    IOSLICE

    CPU milliseconds allowed while user is I/O bound

    CPUSLICE

    CPU milliseconds allowed while user is CPU bound

    SLCWAIT

    Sleep time in milliseconds when a user reaches minimum priority level.

    SLCMAX

    Number of SLCs before CSLICE invoked (max=65545). Declines in this number increase the accuracy of the slice interval. However, CPU overhead increases.

  • CANCEL will end the user's current request. The error procedure will be invoked if the user is in a subsystem.

Example

The following example requests priority information about all active users. The SERV column is either a server number or OUT for swapped out. Note that the column labeled MAX below is SLCMAX.

PRIORITY USER USERID P CUR,MIN-MAX SLICE IOSLICE CPUSLIC MAX SLCWAIT SERV CPU 0 NO USERI S 053,032-079 0.000I 0.070 0.100 50 0.00 OUT 0.001 1 BECKETT S 061,032-079 0.000I 0.070 0.100 50 0.00 OUT 0.013 2 LESTER H 127,080-127 0.000I 0.070 0.100 50 0.00 5 0.170 3 MATSUZAK S 061,032-079 0.000I 0.070 0.100 50 0.00 OUT 0.012 4 PENNY H 104,080-127 0.000I 0.070 0.100 50 0.00 1 0.422 5 WAKEFIEL H 114,080-127 0.000I 0.070 0.100 50 0.00 3 0.105 6 VARITEK S 079,032-079 0.000I 0.070 0.100 50 0.00 OUT 0.063 7 YOUKILIS S 079,032-079 0.000I 0.070 0.100 50 0.00 OUT 0.069 8 PEDROIA S 079,032-079 0.000I 0.070 0.100 50 0.00 6 0.133 9 LOWELL S 072,032-079 0.000I 0.070 0.100 50 0.00 OUT 0.032 11 LUGO S 079,032-079 0.000I 0.070 0.100 50 0.00 2 0.112

The following example requests priority information about user number 112:

PRIORITY 112

The following example assigns a HIGH priority to user number 2:

PRIORITY 2, HIGH

Usage notes

The PRIORITY command allows Model 204 resources to be allocated to individual users or applications based upon their relative service requirements. This is done by placing users in one of three priority classes (LOW, STANDARD, or HIGH) or by assigning a number to indicate the user's priority.

In general, HIGH priority users receive prompter service than STANDARD priority users, and STANDARD priority users receive prompter service than LOW priority users. A detailed presentation of priority scheduling is included in Dynamic dispatching.

Once a priority has been assigned, that priority remains in effect until it is changed by another PRIORITY command or until you log out of Model 204.

The output of the PRIORITY command displays the information listed in the following table.

PRIORITY command output formats

Header

Description

USER

User number

USERID

User ID as supplied at login

P

Current priority class. L-Low, S-Standard, H-High, *-Set by PRIORITY Command, Z-Sleeping (priority 0), ? - Priority change in progress

CUR

Current priority

MIN

Minimum priority

MAX

Maximum priority

SLICE

I for I/O bound or C for CPU bound.

IOSLICE

CPU milliseconds allowed while user is I/O bound.

CPUSLIC

CPU milliseconds allowed while user is CPU bound.

MAX

SLCMAX. Number of Stop-Loop-Checks (SLCs) before CSLICE invoked (max=65535).

SLCWAIT

Sleep time in milliseconds, invoked each time a user reaches minimum priority level.

SERV

Server number the user currently occupies. OUT if not in-server.

CPU

Amount of CPU time consumed by this user.