HP 3000 Manuals

Using the Miscellaneous Configurator [ Performing System Management Tasks ] MPE/iX 5.0 Documentation


Performing System Management Tasks

Using the Miscellaneous Configurator 

Use the MISC configurator to change miscellaneous system resources, such
as resource identification numbers, job-related limits, session-related
limits and the stack and heap sizes.

To access the MISC configurator 

You make all miscellaneous system configuration changes from within the
MISC configurator, which is one of the SYSGEN modules.  To access the
MISC configurator, do the following:

   1.  At the MPE prompt, enter:

            SYSGEN 

   2.  At the SYSGEN prompt (sysgen>), enter:

            sysgen>MISC 

When you first access the MISC configurator, you see a list of the
commands available to you.  To issue a command, you can either enter the
full command name or the abbreviation shown in parentheses.
___________________________________________________________________________
|                                                                         |
|                                                                         |
|      sysgen>MISC                                                        |
|                                                                         |
|             ** MISC configurator commands **                            |
|                                                                         |
|             drin (dr)        io              job (jo)       lrin (lr)   |
|             resource (re)    session (se)    show(sh)       stack (st)  |
|             system (sy)                                                 |
|                                                                         |
|             clear (cl)(c)    exit (ex)(e)     help (he)(h)    hold (ho) |
|             oclose (oc)      redo                                       |
|      misc>                                                              |
|                                                                         |
___________________________________________________________________________

          Example 6-1.  Accessing the MISC Configurator 

To use online help 

You can display helpful information about any of the MISC configurator
commands on the screen.  To do so, enter the HELP command at the misc>
prompt in one of two forms:

   *   To get help for a specific command, type HELP and then the command
       name.  For example, to display a description, the syntax, and
       examples of the LRIN command, enter:

            misc:HELP LRIN 

   *   To see a list of all the MISC configurator commands with a brief
       description of each one, simply enter HELP or H.

To show current values 

Use the SHOW command (abbreviated SH) to display one or all of the items
you can configure with the MISC configurator.  The syntax of the SHOW
command is:

          {            {IO      }}
          {            {JOB     }}
          {            {RESOURCE}}
SHOW (SH) {[COMMAND =] {SESSION }} [[DEST =] OFFLINE]
          {            {STACK   }}
          {            {SYSTEM  }}
          {            {ALL     }}
--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| IO                  | Displays the number of devices to reserve for dynamic              |
|                     | configuration.                                                     |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| JOB                 | Displays the job-related limits and default operating points.      |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| RESOURCE            | Displays system resource allocation values.                        |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| SESSION             | Displays the session-related limits of the system and the defau lt |
|                     | operating points.                                                  |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| STACK               | Displays the size of the NM stack, CM stack, and the heap.         |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| SYSTEM              | Displays the settings of various system resource values, the sys   |
|                     | tem ID, and logon and command interpreter prompts.                 |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| ALL                 | Lists all of the information described above.                      |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| OFFLINE             | Redirects the output of the SHOW command to the SYSGEN list ing    |
|                     | file, SYSGLIST. Using OFFLINE does not immediately generate a      |
|                     | print out.  The information is sent to SYSGLIST until you either   |
|                     | enter the OCLOS E command or exit SYSGEN. Exiting SYSGEN or using  |
|                     | OCLOSE closes SYSGLIS T and prints the file.                       |
|                     |                                                                    |
--------------------------------------------------------------------------------------------

You can display one item or all items on screen, or you can print the
information.

   *   To display all items, at the misc> prompt enter the SHOW command
       without any parameters or enter the command this way:

            misc>SHOW ALL 

   *   To display one item, at the MISC prompt (misc>), enter the SHOW
       command followed by the item you want to see.  For example, to
       display job-related limits, enter:

            misc>SHOW JOB 

Below is an example of the kind of output you can expect.
____________________________________________________________________________
|                                                                          |
|                                                                          |
|      misc>SHOW JOB                                                       |
|                                                                          |
|               JOB command       parameter      MAX       MIN     CURRENT |
|            -----------------    ---------    -------   -------   ------- |
|            DEFAULT CPU LIMIT    cputime        32767         0         0 |
|            MAXIMUM LIMIT        maxlimit         999         0        60 |
|            POOL SIZE            pool             200         1         1 |
|                                                                          |
____________________________________________________________________________

          Example 6-2.  MISC Configurator SHOW Output 

To print current values 

Instead of displaying miscellaneous configuration information on screen,
you can print it.  To do so, add the OFFLINE parameter to the SHOW
command.  For example, to print information about the stacks, enter:

     misc>SHOW STACK OFFLINE 

To configure I/O-related parameters 

The I/O-related parameters maxdyninput and maxdynoutput parameters are
currently not used.  Network Services uses the maxdynio parameter; you
can change it only under the direction of Hewlett-Packard.

To configure job-related limits 

Use the JOB command (abbreviated JO) to configure job-related limits and
default operating modes.  The syntax of the command is:

JOB (JO) [[CPUTIME =] secondcount] [[MAXLIMIT =] maximumjoblimit]

[[POOL =] poolsize]

--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| CPUTIME             | Sets the default CPU time limit for batch jobs.                    |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MAXLIMIT            | Sets the maximum job limit that may be set through the LIMIT       |
|                     | command.                                                           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| POOL                | Is the number of pre-created JSMAIN processes ready to be used     |
|                     | when someone logs on.                                              |
|                     |                                                                    |
--------------------------------------------------------------------------------------------

          Table 6-1.  Values for JOB Parameters 

--------------------------------------
|              |          |          |
|  Parameter   | Minimum  | Maximum  |
|              |          |          |
--------------------------------------
|              |          |          |
| CPUTIME      |    0     |  32767   |
|              |          |          |
--------------------------------------
|              |          |          |
| MAXLIMIT     |    0     |   999    |
|              |          |          |
--------------------------------------
|              |          |          |
| POOL         |    1     |   200    |
|              |          |          |
--------------------------------------

For example, to change the parameter CPUTIME to 600 (using keyword
parameters), enter:

     misc>JOB CPUTIME=600 

Or, to change all parameters, enter:

     misc>JOB CPUTIME=500 MAXLIMIT=10 POOL=150 

To enter the same command using positional parameters, enter:

     misc>JOB 500 10 150 

To display resource identification numbers (RINs) 

Use the LRIN command (abbreviated LR) to display RIN ownership.  You can
either display the information on screen or use the OFFLINE parameter to
print it.

   *   To display the information on screen, at the misc>prompt, enter:

            misc>LRIN 

   *   To print the information, at the misc> prompt enter:

            misc>LRIN OFFLINE 
            misc>OCLOSE 

       The OFFLINE parameter redirects the output to the file SYSGLIST;
       the OCLOSE command closes SYSGLIST and prints the information.

The resource ownership information you see depends on your system, but it
will look similar to this:

      rin    username
     ____  _______________
      3    MANAGER .SYS
      148  MANAGER .QASYS
      149  MANAGER .QASYS
      150  MANAGER .QASYS

To delete RINs 

Use the DRIN command (abbreviated D) to delete one or more global
resource identification numbers.  Any changes you make take effect only
if you create a system load tape and use it to update the configuration
with UPDATE CONFIG or to install the system with INSTALL. The syntax of
the DRIN command is:

DRIN (DR) [[GLOBAL =] globalrinnumber]

You can delete either one RIN or a group of RINs:

   *   To delete a single RIN, enter the DRIN command and the global
       number.  For example, to delete RIN 4, enter:

            misc>DRIN 4 

   *   To delete a group of RINs, enter the DRIN command and the RIN
       numbers enclosed in parentheses and separated by commas.  For
       example, to delete RINs 1,2,3,4,15, and 84, enter:

            misc>DRIN (1,2,3,4,15,84) 

To set resource allocations 

Use the RESOURCE command (abbreviated RE) to allocate system resources.
Any changes you make take effect only if you create a system load tape
and use it to update the configuration with UPDATE CONFIG or to install
the system with INSTALL.

The syntax of the RESOURCE command is:

RESOURCE (RE) [[GRINS =] globalrinallocation] [[RINS =] totalrinallocation]

[[IOMONT =] iomonitortablesize] [[MAXCMCODE =] cmcodesegmentsize]

[[CMSEGS =] cmcodesegsperproc] [[MAXXDATA =] maxsizeofxdataseg]

[[XDATAPERPROC =] maxdatasegs/proc]

--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| GRINS               | Sets the number of global RINs to be allocated.                    |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| RINS                | Sets the total number of global and local RINs to be allocated.    |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| IOMONT              | Sets the size of the I/O monitor area.                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MAXCMCODE           | Sets the maximum CM code segment size allowed for any given        |
|                     | process.                                                           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MAXXDATA            | Sets the maximum extra data segment size allowed.                  |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| XDATAPERPROC        | Sets the maximum number of extra data segments for any given       |
|                     | process.                                                           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------

          Table 6-2.  Values for RESOURCE Parameters 

----------------------------------------------------
|                    |              |              |
|     Parameter      |   Minimum    |   Maximum    |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| GRINS              | 1            | 1365         |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| RINS               | 5            | 5459         |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| IOMONT             | 10           | 100          |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| MAXCMCODE          | 1024         | 16384        |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| CMSEGS             | 1            | 255          |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| MAXXDATA           | 0            | 32764        |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| XDATAPERPROC       | 0            | 255          |
|                    |              |              |
----------------------------------------------------

For example, to allocate 100 global RINS, at the misc> prompt enter:

     misc>RESOURCE GRINS=100 

Or, to allocate 40 global RINs and set the IO monitor area to 80 (using
keyword parameters), enter:

     misc>RESOURCE GRINS=40 IOMONT=80 

To allocate the same resources (using positional parameters), enter:

     misc>RE,,80 1024 

To set session-related limits 

Use the SESSION command (abbreviated SE) to configure session-related
limits and default operating points.  The syntax of the SESSION command
is:

             {[MAXLIMIT =] maximumsessionlimit}
SESSION (SE) {[LOGONTIMEOUT =] timeinseconds  }
             {[CITIMEOUT =] timeinminutes     }
             {[POOL =] poolsize               }

--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MAXLIMIT            | Sets the maximum session limit.                                    |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| LOGONTIMEOUT        | Sets the number of seconds a user has to log on to the system.     |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| CITIMEOUT           | Sets the number of minutes a user may be inactive at the terminal  |
|                     | before being automatically logged off the system.  A value of zero |
|                     | prevents automatic log off.                                        |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| POOL                | Is the number of precreated JSMAIN processes ready to be used when |
|                     | someone logs on.                                                   |
|                     |                                                                    |
--------------------------------------------------------------------------------------------

          Table 6-3.  Values for SESSION Parameters 

----------------------------------------------------
|                    |              |              |
|     Parameter      |   Minimum    |   Maximum    |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| MAXLIMIT           | 1            | 2700         |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| LOGONTIMEOUT       | 10           | 2700         |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| CITIMEOUT          | 0            | 546          |
|                    |              |              |
----------------------------------------------------
|                    |              |              |
| POOL               | 1            | 200          |
|                    |              |              |
----------------------------------------------------

For example, to change the MAXLIMIT to 200 and the LOGONTIMEOUT to 150
(using keyword parameters), enter:

     misc>SE MAXLIMIT=200 LOGONTIMEOUT=150 

To set the same limits using positional parameters, enter:

     misc>SE 200 150 

To set sizes of NM and CM stacks 

Use the STACK command (abbreviated ST) to configure the default sizes of
the native mode (NM) and compatability mode (CM) stacks and of the heap.

The syntax of the STACK command is:

           {[NM =] defaultnmstacksize     }
           {[MAXNM =] maxsizeofnmstacksize}
STACK (ST) {[CM =] defaultcmstacksize     }
           {[MAXCM =] maxsizecmstack      }
           {[HEAP =] defaultnmheapsize    }
           {[MAXHEAP =] maxsizeofnmheap   }

--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| NM                  | Sets the default NM stack size, which is expressed in bytes.  The  |
|                     | NM value must be less than the value of MAXNM (see below).         |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MAXNM               | Sets the maximum NM stack size, which is expressed in bytes.       |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| CM                  | Sets the default CM stack size, which is expressed in CM words (16 |
|                     | bits in length).  The value set for the CM parameter must be less  |
|                     | than the value set for the MAXCM parameter (see below).            |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MAXCM               | Sets the maximum allowable CM stack size.                          |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| HEAP                | Sets the default heap size, which is expressed in bytes.  The      |
|                     | value must not exceed MAXHEAP (see below).                         |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| MAXHEAP             | Sets the maximum heap size, which is expressed in bytes.           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------

          Table 6-4.  Values for STACK Parameters 
----------------------------------------------
|              |              |              |
|  Parameter   |   Minimum    |   Maximum    |
|              |              |              |
----------------------------------------------
|              |              |              |
| NM           |    262144    |    MAXNM     |
|              |              |              |
----------------------------------------------
|              |              |              |
| MAXNM        |    262144    |  1068498944  |
|              |              |              |
----------------------------------------------
|              |              |              |
| CM           |     256      |     4096     |
|              |              |              |
----------------------------------------------
|              |              |              |
| MAXCM        |     256      |    31232     |
|              |              |              |
----------------------------------------------
|              |              |              |
| HEAP         |    524288    |   MAXHEAP    |
|              |              |              |
----------------------------------------------
|              |              |              |
| MAXHEAP      |    524288    |  1068498944  |
|              |              |              |
----------------------------------------------

For example, to change the HEAP parameter to 600000, enter:

     misc>STACK HEAP=600000 

Or, to change the stack and heap sizes (using keyword parameters), enter:

     misc>STACK NM=262144 MAXNM=262144 HEAP=600000 

To make the same changes (using positional parameters), enter:

     misc>STACK 262144 262144,,,600000 

To set strings and string parameters 

Use the SYSTEM command (abbreviated SY) to set the logon prompt string,
the command interpreter prompt string, and to set the version.  The
syntax of the SYSTEM command is:

            {[USERVERSION =] x.yy.zz     }
SYSTEM (SY) {[LOGONPROMPT =] promptstring}
            {[CIPROMPT =] promptstring   }

--------------------------------------------------------------------------------------------
|                     |                                                                    |
|      Parameter      |                             Definition                             |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| USERVERSION         | Allows the system manager to identify the system with a version    |
|                     | meaningful to your environment.  This might identify some          |
|                     | combination of third-party products.                               |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| LOGONPROMPT         | Sets the system prompt.                                            |
|                     |                                                                    |
--------------------------------------------------------------------------------------------
|                     |                                                                    |
| CIPROMPT            | Sets the default prompt used by the command interpreter.           |
|                     |                                                                    |
--------------------------------------------------------------------------------------------

For example, to change the user version to A.A1.35, enter:

     misc>SYSTEM USERVERSION=A.A1.35 


NOTE If you change the user version, you must save it to something other than the CONFIG group in the SYS account or it will be lost. The changed USERVERSION takes effect only if you create a system load tape containing the changes and use it to update the system.
To change the command interpreter prompt from the default (:) to BORG, enter: misc>SY CIPROMPT=BORG To include special characters in either the logon prompt or the command interpreter prompt, enclose them in single or double single quotes. For example: misc>SY LOGONPROMPT='DOUG''S' CIPROMPT='FRED''S'


MPE/iX 5.0 Documentation