Advanced Server for OpenVMS

Advanced Server for OpenVMS

Commands Reference Manual

Order Number: AA--R6G5B--TE


January 1999

This manual provides command syntax descriptions for all ADMINISTER commands available with the Advanced Server for OpenVMS.

Revision/Update Information: This manual supersedes the DIGITAL PATHWORKS for OpenVMS (Advanced Server) Commands Reference Manual, AA-R6G5A-TE.

Operating System Version: OpenVMS Alpha Version 7.2
OpenVMS VAX Version 7.2
OpenVMS Alpha Version 7.1
OpenVMS VAX Version 7.1

Software Versions: Advanced Server V7.2 for OpenVMS
PATHWORKS V6 for OpenVMS (Advanced Server)


Compaq Computer Corporation
Houston, Texas


First Published, August 1997
Revised, January 1999

Compaq Computer Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.

Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor.

Compaq conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community.

© Compaq Computer Corporation 1997, 1999. All rights reserved.

The following are trademarks of Compaq Computer Corporation:

Alpha, Compaq, DECdirect, DECnet-Plus, DECprint, DIGITAL, OpenVMS, PATHWORKS, VAX, VAX DOCUMENT, VAXcluster, VMS, and the Compaq logo.

The following are third-party trademarks:

AT&T is a registered trademark of American Telephone and Telegraph Company.
Apple, AppleShare, LaserWriter, Macintosh, and TRUETYPE are registered trademarks of Apple Computer, Inc.
DEC Rdb is a trademark of Oracle Corporation.
Hewlett-Packard, HP, LaserJet, and PCL are registered trademarks of Hewlett-Packard Company.
IBM and OS/2 are registered trademarks of International Business Machines Corporation.
Microsoft, MS-DOS, and Windows are registered trademarks, and Windows 95, Windows 98, and Windows NT are trademarks of Microsoft Corporation.
MultiNet and TCPWARE are registered trademarks of Process Software Corporation.
Novell and NetWare are registered trademarks of Novell, Inc.
PostScript is a registered trademark of Adobe Systems Incorporated.

All other trademarks and registered trademarks are the property of their respective holders.

ZK6544

The Advanced Server for OpenVMS documentation set is available on CD-ROM.

This document was prepared using VAX DOCUMENT, Version V3.2-1n.

Contents Index


Preface

Welcome to the Advanced Server for OpenVMS Commands Reference Manual. For the purposes of this text, the Advanced Server for OpenVMS is referred to as the Advanced Server. The information presented in this guide is equally applicable to:

Usage of the term "Advanced Server" in this guide refers to either version of the file and print server, except when the text explicitly specifies a version number.

The Advanced Server and its associated OpenVMS system platform provide a powerful, reliable, and open operating environment that meets the demands of client-server computing. This Commands Reference Manual provides reference material to help you manage and maintain your network using the Advanced Server ADMINISTER command line interface.

Intended Audience

This manual is for the Advanced Server for OpenVMS server administrator. As the administrator, you must be familiar with the OpenVMS operating system to support the server and with other operating systems to support clients. It is also expected that you have experience doing network administration, and that you are familiar with OpenVMS DCL command language syntax and the specific network configuration being managed. You are assumed to have read the other documents in the Advanced Server for OpenVMS set and to have access to documentation for any clients running other operating systems.

Document Structure

This document contains the following chapters:
Chapter Description
Chapter 1, Overview Provides an overview of this guide.
Chapter 2, ADMINISTER Commands Describes the function and syntax of all ADMINISTER commands for managing the Advanced Server.
Chapter 3, Net Commands and ADMINISTER Command Equivalents Lists PATHWORKS V5 for OpenVMS (LAN Manager) Net commands and their ADMINISTER command equivalents.

Related Documents

The following table lists related Advanced Server for OpenVMS documents.
Document Description
Advanced Server for OpenVMS Server Installation and Configuration Guide Explains how to install and configure Advanced Server software.
Advanced Server for OpenVMS Concepts and Planning Guide Provides an overview of and introduction to the Advanced Server software and associated networking concepts for system administrators and operators.
Advanced Server for OpenVMS Server Administrator's Guide Explains how to manage and customize the Advanced Server software.
Advanced Server for OpenVMS Guide to Managing Advanced Server Licenses Describes the license server software and how to manage Advanced Server licenses.

The following table lists related PATHWORKS for OpenVMS (Advanced Server) documents.
Document Description
PATHWORKS for OpenVMS (Advanced Server) Server Migration Guide Explains how to upgrade a PATHWORKS for OpenVMS (LAN Manager) server to PATHWORKS V6 for OpenVMS (Advanced Server).
PATHWORKS for OpenVMS (Advanced Server) Server Installation and Configuration Guide Explains how to install and configure Advanced Server for OpenVMS software.
Advanced Server for OpenVMS Concepts and Planning Guide Provides an overview of and introduction to the PATHWORKS for OpenVMS (Advanced Server) software and associated networking concepts for system administrators and operators.
PATHWORKS for OpenVMS (Advanced Server) Server Administrator's Guide Explains how to manage and customize the PATHWORKS for OpenVMS (Advanced Server) software.
Advanced Server for OpenVMS Guide to Managing Advanced Server Licenses Describes the license server software and how to manage PATHWORKS for OpenVMS (Advanced Server) licenses.

The following table lists related OpenVMS documents.
OpenVMS Document Description
OpenVMS Alpha V7.1 Upgrade and Installation Manual Describes how to install the OpenVMS Alpha V7.1 system software.
OpenVMS Alpha V7.2 Upgrade and Installation Manual Describes how to install the OpenVMS Alpha V7.2 system software.
OpenVMS VAX V7.1 Upgrade and Installation Manual Describes how to install the OpenVMS VAX V7.1 system software.
OpenVMS VAX V7.2 Upgrade and Installation Manual Describes how to install the OpenVMS VAX V7.2 system software.
OpenVMS System Manager's Manual A task-oriented guide to managing an OpenVMS system, including procedures for setting up the OpenVMS Registry.
OpenVMS System Management Utilities Reference Manual A reference guide to the utilities and tools used in managing an OpenVMS system.
OpenVMS License Management Utility Manual Explains how to load and manage license Product Authorization Keys (PAKs)
OpenVMS Guide to Extended File Specifications Describes Extended File Specifications on OpenVMS, including how to set up and enable the ODS-5 file system.
OpenVMS DCL Dictionary: A--L, OpenVMS DCL Dictionary: M--Z Provide detailed reference information and examples for OpenVMS DCL commands and lexical functions.

Reader's Comments

Compaq welcomes your comments on this manual.

Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by:
Internet openvmsdoc@zko.mts.dec.com
Fax 603-884-0120, Attention: OSSG Documentation, ZKO3-4/U08
Mail Compaq Computer Corporation
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698

How To Order Additional Documentation

Use the following World Wide Web address to order additional documentation:


http://www.openvms.digital.com:81/ 

If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825).

Conventions

The following conventions are used in the Advanced Server documentation set:
Convention Meaning
Advanced Server Advanced Server refers to PATHWORKS Advanced Server as well as Advanced Server for OpenVMS file server.
[Ctrl/] x While you hold down the Ctrl key, press another key or a pointing device button.
italic text Indicates a place holder for information or parameters that you must provide. For example, if the procedure asks you to type file-name, you must type the actual name of a file.

Italics also indicate path names, new terms, and the titles of other documents referenced.

monospace text Indicates the actual commands, words, or characters that you type in a dialog box or at a command prompt or system output.
Return or Enter Indicates where you should press the Return key to execute a command or terminate a sequence. This key is labeled Return or Enter, depending on your keyboard.
UPPERCASE TEXT Indicates names of OpenVMS and Advanced Server for OpenVMS commands and qualifiers. You can enter commands and qualifiers in any combination of uppercase and lowercase letters, unless otherwise noted.
/ A forward slash in command descriptions indicates that a command qualifier follows.
= An equal sign (=) in command descriptions indicates you must provide information.
[ ] In command format descriptions, indicates optional elements. Multiple elements are separated by vertical bars (|). You can enter as many as you want.
{ } In command format descriptions, indicates you must enter at least one listed element. The elements are separated by bars (|).
... A horizontal ellipsis following an entry in a command line indicates that the entry or a similar entry can be repeated any number of times. An ellipsis following a file name indicates that additional parameters, values, or information can be entered.
.
.
.
A vertical ellipsis in an example indicates that not all the data is shown.
Note: Provides information of special importance.


Chapter 1
Overview

The Advanced Server for OpenVMS software provides a flexible system for managing wide area networks (WANs) and local area networks (LANs). The Advanced Server enables you to use Compaq computers as servers to share network resources with supported clients and is fully compatible with Windows NT servers running in the same network.

The Advanced Server is an OpenVMS-based network operating system (NOS) fully compatible with Microsoft networking technology.

1.1 ADMINISTER Commands

You use the Advanced Server command line interface (ADMINISTER commands) to manage your network from an Advanced Server. Task-oriented procedures using these commands are described in your Server Administrator's Guide. The Advanced Server for OpenVMS Commands Reference Manual provides full descriptions of the ADMINISTER commands with examples; commands are presented in alphabetical order.

1.2 Net Commands

PATHWORKS V5 for OpenVMS (LAN Manager) uses the Net command line interface (Net commands) to perform some functions for managing your network. With Advanced Server, Net commands are obsolete. Their functions are now available using ADMINISTER commands. The ADMINISTER command line interface provides a subset of the Net commands for backward compatibility. This feature enables users to migrate to the new command syntax.

Chapter 3, Net Commands and ADMINISTER Command Equivalents, in this manual provides a list of the Net commands and the ADMINISTER commands that provide the same functions. Use the ADMINISTER commands in place of Net commands to manage your network.


Chapter 2
ADMINISTER Commands

You manage the Advanced Server from your OpenVMS system using the ADMINISTER command with its command line interface. Some commands require privileges (group membership), described in your Server Administrator's Guide.

You can also use programs available through Windows NT server administration tools to manage the Advanced Server. In the context of this manual, as administrator you are an OpenVMS system manager.

This chapter lists commands that are available in the Advanced Server and also summarizes syntax and usage conventions. You can also use the ADMINISTER Help file for information on these commands. To access ADMINISTER Help, enter ADMINISTER HELP at the DCL system prompt:


$ ADMINISTER HELP 

2.1 Invoking the ADMINISTER User Interface

You control many aspects of the Advanced Server with the ADMINISTER command line interface. You can invoke the ADMINISTER user interface in one of two ways:

Once you have invoked the command line interface, you can enter any number of commands. This way of using the command line interface provides for better system response than entering commands from the OpenVMS prompt.

You can enter commands with parameters and qualifiers on a single line as shown in this example:


$ ADMINISTER ADD COMPUTER DOROTHY/DOMAIN=LANDOFOZ/ROLE=BACKUP 

In some cases, you will be prompted for parameters you do not enter. For example, if you do not enter the user name with the LOGON command, you are prompted for it:


LANDOFOZ\\TINMAN> LOGON 
Username: 

Although the software may prompt for required parameters, do not rely on the software to prompt you for all required information. Be sure to enter all required information, except for passwords, on the command line. For information about entering passwords, see Section 2.1.5, Using Passwords with Commands.

2.1.1 Local and Remote Management

You can use the ADMINISTER command line interface to administer the local computer, as well as any other compatible servers on the network to which you have access. By default, you are set up to administer the local server and the domain to which it belongs. You may remotely administer a domain and server in one of three ways:

2.1.2 Privileges Required

Some of your network users may be designated as Account Operators, Print Operators, or Server Operators. These users have limited administrative or operator privileges that enable them to perform specific tasks. If you have different operators responsible for parts of your network and you do not want to assign them full administrative privileges, then make them members of groups only at the server being administered.

Required privileges are included in the command descriptions in this manual.

2.1.3 Understanding Command Syntax

In this manual, command syntax for ADMINISTER commands is denoted as follows:

In general, the ADMINISTER command syntax conforms to the OpenVMS DCL command conventions. Refer to the OpenVMS DCL Dictionary for more information.

2.1.4 Case Sensitivity

Due to the behavior of OpenVMS, all parameters and qualifier values entered on the command line are converted to uppercase characters when they are processed by the user interface. If you wish to preserve case, or you wish to enter any value which contains blanks (spaces) or any nonalphanumeric characters, you must enclose the value in quotation marks. This is not necessary, however, if you are prompted for additional information after entering a command.

Since passwords are case sensitive in most cases, pay careful attention when entering them on a command line. If they are to contain any lowercase letters, be sure to enclose them in quotation marks.

For further information, see your Server Administrator's Guide.

2.1.5 Using Passwords with Commands

Some commands require you to enter a password. You can provide a password with a command by typing the password on the same line as the command. For example, to log on as the user named JIM using the password KAHUNA, you type:


$ ADMINISTER 
LANDOFOZ\\TINMAN> LOGON JIM KAHUNA 
The server \\TINMAN successfully logged you on as JIM. 
Your privilege level on domain LANDOFOZ is ADMIN. 
The last time you logged on was 04/08/98 07:48 PM 
 
LANDOFOZ\\TINMAN> 

Since passwords are case sensitive in most cases, pay careful attention when entering them on a command line. If they are to contain any lowercase letters, blanks (spaces), or nonalphanumeric characters, be sure to enclose them in quotation marks.

You can also have the user interface prompt you for the password. For example, to log on to the network, type:


$ ADMINISTER 
LANDOFOZ\\TINMAN> LOGON JIM 
Password: 
The server \\TINMAN successfully logged you on as JIM. 
Your privilege level on domain LANDOFOZ is ADMIN. 
The last time you logged on was 04/08/98 07:48 PM 
 
LANDOFOZ\\TINMAN> 

When you enter a password when prompted, as in the second example, the password does not appear on the screen as you type. This helps you keep your password confidential, providing added security. In addition, you need not use quotation marks if the password contains lowercase letters, blanks (spaces), or nonalphanumeric characters (as you do when entering the password on the command line).

If you forget to enter a password for a command that requires one, the software prompts you for it. Depending on the command that you type, the software may also prompt you for other required information, such as your user name.

Although the software may prompt for required parameters, do not rely on the software to prompt you for all required information. Be sure to enter all required information, except for passwords, on the command line.


Next Contents Index