[Digital logo]
[HR]

OpenVMS System Management Utilities Reference Manual


Previous | Contents

The default value of 7 preserves compatibility with existing DECwindows Motif behavior. A value of 0 disables all unevaluated configurations.

SETTIME

SETTIME enables (1) or disables (0) solicitation of the time of day each time the system is booted. This parameter should usually be off (0), so that the system sets the time of day at boot time to the value of the processor time-of-day register. You can reset the time after the system is up with the DCL command SET TIME (see the OpenVMS DCL Dictionary).

SHADOWING

SHADOWING enables or disables shadowing and specifies the mode of shadowing operations that you want to enable. SHADOWING is a value that specifies the type of disk class driver that is loaded on the system: DUDRIVER, DSDRIVER, or SHDRIVER. See Volume Shadowing for OpenVMS for more information about setting system parameters for volume shadowing.

Specify one of the following values:
Value Description
0 No shadowing is enabled; SHDRIVER is not loaded. This is the default value.
2 Phase II shadowing enabled. SHDRIVER is loaded. Phase II shadowing provides shadowing of all disks located on a standalone system or an OpenVMS Cluster system.


Note

A parameter value of 1 represents Phase I, which is no longer supported. Instead, use Phase II shadowing.

SHADOW_MAX_COPY (A,D)

Use this parameter for Phase II shadowing only. The value of SHADOW_MAX_COPY controls how many parallel copy threads are allowed on a given node.

Carefully consider the needs of each shadowed VAX node when you set this parameter. Too high a value for SHADOW_MAX_COPY can affect performance by allowing too many copy threads to operate in parallel. Too low a value unnecessarily restricts the number of threads your system can effectively handle.

See Volume Shadowing for OpenVMS for more information about setting system parameters for volume shadowing.

SHADOW_MBR_TMO (D)

SHADOW_MBR_TMO controls the amount of time the system tries to fail over physical members of a shadow set before removing them from the set. The SHADOW_MBR_TMO parameter replaces the temporary VMSD3 parameter used in prior releases.

The SHADOW_MBR_TMO parameter is valid for use only with Phase II of Volume Shadowing for OpenVMS. You cannot set this parameter for use with Phase I, which is obsolete.

Use the SHADOW_MBR_TMO parameter (a word) to specify the number of seconds, in decimal from 1 to 65,535, during which recovery of a repairable shadow set is attempted. If you do not specify a value or if you specify 0, the default delay of 20 seconds is used.

Because SHADOW_MBR_TMO is a dynamic parameter, you should use the SYSGEN command WRITE CURRENT to permanently change its value.

SHADOW_REMOVE_1

On Alpha systems, SHADOW_REMOVE_1 is reserved to Digital.

SHADOW_REMOVE_2

On Alpha systems, SHADOW_REMOVE_2 is reserved to Digital.

SHADOW_SYS_DISK

A SHADOW_SYS_DISK parameter value of 1 enables shadowing of the system disk. A value of 0 disables shadowing of the system disk. The default value is 0.

In addition, you should specify a system disk shadow set virtual unit number with the SHADOW_SYS_UNIT system parameter, unless the desired system disk unit number is DSA0.

To enable minimerge on a system disk, add the value 4096 to your existing SHADOW_SYS_DISK value. For example, if you have SHADOW_SYS_DISK set to a value of 1, change it to 4097 to enable minimerge. Also be sure to set the DUMPSTYLE parameter to dump off system disk, as described in OpenVMS Version 7.1 Release Notes.

SHADOW_SYS_TMO

The SHADOW_SYS_TMO parameter has the following two distinct usages:

This parameter applies only to members of the system disk shadow set. All nodes using a particular system disk shadow set should have their SHADOW_SYS_TMO parameter set to the same value once normal operations begin.

The default value is 20 seconds. Change this parameter to a higher value if you want the system to wait more than the 20-second default for all members to join the shadow set. You can set the parameter value to 20 through 65,535 seconds.

SHADOW_SYS_UNIT

Use this parameter for Phase II shadowing only. The SHADOW_SYS_ UNIT parameter is an integer value that contains the virtual unit number of the system disk. The default value is 0. The maximum value allowed is 9999. This parameter is effective only when the SHADOW_SYS_DISK parameter has a value of 1. This parameter should be set to the same value on all nodes booting off a particular system disk shadow set. See Volume Shadowing for OpenVMS for more information about setting system parameters for volume shadowing.

SHADOW_SYS_WAIT

The SHADOW_SYS_WAIT parameter extends the time a booting system waits for all current members of a mounted shadowed system disk to become available to this node. The shadow set must already be mounted by at least one other cluster node for this parameter to take effect.

The default value is 256 seconds. Change this parameter to a higher value if you want the system to wait more than the 256-second default for all members to join the shadow set. You can set the parameter value to 1 through 65,535 seconds.

SMP_CPUS

SMP_CPUS identifies which secondary processors, if available, are to be booted into the multiprocessing system at boot time. SMP_CPUS is a 32-bit mask; if the value of a bit in the mask is 1, the processor with the corresponding CPU ID is booted into the multiprocessing system (if it is available). For example, if you want to boot only the CPUs with CPU IDs 0 and 1, specify the value 3 (both bits are on).

The default value of SMP_CPUS, --1, boots all available CPUs into the multiprocessing system.

Note that, although a bit in the mask corresponds to the primary processor's CPU ID, the primary processor is always booted. That is, if the mask is set to 0, the primary CPU will still boot. Any available secondary processors will not be booted into the multiprocessing system.

This parameter is ignored if the MULTIPROCESSING parameter is set to 0.

SMP_LNGSPINWAIT

Certain shared resources in a multiprocessing system take longer to become available than allowed for by the SMP_SPINWAIT parameter. SMP_LNGSPINWAIT establishes, in 10-microsecond intervals, the length of time a processor in a multiprocessing system waits for these resources. A timeout causes a CPUSPINWAIT bugcheck.

The default value is 3 seconds (300,000 10-microsecond intervals).

SMP_SANITY_CNT

SMP_SANITY_CNT establishes, in 10-millisecond intervals, the timeout period for each CPU in a symmetric multiprocessing (SMP) system. Each CPU in an SMP system monitors the sanity timer of one other CPU in the configuration to detect hardware or software failures. If allowed to go undetected, these failures could cause the cluster to hang. A timeout causes a CPUSANITY bugcheck.

The default value is 300 milliseconds (30 10-millisecond intervals).

SMP_SPINWAIT

SMP_SPINWAIT establishes, in 10-microsecond intervals, the amount of time a CPU in an SMP system normally waits for access to a shared resource. This process is called spinwaiting.

A timeout causes a CPUSPINWAIT bugcheck.

The default value is 100 milliseconds (10,000 10-microsecond intervals).

SPTREQ (A)

On VAX systems, SPTREQ sets the number of system page table (SPT) entries required for mapping the following components:

The number of system page table entries required for all other purposes is automatically computed and added to the value of SPTREQ to yield the actual size of the system page table.

STARTUP_P1--8

STARTUP_P1 specifies the type of system boot the system-independent startup procedure is to perform. If STARTUP_P1 is blank, "FULL" is used as parameter 1; "MIN" indicates a minimum boot that starts only what is absolutely necessary for the operating system to run.

STARTUP_P2 controls whether verification is set during the execution of the system-independent startup procedure. If STARTUP_P2 is blank, verification is not enabled; "TRUE" indicates that verification is enabled.

STARTUP_P3 through STARTUP_P8 are reserved for future use.

SWPFILCNT

SWPFILCNT defines the maximum number of swap files that can be installed.

SWPOUTPGCNT (A on VAX,D)

This parameter allows the swapper an alternative mechanism before actually performing swaps.

On VAX systems, SWPOUTPGCNT defines the minimum number of pages to which the swapper should attempt to reduce a process before swapping it out. The pages taken from the process are placed into the free-page list.

On Alpha systems, SWPOUTPGCNT defines the minimum number of pagelets to which the swapper should attempt to reduce a process before swapping it out. The pagelets taken from the process are placed into the free-page list.

SYSMWCNT (A,G,M)

SYSMWCNT sets the quota for the size of the system working set, which contains the pageable portions of the system, the paged dynamic pool, RMS, and the resident portion of the system message file.

While a high value takes space away from user working sets, a low value can seriously impair system performance. Appropriate values vary, depending on the level of system use. When the system is running at full load, check the rate of system faults with the MONITOR PAGE command of the Monitor utility. An average system page fault rate of between 0 and 3 page faults per second is desirable. If the system page fault rate is high, and especially if the system seems to be slow, you should increase the value of SYSMWCNT. However, do not set this parameter so high that system page faulting never occurs.

SYSTEM_CHECK

SYSTEM_CHECK investigates intermittent system failures by enabling a number of run-time consistency checks on system operation and recording some trace information.

Enabling SYSTEM_CHECK causes the system to behave as if the following system parameter values are set (although the values of the following parameters are not actually changed):
Parameter Value Description
BUGCHECKFATAL 1 Crash the system on nonfatal bugchecks
POOLCHECK %X616400FF Enable all poolchecking, with an allocated pool pattern of %x61616161 ('aaaa') and deallocated pool pattern of x64646464 ('dddd')
MULTIPROCESSING 2 Enable full synchronization checking

While SYSTEM_CHECK is enabled, the previous settings of the BUGCHECKFATAL and MULTIPROCESSING parameters are ignored. However, setting the parameter POOLCHECK to a nonzero value overrides the setting imposed by SYSTEM_CHECK.

Setting SYSTEM_CHECK creates certain image files that are capable of the additional system monitoring. These image files are located in SYS$LOADABLE_IMAGES and can be identified by the suffix _MON.

TAILORED

TAILORED specifies whether or not the system is tailored during installation. Digital recommends using the default value.

TAPE_ALLOCLASS

TAPE_ALLOCLASS determines the tape allocation class for the system. The tape allocation class creates a unique clusterwide device name for multiple access paths to the same tape.

The TAPE_ALLOCLASS parameter can also be used to generate a unique clusterwide name for tape devices with identical unit numbers.

TAPE_MVTIMEOUT (D)

TAPE_MVTIMEOUT is the time in seconds that a mount verification attempt will continue on a given magnetic tape volume. If the mount verification does not recover the volume within that time, the I/O operations outstanding to the volume will terminate abnormally.

TIMEPROMPTWAIT

TIMEPROMPTWAIT defines the number of seconds that you want a processor to wait for the time and date to be entered when a system boot occurs, if the processor's time-of-year clock does not contain a valid time. (The time unit of micro-fortnights is approximated as seconds in the implementation.) If the time specified by TIMEPROMPTWAIT elapses, the system continues the boot operation, and the date and time are set to the last recorded time that the system booted.

Note

Digital recommends that you set the correct system time before allowing the system to run, so that all functions using time-stamping (such as the operator log, the error log, accounting records, file creation dates, and file expiration dates) will contain correct time values.

Depending on the value specified for the TIMEPROMPTWAIT parameter, the system acts in one of the following ways:

TIMVCFAIL (D)

TIMVCFAIL specifies the time required for an adapter or virtual circuit failure to be detected. Digital recommends that the default value be used. Digital also recommends that this value be lowered only in OpenVMS Cluster of three CPUs or less, that the same value be used on each computer in the cluster, and that dedicated LAN segments be used for cluster I/O.

TMSCP_LOAD (A)

TMSCP_LOAD allows the loading of the tape mass storage control protocol server software. The TMSCP_LOAD parameter also sets locally connected tapes served. Refer to OpenVMS Cluster Systems for information about setting the TMSCP_LOAD parameter.

When TMSCP_LOAD is set to 0, it inhibits the loading of the tape server and the serving of local tapes. When TMSCP is set to 1, it loads the tape server into memory at the time the system is booted, and makes all directly connected tape drives available clusterwide. The following table describes the two states of the TMSCP_LOAD parameter:
State Function
0 Do not load the TMSCP tape server. Do not serve any local tape devices clusterwide. This is the default value.
1 Load the TMSCP tape server. Serve all local TMSCP tape devices clusterwide.

TMSCP_SERVE_ALL

TMSCP_SERVE_ALL specifies TMSCP tape-serving functions when TMSCP server is loaded. If TMSCP_LOAD is set to 0, the TMSCP_SERVE_ALL parameter is ignored. Refer to OpenVMS Cluster Systems for information about setting the TMSCP_SERVE_ALL parameter.

The following table describes the parameter settings:
State Function
0 Do not serve tapes. This is the default value.
1 Serve all available tapes.
2 Serve only locally connected tapes.

TTY_ALTALARM

TTY_ALTALARM sets the size of the alternate type-ahead buffer alarm. This value indicates at what point an XOFF should be sent to terminals that use the alternate type-ahead buffers with the size specified by the TTY_ALTYPAHD parameter.

TTY_ALTYPAHD

TTY_ALTYPAHD sets the size of the alternate type-ahead buffer. Use this parameter to allow the block mode terminals and communications lines to operate more efficiently.

The default value is usually adequate. Do not exceed the maximum value of 32767 when setting this parameter.

TTY_AUTOCHAR (D)

TTY_AUTOCHAR sets the character the terminal driver echoes when the job controller has been notified.

TTY_BUF

TTY_BUF sets the default line width for terminals.

TTY_CLASSNAME

TTY_CLASSNAME provides the 2-character prefix for the terminal class driver name that is required when booting. Changing the prefix can be useful when debugging a new terminal driver.

TTY_DEFCHAR

TTY_DEFCHAR sets the default characteristics for terminals, using a code derived by summing the following hexadecimal values:
Characteristic Value (Hex) Function
PASSALL 1 Passall.
NOECHO 2 Noecho mode.
NOTYPEAHEAD 4 No type-ahead buffer.
ESCAPE 8 Escape sequence processing.
HOSTSYNC 10 Host can send XON and XOFF.
TTSYNC 20 Terminal can send XON and XOFF.
SCRIPT 40 Internal use only.
LOWER 80 Lowercase.
MECHTAB 100 Mechanical tabs.
WRAP 200 Wraparound at end of line.
CRFILL 400 Perform carriage return fill.
LFFILL 800 Perform line feed fill.
SCOPE 1000 Terminal is a scope.
REMOTE 2000 Internal use only.
EIGHTBIT 8000 Eight-bit terminal.
MBXDSABL 10000 Disable mailbox.
NOBRDCST 20000 Prohibit broadcast.
READSYNC 40000 XON and XOFF on reads.
MECHFORM 80000 Mechanical form feeds.
HALFDUP 100000 Set for half-duplex operation.
MODEM 200000 Set for modem signals.
PAGE FF000000 Page size. Default is 24.

Note

Do not set NOTYPEAHEAD, CRFILL, or LFFILL characteristics as the default in TTY_DEFCHAR.

Where a condition is false, the value is 0.

The upper byte is the page length. The default characteristics are 24 lines per page, terminal synchronization, wraparound, lowercase, scope, and full-duplex.

TTY_DEFCHAR2

TTY_DEFCHAR2 sets a second longword of default terminal characteristics. The default characteristics are represented as a code that is derived by summing the following hexadecimal values:
Characteristic Value (Hex) Function
LOCALECHO 1 Enable local echo terminal logic; use with the TTY_DEFCHAR NOECHO characteristic.
AUTOBAUD 2 Enable autobaud detection.
HANGUP 4 Hang up on logout.
MODHANGUP 8 Allow modification of HANGUP without privileges.
BRDCSTMBX 10 Allow sending of broadcasts to mailboxes.
XON 20 (No effect in this parameter.)
DMA 40 (No effect in this parameter.)
ALTYPEAHD 80 Use the alternate type-ahead parameters.
SETSPEED 100 Clear to allow setting of speed without privileges.
DCL_MAILBX 200 Function reserved to Digital.
DECCRT4 400 Terminal is Digital CRT Level 4.
COMMSYNC 800 Enable flow control using modem signals.
EDITING 1000 Line editing allowed.
INSERT 2000 Sets default mode for insert.
FALLBACK 4000 Do not set this bit with SYSGEN. Refer to the OpenVMS Terminal Fallback Utility Manual for information on setting the FALLBACK terminal characteristic using the Terminal Fallback utility. (This manual has been archived but is available in PostScript and DECW$BOOK (Bookreader) formats on the OpenVMS Documentation CD-ROM. A printed book can be ordered through DECdirect (800-354-4825).)
DIALUP 8000 Terminal is a dialup line.
SECURE 10000 Guarantees that no process is connected to terminal after Break key is pressed.
DISCONNECT 20000 Allows terminal disconnect when a hangup occurs.
PASTHRU 40000 Terminal is in PASTHRU mode.
SYSPWD 80000 Log in with system password only.
SIXEL 100000 Sixel graphics.
DRCS 200000 Terminal supports loadable character fonts.
PRINTER 400000 Terminal has printer port.
APP_KEYPAD 800000 Notifies application programs of state to set keypad on exit.
ANSICRT 1000000 Terminal conforms to ANSI CRT programming standards.
REGIS 2000000 Terminal has REGIS CRT capabilities.
BLOCK 4000000 Block mode terminal.
AVO 8000000 Terminal has advanced video.
EDIT 10000000 Terminal has local edit capabilities.
DECCRT 20000000 Terminal is a Digital CRT.
DECCRT2 40000000 Terminal is a Digital CRT Level 2.
DECCRT3 80000000 Terminal is a Digital CRT Level 3.

The defaults are AUTOBAUD and EDITING.

TTY_DEFPORT

TTY_DEFPORT provides flag bits for port drivers. Bit 0 set to 1 indicates that the terminal controller does not provide automatic XON/XOFF flow control. This bit should not be set for Digital controllers but is needed for some foreign controllers. Currently only the YCDRIVER (DMF32, DMZ32) uses this bit. The remaining bits are reserved for future use.

TTY_DIALTYPE

TTY_DIALTYPE provides flag bits for dialups. Bit 0 is 1 for United Kingdom dialups and 0 for all others. Bit 1 controls the modem protocol used. Bit 2 controls whether modem lines will hang up 30 seconds after seeing CARRIER if a channel is not assigned to the device. The remaining bits are reserved for future use. See the OpenVMS I/O User's Reference Manual for more information on flag bits.

TTY_DMASIZE (D)

TTY_DMASIZE specifies the number of characters in the output buffer below which character transfers are performed, and above which DMA transfers occur, provided the controller is capable of DMA I/O.

TTY_PARITY

TTY_PARITY sets terminal default parity.

TTY_RSPEED

TTY_RSPEED defines the receive speed for terminals. If TTY_RSPEED is 0, TTY_SPEED controls both the transmit and the receive speed. Maximum value is 17. This parameter is only applicable for controllers that support split-speed operations, such as the DZ32 and the DMF32.

TTY_SCANDELTA

TTY_SCANDELTA sets the interval for polling terminals for dialup and hangup events. Shorter intervals use more processor time; longer intervals may result in missing a hangup event.

TTY_SILOTIME

TTY_SILOTIME defines the interval at which the DMF32 hardware polls the input silo for received characters. The DMF32 asynchronous terminal controller can delay the generation of a single input interrupt until multiple characters have accumulated in the input silo. TTY_SILOTIME specifies the number of milliseconds that the characters are allowed to accumulate prior to the generation of an input interrupt by the hardware.

TTY_SPEED

TTY_SPEED sets the systemwide default speed for terminals. Low byte is transmit speed, and high byte is receive speed. If high byte is set to 0, receive speed is identical to transmit speed. Maximum value is 17. Baud rates are defined by the $TTDEF macro.

TTY_TIMEOUT (D)

TTY_TIMEOUT sets the number of seconds before a process associated with a disconnected terminal is deleted. The default value (900 seconds) is usually adequate. Note that using values for TTY_TIMEOUT greater than one year (value %X01E13380) can cause overflow errors and result in a disconnected device timing out immediately.

TTY_TYPAHDSZ

TTY_TYPAHDSZ sets the size of the terminal type-ahead buffer. The default value is usually adequate. Do not exceed the maximum value of 32767 when setting this parameter.

UAFALTERNATE (G,M)

UAFALTERNATE enables or disables the assignment of SYSUAF as the logical name for SYSUAFALT, causing all references to the user authorization file (SYSUAF) to be translated to SYS$SYSTEM:SYSUAFALT. Use of the normal user authorization file (SYS$SYSTEM:SYSUAF) can be restored by deassigning the system logical name SYSUAF. This parameter should be set on (1) only when the system is being used by a restricted set of users. You must create a user authorization file named SYSUAFALT prior to setting UAFALTERNATE to 1.

UDABURSTRATE (G)

UDABURSTRATE is reserved to Digital.

USERD1 (D)

USERD1 is reserved for definition at the user's site. The reserved longword is referenced by the symbol SGN$GL_USERD1.


Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  6048P068.HTM
  OSSG Documentation
  26-NOV-1996 12:44:07.01

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal