HP OpenVMS Systems

HP Advanced Server for OpenVMSServer
Administrator's Guide

The OpenVMS Registry server must be running for the Advanced Server to
run. If the OpenVMS Registry server is not running when you initially
configure the Advanced Server or when the Advanced Server is started, the
Advanced Server attempts to start the OpenVMS Registry server. For
information about configuring and starting the OpenVMS Registry server,
refer to the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. For more information, refer also to the
HP OpenVMS System Manager's Manual or the COM, Registry, and Events for OpenVMS Developer's Guide (included in the OpenVMS
Documentation CD-ROM).

For a detailed list of most of the server configuration parameters that
can be stored in the OpenVMS Registry, including descriptions of the
parameters, LANMAN.INI parameter mappings, default data settings and
minimum and maximum values for integer data, see Appendix A, Server Configuration Parameters.

Note

The Advanced Server startup procedure records a list of all Advanced Server
parameters that are defined in the OpenVMS Registry. You can use this
list as a reference if you should ever need the latest parameter
values. The list is stored in the following location, where
nodename is the name of your server node:

You can manage Advanced Server software parameters in the OpenVMS
Registry remotely, from a Window NT computer running Windows NT Server
or Workstation software. However, HP recommends that you
manage these parameters from an OpenVMS system so that you can use
PWKR$REGUTL, which has built-in knowledge of keys and values used by
the Advanced Server, as explained in Section 7.3.3.2, Managing Registry-Stored Advanced Server Parameters from OpenVMS.

Windows NT provides two registry editor utilities: REGEDT32 and
REGEDIT. Use the REGEDT32 application to display and modify server
parameters; the REGEDIT utility cannot be used to modify the OpenVMS
Registry. For more information about using REGEDT32, refer to the
Window NT product documentation.

When you access the OpenVMS Registry from a network client, the
connection is based on network user authentication. Therefore, you must
be logged on to the network to access the registry from a network
client. If you are using Windows NT REGEDT32 to modify server
parameters, you must be logged on as a privileged user.

To access the server parameters in the OpenVMS Registry:

Start the REGEDT32 application using the Run... menu item in the
Start menu.

Select the Select Computer... menu item from the Registry menu.

Enter the name of the OpenVMS server in Computer: text box. Click
on OK.

Select the panel HKEY_LOCAL_MACHINE on the OpenVMS server.

Expand the key you want to open by double-clicking on it.

Display the data associated with a value by double-clicking on the
value.

If you are managing the Advanced Server from the OpenVMS system (you are
using a workstation or terminal emulator), you can use either the
OpenVMS system registry control program (REG$CP) or the PWRK$REGUTL
utility supplied with the Advanced Server. You can modify registry
entries in the OpenVMS Cluster only; you cannot modify entries for
remote servers. For information about REG$CP, see the REG$CP online
help. The PWRK$REGUTL utility is described in Section 7.3.4, Using the PWRK$REGUTL Utility to Manage Advanced Server Parameters in the OpenVMS Registry.

Figure 7-6, Example Keys to Advanced Server Registry Values, shows the registry architecture as displayed by the
Windows NT registry editor. The architecture shown includes several
keys that are not accessible by the PWRK$REGUTL utility on OpenVMS.
Those keys and the values they include are referenced for use by other
applications. The PWRK$REGUTL utility accesses Advanced Server
configuration parameters that directly pertain to the operation of the
server and its services. HP recommends modifying only those parameters
accessible by PWRK$REGUTL.

The PWRK$REGUTL utility allows you to display, set, and delete server
configuration parameters in the OpenVMS Registry. The PWKR$REGUTL
utility is available to use after you install the Advanced Server
software. HP recommends that you use PWRK$REGUTL to manage
server configuration parameters in the OpenVMS Registry for the
following reasons:

It has built-in knowledge of keys and values used by the
Advanced Server, including the attributes of the data, such as minimum,
maximum, and default values. As such, it restricts you from setting
inappropriate values for server parameters.

It prevents you from managing parameters in the OpenVMS Registry
that should not be modified.

If your process has defined the Advanced Server command definitions
provided in the PWRK$DEFINE_COMMANDS.COM file, or if you have defined
the REGUTL command, you can start the PWRK$REGUTL utility by entering
the REGUTL command. To define the REGUTL command and start the utility,
enter the following commands at the OpenVMS command prompt:

$ REGUTL :== $SYS$SYSTEM:PWRK$REGUTL.EXE
$ REGUTL
REGUTL>

As shown, the PWRK$REGUTL utility responds by displaying the REGUTL>
prompt.

To use PWRK$REGUTL to access the OpenVMS Registry, your process must
have one of the following:

OpenVMS SYSPRV system privileges

REG$UPDATE right identifier associated with the user account

The PWRK$REGUTL utility has a command-line user interface that is
compatible with OpenVMS DCL command conventions.

When you use the PWRK$REGUTL utility, the OpenVMS Registry server must
be running on the OpenVMS system. However, the Advanced Server need not
be running. This allows you to modify server configuration parameters
before the Advanced Server is started.

The PWRK$REGUTL program includes complete online help, displaying the
PWRK$REGUTL commands, qualifiers, and parameters. The following
sections describe some common operations performed with PWRK$REGUTL. To
get online help, enter the HELP command at the REGUTL> prompt:

REGUTL> HELP
The PWRK$REGUTL utility is provided with Advanced Server for OpenVMS
for setting and modifying server configuration parameters. Refer to
the Advanced Server for OpenVMS Server Administrator's Guide for more
information about using this utility.
You can get more help by entering any of the following commands:
CREATE REQUIRED KEYS CREATE REQUIRED VALUES
DELETE KEY DELETE KNOWN KEYS
DELETE KNOWN VALUES DELETE PARAMETER
DELETE VALUE EXIT
HELP SET PARAMETER
SET VALUE SHOW PARAMETER
SHOW VALUE
Topic?

This example shows the top-level help, listing the possible commands.
The help file displays further information about specific commands when
you enter the command name after the
Topic?
prompt.

You can display, set, or delete server configuration parameters in the
OpenVMS Registry by using either of two syntax styles for PWRK$REGUTL
commands: registry style or LANMAN.INI style. The registry-style
commands are SHOW VALUE, SET VALUE, and DELETE VALUE. The corresponding
LANMAN.INI style commands are SHOW PARAMETER, SET PARAMETER, and DELETE
PARAMETER. Whatever style you use, specify the following in the command
line:

The parameter path. In registry-style syntax, the parameter path is
the registry key under the root key. In LANMAN.INI-style syntax, it is
the section name.

The parameter name. In registry-style syntax, the parameter name is
the registry value name. In LANMAN.INI-style syntax, it is the
LANMAN.INI keyword.

For example, to modify the SrvComment (server
description) parameter in registry style, use the SET VALUE command,
specifying the registry key,
SYSTEM\CURRENTCONTROLSET\SERVICES\LANMANSERVER\PARAMETERS and value
name (SrvComment). The command sets the server
description as "I.L.M. Server".

This example includes the command-line continuation character (-) to
allow the command to be continued past the end of the first line. You
can use the wildcard character (*) instead of the key name, simplifying
the command input, as in the following example:

REGUTL> SET VALUE * SRVCOMMENT "I.L.M. Server"

To modify the SrvComment server parameter in
LANMAN.INI style, use the SET PARAMETER command, specifying the
LANMAN.INI section and keyword names.

REGUTL> SET PARAMETER SERVER SRVCOMMENT "I.L.M. Server"

To simplify command input, you can specify the asterisk (*) wildcard
character for the LANMAN.INI section name.

The LANMAN.INI syntax style conforms to the structure and naming of
server parameters as used in PATHWORKS V6 for OpenVMS (Advanced Server). You can use the LANMAN.INI
style if you are more familiar with the LANMAN.INI structure and
terminology. Remember that when you use the LANMAN.INI syntax style,
the server parameters are actually retrieved and modified in the
OpenVMS Registry: the Advanced Server for OpenVMS does not use the LANMAN.INI file
(the PATHWORKS V6 for OpenVMS (Advanced Server) does).

You can display server parameters and settings that are established by
the server configuration procedure, those that have been migrated from
the LANMAN.INI file if the server was upgraded from PATHWORKS V6 for OpenVMS (Advanced Server), and
any parameters that have been set using a registry management tool. You
can display the default values for server parameters that are not
currently stored in the registry by using the /KNOWN qualifier with the
SHOW command, as described in Section 7.3.4.5.1, Displaying Server Parameters, Including Defaults of Those Not Currently Stored in the Registry.

To display information about server parameters currently stored in the
OpenVMS Registry, use the SHOW VALUE or SHOW PARAMETER command. For
example, to display information about the Scripts
parameter in registry style, enter the following command. The registry
key and value names are displayed along with other information.

You can specify the wildcard character (*) for the parameter path and
name, or to replace a portion of the command option. (The percent (%)
wildcard character is not valid.) For example, to display the location
where logon scripts are stored, enter the following registry-style
command:

To show all server parameters, use the SHOW VALUES command with a
wildcard. Using the SHOW PARAMETERS command with a wildcard (such as,
SHOW PARAMETERS * *) displays only those server parameters equivalent
in name to the parameters originally defined in the PATHWORKS V6
(Advanced Server) software (the LANMAN.INI file). In other words, the
SHOW PARAMETERS command does not display all the server-related
registry data that can be set. It omits the several server parameters
that have been added to the Advanced Server for OpenVMS software and are foreign to
PATHWORKS V6.

To display information about the Scripts parameter in
LANMAN.INI style, enter the following command:

Displays only those parameters whose settings have been changed from
their default values.

/FULL

Displays complete information about parameters, including data type and
the minimum and maximum values.

/KNOWN

Displays values or data for Advanced Server parameters currently stored
in the registry and the server defaults for those not currently stored
in the registry. Using the SHOW command without the /KNOWN qualifier
displays only those server parameters currently stored in the registry.

/MAP_NAME

Displays the registry key and value names, along with the corresponding
LANMAN.INI section and keyword names.

To display all Advanced Server parameters, including the default values
of those not currently stored in the registry, use wildcards and the
/KNOWN qualifier with the SHOW PARAMETER or SHOW VALUE command, such as
in the following example (registry style):

REGUTL> SHOW VALUE * * /KNOWN

When you use the SHOW command without the /KNOWN qualifier, the display
includes only those server parameters currently stored in the registry
(in other words, those that have been set or created with a registry
management tool). Refer to the restriction noted in Section 7.3.4.5, Displaying Server Parameter Settings,
about displaying parameters with a wildcarded SHOW PARAMETERS command.

Note that the Advanced Server startup procedure records a list of all
Advanced Server parameters that are set in the OpenVMS Registry. You can
use this list as a reference if you should ever need the latest
parameter values. For more information, see Section 7.3.2,Advanced Server Parameters Stored in the Registry.

You can use the /KNOWN qualifier to display server parameters
associated with a specific key, such as in the following example. In
this example, the SHOW command displays all parameters associated with
the key SYSTEM\CURRENTCONTROLSET\SERVICES\NETLOGON\PARAMETERS, both
those currently stored in the registry and the defaults for those not
being stored in the registry. The "Source:" field indicates
whether the value for the parameter is obtained from the registry or
the server software default.

To display complete information about server parameters in the OpenVMS
Registry, use the /FULL qualifier with the SHOW VALUE or SHOW PARAMETER
command. The display includes information such as the parameter default
setting, and minimum and maximum values allowed. For example, to
display detailed information about the MaxSize server
parameter, enter the following command (registry style):