HP OpenVMS System Management Utilities Reference Manual


Previous Contents Index

LICENSE UNLOAD

Deactivates licenses registered in the LICENSE database.

Requires CMKRNL, SYSNAM, and SYSPRV privileges.


Format

LICENSE UNLOAD [product]


Parameter

product

Specifies the name of the product whose license you want to deactivate. If you enter the LICENSE UNLOAD command without specifying a product name, the system deactivates all available registered licenses.

Qualifier

/PRODUCER=string

Specifies the name of the company that owns the product for which you have a license. Use this qualifier only if the product is from a company other than HP.

Description

You can use the LICENSE UNLOAD command to deactivate licenses on multiple systems and on nonlocal systems in the system management environment. The SYSMAN LICENSE commands are a subset of the License Management Facility (LMF) commands. For more information about the LMF, see the HP OpenVMS License Management Utility Manual.

Example


SYSMAN> LICENSE UNLOAD FORTRAN 
      

This command deactivates the license for HP Fortran for OpenVMS. Because the license is for a HP product, the command does not include the /PRODUCER qualifier.

PARAMETERS DISABLE CHECKS

Bypasses validation of parameter values. SYSMAN parameter validation ensures that the parameters fall within the defined minimum and maximum values specified in the PARAMETERS SET command.

Format

PARAMETERS DISABLE CHECKS


Parameters

None.

Qualifiers

None.

Description

The PARAMETERS DISABLE CHECKS command enables you to override minimum and maximum values established for system parameters. SYSMAN does parameter checks by default. If you attempt to set parameter values outside the allowable limits when checks are enabled, the operating system issues an error message. By disabling checks you can set parameter values regardless of the minimum and maximum limits.

Note

Range checks are enabled by default because HP suggests that systems operate within these minimum and maximum values. Setting parameters outside these limits can result in system failures or hangs.

Example


SYSMAN> SET ENVIRONMENT/CLUSTER
SYSMAN> SET PROFILE/DEFAULT=SYS$SYSTEM/PRIVILEGES=CMEXEC 
SYSMAN> PARAMETERS SET MAXPROCESSCNT 10
%SMI-E-OUTRANGE, parameter is out of range 
SYSMAN> PARAMETERS DISABLE CHECKS
SYSMAN> PARAMETERS SET MAXPROCESSCNT 10 
      

In this example, the initial attempt to set MAXPROCESSCNT below the minimum fails because range checks are enabled. However, once range checks are disabled, the PARAMETERS SET MAXPROCESSCNT command succeeds.

PARAMETERS ENABLE CHECKS

Validates all parameter values to ensure that they fall within the defined minimum and maximum values.

Because range checks are enabled by default, use PARAMETERS ENABLE CHECKS after entering a PARAMETERS DISABLE CHECKS command.


Format

PARAMETERS ENABLE CHECKS


Parameters

None.

Qualifiers

None.

Example


SYSMAN> PARAMETERS DISABLE CHECKS
SYSMAN> PARAMETERS SET WSMAX 20
SYSMAN> PARAMETERS ENABLE CHECKS
SYSMAN> PARAMETERS SET WSMAX 30
%SMI-E-OUTRANGE, parameter is out of range
SYSMAN> PARAMETERS SHOW WSMAX
Parameter Name    Current  Default  Minimum  Maximum Unit  Dynamic
WSMAX                2000     1024       60   6400 pages          
 
      

The PARAMETERS ENABLE CHECKS command in this example shows that when range checking is disabled, the system accepts a working set value (WSMAX) of 20. However, once range checking is enabled with the PARAMETERS ENABLE CHECKS command, the system does not accept a WSMAX below the minimum, which is 60.

PARAMETERS SET

Changes the value of a specific parameter in the work area.

The PARAMETERS SET command does not modify parameter files, the current system parameter file on disk, or the active system. For information about performing these modifications, see the PARAMETERS WRITE command.


Format

PARAMETERS SET parameter-name [value]


/STARTUP filespec


Parameters

parameter-name

Specifies the name of the parameter to modify. Instead of a name, you can enter a period (.) to change the value of the most recently displayed or the most recently modified parameter. See the PARAMETERS SHOW command for an example of using the period in place of a parameter name.

For a list of system parameters and further information about them, use the command HELP PARAMETERS.

value

Specifies the new value for the parameter. Enclose values for ASCII parameters in quotation marks if they contain embedded spaces or other special characters.

Typically the value is an integer or the keyword DEFAULT. The keyword DEFAULT sets the parameter to its default value. The PARAMETERS SHOW command displays the defined minimum, maximum, and default values for the parameter, which are required unless range checking is disabled with the command PARAMETERS DISABLE CHECKS.


Qualifier

/STARTUP filespec

Sets the name of the site-independent startup procedure to the given file specification. A file specification has a maximum length of 31 characters. The initial startup command procedure is SYS$SYSTEM:STARTUP.COM.

Examples

#1

SYSMAN> PARAMETERS SET PFCDEFAULT 20
      

This command assigns a value of 20 to the PFCDEFAULT parameter.

#2

SYSMAN> PARAMETERS SET GBLSECTIONS DEFAULT
      

This command assigns the default value (40) to the GBLSECTIONS parameter.

#3

SYSMAN> PARAMETERS SET/STARTUP SYS$SYSTEM:XSTARTUP.COM
      

This command assigns SYS$SYSTEM:XSTARTUP.COM as the current site-independent startup command procedure.

PARAMETERS SHOW

Displays the value of a parameter or a group of parameters in the work area. In addition, the command shows the minimum, maximum, and default values of a parameter and its unit of measure.

Format

PARAMETERS SHOW [parameter-name]


Parameter

parameter-name

Specifies the name of a parameter or a period (.). A period is interpreted as a request for the parameter specified in the last PARAMETERS SET or PARAMETERS SHOW command. The parameter name can be abbreviated, but the abbreviation must be unique because SYSMAN selects the first parameter that matches.

Beginning in OpenVMS Version 8.2, if the parameter-name that you enter is obsolete, SYSMAN displays OBSOLETE in the Units column.


Qualifiers

/ACP

Displays all Files--11 ACP parameters.

/ALL

Displays the values of all active parameters.

/CLUSTER

Displays all parameters specific to clusters.

/DYNAMIC

Displays all parameters that would be in effect immediately after you enter a PARAMETERS WRITE ACTIVE command.

/GEN

Displays all general parameters.

/HEX

Displays numeric parameters in hexadecimal rather than decimal radix. Specify the /HEX system parameter name or the parameter type. If you specify the /HEX qualifier with the /NAMES qualifier, /HEX is ignored.

/JOB

Displays all job controller parameters.

/LGI

Displays all LOGIN security control parameters.

/MAJOR

Displays the most important parameters.

/MULTIPROCESSING

Displays parameters specific to multiprocessing.

/NAMES

Displays only parameter names. You can combine other qualifiers with this one.

/OBSOLETE

Displays the names of all obsolete system parameters.

/OUTPUT

Directs output to the specified file rather than SYS$OUTPUT. Without a file specification, the output goes to SYSMAN.LIS in the current directory.

/PAUSE

Controls the rate at which the system displays information about parameters.

/PQL

Displays the parameters for all default process quotas.

/RMS

Displays all parameters specific to OpenVMS Record Management Services (RMS).

/SCS

Displays all parameters specific to OpenVMS Cluster System Communications Services.

/SPECIAL

Displays all special control parameters.

/STARTUP

Displays the name of the site-independent startup procedure.

/SYS

Displays all active system parameters.

/TTY

Displays all parameters for terminal drivers.

Description

SYSMAN displays parameters in decimal unless you specify the /HEX qualifier. ASCII values are always displayed in ASCII.

Abbreviations for parameter names must be unique because SYSMAN displays the first parameter matching the abbreviation. Ambiguity checks do not occur. For example, a specification of PARAMETERS SHOW GBL displays the GBLSECTIONS parameter. To display the GBLPAGFIL parameter, you must specify PARAMETERS SHOW GBLPAGF to avoid displaying the GBLPAGES parameter.

You can use a period (.) to indicate that you want to work with the system parameter that you specified in the last PARAMETERS SET or PARAMETERS SHOW command.


Examples

#1

SYSMAN> PARAMETERS SHOW GBLSECTIONS
Parameter Name    Current   Default   Minimum     Maximum Unit  Dynamic
GBLSECTIONS           100        40        20     -1  Sections
 
SYSMAN> PARAMETERS SET . 110
SYSMAN> PARAMETERS SHOW .
Parameter Name    Current   Default   Minimum     Maximum Unit  Dynamic
GBLSECTIONS           110        40        20     -1  Sections          
      

In this example, the user first displays the values of the GBLSECTIONS parameter and then refers to the parameter with a period to set its current value to 110. The next PARAMETERS SHOW command also uses the period notation to obtain confirmation that the change occurred.

#2

SYSMAN> PARAMETERS SHOW/ACP
      

This command produces output similar to the following example:


Parameters in use: Active 
Parameter Name        Current   Default   Minimum   Maximum Unit  Dynamic 
ACP_MULTIPLE                0         1         0         1 Boolean     D 
ACP_SHARE                   1         1         0         1 Boolean 
ACP_MAPCACHE               52         8         1        -1 Pages       D 
ACP_HDRCACHE              138       128         2        -1 Pages       D 
ACP_DIRCACHE              138        80         2        -1 Pages       D 
ACP_DINDXCACHE             37        25         2        -1 Pages       D 
ACP_WORKSET                 0         0         0        -1 Pages       D 
ACP_FIDCACHE               64        64         0        -1 File-Ids    D 
ACP_EXTCACHE               64        64         0        -1 Extents     D 
ACP_EXTLIMIT              300       300         0      1000 Percent/10  D 
ACP_QUOCACHE              130        64         0        -1 Users       D 
ACP_SYSACC                  4         8         0        -1 Directories D 
ACP_MAXREAD                32        32         1        64 Blocks      D 
ACP_WINDOW                  7         7         1        -1 Pointers    D 
ACP_WRITEBACK               1         1         0         1 Boolean     D 
ACP_DATACHECK               2         2         0         3 Bit-mask    D 
ACP_BASEPRIO                8         8         4        31 Priority    D 
ACP_SWAPFLGS               14        15         0        15 Bit-mask    D 
ACP_XQP_RES                 1         1         0         1 Boolean 
ACP_REBLDSYS                0         1         0         1 Boolean 

#3

SYSMAN> PARAMETERS SHOW/ACP/HEX
      

This command produces a hexadecimal display of the values of the ACP system parameters.


Parameters in use: Active 
Parameter Name        Current   Default   Minimum   Maximum Unit  Dynamic 
ACP_MULTIPLE         00000000  00000001  00000000  00000001 Boolean     D 
ACP_SHARE            00000001  00000001  00000000  00000001 Boolean 
ACP_MAPCACHE         00000034  00000008  00000001  FFFFFFFF Pages       D 
ACP_HDRCACHE         0000008A  00000080  00000002  FFFFFFFF Pages       D 
ACP_DIRCACHE         0000008A  00000050  00000002  FFFFFFFF Pages       D 
ACP_DNDXCACHE        00000025  00000019  00000002  FFFFFFFF Pages       D 
ACP_WORKSET          00000000  00000000  00000000  FFFFFFFF Pages       D 
ACP_FIDCACHE         00000040  00000040  00000000  FFFFFFFF File-Ids    D 
ACP_EXTCACHE         00000040  00000040  00000000  FFFFFFFF Extents     D 
ACP_EXTLIMIT         0000012C  0000012C  00000000  000003E8 Percent/10  D 
ACP_QUOCACHE         00000082  00000040  00000000  FFFFFFFF Users       D 
ACP_SYSACC           00000004  00000008  00000000  FFFFFFFF Directories D 
ACP_MAXREAD          00000020  00000020  00000001  00000040 Blocks      D 
ACP_WINDOW           00000007  00000007  00000001  FFFFFFFF Pointers    D 
ACP_WRITEBACK        00000001  00000001  00000000  00000001 Boolean     D 
ACP_DATACHECK        00000002  00000002  00000000  00000003 Bit-mask    D 
ACP_BASEPRIO         00000008  00000008  00000004  0000001F Priority    D 
ACP_SWAPFLGS         0000000E  0000000F  00000000  0000000F Bit-mask    D 
ACP_XQP_RES          00000001  00000001  00000000  00000001 Boolean 
ACP_REBLDSYS         00000000  00000001  00000000  00000001 Boolean 

#4

SYSMAN> PARAMETERS SHOW/OBSOLETE
      

This command displays the names of all obsolete system parameters.


SYSMAN> PARAMETERS SHOW/OBSOLETE


Node XENON3:   Parameters in use: ACTIVE 
 
Parameter Name            Current    Default    Minimum    Maximum Unit  Dynamic 
--------------            -------    -------    -------    ------- ----  ------- 
VECTOR_PROC                     1          1          0          3 Obsolete 
PAGFILCNT                       0          0          0          0 Obsolete 
SWPFILCNT                       0          0          0          0 Obsolete 
VIRTUALPAGECNT         2147483647 2147483647       2048 2147483647 Obsolete 
EXUSRSTK                     1024       1024       1024         -1 Obsolete 
QBUS_MULT_INTR                  0          0          0          1 Obsolete 
LAMAPREGS                       0          0          0        255 Obsolete 
LOCKIDTBL_MAX             4251127   16776959       1792   16776959 Obsolete 
SCSCONNCNT                     40         40          2      32767 Obsolete 
UDABURSTRATE                    0          0          0         31 Obsolete 
SA_APP                          0          0          0          1 Obsolete 
TAILORED                        0          0          0          1 Obsolete 
BOOT_STYLE                      0          0          0          2 Obsolete 
SD_ALLOCLASS                    0          0          0        255 Obsolete 
NISCS_LAN_OVRHD                 0          0          0        256 Obsolete 
SERVED_IO                       0          0          0          0 Obsolete 
XFMAXRATE                     236        236          0        255 Obsolete 
   .
   .
   .

#5

SYSMAN> PARAMETERS SHOW <parameter_name>
      

This command displays information about one obsolete system parameter, VIRTUALPAGECNT.


SYSMAN> PARAMETERS SHOW VIRT


%SYSMAN-I-NODERR, error returned from node XENON3 
-SMI-E-NOSUCHPARM, no such parameter 

You must enter the full name of the parameter:


SYSMAN> PARAMETERS SHOW VIRTUALPAGECNT


Node XENON3:   Parameters in use: ACTIVE 
Parameter Name            Current    Default    Minimum    Maximum Unit  Dynamic 
--------------            -------    -------    -------    ------- ----  ------- 
VIRTUALPAGECNT         2147483647 2147483647       2048 2147483647 Obsolete 
 
SYSMAN> 
$ 

#6

SYSMAN> PARAMETERS SHOW/STARTUP
Startup command file = SYS$SYSTEM:STARTUP.COM
      

This command displays the name of the site-independent startup command procedure.


SYSMAN> PARAMETERS SHOW/PAUSE MAXPROCESSCNT


Node EXPERT:   Parameters in use: ACTIVE 
 
Parameter Name         Current    Default    Minimum    Maximum Unit  Dynamic 
--------------         -------    -------    -------    ------- ----  ------- 
MAXPROCESSCNT              160         32         12       8192 Processes 


Press return to continue [Return]


Node MODERN:   Parameters in use: ACTIVE 
 
Parameter Name         Current    Default    Minimum    Maximum Unit  Dynamic 
--------------         -------    -------    -------    ------- ----  ------- 
MAXPROCESSCNT              157         32         12       8192 Processes 


Press return to continue [Return]


 
Node IMPOSE:   Parameters in use: ACTIVE 
 
Parameter Name         Current    Default    Minimum    Maximum Unit  Dynamic 
--------------         -------    -------    -------    ------- ----  ------- 
MAXPROCESSCNT               50         32         12       8192 Processes 


Press return to continue [Return]

.
.
.

The command in this example allows you to control the rate at which the information is displayed.

PARAMETERS USE

Reads a set of system parameters into the work area for display or modification.

Format

PARAMETERS USE source


Parameter

source

The source of a system parameter file for data to be read into the work area. The source can be any of the following items:
ACTIVE Read parameters from memory. When you invoke SYSMAN, active values are in effect.
CURRENT Read parameters from the default system parameter file, which is the source for parameters when you boot the system. Using the current parameters requires read (R) access to the system parameters file.
  • On Alpha systems, the file that contains current parameters is SYS$SYSTEM:ALPHAVMSSYS.PAR.
  • On Integrity servers, the file that contains current parameters is SYS$SYSTEM:IA64VMSSYS.PAR.
filespec Read parameters from a previously created system parameter file. The default file type is .PAR. You need read access to the file.
DEFAULT Read a parameter set containing the default values for all parameters. These values are supplied with the operating system.

Qualifiers

None.

Description

Depending on the source you enter with the command, PARAMETERS USE activates the parameter values:

Example


SYSMAN> PARAMETERS USE DEFAULT
SYSMAN> SET STARTUP_P1 "MIN"
 
      

The first command activates the default parameter values that are supplied with the operating system. The second command sets the STARTUP_P1 system parameter to "minimum." This avoids starting all layered products on a system that is not tuned for them, which might cause the system to hang.


Previous Next Contents Index