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