HP DCE for OpenVMS Alpha and OpenVMS I64

HP DCE for OpenVMS Alpha and OpenVMS I64

Reference Guide

Order Number: BA361-90003


January 2005

This guide provides reference information for HP Distributed Computing Environment (DCE) for OpenVMS Alpha and OpenVMS I64.

Revision/Update Information: This guide supersedes the Compaq DCE for OpenVMS VAX and OpenVMS Alpha Reference Guide Version 3.0.

Operating System: OpenVMS Alpha Version 7.3-2 or higher
OpenVMS I64 Version 8.2

Software Version: HP DCE for OpenVMS Version 3.2



Hewlett-Packard Company
Palo Alto, California


© Copyright 2005 Hewlett-Packard Development Company, L.P.

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

All Java and Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc., in the U.S. and other countries.

Oracle is a US registered trademark of Oracle Corporation, Redwood City, California.

OSF and Motif are trademarks of The Open Group in the US and other countries.

UNIX is a registered trademark of The Open Group.

Microsoft, Windows, Windows NT, and MS Windows are US registered trademarks of Microsoft Corporation.

X/Open is a registered trademark, and the X device is a trademark of X/Open Company Ltd. in

Printed in the US

ZK6533

The HP OpenVMS documentation set is available on CD-ROM.

This document was prepared using DECdocument, Version V3.3-1e.

Contents Index


Preface

The HP DCE for OpenVMS Alpha and OpenVMS I64 Reference Guide provides users of the HP Distributed Computing Environment (DCE) Kit with reference information necessary to use HP DCE Version 3.2 on OpenVMS Alpha and OpenVMS Industry Standard 64 (I64) systems. This guide should be used with the documents listed under Associated Documents.

Intended Audience

This guide is written for:

Document Structure

This guide contains the following parts and chapters:

Related Documents

For additional information about HP OpenVMS products and services, visit the following World Wide Web address:


http://www.hp.com/go/openvms/ 

Reader's Comments

HP welcomes your comments on this manual. Please send comments to either of the following addresses:
Internet openvmsdoc@hp.com
Postal Mail Hewlett-Packard Company
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698

How To Order Additional Documentation

For information about how to order additional documentation, visit the following World Wide Web address:


http://www.hp.com/go/openvms/doc/order/ 

Conventions

VMScluster systems are now referred to as OpenVMS Cluster systems. Unless otherwise specified, references in this document to OpenVMS Clusters or clusters are synonymous with VMSclusters.

The following conventions are used in this guide:
Ctrl/ x A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.
italic text Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where device-name contains up to five alphanumeric characters).
UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.
Monospace type Monospace type indicates code examples and interactive screen displays.

In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example.

Case-sensitivity OpenVMS operating system commands do not differentiate between uppercase and lowercase. However, many DCE commands do make this distinction. In particular, the system configuration utility interprets names in a case-sensitive manner.


Part 1
Integrated Login Reference


Chapter 1
Integrated Login DCE$UAF Commands

This chapter contains reference information on the Integrated Login UAF commands discussed in the HP DCE for OpenVMS Alpha and OpenVMS I64 Product Guide.

1.1 Running the DCE$UAF Utility

Integrated Login provides two methods of running the DCE$UAF utility:

1.2 Initialization File

The Integrated Login DCE$UAF utility has the capability to execute an initialization file. By default, the file is called DCE$UAF_INIT.COM.

The DCE$UAF initialization file is a command procedure that the DCE$UAF utility automatically executes at startup. Every time you start the DCE$UAF utility, the commands contained in the file are automatically executed.

An initialization file contains any command lines you might always enter when you start the DCE$UAF utility. For example, you might include DEFINE/KEY commands in the initialization file.

If you use a file other than DCE$UAF_INIT.COM as your DCE$UAF utility initialization file (for example, START.COM), define it with the following command:


$ DEFINE DCE$UAF_INIT WORK:[SMITH]START.COM

If you include your startup commands in DCE$UAF_INIT.COM, there is no need to separately define it.


@

Executes a DCE$UAF utility command procedure.

Synopsis

@ FILE-SPEC /OUTPUT=file-spec


Parameters

FILE-SPEC

Specifies the command procedure to be executed. A command procedure is a file containing a sequence of DCE$UAF commands. When the command procedure is executed, the commands in the file are processed in order as if each command had been entered individually from the terminal or workstation.

If you do not specify a file type, the system uses the default file type of .COM.

No wildcard characters are allowed in the file specification.


Qualifiers

/OUTPUT=file-spec

Requests that all output directed to the logical device SYS$OUTPUT be written to the file or device specified. System responses and error messages are written to SYS$COMMAND as well as to the specified file.

The default output file type is .LIS.

No wildcard characters are allowed in the output file specification.


Description

The @ command directs the DCE$UAF utility to read commands from the specified command file.

ADD

Adds new records to the DCE authorization file (DCE$UAF).

Synopsis

ADD [USERNAME] [DCE-NAME] / [NO]ALL /FLAGS=flags /[NO]LOG


Parameters

USERNAME

OpenVMS username for the DCE authorization record to be added. This argument is not required if /ALL is specified. In all other cases it is required.

DCE-NAME

DCE principal name to be associated with the OpenVMS account USERNAME. If the principal exists in a different DCE cell from the current DCE cell, specify the DCE name in the format principal@cell. If the DCE name contains lowercase characters, spaces, or other special characters, enclose the entire string in quotes.

This argument is not required if /ALL is specified. This argument is optional if /ALL is not specified. If it is not specified, then USERNAME, converted to lowercase, is the default.


Qualifiers

/ALL

/NOALL (default)

If present, specifies that a DCE authorization record be created for all accounts in the system authorization file (SYSUAF) that do not currently have an authorization record. In this case the USERNAME and DCE-NAME arguments should not be specified as the DCE name is derived from the OpenVMS username. (Refer to the description of DCE-NAME for more information.) If not present, the record to be added is specified by the USERNAME argument.

/FLAGS=([NO]keyword[,...])

Specifies special attributes that are to be stored with the DCE$UAF record. The keyword you can specify is as follows:

/LOG (default)

/NOLOG

Controls whether or not a message is displayed after a record has been added.

Description

The ADD command adds new records to the DCE authorization file (DCE$UAF).

Example


DCE$UAF> ADD SMITH
%DCE-S-UAF_ADDED, created entry SMITH, principal is "smith"
DCE$UAF> ADD SMITH "John Smith"
%DCE-S-UAF_ADDED, created entry SMITH, principal is "John Smith"
DCE$UAF> ADD SMITH "smith@othercell"
%DCE-S-UAF_ADDED, created entry SMITH, principal is "smith@othercell"
      


ANALYZE

Checks the continuity between the OpenVMS system authorization file (SYSUAF) and the DCE Authorization file (DCE$UAF).

Synopsis

ANALYZE /[NO]DCE$UAF /OUTPUT=output /[NO]SYSUAF /[NO]VERBOSE


Qualifiers

/DCE$UAF (default)

/NODCE$UAF

Specifies that the DCE authorization file (DCE$UAF) be read record by record and any record found that does not have a matching account in the OpenVMS authorization file (SYSUAF) be reported.

Any discrepancies found can be corrected using the /PURGE command.

/OUTPUT=(output)

Determines where the output is written. The default is SYS$OUTPUT:.

/SYSUAF (default)

/NOSYSUAF

Specifies that the OpenVMS system authorization file (SYSUAF) be read account by account and any account found that does not have a matching record in the DCE Authorization file (DCE$UAF) be reported.

Any discrepancies found can be corrected using the ADD command.

/VERBOSE

/NOVERBOSE (default)

Specifies that all accounts/records be displayed. By default only those without matching records/accounts are displayed.

Description

The ANALYZE command checks the continuity between the OpenVMS authorization file (SYSUAF) and the DCE Authorization file (DCE$UAF).

Example


DCEUAF> ANALYZE
%DCE-I-UAF_SYSCHKBEG, starting scan of SYSUAF file
SYSUAF entry ALAN does not exist in DCE$UAF
SYSUAF entry BILL does not exist in DCE$UAF
SYSUAF entry DCE$SERVER does not exist in DCE$UAF
SYSUAF entry DEFAULT does not exist in DCE$UAF
SYSUAF entry FAL$SERVER does not exist in DCE$UAF
SYSUAF entry JAMES does not exist in DCE$UAF
SYSUAF entry MAIL$SERVER does not exist in DCE$UAF
SYSUAF entry NML$SERVER does not exist in DCE$UAF
SYSUAF entry OPERATOR does not exist in DCE$UAF
SYSUAF entry PHONE$SERVER does not exist in DCE$UAF
SYSUAF entry SYSTEM does not exist in DCE$UAF
SYSUAF entry WALLY does not exist in DCE$UAF
12 out of 97 records do not have a DCE$UAF entry
%DCE-I-UAF_SYSCHKEND, completed scan of SYSUAF file
%DCE-I-UAF_DCECHKBEG, starting scan of DCE$UAF file
0 out of 24 records do not have a SYSUAF entry
%DCE-I-UAF_DCECHKEND, completed scan of DCE$UAF file
DCEUAF>
      


ATTACH

Switches control of your terminal from your current process to another process.

Synopsis

ATTACH [PROCESS-NAME] /IDENTIFICATION=pid


Parameters

PROCESS-NAME

Specifies the name of a parent process or spawned subprocess to which control passes. The process must already exist, be part of your current job, and share the same input stream as your current process. However, the process cannot be your current process or a subprocess created with the /NOWAIT qualifier.

Process names can contain from 1 to 15 alphanumeric characters. If a connection to the specified process cannot be made, an error message is displayed.

The PROCESS-NAME argument is incompatible with the /IDENTIFICATION qualifier.


Qualifiers

/IDENTIFICATION=pid

Specifies the process identification (PID) of the process to which terminal control will be transferred. Leading zeros can be omitted. The /IDENTIFICATION qualifier is incompatible with the PROCESS-NAME argument.

If you omit the /IDENTIFICATION qualifier, you must specify a process name.


Description

The ATTACH command switches control of your terminal from your current process to another process. This command allows you to move between processes that you create with the SPAWN command. For example, while you are editing a file, use the SPAWN command to move to a subprocess such as the DCE$UAF utility. Then enter ATTACH to move back to the editing session. If you want to return to the DCE$UAF utility, enter the ATTACH command to move back to the DCE$UAF subprocess you already created.

Examples

#1

DCE$UAF> ATTACH JONES_2
      

Transfers the terminal's control to the subprocess JONES_2.

#2

DCE$UAF> ATTACH/IDENTIFICATION=30019
      

The ATTACH command switches control from the current process to a process having the PID 30019. Notice that because the /IDENTIFICATION qualifier is specified, the PROCESS-NAME argument is omitted.


DEFINE/KEY

Associates an equivalence string and a set of attributes with a key on the terminal keyboard.

Synopsis

DEFINE/KEY KEY-NAME EQUIVALENCE-STRING /[NO]ECHO /[NO]ERASE /[NO]IF-STATE /[NO]LOCK-STATE /[NO]LOG /[NO]SET-STATE /[NO]TERMINATE


Parameters

KEY-NAME

Specifies the name of the key that you are defining. All definable keys on VT52 terminals are located on the numeric keypad. On VT100-series terminals, you can define the left and right arrow keys as well as all the keys on the numeric keypad. On terminals with LK201 keyboards, the following types of keys can be defined:

Some definable keys are enabled for definition all the time. Others, including KP0 to KP9, Period, Comma, and Minus, must be enabled for definition purposes. Before using these keys, enter either the SET TERMINAL/APPLICATION command or the SET TERMINAL/NONUMERIC command.

On LK201 keyboards, you cannot define the up and down arrow keys or function keys F1 to F5. The left and right arrow keys and the F6 to F14 keys are reserved for command line editing. You must enter the SET TERMINAL/NOLINE_EDITING command before defining these keys. You can also press Ctrl/V to enable keys F7 to F14. Note that Ctrl/V will not enable the F6 key.

EQUIVALENCE-STRING

Specifies the character string to be processed when you press the key. Enclose the string in quotation marks (" ") to preserve spaces and lowercase characters.

Qualifiers

/ECHO (default)

/NOECHO

Displays the equivalence string on your screen after the key has been pressed. You cannot use the /NOECHO qualifier with the /NOTERMINATE qualifier.

/ERASE

/NOERASE (default)

Determines whether the current line is erased before the key translation is inserted.

/IF_STATE=(state-name,...)

/NOIF_STATE

Specifies a list of one or more states, one of which must be in effect for the key definition to work. The /NOIF_STATE qualifier has the same meaning as /IF_STATE=current_state. The state name is an alphanumeric string. States are established with the /SET_STATE qualifier or the SET KEY command. If you specify only one state name, you can omit the parentheses. By including several state names, you can define a key to have the same function in all the specified states.

/LOCK_STATE

/NOLOCK_STATE (default)

Specifies that the state set by the /SET_STATE qualifier remain in effect until explicitly changed. (By default, the /SET_STATE qualifier is in effect only for the next definable key you press or the next read-terminating character that you type.) Can only be specified with the /SET_STATE qualifier.

/LOG (default)

/NOLOG

Displays a message indicating that the key definition has been successfully created.

/SET_STATE=state-name

/NOSET_STATE (default)

Causes the specified state name to be set when the key is pressed. (By default, the current locked state is reset when the key is pressed.) If you have not included this qualifier with a key definition, you can use the SET KEY command to change the current state. The state name can be any alphanumeric string; specify the state as a character string enclosed in quotation marks.

/TERMINATE

/NOTERMINATE (default)

Specifies whether the current equivalence string is to be processed immediately when the key is pressed (equivalent to entering the string and pressing the Return key). By default, you can press other keys before the definition is processed. This allows you to create key definitions that insert text into command lines, after prompts, or into other text that you are entering.

Description

The DEFINE/KEY command associates an equivalence string and a set of attributes with a key on the terminal keyboard. The /KEY qualifier is required.


Next Contents Index