After you enter a command, the system responds with a display
that includes a summary of the command you entered, the UID
of the entity (if enabled) referred to in the command, and a
timestamp showing when the output was gathered or the command
executed. With some commands (for example, show), the output
also includes a display of certain values.
Some of the timestamps displayed during ncl show commands are
returned with a value of undefined for some entities. This
indicates that the condition that causes the attribute to be
timestamped has not occurred yet.
The following is an example of a typical show display:
ncl>show session control application fal all chara
Node 0 Session Control Application fal
AT 1994-02-21-14:54:01.609-05:00I0.137
Characteristics
Addresses
{ number=17 =
}
Incoming Proxy = True
Node Synonym = False
Image Name = /usr/etc/fal
User Name = guest
Incoming OSI TSEL =''H
Data Abstraction = Message
Accept Mode = Deferred
Programming Interface = Phase IV
Maximum Instances = 0
Allow DECnet Internet Gateway Access = True
Exception messages
If a command does not complete successfully, you can get one or
more exception or error messages. There are three categories of
error displays:
o Errors caused by incorrect command syntax. In these errors,
NCL issues the error message immediately and does not send the
command to the entity itself. For example:
# ncl show tree all
SYNTAX ERROR: No match was found for this string.
show tree all
____ ^
o Validation errors, in which NCL accepts the command syntax
as valid, but subsequently returns an error message when the
command violates a constraint or rule. For example:
# ncl set routing probe rate = 0
RANGE ERROR: The minimum value for this attribute is 1.
set routing probe range = 0
_________________________ ^
In this case, the value 0 was outside the allowable range of
values for this attribute. NCL detected this after it had parsed
the command, but before it had issued the command to the entity.
o Errors returned from the remote entity's agent. In these
errors, NCL was able to interpret the command, but was unable
to perform it for some reason. For example:
Node 0 CSMA-CD
AT 1994-10-06-15:35:14.069-04:00I0.301
FAILED IN DIRECTIVE: Create
DUE TO: Error specific to this entity's class
REASON: Already Exists
Description: Already Exists
A response returned from the remote agent will be displayed
with an AT time stamp. See Appendix A of the DECnet-Plus Network
Control Language Reference for more information on responses.
Adjusting the Display Format
Use the following local commands to adjust the display format.
To define how far over the values can be indented (default=34),
use the commands:
ncl> set ncl name display width = 50
ncl> show ncl name display width
To control whether or not dots are filled in between the attribute
name and its value (for example, state ..... = On), use the
commands:
ncl> enable ncl dots
ncl> disable ncl dots
To control whether counters are displayed left justified or right
justified, use the commands:
ncl> set ncl counter justification = left
ncl> set ncl counter justification = right
To determine if backtranslation will be done or not, use the
commands:
ncl> enable ncl backtranslation
ncl> disable ncl backtranslation
The page width is used to intelligently wrap error messages and to
decide if the snapshot display will require 1 line or 2 lines per
counter. Normally, NCL tracks the page width automatically. To
override the value if necessary, use the commands:
ncl> set ncl page width = 50
ncl> show ncl page width
When NCL is processing an NCL script, use the following commands
to determine if each command should be echoed before it is executed:
ncl> enable ncl command echo
ncl> disable ncl command echo