DECnet forOpenVMSNetwork

8/12/2019 DECnet forOpenVMSNetwork

1/252

DECnet for OpenVMS NetworkManagement Utilities

Order Number: AAPV61ATK

May 1993

This document contains information about commands for the Network

Contr ol Pr ogram (NCP ) a nd for t he D TS/DTR ut ility. This document is

for users responsible for DECnet for OpenVMS network management.

Revision/Update Information: This is a new manua l.

Software Version: OpenVMS AXP Vers ion 1.5OpenVMS VAX Version 6.0

Digital Equipment CorporationMaynard, Massachusetts


2/252

May 1993

The information in this document is subject to change without notice and should not be construedas a commitment by Digita l Equipment Corporat ion. Digital Eq uipment Corporat ion a ssumes noresponsibil i ty for any errors that may appear in this document.

The software described in this document is furnished under a l icense and may be used or copied

only in accordance with the terms of such l icense.

No responsibil i ty is assumed for the use or rel iabil i ty of software on equipment that is not suppliedby Digital Equipment Corporation or i ts affil iated companies.

Digital Equipment Corporation 1993.

All Rights Reserved.

The postpaid Readers Comments forms at the end of this document request your cri t ical evaluationto assist in preparing future documentation.

The following are tra demarks of Digital Equipment C orporation: AXP, B ookreader, C I , D DCMP,DEC , DE Cnet, D ECnet RSX, DE LUA, DEQNA, DEU NA, Digita l , DEC dns, OpenVMS, VAX, VAXP.S.I . , VMS, VMScluster , VMS RMS, and the Digital logo.

The fol lowing is a third-party trademark:

Telenet is a r egistered tra demar k of GTE Telenet Communicat ion Corpora tion.

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

This d ocument wa s prepared using VAX DOCU MENT, Version 2.1.


3/252

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Part I The Network Control Program Utility

1 Description

1.1 Co m m a n d S y n t a x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111.2 E n t e rin g Co m m a n d s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

1.3 Co m m a n d P rom p t in g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141.3.1 E x it in g t h e P ro m pt in g S e qu en ce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151.3.2 P ro m pt in g E x a m p les . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161.4 Co m pon e n t a n d P a ra m e t er S yn t a x Ru les . . . . . . . . . . . . . . . . . . . . . . . . . . 171.5 N CP HE L P F a cili t y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

2 Using NCP

2.1 Hin t s f or U sin g Com m a n d s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3 NCP Commands

CL E A R/P UR G E CI RC UI T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

CL E A R/P UR G E E X E CU TOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

CL E A R E X E C UTOR N OD E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

CL E A R/P URG E L I N E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312

CL E A R/P UR G E L OG G I N G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

CL E A R/P UR G E L OG G I N G E V E N TS . . . . . . . . . . . . . . . . . . . . . . . . . 317

CL E A R/P UR G E L OG G I N G N AM E . . . . . . . . . . . . . . . . . . . . . . . . . . . 319

CL E A R/P U RG E M OD UL E CON F I G URATOR . . . . . . . . . . . . . . . . . . . 320

CLE AR/P U RG E MOD U LE X25-ACC ES S (Remote ma na gement

on ly) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

CLE AR/P U RG E MODU LE X25-P ROTOCOL (Remote man agement

on ly) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

CL EAR/P U RG E MODU LE X25-SE RVER/X29-SE RVER (Remote

m a n a g e m en t o n ly) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

CL E A R/P URG E N OD E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

CL E A R/P URG E N OD E CI RCU I T . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

CL E A R/P UR G E OB J E CT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

CON N E CT N OD E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

CON N E CT V I A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

C O P Y K N O WN N O D E S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336

D I S CON N E CT L I N K . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

iii


4/252

HE L P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

L OAD N OD E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

L OAD VI A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347

L O OP C I R C U I T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

L OOP E X E CU TOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

L OOP L I N E (Re m ot e m a n a g e m e n t o n ly) . . . . . . . . . . . . . . . . . . . . . . . 352

L O OP N O D E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

S E T CI RCU I T AL L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

S E T/D E F I N E CI RC UI T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

S E T E X E CUTOR AL L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

S E T/D E F I N E E X E CU TOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

S E T E X E CUTOR N OD E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

S E T K N OWN P ROX I E S A L L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

S E T L I N E A L L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376

S E T/D E F I N E L I N E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377

S E T L O G G I N G AL L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

S E T/D E F I N E L OG G I N G E V E N TS . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

SE T/DE FINE LOG G ING STATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

S E T/D E F I N E M OD UL E CON F I G URATOR . . . . . . . . . . . . . . . . . . . . . 390

SE T/DE FINE MODU LE X25-ACC ES S (Remote mana gement only). . . 392

SE T/DE FINE MODU LE X25-P ROTOCOL (Remote ma na gement

on ly) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

SE T/DE FI NE MODU LE X25-SE RVER/X29-SE RVER (Remote

m a n a g e m en t o n ly) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3100

S E T N O D E AL L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3105

S E T/D E F I N E N OD E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3106

S E T/D E F I N E N OD E CI RC UI T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3111

S E T OB J E C T AL L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3112S E T/D E F I N E OB J E CT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3113

S H OW ARE A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3118

S H OW/L I S T CI RCUI T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3120

S H OW/L I S T E XE CU TOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3125

S H OW/L I S T L I N E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3128

S H O W L I N K S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3131

S H OW/L I S T L OG G I N G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3133

SH OW/LIS T MODU LE CONFI G U RATOR . . . . . . . . . . . . . . . . . . . . . . 3136

SH OW/LIS T MODU LE X25-ACC ES S (Remote ma na gement only) . . . 3139

SH OW/LIS T MODU LE X25-P ROTOCOL (Remote ma na gement

on ly) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3141SH OW/LI ST MODU LE X25-S E RVER /X29-SE RVER (Remote

m a n a g e m en t o n ly) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3145

S H OW/L I S T NOD E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3147

S H OW/L I S T OB J E CT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3152

TE L L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3154

TRI G G E R N OD E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3156

TRI G G E R V I A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3158

Z E RO CI RCU I TS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3159

iv


5/252

ZE R O E X E C U TO R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3160

Z E RO L I N E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3161

ZERO MOD U LE X25-P ROTOCOL (Remote man agement only) . . . . . . 3162

ZERO MODULE X25-SERVER (Remote management

only)/X29-SE RVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3163

Z E RO N OD E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3164

Part II DECnet for OpenVMS DTS/DTR Utility

4 DECnet Test Sender/DECnet Test Receiver (DTS/DTR) Commands

4.1 D TS C om m a n d S yn t a x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414.2 D TS /D TR U sa g e S u m m a ry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424.3 D TS C om m a n d s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

CON N E CT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

D ATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

D I S CON N E CT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

HE L P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410

I N TE RRU P T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

A DECnet Circuit and Line Devices

B Network Counter Summary

B.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B1B.2 Circuit Co u n t ers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B4B.3 L in e Cou n t e rs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B7B.4 N od e Cou n t e rs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B11B.5 X.25 Pr otocol Module DTE Counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B13B.6 X .25 a n d X .29 S e rver M o d ule Cou n t e rs . . . . . . . . . . . . . . . . . . . . . . . . . . . B14

C States and Transitions

C.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C1C.2 Circuit a n d L in e S t a t e s a n d Tra n sit ion s . . . . . . . . . . . . . . . . . . . . . . . . . . C1C.3 L i nk S t a t e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C5C.4 D TE S t a t e s a n d Tra n sit ion s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C5C.5 X.25 Server Module Sta tes an d Tra nsit ions . . . . . . . . . . . . . . . . . . . . . . . . C8

D Event Class and Type Summary

D.1 N e t w ork M a n a g em e n t L a ye r E ven t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D2D.2 S e ssion Co n t rol L a ye r E ve n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D4D.3 E n d C om m u n ica t io n s L a ye r E ve n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D4D.4 Rou t in g L a ye r E ve n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D4D.5 D a t a L in k L a ye r E ve n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D9D.6 X .25 P a ck et L e ve l E ven t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D11D.7 S yst e m -S p e cifi c E ve n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D12D.8 D ig i t a l D ist ribu t e d N a m e S e rvice (D E C d n s) Cle rk E ve n t s . . . . . . . . . . . . D12

v


6/252

Index

Tables

11 C om m a n d S y n t a x E x a m p le . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

12 N C P S y n t a x S u m m a r y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

21 P rivileg es f or N CP Op era t ion s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

31 Object Type Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3116

A1 E t h e rn e t Circu it a n d L in e D evice s . . . . . . . . . . . . . . . . . . . . . . . . . . . . A1

A2 D D C M P a n d CI Circu it a n d L in e D e vices . . . . . . . . . . . . . . . . . . . . . . A1

A3 X .25 Circu it a n d L in e D e vice s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A2

A4 F D D I Circuit a n d L in e D e vice s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A2

C1 Circuit a n d L in e S t a t e s a n d S u b st a t e s . . . . . . . . . . . . . . . . . . . . . . . . . C1

C2 Circuit a n d L in e S t a t e Tra n sit ion s . . . . . . . . . . . . . . . . . . . . . . . . . . . . C2

C3 L i nk S t a t e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C5

C4 D TE S t a t e s a n d S u b st a t e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C6

C5 D TE S t a t e Tra n sit ion s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C6

C6 X .25 S e rver S t a t e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C8

C7 X .25 S e rver S t a t e Tra n sit ion s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C8

vi


7/252

Preface

Intended Audience

Th e D E C n et f or O p en V M S N et w o r k M a n a gem en t U t i l i t i es is a reference to the

forma ts a nd synt ax of NCP an d DTS/DTR comma nds. This ma nua l is for users

a lre a d y f a m il ia r w it h D E Cn e t f or Op en VM S con ce pt s. S yst e m m a n a g e rs ca n u se

NCP to configure, control, monitor, or test DECnet for OpenVMS software.

Document Structure

This document consists of four chapters and one appendix:

Ch a p t er 1 p rovid es a f u ll d escript ion o f t h e N CP u t i l it y, in clu t h e f ol low in g

topics:

C om m a nd s yn t a x

E n t er in g com m a n ds

C om m a n d pr om pt i ng

C om p on en t a n d pa r a m et e r s y n t a x r u le s

NC P H E L P

Ch a p t er 2 ou t l in es t h e f ol low in g N CP in form a t ion :

I n v ok in g t h e u t i li t y

E x it i ng t h e u t il it y

D i r ect i n g ou t pu t

Restrict ions or privileges for specifi c operat ions

Ch a p t er 3 d e scrib es N CP com m a n d s, in clu d in g form a t , p a ra m e t e qu a lifi e rs,

and examples.

Cha pter 4 provides a description of the DTS/DTR utility

Appendix A lists DEC net for OpenVMS circuit and line devices.

Appendix B includes descriptions of circuit , l ine an d node counters.

Ap pe n d ix C con t a in s d escript ion s of circu it , l in e , a n d l in k st a t e s, a n d t h e ir

substa tes a nd tra nsit ions.This section also describes X25-SE RVER module

a n d D TE st a t e s, sub st a t e s, a n d t h e ir t ra n si t ion s.

Ap pe n d ix D in clu d es a su m m a ry o f N CP e ve n t s in t e rm s of t h eir cla ss a n d

type.

vii


8/252

Associated Documents

Before using NCP, you should be familiar with the basic networking concepts

described in the D E C n et f or O p en V M S G u i d e t o N et w o r k i n g . D E C n e t f or

OpenVMS concepts and NCP usage information are presented in the DECnet

f o r O p e n V M S N e t w o r k i n g M a n u a l , wh ich also describes the procedures needed

t o con fi g u re, m a n a g e , t e st , a n d m on it or yo u r n e t w o rk . Re fe r t o t h a t m a n u a l f orm ore in f orm a t ion a b ou t a n y N C P com m a n d l ist e d in t h is m a n u a l .

The following functiona l s pecifi cations defi ne Digita l Netw ork Architecture (DNA)

P h a se I V p rot o cols t o w h ich a l l im p lem e n t a t io n s of D E Cn e t P h a se I V a d h e re :

DE Cnet Di gi tal N etwork Ar chit ectur e General D escri ption

Di gital D ata Comm un icati ons M essage Pr otocol Fu ncti onal Specification

N etw ork Ser vices Pr otocol Fun cti onal Specificati on

M ain tenan ce Oper ati on Pr otocol Fun ctional Specificati on

Da ta Access Pr otocol Fu ncti onal Specificati on

Routi ng L ayer Fun cti onal Specificati on

DN A Session Cont r ol Fu nctional Specification

DN A Phase I V N etw ork M anagement F unctional Specification

Et her net N ode Pr oduct Archi tectu r e Specification

Eth ern et Data Li nk F un cti onal Specification

Conventions

In this manual, every use of OpenVMS AXP means the OpenVMS AXP operating

system, every use of OpenVMS VAX means the OpenVMS VAX operating system,

and every use of OpenVMS means both the OpenVMS AXP operating system and

the OpenVMS VAX operating system.

The following conventions ar e used to identify informa tion specifi c to OpenVMS

AXP or to OpenVMS VAX:

AXPThe AXP icon denotes the beginning of information

specifi c to OpenVMS AXP.

VA XThe VAX icon denotes t he beginn ing of informa tion

specifi c to OpenVMS VAX.

The diamond symbol denotes the end of a section of

information specific to OpenVMS AXP or to OpenVMS

VAX.

The following conventions ar e a lso used in t his ma nua l:

C t r l /x A s equ ence s u ch a s Ct r l/x indica t es t ha t you mu s t hold dow nt he key la beled Ct rl w hile you p res s a not her key or a p oint ingdevice button.

viii


9/252

. . . A h or izon ta l ellipsis in exa m ples in dica t es on e of t he follow in gpossibilities:

Ad d i t ion a l op t ion a l a r g u m en t s in a s t a t e m en t h a v e b ee nomitted.

The preceding i t em or i t ems ca n be repea t ed one or moretimes.

Addit iona l pa ra met ers , va lu es , or ot her informa t ion ca n beentered.

.

.

.

A vertical ellipsis indicates the omission of items from a codeexa mp le or comma nd forma t ; t he i t ems a re omit t ed beca u s et hey a re not imp ort a nt t o t he t opic being dis cu s sed.

[ ] I n for ma t descript ion s, bra cket s indica te opt iona l elem en ts.You can choose one, none, or all of th e options. (B ra ckets a renot op t iona l , how ever, in t he s ynt a x of a direct ory na me ina n Op enV MS fi le s p ecifi ca t ion, or in t h e s ynt a x of a s u bs t r ings p ecifi ca t ion in a n a s s ignment s t a t ement . )

{ } I n for m a t descr ipt ions, br a ces su rr oun d a r eq uired ch oice ofoptions; you m ust choose one of t he options listed.

boldface text B oldface text is used to show user input in B ookreader versionsof t he ma nu a l.

i talic text I t a l ic t ext emp ha s iz es imp ort a nt informa t ion, indica t esva ria bles , a nd indica t es comp let e t i t les of ma nu a ls . I t a l ict ext a ls o rep res ent s informa t ion t ha t ca n va ry in s ys t emmessages (for example, Internal error number), command lines(for exam ple, /P RODU CE R=n a m e ) , a nd comma nd p a ra met ersin t ext .

U P P E R C AS E TE X T U p pe rca s e t e xt in d ica t e s a com m a n d , t h e n a m e of a r ou t in e,t he na me of a fi le, or t he a bbrevia t ion for a s ys t em p rivilege.

- A hy phen in code exa mples in dica tes t ha t a ddit iona l

a rgu ment s t o t he requ es t a re p rovided on t he l ine t ha t follow s .nu m bers All nu m bers in t ext a re a ssu m ed t o be decim al, un less

otherwise noted. Nondecima l radixesbinary, octal, orhexadecimalare explicitly indicated.

Notes

In this document, discussions that refer to VMScluster environments

apply to both VAXcluster sy stems tha t include only VAX nodes a nd

VMScluster systems that include at least one AXP node unless indicated

otherwise.

I n t h is d o cu m e n t , d iscu ssio n s t h a t re f e r t o D E Cd n s a p p ly t o t h e

Distr ibuted Na me S ervice (DNS) V1.1.

ix


10/252


11/252

Part IThe Network Control Program Utility


12/252


13/252

1Description

Th e N e t w o rk Co n t rol P rog ra m (N CP ) is t h e u t i l i t y p ro gra m u sed b y syst e m a n d

n e t w o rk m a n a g e rs t o con fi g u re a n d con t ro l D E Cn e t n od e s. S yst e m m a n a g e rs ca n

also use NCP to monitor network resources and test network components. This

m a n u a l p re se n t s t h e syn t a x o f t h e N CP com m a n d s u sed t o p e rform t h e se t a sk s.

Co n sult t h e D E C n et f or O p en V M S N et w o r k i n g M a n u a l for detailed descriptions

e xp la in in g t h e u se of t h e N CP com m a n d s. Af t e r yo u re a d t h e a p pro pria t e

sections of the D E C n et f or O p en V M S N et w o r k i n g M a n u a l a n d k n o w w h ich N CP

command (or series of commands) you need, use this manual for the syntax of the

commands.

The description of NCP covers the following topics:

C om ma n d s yn ta x

E n t er in g com m a n ds

C om m a n d pr om pt in g

C om p on en t a n d p a r a m e t er s y n t a x r u le s

N CP H E L P F a cilit y

Th e D E C n et f o r O p en V M S N et w o r k i n g M a n u a l a lso contains an overview of

networking concepts and descriptions of the components that make up the

network.

1.1 Command Syntax

To invoke NCP, type RU N S YS$SYSTEM:NCP at the D CL prompt. The N C P >

prompt indicates that you are using the NCP utility program. When you receive

this prompt, you can enter NCP commands.

11


14/252

Description1.1 Command Syntax

The NCP command syntax has four parts: a command verb, a component, one or

more para meters a nd, optiona lly, one or m ore qualifi ers. Table 11 is a n example

of t h is syn t a x .

Table 11 Command Syntax Example

Command Verb Component Parameter Qualifier

S H OW AC TI VE L I N E S C H AR AC TE R I S TI C S TO fi lespec

K NOWN L IN ES C OU NTE RS

L I N E line-id S TATU S

SUMMARY

For each command, you must supply a command verb and a component. Some

com m a n d s a lso re qu ire on e or m o re p a ra m e t e rs. Co m m a n d q u a lifi e rs a re

optional. Unless otherwise indicated, you can specify parameters in any order.

1.2 Entering Commands

E n t e r N CP com m a n d s a s verb s, com p on e n t s, p a ra m e t e rs, a n d qu a lifi e rs se pa ra t e d

by spaces or t abs. To continue a long comma nd to th e next line, use the sta nda rd

continua tion line convention (a hyphen a s th e last chara cter in the line). The

N C P > prompt is not display ed on continua tion lines; instead, continuat ion lines

prompt with an underscore character. For example:

NCP>SET EXECUTOR -_ ADDRESS 11 -_ INCOMING TIMER 30 -_ STATE ONNCP>

In command fi les, use an exclama tion point ( ! ) to designate a comment line. NCP

ig n ore s h yp h en s w it h in a n d a t t h e e n d o f a com m e n t l in e. Ho w e ver, N CP d oe s

not ignore lines beginning with an exclamation point if they follow a command

line ending with a hyphen.

W h e n e n t e rin g a n N CP co m m a n d , yo u ca n t ru n ca t e a n y co m m a n d ve rb ,

com p on e n t n a m e , p a ra m e t e r n a m e , or qu a lifi e r n a m e t o i t s f ew e st u n iqu e let t e rs .

For example, the following tw o comma nds perform the sa me function:

NCP>SET EXECUTOR ADDRESS 11 STATE ON

NCP>SET EXE AD 11 STA ON

For clarity, all examples show the full command syntax.

Recalling Commands

You can recall NCP comma nds t ha t y ou previously entered by pressing C trl/B or

the arrow keys in response to the N C P > prompt.

You can press C trl/B or the up-ar row key up to 20 t imes t o recall t he last 20

com m a n d s you h a ve t yp ed . Af t e r yo u re ca l l a n N C P com m a n d , yo u ca n e d it i t

and then reenter it . You can press the down-arrow key to recall the next (most

recent) command in th e NCP comma nd r ecall buffer.

12


15/252

Description1.2 Entering Commands

Using Wildcard Characters to Enter Commands

You can use the asterisk (* ) and the percent sign (%) as wildcard characters in

a n N CP com m a n d l in e t o rep rese n t N CP com p on e n t s b y a g e n era l n a m e , ra t h e r

tha n specify ea ch component na me individually.

You can use the w ildcar d cha ra cters to represent the following component n am es:

Node n am e

N od e a d dr es s

C ir cu it n a me

L in e n a me

O bject n a m e

E ven t s

The asterisk wildcard represents one or more characters, while the percent sign

represents a single character.

Rules for Using Wildcard Characters

The following rules define how you can use wildcard characters with component

n a m e s:

I f t h e com p on en t n a m e i s a s t r i ng , t h e w i l dca r d c h a r a c t er m a y o ccu r a t a n y

location in the string. For example:

NCP>LIST NODE ST%R STATUSNCP>SHOW OBJECT M* CHARACTERISTICS

Th e fi rst com m a n d re qu est s a l is t of s t a t u s in f orm a t ion f or a l l n o d es w it h

four-letter node names beginning with ST and ending with R. The second

command requests a list ing of characterist ics for all objects with names

beginning with M.

F o r n od e a d d re sses, w h ich a re rep rese n t ed by t h e f orm a t area-number.node-number, o n ly t h e node-number portion of the node address (the numeral

on t h e r ig h t s id e of t h e p eriod ) ca n con t a in a w ild ca rd . F o r e x a m p le , t h e

following command sets a COUNTER TIMER value of 45 seconds for all

nodes in area 4:

NCP>SET NODE 4.* COUNTER TIMER 45

Specifying a node address such as *.5 is invalid because the ar ea-num ber

cannot contain a wildcard.

I n a n o d e a d d r e ss , a w i l dca r d c h a r a ct e r ca n n ot b e com b in ed w i t h a n u m e r a l

t o re pre sen t a p a rt ia l node-number. The node addresses 4.* and 4.%contain

valid uses of the w ildcar d cha ra cters, but t he node addr esses 4.%2 an d 4.1*

a re in va l id .

F or e ve nt s , w h i ch a r e r ep r es en t e d b y t h e f or m a t class.type, o n ly t h e type

portion of the event (the n umeral on the r ight side of th e period) can conta in

a w ild ca rd . F o r e xa m p le, t h e f ol low in g com m a n d sp ecifi e s t h a t a l l c la ss 2

events ar e to be logged:

NCP>SET KNOWN LOGGING EVENTS 2.*

13


16/252


17/252

Description1.3 Command Prompting

Each prompt consists of two parts: the component or parameter desired, and its

format. The syntax is as follows:

component (format):

The component part indicates the name of either the component or parameter.

The forma t pa rt indicat es the ra nge of acceptable values. The forma t pa rtpresents command words in uppercase, value classes in lowercase as descriptive

st rin g s, a n d n u m e ric ra n g e s a s t w o n u m b e rs se p a ra t e d b y a h yp h e n . Co m m a s

in d ica t e a l t e rn a t ives t h a t a re m u t u a lly e xclu sive.

P ro m pt in g d o es n o t g u a ra n t e e t h a t yo u a re e n t e rin g a va l id com m a n d . E ve n

if p a ra m e t ers a re re qu ired t o m a k e t h e com m a n d m e a n in g fu l , p rom p t in g d oe s

n ot d e m a n d a re spon se f or a l l t h e re qu ired p a ra m e t er va lu es o r n a m e s, a s t h e

following example indicates:

NCP>SET OBJECT NML ReturnObject number (0-255): ReturnFile name (filename.type): Return

Privileges (List of VMS privileges): Return

User ID (1-16 characters): Return

Password (1-8 characters): ReturnAccount (1-16 characters): ReturnProxy access INCOMING, OUTGOING, BOTH, NONE:) Return%NCP-F-NOPARM, no parametersNCP>

1.3.1 Exiting the Prompting Sequence

You can exit a prompting s equence by pressing Ct rl/Z. When y ou do so, th e NCP >

p rom p t re t u rn s, a n d yo u ca n t h e n e n t e r a n ot h e r N CP com m a n d . To e xit N CP

completely, press C tr l/Z at th e NCP > prompt.

The following example shows how to interrupt a prompting sequence and exit

NCP.

NCP>SET Return(CIRCUIT, EXECUTOR, KNOWN, LINE,

LOGGING, MODULE, NODE, OBJECT): LINELine ID (dev-c-u.t): FZA-1Number of receive buffers (1-1024): Ctrl/Z...NCP> Ctrl/Z$

If , after responding to one or more prompts, you want to exit the prompting

sequence but retain whatever information you have provided in the database, you

can respond to the next prompt with _DONE, as follows:

NCP>DEFINE OBJECT ReturnObject Name (12 characters): TALOSObject Number (0-255): 101File name (filename): TALOS.EXEPrivileges (List of VMS privileges): _DONENCP>

I n t h is e xa m p le, N CP m a k e s a n e w e n t ry in t h e p erm a n e n t d a t a b a se f or o b je ct

TALOS. B ecause _DONE is used in r esponse to a prompt, NC P wr ites no

ot h e r p a ra m e t er in f orm a t ion t o t h e d a t a b a se f or t h is o bje ct , a n d N C P e xit s t h e

p rom p t in g se qu en ce. N ot e t h a t N CP re t u rn s a su ccess m e ssa g e w h e n ever i t

modifies the permanent database successfully.

15


18/252


Using _DONE may not be successful, however, if you do not provide all of the

necessary parameters for a given component. For example:

NCP>DEFINE OBJECT ReturnObject Name (12 characters): RIGELObject Number (0-255): ReturnFile name (filename): RIGEL.EXEPrivileges (List of VMS privileges): _DONE%NCP-I-NMLRSP, listener response - Parameter missing, numberObject = RIGELNCP>

This example is simila r to th e previous exam ple except tha t the object number

is omitted. B ecause each object mus t ha ve an object num ber defined in t he

database, and because none currently exists for object RIGEL, NCP does not

u p da t e t h e d a t a b a se w it h t h is in f orm a t ion .

1.3.2 Prompting Examples

The following exam ples illustra te t hree types of prompting t ha t NCP provides:

P ro m pt s t o su pp ly m issin g com p on e n t

NCP>CLEAR Return(CIRCUIT, EXECUTOR, KNOWN, LINE, LOGGING, MODULE, NODE, OBJECT):

No component is specifi ed for the C LEAR comma nd. The prompt forma t

is a l is t of va l id com p on e n t s se pa ra t e d b y com m a s. N ot e t h a t t h e p lu ra l

component KNOWN is included in this list.

P r o m pt s t o s u pp ly p a r a m e t er va l u es

NCP>CLEAR LINE ReturnLINE ID (dev-c-u):

N CP p rom p t s f or t h e l ine-id for t his component because it is not provided

w it h t h e com m a n d .

The following example shows variat ions of the prompting scheme forp a ra m e t e r va lu es:

NCP>SET EXECUTOR ReturnNode address (1.1-63.1023): 2.11State (ON, OFF, SHUT, RESTRICTED): ONSystem id string (32 characters:) "DECnet for OpenVMS"..

P r o m pt s t o s el ect pa r a m et e r n a m e s

NCP>CLEAR LINE ReturnLine ID (dev-c-u.t): FZA-1All line parameters (Y,N):

N CP p rom p t s f o r t h e se lect ed p a r a m e t e r n a m e s w h o se va lu es a re t o b ere m oved f ro m t h e d a t a b a se. I n t h is ca se, n o p a ra m e t e r n a m e is g ive n ;

consequently, NCP asks if a ll va lues should be removed. The Y para meter

in d ica t e s t h a t a l l va lu es sh o u ld b e re m o ve d . U sin g N o r RE TURN ca u ses

NCP to provide a different response.

16


19/252


NCP> CLEAR NODE BOSTON ReturnAll node parameters (Y,N): ReturnHost node (Y,N): Y...Service password (Y,N): YTertiary loader (Y,N): N

Because RETURN is the response to the first prompt, NCP prompts for all of

t h e p a ra m e t e r n a m e s.

1.4 Component and Parameter Syntax Rules

Wh e n yo u e n t e r N CP com m a n d s, m a n y com p on e n t s, p a ra m e t ers, a n d qu a lifi e rs

re qu ire you t o su pp ly a d d it ion a l in f orm a t ion . F o r t h e m o st p a rt , t h e ir syn t a x

follows a standard set of rules. Exceptions to these rules are documented in the

description of the component, para meter, or qua lifier to w hich they a pply.

The syntax of the various component-name, parameter, and qualifier values

is summa rized in Table 12. In t he follow ing ta ble, a ll numeric values are in

decimal an d ha ve a ra nge of 0 to 65,535 unless otherwise specified:

Table 12 NCP Syntax Summary

a ccoun t A st rin g of u p t o 39 a lph anu m eric a nd hy ph en cha ra ct ers.Op enV M S op era t ing s ys t ems d o not cu rrent ly u s e t hisstring for access control.

a rea -n um ber A d ecim a l va lu e in t he r a ng e 1 t o 63 t o be specifi ed in t hebeginning of t he n ode-add ress a nd s ep a ra t ed from t he nodenumber by a p eriod. I f you do not s p ecify a n a rea nu mber,t he a rea n u mber of t he execu t or is u s ed. The defa u lt a reanumber for the executor is 1.

(continued on next page)

17


20/252

Description1.4 Component and Parameter Syntax Rules

Table 12 (Cont.) NCP Syntax Summary

circuit -id A st ring of cha ra ct ers w hose exa ct syn ta x is t ha t for aDE Cnet for Op enVM S circu it . The s t r ing ma y a ls o betha t for an X.25 circuit identifi cation. For X.25 circuits,c ir c uit - id is a s t r ing of u p t o 15 cha ra ct ers beginning w it h

X25-.

Circu it ident ifica t ion t a kes one of t he follow ing forma t s :

dev-cdev-c-udev-c.tdev-c-u.t

d e v I s a d ev ic e n a m e . R e f er t o t h e d e scr i pt i on of device-type for a l is t of device mnemonic na mes . Fora complete list of DECnet for OpenVMS circuitdevices and descriptions, see Appendix A.

c I s a d eci m a l n u m be r (0 or a p os it i ve i nt e ge r)designating the devices hardware controller.

u I s a d eci m a l u n it or ci rcu it nu m be r (0 or a pos it i veint eger) inclu ded only i f more t ha n one u nit isassociated with the controller.

t I s a de ci ma l n u m be r (0 or a pos it i ve i n te ge r) t h a tident ifies a t r ibu t a ry on a m u lt ip oint circu it . This isa logica l t r ibu t a ry nu mber, not t o be confu s ed w it ht he t r ibu t a ry a ddres s u s ed t o p oll t he t r ibu t a ry.

cpu -t ype A st rin g of ch ar a ct er s con sist in g of on e of t he follow in g:

DECSYSTEM1020P D P 1 1

P D P 8VAX

d est -n am e An id en tifi ca t ion st rin g con sist in g of 1 t o 16 a lph an um er iccha ra ct ers .

d evice-t ype A st rin g of ch ar act er s r epr esen tin g t he m nem on ic n a mefor the device. Appendix A in this book contain s a list ofdevices, current a s of this publicat ion dat e. The followinglist represents typical devices:

B N A F ZA MFA MN A

QN A S VA U N A

dt e-a ddress A st rin g of u p t o 15 decima l digit s. S ee t he P ubl ic N et wor k I nf or m at ion ma nu a l for t he exa ct forma t of t his p a ra met er

on your network.(continued on next page)

18


21/252



event -list A list of even t t ypes for a given cla ss in t he for ma tclass.type. When specifying a n event list , you ma y specifyonly one class; however, you can specify a range of types byusing comma s a nd hyphens, for example, 4.35,710. You

ca n u s e t he a s t eris k w ildca rd cha ra ct er in a n event l is t , bu tonly to replace an event ty pe. The following ta ble providesexamples of these formats.

Event List Meaning

4.4 I dent ifi es even t cla ss 4, t ype 4.

4.57 I den tifi es even t cla ss 4, t ypes 5 t hr oug h7.

4.5,7 9,11 I d en t ifi e s ev en t cla s s 4, t y pes 5, 7t hrou gh 9, a nd 11. N ot e t ha t t yp es mu s tbe specified in ascending order.

4.* I dent ifi es a ll event t ypes for cla ss 4events.

fi lespec A fi le specifi ca t ion st ring in t he follow ing gener al form at :

node-spec::device:[directory]filename.type;version

L ogica l na mes a re p ermit t ed.

R efer t o t he V M S DCL Conc ept s M anual for t he forma tof a file s p ecifica t ion, a nd t he G u i d e t o O p en V M S F i l e A ppl ic at ions for more information about specifying files.

h-a ddr ess A st ring of 6 pa irs of h exa decim al digit s sepa ra t ed byhyphens (for exam ple 08002B2BAFF3). The st ringrepresents the hardware address of a LAN device controller.

hex-by t e A st rin g of exa ct ly 2 h exa decim a l digit s.

h ex-pa ssw or d A st rin g of up t o 8 h exa decim a l d ig it s.

hex-va lue A st rin g of up t o 32 h exa decim a l digit s.

id -st rin g A st rin g of u p t o 32 ch ar act er s. I f t he st rin g in clu des spa cesor t a bs , enclos e i t w it hin qu ot a t ion m a rks .


19


22/252



lin e-id A st ring of cha ra ct ers w hose exa ct syn t a x is t h a t for aDE Cnet for Op enV MS line ident ifi ca t ion. The s t r ing ma ya ls o be t ha t for a n X. 25 line ident ifica t ion. For Op enV MSopera t ing s ys t ems , l i ne- id t a kes one of t he follow ing

forma t s :

dev-cdev-c-u

d e v I s a d ev ic e n a m e . R e f er t o t h e d e scr i pt i on of device-type for a l ist of device mnemonic na mes . For acomplete list of DECnet for OpenVMS line devicesan d descriptions, see Appendix A.

c I s a d eci m a l n u m be r (0 or a p os it i ve i nt e ge r)designating the devices hardware controller.

u I s a d eci ma l u n it or l in e n u m be r (0 or a pos it i veint eger) inclu ded only i f more t ha n one u nit isassociated with the controller.

m icrosecon ds A decim a l nu m eric va lu e.

m illiseconds A decim a l nu m eric va lu e.

n et w or k-n a me F or X.25 cir cu it s, s pecifi e s a 1- t o 16-ch a ra ct era lp ha nu meric ident ifier t ha t indica t es t he net w ork t o beused.

n od e-a d dr es s A n um er ic va lu e in t he r a ng e 1.1 t o 63.1023, com pos edof a n a rea nu mber t o t he lef t of t he p eriod follow ed by anode number to th e right of th e period. (The node numberindica t es t he a ddres s of t he node w it hin t he s p ecified a rea . )I f t he a rea nu mber is not s u p p lied, t he a rea nu mber of t heexecu t or node is u s ed. The defa u lt a rea nu mber for t heexecutor is 1.

node-id E it her a node-nameor a n ode-add r ess.

n od e-n am e A st rin g of u p t o six a lph a nu mer ic ch a ra ct er s con ta in in g a tlea s t one a lp ha bet ic cha ra ct er.

node-spec A node-id followed by optional access control information int he follow ing forma t :

node-id"u s er p a s s w ord"node-id"user password account"

n od e-t ype A st rin g of ch ar a ct er s con sist in g of on e of t he follow in g:

N onrou t ing I I I

Nonrouting IV

R ou t ing I V

R ou t ing I I IArea

nu m ber A decim a l nu m eric va lu e.

ob ject -n a me A s tr in g of u p t o 16 pr in t a ble ch a ra ct er s, con sist in g ofa lp ha nu meric cha ra ct ers , t he dolla r s ign ( $) , or t heunderscore (_).

VAX specifi c


110


23/252



p-a ddress A st ring of 6 pa irs of h exa decim al digit s sepa ra t ed byhyph ens (for exam ple AA0004000310). The va lue ist he u niqu e p hys ica l a ddres s t ha t t he node ha s s et for i t s elfor , i f t he node ha s not s et a p hys ica l a ddres s , t he ha rdw a re

address associated with the nodes device controller.pa ssw ord A st r in g of up t o 39 pr int a ble cha ra ct ers.

pr iv ileg e-list A list of Open VMS pr iv ileg e n a mes d elim it ed b y s pa cecha ra ct ers .

secon ds A decim a l nu m er ic va lu e.

sin k-n a me A st rin g of a lph a nu mer ic ch a ra ct er s t ha t specifi es t he n a meof a n event s ink. The logging console na me is a s t r ing inthe form TTcnn (if a termina l) or a fi le specificat ion if it is afi le tha t receives events in th e console format . The loggingfi le na me is a fi le s pecifica t ion. The logging monit or na meis a 1- to 9-character name. If the string includes spaces ort a bs , enclos e i t in qu ot a t ion ma rks .

soft w are-id A st r in g of up t o 16 cha ra ct ers.

s of tw a r e-t y pe A s t ri ng of ch a r a ct er s con si st in g of on e of t h e f ol low i ng :

MANAGEMENT FILESE C ON DAR Y L OADE RSYSTEMTER TIARY L OADER

t r ib ut a r y-a d d res s A n um er ic v a lu e i n t h e r a n ge of 0 t o 255.

user-id A st rin g of u p t o 39 a lph anu m eric a nd hy ph en cha ra ct ers.The op era t ing s ys t em ma y inclu de a ddit iona l res t r ict ions;for exa mp le, Op enVM S s ys t ems l imit t he s t r ing t o 12cha ra ct ers .

VAX specifi c

Qu ot a t ion m a rk d e lim it ers a re va l id f o r t h e node-spec form a t . I n a d d it ion , yo u

ca n u se q u ot a t ion m a rk s a s d e lim it ers w h e n p rovid in g re ceive a n d t ra n sm it

p a ssw o rd s f or t h e S E T N OD E a n d D E F I N E N OD E com m a n d s. F o r ex a m p le :

NCP>SET NODE TRANSMIT PASSWORD "HI OpenVMS"

Also, u se qu o t a t io n m a rk s t o d e fi n e a sof t w a re id en t ifi ca t ion st r in g w it h t e xt a n d

spaces for the IDENTIFICATION parameter of the SET EXECUTOR command.

For example:

NCP>SET EXECUTOR IDENTIFICATION "VMS HOST SYSTEM"

111


24/252


25/252

2Using NCP

Th e N e t w o rk Co n t rol P rog ra m (N CP ) is a D E C n e t f o r Op en V MS u t i l it y t h a t

accepts commands to configure, control, monitor, and test a DECnet network.

Entering Commands

To invoke NC P, enter the following DC L comma nd:

$ RUN SYS$SYSTEM:NCP

NCP returns the following prompt:

NCP>

Alternatively, you can enter a single NCP command from DCL by first entering a

D CL st rin g a ssig n m en t st a t e m en t . F o r ex a m p le :

$ NCP=="$NCP"$ NCP SHOW EXECUTOR STATUS

Node Volatile Status as of 12-JUL-1992 11:57:59

Executor node = 4.306 (INTER)

State = onPhysical address = AA-00-04-00-32-11Active links = 2Delay = 0

$

NCP executes the SH OW EXE CU TOR S TATU S comma nd a nd r eturns control to

D C L .

To exit from a n N CP session, ty pe EXIT or press C TRL/Z a fter th e N C P > prompt.

Ou t p ut f or t h e S HOW a n d L I S T com m a n d s is n o rm a lly d isp la ye d on t h e d e f a u lt

output device, SYS $OUTP U T. Alternat ively, y ou ma y direct output to a specifi ed

fi le u sin g t h e TO q u a lifi e r w it h t h e S HOW or L I S T com m a n d .

Certa in NCP comma nds require privileges, as shown in Table 21. For DE Cnet

purposes, an account is considered privileged if any privileges other than

N E TM B X a n d TM PM B X a re h e ld .

21


26/252

Using NCP

Table 21 Privileges for NCP Operations

Operation Required Privileges

S ta rt t h e n et wor k AC NT, C MK RN L , S YS NAM, a nd D ETAC H

P erform t a s k-t o-t a s k commu nica t ion N E TM B X is requ ired t o a s s ign a cha nnel t o t he

NET device. TMP MBX is req uired to optiona llya s s ocia t e a t emp ora ry ma ilbox w it h a net w orkchannel.

C rea t e a logica l link N E TMB X

Declare a name or object number ina u s e r t a s k

SYSNAM (Refer to DE Cnet f or O penV M S N et w or k i n g M a n u a l for information about usert a s ks . )

CL E A R p a ra met ers from t hevola t i le da t a ba s e

N E TM B X a n d O P E R

I ssu e C ON N E CT com ma nds N E TMB X

C OP Y K NOWN N OD E S N ETMB X, TMP MB X a nd OP E R (S YS P RV is a lsoneeded if a cces s t o t he p erma nent node da t a ba s e isrequired or if the WITH option is used.)

D E F I N E p a r a m e t e r s i n t h ep er m a n e n t d a t a b a s e

S Y S P R V a n d O P E R 1

D I S C ON N E C T L I N K s N E TMB X a nd OP ER

L I ST p a ra met ers kep t in t hep er m a n e n t d a t a b a s e

S Y S P R V1

LIST service passwords kept in thep er m a n e n t d a t a b a s e


L I ST receive p a s s w ords , t ra ns mitpasswords, and object and executoraccess control passwords kept in thep er m a n e n t d a t a b a s e

B YP A SS

I ssu e L OAD com ma nds N E TMB X, TMP MB X a nd OP E R

U se L OOP C I R C U IT N E TMB X, TMP MB X a nd OP E R

U se L OOP E XE CU TOR N E TMB X a nd TMP MB X

P U R G E p a r a m e t e r s f r o m t h ep er m a n e n t d a t a b a s e


SE T p a ra met ers kep t in t he vola t i led a t a b a s e


I s su e S E T E X E C U TO R N OD E R eq u ir es N E TM B X a n d TM P M B X p ri vi le ge s ont he loca l node, a nd N M L on t he execu t or nodemu s t ha ve a p p rop ria t e p rivileges t o p erform t hecomma nds is s u ed a f t er t he SE T E XE CU TORN ODE comma nd.

U s e "S E T component AL L " t o loa dp a ra met ers from t he p erma nentd a t a b a s e t o t h e v o la t i l e d a t a b a s e

N E TM B X , O P E R a n d S Y S P R V1

SHOW p a ra met ers kep t in t hevola t i le da t a ba s e

NETMBX

1You can perform operations requiring access to the permanent database without the SYSPRVprivilege i f you have read and write access to al l configuration database files or hold BYPASSprivilege. However, Digital recommends tha t you protect th ese network configura tion files fromunauthorized access by requiring S YSPRV to a ccess these fi les.


22


27/252

Using NCP

Table 21 (Cont.) Privileges for NCP Operations

Operation Required Privileges

SHOW service passwords kept int he vola t i le da t a ba s e


SH OW receive p a s s w ords , t ra ns mitp a s s w ords , a nd a cces s cont rolp a s s w ords kep t in t he vola t i led a t a b a s e

N E TM B X a nd B YP A SS

I ssu e TE LL com ma nd s Req uir es N ETMB X a n d TMP MB X on t he loca lnode, a nd N M L on t he execu t or node mu s t ha ves u fficient p rivileges t o p erform t he comma nd t ha tfollows TELL.

I ssu e TR IG G E R com ma n ds N ETMB X, TMP M B X a n d O P E R

ZE R O cou nt er s N E TMB X a nd OP E R

2.1 Hints for Using Commands

You can abbreviate any command verb, component, parameter, or qualifier as

long as the abbreviat ion is not ambiguous.

Co m m a n d s t h a t h a ve t h e sa m e co m p o n e n t s a n d p a ra m e t e rs, ye t d i f f e re n t

command verbsdepending upon whether they access the volat ile or the

p erm a n e n t d a t a b a se a re l ist e d t o g et h e r in Ch a p t er 3. E x a m p les o f com m a n d s

list e d t og et h e r a re C L E A R a n d P URG E , S E T a n d D E F I N E , a n d S H OW a n d L I S T,

w h e re CL E AR, S E T, a n d S H OW verb s a p ply t o t h e vola t i le d a t a b a se a n d P URG E ,

D E F I N E a n d L I S T ve rbs a p ply t o t h e p erm a n e n t d a t a b a se . Wh e n t w o com m a n d s

ar e grouped together, components a nd pa ra meters a re described for t he comma nd

tha t a ccesses th e volat ile data base. Typically, the actions described for t he

vola t i le d a t a b a se a lso a p p ly t o t h e p erm a n e n t d a t a b a se . Ho w e ver, i f ce rt a in

commands apply only to a part icular database or if a different action is required

for the volat ile and permanent databases, these exceptions are specifically notedin t he comma nd description.

I n g e n e ra l , t h e N CP com m a n d s a n d p a ra m e t e rs a re com m o n t o m ost n e t w ork

con fi g u ra t io n s. E x cep t ion s t o t h is g en e ra l r u le a re n ot e d u n d e r t h e com m a n d

or para meter t o which t hey a pply. The VAX ma rgin icon indicat es functions

supported only on VAX systems. Other restr ict ions ar e noted a s par t of the

command or parameter description.

Note

A lt h o u g h N CP m a y a cce p t a p a rt icu la r co m m a n d syn t a x , t h is is n o

guarantee that some other DECnet implementation supports the function.

For a complete description of the network components specified in NCP

commands, see the D E C n et f or O p en V M S N et w o r k i n g M a n u a l . T h a t m a n u a l

a lso ex pla in s h o w t o u se t h e N CP com m a n d s t o m a n a g e t h e D E C n e t n e t w o rk .

23


28/252


29/252

3NCP Commands

This chapter presents NC P comma nd descriptions. Comma nds a re presented

in a lph a b e t ica l ord e r w it h t h e a ssocia t e d com m a n d p a ra m e t ers a n d a p p rop ria t e

examples.

N CP a l low s f or m a n a g em e n t o f t h e loca l n o de a n d f or r e m ot e m a n a g e m en t of a n y

DECnet node that you specify as the executor. When you issue NCP commands,

there are two ways to specify the executor the location at which the command

executes:

B e g in in d iv id u a l N C P c om m a n d s w i t h t h e TE L L p re fi x .

S e t t h e e xe cu t or w it h t h e S E T E X E CU TOR N OD E com m a n d . All su b sequ e n t

NCP commands execute at the remote node until you:

I ssu e a n o t h e r S E T E X E CU TOR N OD E com m a n d ,

I ssu e a CL E AR E X E CU TOR N OD E com m a n d , or

E x it N CP.

To enter one or tw o NCP comma nds for remote execution, it is probably ea sier to

use the TELL prefix. To execute multiple NCP comma nds a t a remote node, fir st

issue the SET EXECUTOR NODE command, specifying that node.

NoteN CP com m a n d s a n d com m a n d p a ra m e t ers a re n o t a l l su p p ort e d o n e very

h a rd w a re p la t f orm . I n so m e ca se s, N CP a l low s you t o se t a n d d isp la y

an unsupported parameter. However, the unsupported parameter is not

functional and has no effect on the operation of the DECnet software.

31


30/252

CLEAR/PURGE CIRCUIT

CLEAR/PURGE CIRCUIT

The CLEAR CIRCUIT command resets circuit parameters in the volat ile database

to the default va lue (if any ), or removes them from the volat ile da ta base. TheP URG E CI RC UI T com m a n d re m oves circu it p a ra m e t ers f ro m t h e p e rm a n e n t

d a t a b a s e .

Format

CLEAR circuit-component parameter [...]

PURGE circuit-component parameter [...]

Circuit Components

CIRCUIT KNOWN CIRCUITS

Circuit ComponentsCIRCUIT circuit-idRe set s t o t h e d e f a u lt va lu e (i f a n y) o r re m ove s f rom t h e d a t a b a se t h e p a ra m e t e rs

for a specific circuit. The c i rcuit- id sp e cifi e s t h e n a m e of t h e circuit yo u w a n t t o

clear.

KNOWN CIRCUITSRe set s t o t h e d e f a u lt va lu e (i f a n y) o r re m ove s f rom t h e d a t a b a se t h e p a ra m e t e rs

for a ll known circuits.

Command Parameters

ACTIVE BASE (VAX only)

VA X Applies only to DD CMP CONTROL circuits. Resets to its default value theACTIVE B ASE value in volat ile the da ta base. Removes the ACTIVE B ASE

p a ra m e t e r f rom t h e p e rm a n e n t d a t a b a se .

ACTIVE INCREMENT (VAX only)Applies only to DDC MP CONTROL circuits. Resets to its default va lue the

ACTIVE I NCRE MENT value in t he volat ile data base. Removes the ACTIVE

I N CRE M E N T p a ra m e t e r f ro m t h e p erm a n e n t d a t a b a se .

ALLRemoves from the da ta base t he specified circuit or a ll known circuits. The circuit

must be in the OFF state before you specify this parameter.

VA X BABBLE TIMER (VAX only)Applies only to DDC MP CONTROL circuits. Resets to its default va lue theB A B B L E TI M E R va lu e in t h e vola t i le d a t a b a se . Re m ove s t h e B A B B L E TI M E R

p a ra m e t e r f rom t h e p e rm a n e n t d a t a b a se .

COSTRe set s t o i t s d e fa u lt va lu e t h e COS T va lu e in t h e vola t i le d a t a b a se . Re m oves t h e

COS T p a ra m e t er f ro m t h e p e rm a n e n t d a t a b a se . D o es n o t a p ply t o X .25 P VCs.

32


31/252


32/252

CLEAR/PURGE CIRCUIT

MAXIMUM ROUTERSAp plies o n ly t o E t h e rn et a n d F D D I circuit s . Re set s t o i t s d e f a u lt va lu e t h e

M AX I M UM ROU TE R va lu e in t h e vola t i le d a t a b a se . Re m oves t h e M AX I M UM

ROUTE RS p a ra m e t e r f ro m t h e p erm a n e n t d a t a b a se .

VA X MAXIMUM TRANSMITS (VAX only)

Applies only to DDC MP CONTROL circuits. Resets to its default va lue

the MAXIMUM TRANSMIT number in t he volat ile data base. Removes the

MAXIMUM TRANSMITS parameter from the permanent database.

NETWORK (Remote management only)Applies only to purging X.25 P VCs a nd X.25 D LM circuits. Removes th e circuit s

n e t w o rk pa ra m e t ers f ro m t h e p erm a n e n t d a t a b a se .

NUMBER (Remote management only)Applies only to incoming DLM circuits. Removes the restriction on accepting calls

only from a part icular remote DTE number.

RECALL TIMER (Remote management only)

Applies only to X.25 DLM circuits. Resets to its default va lue the RE CALLTI M E R va lu e in t h e vola t i le d a t a b a se . Re m oves t h e RE C AL L TI M E R p a ra m e t er

f rom t h e p e rm a n e n t d a t a b a se .

ROUTER PRIORITYAp plies o n ly t o E t h e rn et a n d F D D I circuit s . Re set s t o i t s d e f a u lt va lu e t h e

p riori t y a ssig n ed t o t h e ro u t er in t h e vola t i le d a t a b a se . Re m ove s t h e ROU TE R

P RI ORI TY p a ra m e t er f ro m t h e p e rm a n e n t d a t a b a se .

VA X TRANSMIT TIMER (VAX only)

Applies only to DDC MP CONTROL circuits. Resets to its default va lue the

TRANSMIT TIME R va lue in the d at aba se.

34


33/252

CLEAR/PURGE CIRCUIT

Examples

VA X 1. NCP>CLEAR CIRCUIT DMB-0 ALL

This command removes all parameter entries for circuit DMB0 in the

volat ile data base. As a result , the circuit n o longer exists for t he local

D E Cn e t so f t w a re .

2. NCP>CLEAR CIRCUIT DMP-0.4 COUNTER TIMER

This command removes the COUNTER TIMER parameter for circuit

D M P 0.4 f rom t h e vo la t i le d a t a b a se .

3. NCP>PURGE CIRCUIT SVA-0 ALL

This command removes all parameter entries in the permanent database for

the Ethernet circuit SVA-0.

4. NCP>CLEAR CIRCUIT SVA-* ALL

This command clears all SVA circuits and the associated parameters for allSVA circuits in th e volat ile data base.

35


34/252

CLEAR/PURGE EXECUTOR


The CLEAR EXECUTOR command resets selected parameters to the default

value (if any ) or r emoves them from th e volat ile data base. You can not clear

t h e B U F F E R S I Z E , S E G M E N T B U F F E R S I Z E , M AX I MU M B R O AD C AS TROU TER S, ALIAS NOD E, or S TATE para meters from the volat ile dat aba se

when the executor is in the ON state.

Th e P URG E E X E CU TOR com m a n d re m ove s se le ct e d p a ra m e t ers f rom t h e

p e rm a n e n t d a t a b a se .

Format

CLEAR EXECUTOR parameter [...]

PURGE EXECUTOR parameter [...]

Command Parameters

ALIAS INCOMINGRe m ove s f rom t h e d a t a b a se t h e A L I AS I N COM I N G p a ra m e t e r.

ALIAS MAXIMUM LINKSRe set s t o i t s d e fa u lt va lu e t h e A L I AS M AX I M UM L I N K S va lu e in t h e vola t i le

d a t a b a se . Re m ove s t h e AL I AS M A XI M UM L I N K S p a ra m e t er f ro m t h e


ALIAS NODERemoves from the permanent database the alias node identifier.

ALLRemoves from the permanent database all executor parameters.

VA X AREA MAXIMUM COST (VAX only)

Resets to its default value the AREA MAXIMUM COST value for the local node

in the volat ile database. Removes the AREA MAXIMUM COST parameter for the

local node from the permanent database.

AREA MAXIMUM HOPS (VAX only)Resets to its default value the AREA MAXIMUM HOPS value for the local node

in t h e vo la t i le d a t a b a se . Re m oves t h e ARE A M AX I M UM H OPS p a ra m e t er f or

the local node from the permanent database.

BROADCAST ROUTING TIMERRe set s t o i t s d e fa u lt va lu e t h e B ROAD CA S T ROUTI N G TI M E R va lu e in t h e

volatile database. Removes the BROADCAST ROUTING TIMER parameter fromt h e p e rm a n e n t d a t a b a se .

BUFFER SIZERe m ove s from t h e p e rm a n e n t d a t a b a se t h e B UF F E R S I Z E va lu e.

COUNTER TIMERRemoves from the database the logging t imer to prevent any further counter

logging for the local node.

36


35/252


DEFAULT ACCESSRe set s t o i t s d e f a u lt va lu e t h e D E F AUL T ACCE S S va lu e in t h e vola t i le d a t a b a se .

Re m ove s t h e D E F AUL T ACCE S S p a ra m e t e r f ro m t h e p erm a n e n t d a t a b a se .

DELAY FACTORResets to its default value the DELAY FACTOR value for the local node in the

volat ile data base. Removes the D ELAY FACTOR pa ra meter for the local node

f rom t h e p erm a n e n t d a t a b a se .

DELAY WEIGHTResets to its default value the DELAY WEIGHT value for the local node in the

volat ile da ta base. Removes the DE LAY WEI G HT para meter for th e local node


VA X DNS INTERFACE (VAX only)

Removes from the database the DNS INTERFACE parameter.

DNS NAMESPACE (VAX only)Re m ove s f rom t h e d a t a b a se t h e D N S N AM E S PA CE p a ra m e t e r.

IDENTIFICATIONRe m ove s f rom t h e d a t a b a se t h e id en t ifi ca t io n st r in g .

VA X IDP (VAX only)

Re m ove s f rom t h e d a t a b a se t h e I D P p a ra m e t er.

INACTIVITY TIMERResets to its default value t he INACTIVITY TIMER value for t he local node in

the volat ile dat aba se. Removes the INACTIVITY TIMER para meter for the local

n od e f rom t h e p e rm a n e n t d a t a b a se .

INCOMING PROXY

Re set s t o i t s d e f a u lt va lu e t h e I N COM I N G P ROXY va lu e f or t h e lo ca l n od e in t h evola t i le d a t a b a se . Re m oves t h e I N COM I N G P ROXY p a ra m e t er f or t h e loca l n od e


INCOMING TIMERResets to its default value the INCOMING TIMER value for the local node in the

volatile database. Removes the INCOMING TIMER parameter for the local node


MAXIMUM ADDRESSRe set s t o i t s d e f a u lt va lu e t h e M A XI M UM AD D RE S S va lu e f or t h e lo ca l n od e

in t h e vo la t i le d a t a b a se . Re m oves t h e M AX I M UM A D D RE S S p a ra m e t e r f o r t h e


VA X MAXIMUM AREA (VAX only)

Resets to its default value the MAXIMUM AREA value for the local node in the

volatile database. Removes the MAXIMUM AREA parameter for the local node


MAXIMUM BROADCAST NONROUTERSResets to its default value the MAXIMUM BROADCAST NONROUTERS value

in the volat ile database. Removes the MAXIMUM BROADCAST NONROUTERS

p a ra m e t e r f o r t h e loca l n od e f rom t h e p e rm a n e n t d a t a b a se .

37


36/252


37/252


OUTGOING TIMERResets to its default value the OUTGOING TIMER value for the local node in the

volatile database. Removes the OUTGOING TIMER parameter for the local node


VA X PATH SPLIT POLICY (VAX only)

Resets to its default value the PATH SPLIT POLICY value for the local node in

t h e vo la t i le d a t a b a se . Re m oves t h e PATH S P L I T P OL I CY p a ra m e t er f or t h e loca l

n od e f rom t h e p e rm a n e n t d a t a b a se .

PIPELINE QUOTARe set s t o i t s d e fa u lt va lu e t h e P I P E L I N E QUOTA va lu e f or t h e loca l n o d e in t h e

vola t i le d a t a b a se . Re m ove s t h e P I P E L I N E QUOTA pa ra m e t er f or t h e loca l n o de


PRIVILEGED itemRemoves from t he da ta base t he specified privileged a ccess control informat ion.

Specify a ny or all of th e following items for removal:

A CCOUN TPASSWORD

U S E R

RETRANSMIT FACTORResets t o its default value the RETRANSMIT FACTOR va lue for the local n ode

in the volat ile da ta base. Removes the RE TRANSMIT FACTOR par am eter for t he


VA X ROUTING TIMER

Resets to its default value the ROUTING TIMER value for the local node in the

volatile database. Removes the ROUTING TIMER parameter for the local node


SEGMENT BUFFER SIZERe m ove s t h e S E G M E N T B U F F E R S I Z E p a ra m e t e r f o r t h e loca l n od e f rom t h e


STATERemoves from the permanent database the local nodes state.

SUBADDRESSES (Remote management only)Removes from the database the value of the range of local DTE subaddresses.

TYPERemoves the TYPE parameter for the local node from the permanent database.

39


38/252


Examples

1. NCP>PURGE EXECUTOR IDENTIFICATION INCOMING TIMER

This command removes th e local nodes identifi cation st ring an d incoming

t im e r va lu e f rom t h e p erm a n e n t d a t a b a se .

2. NCP>PURGE EXECUTOR COUNTER TIMER

This command removes the local nodes counter t imer value from the


VA X 3. NCP>CLEAR EXECUTOR AREA MAXIMUM COST

Th is com m a n d re set s t o i t s d e fa u lt va lu e t h e ARE A M AX I M UM COS T

parameter in the volat ile database for the executor.

310


39/252

CLEAR EXECUTOR NODE

CLEAR EXECUTOR NODE

The CLEAR EXECUTOR NODE command clears the default executor

designation. The executor of comma nds becomes the local node. You cannot

u se t h e TE L L p refi x w it h t h e C L E A R E X E CU TOR N OD E com m a n d .After you enter the CLEAR EXECUTOR NODE command, NCP on the local node

performs a ll operat ions using t he privileges of your current process inst ead of the

privilege associat ed w ith the default nonprivileged or privileged a ccounts.

Format

CLEAR EXECUTOR NODE

Parameters

None.

Examples1. NCP>SET EXECUTOR NODE TRNTO"GRAY MARY"

.

.

.NCP>CLEAR EXECUTOR NODE

The first command sets the executor node to node TRNTO. The second

comma nd clears the default executor node designat ion specifi ed previously by

the SET EXECUTOR NODE command. The executor node is now the local

node.

311


40/252

CLEAR/PURGE LINE

CLEAR/PURGE LINE

Th e CL E AR L I N E com m a n d re set s l in e pa ra m e t ers t o t h e d e fa u lt va lu e (i f a n y )

or re m oves t h e e n t ries a n d p a ra m e t ers f ro m t h e vola t i le d a t a b a se .

T h e PURG E L I N E co m m a n d re m o ve s l in e p a ra m e t e rs f ro m t h e p e rm a n e n td a t a b a s e .

Format

CLEAR line-component parameter [...]

PURGE line-component parameter [...]

Line Components

LINE KNOWN LINES

Line Components

LINE line-idIdentifies the specific line whose parameters are to be reset to their default values

(if any) or removed from the database.

KNOWN LINESResets the parameters to the default value (if any) or removes them for all known

lin e s f rom t h e d a t a b a se .

Command Parameters

ALLRemoves the specified line or all known lines from the database. The line must

be in the OFF state before you specify this parameter.

CONTROLLERRe set s t o i t s d e f a u lt va lu e t h e C ON TROL L E R p a ra m e t er in t h e vo la t i le d a t a b a se .

Re m oves t h e C ON TROL L E R p a ra m e t er f rom t h e p e rm a n e n t d a t a b a se .

COUNTER TIMERRemoves the event logging t imer. This prevents a ny further line counter event

logging for the indicated line(s).

VA X DEAD TIMER (VAX only)

Applies only to DDCMP lines. Resets the DEAD TIMER parameter to its default

va lu e in t h e vo la t i le d a t a b a se . Re m ove s t h e D E AD TI M E R p a ra m e t er f ro m t h e


DELAY TIMER (VAX only)Applies only to DD CMP lines. Removes the DE LAY TIME R pa ra meter from the

d a t a b a s e .

ECHO DATAAp plies o n ly t o F D D I l in es. Re set s t o i t s d e fa u lt va lu e t h e E CHO D ATA

p a ra m e t e r in t h e vola t i le d a t a b a se . P e rm a n e n t d a t a b a se op era t ion s ca n n ot

be performed on this parameter.

312


41/252

CLEAR/PURGE LINE

ECHO LENGTHAp plie s on ly t o F D D I l in e s. Re set s t o i t s d e f a u lt va lu e t h e E CH O L E N G TH

p a ra m e t e r in t h e vo la t i le d a t a b a se . Pe rm a n e n t d a t a b a se o p e ra t io n s ca n n o t b e

performed on t his par am eter.

ECHO TARGETAp plie s o n ly t o F D D I l in e s. Re set s t o i t s d e fa u lt va lu e t h e E CHO TARG E T

p a ra m e t e r in t h e vo la t i le d a t a b a se . Pe rm a n e n t d a t a b a se o p e ra t io n s ca n n o t b e

performed on t his par am eter.

VA X HANGUP (VAX only)

Applies only to asynchronous DDCMP lines. Removes the HANGUP parameter

f rom t h e d a t a b a se .

HOLDBACK TIMER (Remote management only)Applies only t o X.25 lines. Removes the H OLDB ACK TIMER para meter from the

database, causing the X.25 software to acknowledge received data immediately.

VA X

LINE SPEED (VAX only)

Ap plie s on ly t o a syn ch ro n ou s D D CM P l in es. Re m ove s t h e L I N E S P E E Dp a ra m e t e r f ro m t h e d a t a b a se .

MAXIMUM BLOCK (Remote management only)Applies only to X.25 lines. Resets to its default value the MAXIMUM BLOCKS

p a ra m e t e r in t h e vo la t i le d a t a b a se . Re m oves t h e M AX I M UM B L OCK S p a ra m e t er


MAXIMUM RETRANSMITS (Remote management only)Applies only t o X.25 lines. Resets the ma ximum number of retra nsmissions

of a f ra m e t o t h e d e f a u lt va lu e f or t h e sp ecifi e d l in e or a l l k n o w n l in e s in t h e

volatile database. Removes the MAXIMUM RETRANSMITS parameter from the


NIF TARGETAp plie s o n ly t o F D D I l in e s. Re set s t o i t s d e f a u lt va lu e t h e N I F TARG E T

p a ra m e t e r in t h e vola t i le da t a b a se . P e rm a n e n t d a t a b a se op era t ion s ca n n ot

be performed on t his par am eter.

PROTOCOLRe m ove s t h e va lu e f or t h e P ROTOCOL p a ra m e t er f rom t h e p e rm a n e n t d a t a b a se .

RECEIVE BUFFERSRe se t s t h e RE CE I V E B UF F E RS p a ra m e t e r t o i t s d e f a u lt va lu e in t h e vo la t i le

d a t a b a se . Re m o ve s t h e RE CE I V E B UF F E RS p a ra m e t e r f ro m t h e p e rm a n e n t

d a t a b a se . Th e l in e m u st b e in t h e OF F st a t e in ord e r t o CL E A R t h is p a ra m e t er.

REQUESTED TRTApplies only to FD DI lines. Resets to its default va lue the REQU ES TED TRT

p a ra m e t e r in t h e vo la t i le d a t a b a se . Re m ove s t h e RE QUE S TE D TRT p a ra m e t e r


RESTRICTED TOKEN TIMEOUTApplies only to FD DI lines. Resets to its default va lue the RES TRIC TED TOKE N

TI M E OU T pa ra m e t er in t h e vo la t i le d a t a b a se . Re m ove s t h e RE S TRI CTE D

TOK E N TI M E OU T p a ra m e t er f rom t h e p e rm a n e n t d a t a b a se .

313


42/252

CLEAR/PURGE LINE

RING PURGER ENABLEAp plies o n ly t o F D D I l in e s. Re set s t o it s d e f a u lt va lu e t h e RI N G P URG E R

E N AB L E p a r a m e t er i n t h e v ol a t i le d a t a b a s e. R em ov es t h e R I N G P U R G E R

E N A B L E p a ra m e t e r f ro m t h e p e rm a n e n t d a t a b a se .

VA X SCHEDULING TIMER (VAX only)

Ap plies o n ly t o D D CM P l in e s. Re set s t h e S CHE D U L I N G TI M E R p a ra m e t e r t o

i t s d e fa u lt va lu e in t h e d a t a b a se .

SERVICE TIMERRe se t s t o i t s d e f a u lt va lu e t h e S E RV I CE T I M E R p a ra m e t e r in t h e vo la t i le

d a t a b a se . Re m oves t h e S E RVI CE TI M E R p a ra m e t e r f rom t h e p e rm a n e n t

d a t a b a s e .

SIF CONFIGURATION TARGETApplies only to FDD I lines. Resets to its default va lue the SIF C ONFIG U RATION

TARG E T pa ra m e t er in t h e vola t i le d a t a b a se . P e rm a n e n t d a t a b a se o pe ra t ion s

cannot be performed on t his par am eter.

SIF OPERATION TARGETApplies only to FDD I lines. Resets to its default va lue the SIF OP ER ATION

TARG E T pa ra m e t er in t h e vola t i le d a t a b a se . P e rm a n e n t d a t a b a se o pe ra t ion s

cannot be performed on t his par am eter.

STATERe set s t o i t s d e fa u lt va lu e t h e S TATE p a ra m e t er in t h e vo la t i le d a t a b a se .

Removes the S TATE para meter from the perma nent da ta base.

VA X STREAM TIMER (VAX only)

Applies only to DDC MP lines. Resets the S TREAM TIMER para meter to its

d e fa u lt va lu e in t h e d a t a b a se .

SWITCH (VAX only)Applies only t o asynchronous D DC MP lines. Removes the SWITCH para meter


TRANSMIT PIPELINE (VAX only)Applies only to DMR11 lines. Removes the TRANSMIT PIPELINE parameter


VALID TRANSMISSION TIMEAp plies on ly t o F D D I l in e s. Re set s t o i t s d e fa u lt va lu e t h e VAL I D

TRAN S M I S S I ON TI M E p a ra m e t er in t h e vola t i le d a t a b a se . Re m oves t h e

VALID TRANSMISSION TIME parameter from the permanent database.

314


43/252

CLEAR/PURGE LINE

Examples

1. NCP>CLEAR LINE SVA-0 ALL

This command removes the Et hernet line called SVA0 from the volat ile

d a t a b a s e .

VA X 2. NCP>CLEAR LINE DMB-0 ALL

This command removes DDCMP line DMB0 from the volat ile database.

VA X 3. NCP>CLEAR LINE DMB-* ALL

This command removes all DDCMP DMB lines from the volat ile database.

315


44/252

CLEAR/PURGE LOGGING

CLEAR/PURGE LOGGING

The CLEAR LOGGING command removes logging parameters from the volat ile

d a t a b a se . T h e PURG E L OG G I N G co m m a n d re m o ve s lo g g in g p a ra m e t e rs f ro m

t h e p e rm a n e n t d a t a b a se .

Format

CLEAR logging-component parameter

PURGE logging-component parameter

Logging Components

KNOWN LOGGING LOGGING FILELOGGING CONSOLE LOGGING MONITOR

Logging Components

KNOWN LOGGINGRemoves from the database the parameters for all known logging.

LOGGING CONSOLERemoves from the database all parameters for logging to the console.

LOGGING FILERe m ove s f rom t h e d a t a b a se a l l p a ra m e t ers f o r log g in g t o a fi le.

LOGGING MONITORRemoves from the database all parameters for logging to a monitor.

Command Parameters

ALLRe m ove s a l l p a ra m e t ers f rom t h e d a t a b a se . Af t e r yo u e n t e r t h e CL E A R/P UR G E

LOGGING command with this parameter, the logging component is no longer

recognized by the n etwork.

CIRCUIT circuit-idRemoves from the database all logging parameters for the specified circuit .

LINE line-idRemoves from the database all logging parameters for the specified line.

NODE node-idRemoves from the database all logging parameters for the specified node.

Examples

1. NCP>CLEAR LOGGING CONSOLE ALL

This command clears logging t o the logging console, a fter w hich th e logging

component is no longer recognized by the network.

316


45/252

CLEAR/PURGE LOGGING EVENTS


The CLEAR LOGGING EVENTS command removes event-source logging

p a ra m e t e rs f rom t h e vola t i le d a t a b a se . Th e PU RG E L OG G I N G E VE N TS

comma nd r emoves event-source logging para meters from the perma nent da ta base.If no source is specified in the command, the source specific events will not be

affected.

Format

CLEAR logging-component parameter [...]

PURGE logging-component parameter [...]

Logging Components

KNOWN LOGGING LOGGING FILELOGGING CONSOLE LOGGING MONITOR

Logging Components

KNOWN LOGGINGRemoves from the database the parameters for all known logging.

LOGGING CONSOLERemoves from the database the parameters for logging to the console.

LOGGING FILERe m ove s f rom t h e d a t a b a se t h e p a ra m e t ers f o r log g in g t o a fi le.

LOGGING MONITORRemoves from the database the parameters for logging to a monitor program.

Command Parameters

EVENTS event-listKNOWN EVENTSRemoves from the database an event class and type or all event classes and types.

You can associate any of the following source parameters when you specify the

EVENTS parameter.

C I R C U I T ci rcu it -i d I d en t ifi e s t h e ci rcu it t o w h i ch t h e ev en t s a p pl y.

Events will not be logged for th is circuit .

L IN E lin e-id I den tifi es t he lin e t o w h ich t he ev en ts a pply. E ven ts

will not be logged for this source.

N OD E n od e-id I den tifi es t he n od e t o w h ich t he even ts a pply.Events will not be logged for this source.

317


46/252


S I NK I den t ifi es t h e n ode w her e t h e even t logger r un s t o

log t he events. There ar e tw o possibilit ies:

E XE C U TO R I den tifi es t he loca l n od e

N OD E n od e-i d I d en t ifi e s t h e n od e a t w h i ch

events ar e being logged

Only events being logged t o this node are r emoved

f rom t h e d a t a b a se . I f t h is p a ra m e t e r is om it t e d , t h e

local node is a ssumed to be t he sink n ode affected.

Examples

1. NCP>CLEAR LOGGING FILE EVENTS 2.*

This comma nd clears logging t o the logging fi le for all class 2 events.

2. NCP>CLEAR LOGGING CONSOLE KNOWN EVENTS LINE SVA-1

This command clears logging t o the console for all known events currently

being logged for line SVA1, an Ethernet line.

318


47/252

CLEAR/PURGE LOGGING NAME

CLEAR/PURGE LOGGING NAME

The CLEAR LOGGING NAME command removes the name of the logging sink

f rom t h e vo la t i le d a t a b a se . Th e PU RG E L OG G I N G N AM E com m a n d re m oves t h e

n a m e of t h e l

DECnet forOpenVMSNetwork

Documents

Transcript of DECnet forOpenVMSNetwork