[Digital logo]
[HR]

DECnet-Plus
Network Control Language Reference


Previous | Contents

Arguments:
reason Specifies which characteristics have not been specified.
dte class The DTE class characteristic has not been specified.
filters The filters characteristic has not been specified.

For delete:

has active connections

One or more active connections exist on this client.

27.3 x25 relay pvc

An x25 relay pvc entity provides a set of default values to be used to establish a connection to a client over a permanent virtual circuit (PVC).
add [node node-id] x25 relay pvc pvc-name rights identifiers simple-name
create [node node-id] x25 relay pvc pvc-name type string
delete [node node-id] x25 relay pvc pvc-name
disable [node node-id] x25 relay pvc pvc-name
enable [node node-id] x25 relay pvc pvc-name
remove [node node-id] x25 relay pvc pvc-name rights identifiers simple-name
set [node node-id] x25 relay pvc pvc-name {local pvc pvc-name | remote dte class simple-name (connector nodes only) | relayed pvc relayed-pvc-name | retry limit integer (connector nodes only) | retry timer integer (connector nodes only) | rights identifiers simple-name }
show [node node-id] x25 relay pvc pvc-name [all [attributes] | all characteristics | all counters | all identifiers | all status ]

27.3.1 Arguments

type string

Type of PVC, either local or remote.

27.3.2 Characteristic Attributes

local PVC

Default: No PVC name Value: Simple-name
Name of the PVC entity that represents the local end of the connection.

remote dte class

Default: No dte class Value: Simple-name
DTE class to be used when setting up the remote end of the connection. It is only specified if the relayed PVC does not reside on the local system. This attribute is only applicable to connector nodes, and will not be visible in other implementations.

relayed PVC

Default: No PVC name Value: Simple-name
Name of the PVC entity that represents the relayed end of the connection.

retry limit

Default: 10 Value: 0--65535
Number of attempts that will be made to set up the PVC connection following the failure of an enable command. This attribute is only applicable to connector nodes, and will not be visible in other implementations.

retry timer

Default: 60 Value: 1--65535
Interval, in seconds, between retries. This attribute is only applicable to connector nodes, and will not be visible in other implementations.

rights identifiers

Default: No rights identifiers Value: Set of simple-names
Rights identifiers possessed by this entity. These rights are used to access the local PVC and relayed PVC if it resides on the local system.

27.3.3 Counter Attributes

connections made

Number of successful connections made by this entity.

creation time

Time at which this entity was created.

times connections lost

Number of times that a successfully established PVC connection has been abnormally terminated.

times retry limit exceeded

Number of times that the retry limit has been reached when trying to set up a PVC connection.

27.3.4 Identifier Attributes

name

Simple name assigned to the PVC when it is created.

27.3.5 Status Attribute

state

State of the x25 relay pvc entity.
failed The retry mechanism has failed to set up the connection.
off The PVC is disabled.
on The PVC is enabled.
retrying The Retry timer is running.

uid

Entity's unique identifier, which is generated when the entity is created.

27.3.6 Event Messages

connection lost

Generated when a successfully established PVC connection fails for some other reason than being disabled.

Argument:
reason Error returned by the X.25 Access module when notifying the X.25 Relay module of the disconnection.

retry limit exceeded

Generated when an attempt to set up a PVC connection fails.

Arguments:
local pvc status State of the local end of the PVC connection.
relayed pvc status State of the relayed end of the PVC connection.

27.3.7 Exceptions

For enable:

insufficient information

One or more characteristics have not been specified.

Arguments:
reason Specifies which characteristics have not been specified.
local pvc The local pvc characteristic has not been specified.
relayed pvc The relayed pvc characteristic has not been specified.
remote dte class The remote dte class characteristic has not been specified.

dte class not type remote

The DTE class specified is not of type remote (connector nodes only).

pvc error

An error has occurred attempting to open either the local or the relayed PVC.

Arguments:
reason Specifies the reason for failing to open the local or relayed pvcs.
local pvc in use The specified local pvc already has a client.
relayed pvc in use The specified relayed pvc already has a client.
local pvc security block Attempt to open the local pvc failed for security reasons.
relayed pvc security block Attempt to open the relayed pvc failed for security reasons.
no such local pvc The specified local pvc does not exist.
no such relayed pvc The specified relayed pvc does not exist.


Chapter 28
X.25 Server Module

This chapter describes all the commands you can use to manage the entities that constitute the X.25 Server module. The X.25 Server module resides in the Application layer of the Digital Network Architecture (DNA). This module interfaces with the X.25 Access module to listen for incoming calls for X.25 Client systems, and to make outgoing calls on behalf of X.25 clients.

Figure 28-1 shows the hierarchical relationship of the entities that constitute the X.25 Server module.

Figure 28-1 Hierarchy of X.25 Server Module Entities



28.1 x25 server

The x25 server entity represents the X.25 server that runs on a gateway system. The X.25 server serves X.25 clients on accessing systems, providing X.25 access to systems that do not have a direct connection to a PSDN.
create [node node-id] x25 server {incoming session template simple-name | maximum session connections number ]
delete [node node-id] x25 server
disable [node node-id] x25 server
enable [node node-id] x25 server
show [node node-id] x25 server [all [attributes] | all characteristics | all counters | all status ] )

28.1.1 Arguments

incoming session template (Digital UNIX)

Optional argument that specifies the Session Control template used to filter incoming Session Control connection requests.

maximum session connections

Optional argument that specifies the number of incoming and outgoing connections that may be supported concurrently.

28.1.2 Characteristic Attributes

incoming session template (Digital UNIX)

The Session Control template specified on an OpenIncoming invocation at the end user Session Control interface. You cannot modify this characteristic.

maximum

session connections

Default: 512 Value: [1..65535]
Maximum number of Session Control connections with clients that the entity can support. This includes both incoming and outgoing connections. You cannot modify this characteristic.

version

Default: Current version number
Version number of the X.25 Gateway Access Protocol (GAP) to which the implementation conforms. You cannot modify this characteristic.

28.1.3 Counter Attributes

connection attempts failed

Number of Session Control connection requests to clients that have failed, due either to exceeding the maximum number of connections or rejection by X.25 clients in accessing systems.

creation time

Time at which this entity was created.

times session control unavailable

Number of times the Session Control unavailable event was raised.

28.1.4 Status Attributes

active inbound session connections

Current number of active inbound Session Control connections with clients.

active outbound session connections

Current number of active outbound Session Control connections with clients.

state

Current state of the x25 server entity.
off The x25 server entity is disabled.
on The x25 server entity is enabled.

uid

Specifies the entity's unique identifier, which is generated when the entity is created.

28.1.5 Event Messages

client connect failed

Generated when the X.25 server is unable to make a connection to an X.25 client (or to any of an alternative set of X.25 clients if the service nodes characteristic is supported for the x25 server client entity).

Arguments:
client Full name of the x25 server client entity.
nodes The node or set of nodes associated with the x25 server client entity.
application Application type in the client entity.

session control unavailable

Generated when the X.25 server detects the absence of the Session Control module or when it detects that the state of Session Control is not set to on.

Arguments:
module extent true or false. Set to false when the X.25 server cannot detect the presence of Session Control. When set to false, the value of the session control port state argument is always null.
session control port state null, off, shut, or restricted. Reflects the state returned by the port state end user interface when the value of the module extent argument is set true.

28.1.6 Exceptions

For enable:

session control no resources

The Session Control module does not have sufficient resources to handle the call.

session control unavailable

The Session Control module either does not exist or is disabled.

28.2 x25 server client

An x25 server client entity provides a set of default values to be used to establish a Session Control connection with an X.25 client when an incoming call arrives for that client. You should create an x25 server client entity for each X.25 client with which the gateway system is associated.
add [node node-id] x25 server client simple-name filters [set]
create [node node-id] x25 server client simple-name
delete [node node-id] x25 server client simple-name
disable [node node-id] x25 server client simple-name
enable [node node-id] x25 server client simple-name
remove [node node-id] x25 server client simple-name filters [set]
set [node node-id] x25 server client simple-name {account string (OpenVMS) | application end-user-specification | destination fullname (OpenVMS) | filters [set] | node fullname | outgoing session template simple-name (OpenVMS) | password string | service nodes [set] | user string }
show [node node-id] x25 server client simple-name [all [attributes] | all characteristics | all identifiers | all status ]

28.2.1 Characteristic Attributes

account (OpenVMS)

Default: No service/account data Value: String
Default service or account data to be used when connecting to the system hosting the X.25 client.

application

Default: 36 Value: End-user-specification
Address information used by the destination Session Control module to select the X.25 client that will receive the connection request.

destination (OpenVMS)

Default: No client name Value: Fullname
Name of the X.25 client to which a connection is to be made when delivering a "filtered" call.

filters

Default: No default Value: Set of simple-names
Set of filters to be used by the server to filter calls for this X.25 client. Each name is the name of an x25 access filter entity.

node

Default: No node name Value: Fullname
Name of the node that hosts the X.25 client to which connection is to be made. This characteristic is supported only if the service nodes characteristic is not supported.

outgoing session template (OpenVMS)

Default: Default template Value: Simple-name
Transport template to be used by the X.25 server to set up a Session Control connection to the X.25 client. The name is the name of an osi transport template entity.

password

Default: No password Value: String
Default password to be used for verification when connecting to the system that hosts the X.25 client. You cannot display this characteristic with the show command.

service nodes

Default: Empty set Value: Set of candidate records
Set of nodes that host the x25 client entities to which connections can be made.

user

Default: No user id Value: String
Default user identification to be used in access verification when connecting to the system that hosts the X.25 client.

28.2.2 Identifier Attributes

name

Simple name assigned to the client when it is created.

28.2.3 Status Attributes

state

Status of the x25 server client entity.
off The x25 server client entity is disabled.
on The x25 server client entity is enabled.

28.2.4 Exception Messages

For enable:

filter in error

One or more of the specified filters does not exist, or is in use.

filter in use

One or more of the specified filters is already being used by another client.

insufficient information

Before enabling the client you must ensure that the following characteristics have been given values of: application, filters, nodes.

28.3 x25 server security nodes

An x25 server security nodes entity defines the set of rights identifiers associated with calls issued by the X.25 Server module (on behalf of the X.25 Client module at an accessing system) to the X.25 Access module at the gateway system. These rights identifiers are used when making access control checks on the DTE class specified when a call is made.
add [node node-id] x25 server security nodes simple-name {nodes [set] | rights identifiers [set] }
create [node node-id] x25 server security nodes simple-name
delete [node node-id] x25 server security nodes simple-name
remove [node node-id] x25 server security nodes simple-name {nodes [set] | rights identifiers [set] }
set [node node-id] x25 server security nodes simple-name {nodes [set] | rights identifiers [set] }
show [node node-id] x25 server security nodes simple-name [all [attributes] | all characteristics | all counters | all identifiers | all status ]

28.3.1 Characteristic Attributes

nodes

Default: No node names Value: Set of full names
DNS full names of accessing systems, or the wildcard full name.

rights identifiers

Default: No rights identifiers Value: Set of simple-names
Set of rights identifiers to be associated with the set of nodes named in the nodes characteristic for purposes of access control to DTE classes at the gateway node.

28.3.2 Counter Attributes

creation time

Time at which this entity was created.

outgoing calls blocked

Number of times that an attempt to establish a call or use a PVC has failed for security reasons.

28.3.3 Identifier Attributes

name

Simple name assigned to the security node when it is created.

28.3.4 Status Attributes

uid

Entity's unique identifier, which is generated when the entity is created.


Appendix A
Interpreting NCL Error Messages

This appendix offers general guidelines for interpreting any NCL error messages you may receive.

A.1 How Errors Are Reported

NCL uses error messages to report and describe errors that occur in both the user interface and the entity.

For some errors, only one message is returned, even if a group of entities was targeted by the directive. The requested entity name is returned as part of the exception if specified. For other errors, if the entities determine that none of the target entities can perform the directive, the entity may return a single exception reply containing the requested entity name. The entity may return an exception or response for each target entity. In this case, the entity name returned is that of the entity performing the directive. The entity may stop forwarding the directive to further entities when an error occurs, providing it responds for each entity performing the directive.

A.2 Standard Format for NCL Error Messages

This section describes the standard format for all NCL error messages.

For example:

# ncl set routing phaseiv prefix = 49:: (1)
Node 0 Routing  (2)
AT 1995-09-08-13:28:43.800-04:00I0.178 (3)
 
FAILED IN DIRECTIVE: Set (4)
DUE TO: Attribute Could Not Be Modified Due To Constraint (5)
 
PhaseIV Prefix = /49 (6)
State = On 
  1. The NCL command in this example attempts to set the current node's routing Phase IV prefix to 49.
  2. This field includes the entity instance, which describes the specific entity of the directive. In this example, the entity was the Routing layer of the current node.
  3. Each message includes a timestamp. The timestamp is taken by the entity as soon as possible after the error occurs. Often this field includes the note, "no timestamp from agent," indicating that the entity did not supply the timestamp.
  4. The FAILED IN DIRECTIVE field indicates the directive (or command verb) that caused the error. In this example, the change could not be set.
  5. The DUE TO field lists the key phrase of the error message. When you look through specific error messages, look for this key phrase. In this example, "Attribute Could Not Be Modified Due To Constraint" indicates that the command somehow violated a constraint built into the command.
    Certain error messages also contain a secondary DUE TO line pertaining to a particular attribute (or qualifier).
  6. This describes the reason for the error. In this example, you cannot set the Phase IV prefix to 49 because the Routing layer is enabled (State = On). You must disable the Routing layer before attempting to change the Phase IV prefix.

A.3 NCL Error Messages for Digital UNIX

The following is an alphabetized list of the NCL error messages. The bolded key phrase appears in the DUE TO field of the error message display.

A.4 NCL Error Messages for OpenVMS

This section describes NCL error messages that can be returned on a command. Command-specific exception messages are described with individual command descriptions.

ACCESSSTRINGTOOLLONG, access control string too long

Explanation: The username/password/account string is longer than 255 characters.
User Action: Use shorter username/password/account string.
ALLOCFAILURE, memory allocation failure

Explanation: NCL could not allocate the required memory.
User Action: Increase the users' quotas or the values for the system generation parameters to allow a larger virtual image. The most likely parameters are BYTLIM, VIRTUALPAGENT, or MAXBUF.
AMBIGUOUS, ambiguous command

Explanation: A keyword in the command is not specified with enough characters to distinguish it from another keyword acceptable in this context. The offending keyword is displayed between backslashes.
User Action: Reenter the command using enough characters to uniquely identify all keywords.
BADNCLENVIRONMENT, syntax error interpreting the NCL$ENVIRONMENT variable

Explanation: The NCL$ENVIRONMENT logical name could not be parsed because of a syntax error in its translation.
User Action: Redefine the NCL$ENVIRONMENT logical name to correct the syntax.
BADPARSERFIELD, unknown datatype or corrupt parse tables

Explanation: The parser encountered corrupted parse tables (NCL$GLOBALSECTION) or an unknown data type.
User Action: (1) If the NCL$GLOBALSECTION file is fragmented (DUMP/HEADER/BLOCK=COUNT:0), try making it contiguous (COPY/CONTIG). (2) Contact your Digital Support representative.
BADVALUE, bad command argument value

Explanation: The command contains an illegal argument value. The illegal value is displayed between backslashes.
User Action: Reenter the command using a legal argument value (if arguments are permitted).
BRACKETNESTING, brackets nested too deeply

Explanation: The command contains too many levels of bracket nesting. The offending bracketed data is displayed between backslashes.
User Action: Reenter the command using fewer nested brackets.
CMLINPUTOOSMALL, CML input itemlist too small

Explanation: The CML input itemlist buffer that is passed to the internal CML interface is too small.
User Action: Contact your Digital Support representative.
CMLRCVFAILED, error receiving command request

Explanation: The call to CML$ReceiveW failed.
User Action: Contact your Digital Support representative.
CMLSENDFAILED, error sending command request

Explanation: The call to CML$SendW failed.
User Action: See Secondary Status for the reason for the failure.
CMLTEMPLATETOOSMALL, CML template itemlist too small

Explanation: The CML template itemlist buffer that is passed to the internal CML interface is too small.
User Action: Contact your Digital Support representative.
DICTIONARYCORRUPT, NCL data dictionary is corrupt

Explanation: The NCL data dictionary returned corrupt data.
User Action: Save NCL$GLOBALSECTION.DAT file. Restore the file and contact your Digital Support representative with the bad file and a description of what was done.
DISPLAYBUFFEROVERFLOW, display data too large for buffers

Explanation: The display data returned by CML is too large for NCL's display buffer.
User Action: Contact your Digital Support representative.
DTETOOLONG, DTE address string is longer than 15 characters

Explanation: The DTE address contains more than 15 characters. The offending address is displayed between backslashes.
User Action: Reenter the command specifying no more than 15 characters for the DTE address.
DUPLICATEARGUMENT, duplicate arguments not allowed

Explanation: The command contains duplicate arguments. The duplicated argument is displayed in parentheses.
User Action: Reenter the command specifying each argument only once.
FULLNAMETOOLONG, FullName string longer than 400 characters

Explanation: The full name string is longer than the architected maximum length of 400 characters. The offending full name is displayed between backslashes.
User Action: Reenter the command specifying a full name of 400 or fewer characters.
ILLEGALCHARACTER, illegal character in input command

Explanation: The command line contains an illegal character. The illegal character is displayed between backslashes.
User Action: Reenter the command line using only legal characters.
IMAGETOOLONG, end user specification image field is too long

Explanation: The image field in the end user specification is too long. The offending data is displayed between backslashes.
User Action: Reenter the command specifying data that does not exceed the allowable limits. Allowable lengths for fields in the end user specification are:
NUMBER = n 0 <= n <= 255
NAME = "string" string <= 16 characters
UIC = [g,u]"string" string <= 12 characters
FULLNAME = fullname fullname <= 400 characters
INVALIDABSTIME, invalid absolute time, use DDDD-HH:MM:SS I SSS

Explanation: Absolute time format is invalid.
User Action: Reenter the time in correct format.
INVALIDACCESSCONTROL, invalid syntax for access control information

Explanation: The access control information is formatted incorrectly. The offending data is displayed between backslashes.
User Action: Reenter the command specifying the access control information in the correct format.
INVALIDADDRESSPREFIX, invalid syntax for an address prefix string

Explanation: The address prefix string contains illegal characters or invalid syntax. The offending data is displayed between backslashes.
User Action: Reenter the command specifying a correct address prefix string.
INVALIDAREAADDRESS, invalid syntax for an area address

Explanation: The area address string contains illegal characters or is incorrectly formatted. The offending data is displayed between backslashes.
User Action: Reenter the command specifying a correct area address.
INVALIDCMLDATA, return data corrupt or incorrectly encoded

Explanation: The data returned by CML is incorrectly formatted or corrupt.
User Action: Contact your Digital Support representative.
INVALIDCOMMAND, unrecognized command

Explanation: NCL does not recognize the command. The unrecognized command is displayed between backslashes.
User Action: Correct the command and reenter it.
INVALIDDNSTS, invalid syntax for a name server timestamp

Explanation: The DECdns timestamp string is incorrectly formatted.
User Action: Reenter in correct format.
INVALIDFULLNAME, invalid syntax for FullName string

Explanation: A full name string is incorrectly formatted. The offending full name is displayed between backslashes.
User Action: Reenter the command specifying the full name string correctly.
INVALIDHEXSTRING, invalid syntax for a hex string

Explanation: A hexadecimal string contains illegal characters. The offending data is displayed between backslashes.
User Action: Reenter the command specifying only legal characters for the hexadecimal string.
INVALIDIPADDRESS, invalid syntax for an IP address

Explanation: The IP address contains illegal characters.
User Action: Reenter with correct syntax (length was equal to zero or contained illegal characters). Valid characters are 0 to 9 and the period (.).
INVALIDLANADDRESS, invalid syntax for LAN Address

Explanation: A LAN address contains illegal characters. The offending data is displayed between backslashes.
User Action: Reenter the command specifying a legal LAN address.
INVALIDLATIN1STRING, invalid characters in Latin1 String

Explanation: A Latin1 string contains invalid characters (usually control characters). The offending data is displayed between backslashes.
User Action: Reenter the command specifying only valid characters in the Latin1 string.
INVALIDNET, invalid syntax for a Network Entity Title

Explanation: The network entity title (NET) string contains illegal characters or is formatted incorrectly. The offending network entity title is displayed between backslashes.
User Action: Reenter the command specifying a legal network entity title string.
INVALIDNSAP, invalid syntax for an NSAP Address string

Explanation: The NSAP address string contains illegal characters or is formatted incorrectly. The offending data is displayed between backslashes.
User Action: Reenter the command specifying a legal NSAP address.
INVALIDOCTETSTRING, invalid syntax for octet or octet string

Explanation: An octet does not contain two hexadecimal digits. The offending data is displayed between backslashes.
User Action: Reenter the command specifying two hexadecimal digits for each octet.
INVALIDPHASE4ADDR, invalid syntax for a Phase IV node address

Explanation: A Phase IV node address has been specified incorrectly. The invalid address is displayed between backslashes.
User Action: Reenter the command specifying a correct Phase IV node address.
INVALIDPHASE4NAME, invalid syntax for a Phase IV node name

Explanation: A Phase IV node-name string contains illegal characters, does not contain at least one alpha character, or is too long. The offending data is displayed between backslashes.
User Action: Reenter the command specifying a legal Phase IV node-name string.
INVALIDPID, invalid syntax for a process identifier

Explanation: The process identifier string does not look like a hexadecimal PID or a process name string. The offending process identifier is displayed between backslashes.
User Action: Reenter the command specifying a valid process identifier.
INVALIDRELOP, invalid syntax for an entity filter relational operator

Explanation: The relational operator in the entity filter is invalid.
User Action: Reenter with valid operator. Valid operators are =, <>, <, <=, >, and >=.
INVALIDSIMPLENAME, invalid syntax for SimpleName string

Explanation: A simple name string is incorrectly formatted. The offending data is displayed between backslashes.
User Action: Reenter the command specifying a valid simple-name string.
INVALIDTIME, invalid syntax for a date/time

Explanation: The binary/character absolute/relative time contains illegal characters or bad syntax.
User Action: Reenter correct absolute or relative time.
INVALIDUID, invalid syntax for an unique identifier

Explanation: The unique identifier contains illegal characters or bad syntax.
User Action: Reenter hexadecimal string with "-" separators.
INVALIDVERSION, invalid syntax for a version number

Explanation: The version number contains illegal characters. The offending data is displayed between backslashes.
User Action: Reenter the command specifying a valid version number.
MISSINGARGUMENT, missing required command arguments

Explanation: The command line was terminated before all required command arguments were specified.
User Action: Reenter the command including all of the required arguments.
MISSINGEDITNUMBER, missing edit number for version number with edit

Explanation: The version number with edit is missing the edit number. The offending data is displayed between backslashes.
User Action: Reenter the command specifying the required edit number.
MISSINGLEFTBKT, missing left bracket

Explanation: The left bracket character is missing. The offending string is displayed between backslashes.
User Action: Reenter the command including the left bracket character.
MISSINGRIGHTBKT, missing right bracket

Explanation: The right bracket character is missing. The offending string is displayed between backslashes.
User Action: Reenter the command including the right bracket character.
NOCONNECTION, cannot establish CMIP connection to remote node

Explanation: The call to CML$InitializeW failed.
User Action: See Secondary Status for the reason for the failure.
NODENAMETOOLONG, node name and/or access control information too long

Explanation: The node name and access control string are too long for NCL's parsed data buffer. The offending data is displayed between backslashes.
User Action: Reenter the command specifying data that does not exceed the allowable limits.
NOGLOBALENTITY, no global NODE entity found in the data dictionary

Explanation: The NCL$GLOBALSECTION.DAT file does not have any entities in it.
User Action: Contact your Digital Support representative.
NOGLOBALSECTION, cannot open and map the parse table global section file

Explanation: The NCL$GLOBALSECTION.DAT file could not be opened.
User Action: See Secondary Status for the reason for the failure.
NOLINKID, no LinkID returned by CML

Explanation: The call to CML$Initialize returned successfully, but did not return a LinkID value.
User Action: Contact your Digital Support representative.
NOSUCHPROCESS, no such process name or insufficient privilege

Explanation: Either the specified process does not exist or you have insufficient privileges to use it. The process name is displayed between backslashes.
User Action: Reenter the command specifying a different process name or retry the command from a privileged account.
PHASE4AREA, Phase IV area number is not between 1 and 63

Explanation: The Phase IV node address contains an area number outside the legal range. The illegal data is displayed between backslashes.
User Action: Reenter the command specifying an area number within the range 1 through 63.
PHASE4NODE, Phase IV node number is not between 1 and 1023

Explanation: The Phase IV node address contains a node number outside the legal range. The illegal data is displayed between backslashes.
User Action: Reenter the command specifying a node number within the range 1 through 1023.
PROMPTNOTFOUND, prompt string not found in message file, using default

Explanation: The initial or continuation prompt string was not found in the NCL message file. The default prompt is being used.
User Action: Contact your Digital Support representative.
REQUESTFAILED, Command failed due to: 'reason code'

Explanation: The CMIP request failed for the reason specified.
User Action: Correct the problem stated by the reason code and retry the command.
SCRIPTNESTED, too many levels of nested NCL scripts

Explanation: Nested NCL scripts are not allowed.
User Action: Nest the scripts no more then 10 levels.
SCRIPTNOTFOUND, Cannot open script file, check spelling and/or file specification.

Explanation: Cannot open the script file for input.
User Action: See the Secondary Status for the reason.
SIMPLENAMETOOLONG, SimpleName string longer than 255 characters

Explanation: The simple name string is longer than the architected maximum length of 255 characters. The offending string is displayed between backslashes.
User Action: Reenter the command specifying a simple name of 255 characters or fewer.
TOKENTOOLONG, command line item too long

Explanation: A command line token is too long to fit into the token buffer. The offending item is displayed between backslashes.
User Action: Reenter the command specifying a shorter command line token.
TSELTOOLONG, transport selector octet string is longer than 32 octets

Explanation: The transport selector string exceeds the 32-octet maximum. The illegal string is displayed between backslashes.
User Action: Reenter the command specifying a transport selector string that does not exceed the 32-octet maximum.
UNEXPECTEDRESPONSE, response function from CML does not match requested function

Explanation: CML returned a response with a function code that does not match that of the request.
User Action: Contact your Digital Support representative.
UNKNOWNAFI, unknown authority and format identifier in NSAP

Explanation: The NSAP or address-prefix string contains an illegal or unknown authority and format identifier (AFI) value. The offending data is displayed between backslashes.
User Action: Reenter the command specifying a valid AFI value.
VERSIONMISMATCH, incompatible NCL parse table (Version !UL), expected Version !UL

Explanation: The NCL parse table section (NCL$GlobalSection.DAT) version number did not match that which NCL was built for, and this version is not compatible.
User Action: Resinstall the kit with the proper NCL.EXE and NCL$GlobalSection.DAT.
WRONGBRACKET, mismatched right bracket

Explanation: The right bracket character does not match the corresponding left bracket character. The offending string is displayed between backslashes.
User Action: Reenter the command using matching bracket characters.

A.5 Common NCL Exception Messages

Access Denied

Explanation: You are not authorized to perform the specified command.
Access Violation

Explanation: You have performed an illegal operation for the specified command.
Already Exists

Explanation: You have tried to create an entity that already exist.
Constraint Violation

Explanation: The setting of one or more attributes violates a constraint defined for the entity.
Create With Wildcard

Explanation: You have used a wildcard to create an entity name that is not supported.
Directive Not Supported

Explanation: You have entered an NCL command that is not supported for this entity.
Duplicate Argument

Explanation: You have entered an NCL command with two or more of the same argument.
Duplicate Attribute

Explanation: You have entered an NCL command with two or more of the same attribute.
Entity Class Not Supported

Explanation: You have specified an entity class that is not supported or has not been created.
Entity Is In The Wrong State

Explanation: Due to the state of the entity, it would not accept one of the attribute values in the command.
Filter Invalid For Action

Explanation: You have specified a filter that is invalid for the specified command.
Filter Specified With Wildcarded Class

Explanation: You have specified a filter by using a wildcard. It is an invalid use of a wildcard.
Get List Error

Explanation: An error was detected while getting one or more of the requested attributes.
Has Children

Explanation: You have attempted action on a parent entity that requires you to delete the children entities first.
Invalid Argument Value

Explanation: You have specified one or more arguments with values outside the permitted range.
Invalid Attribute Value

Explanation: You have specified one or more attributes with values outside the permitted range.
Invalid Directive

Explanation: You have attempted to issue an unsupported command.
Invalid Entity Name Format

Explanation: You have specified an illegal entity name.
Invalid Filter

Explanation: You have specifie a filter that is invalid for one or more of the entities named.
Invalid Invocation Identifier

Explanation: You have specified an unsupported identifier.
Invalid Item List Format

Explanation: You have specified an illegal item list format.
Invalid Operator

Explanation: You have specified an unsupported operator.
Invalid Use Of Wildcards

Explanation: You have specified wildcards in an entity name where this is not supported.
No Resources Available

Explanation: The entity could not complete the requested operation due to lack of resources. Typically, this refers to memory or if a resource like maximum links has been exceeded. If you receive this message on startup, try raising the PQL_MBYTLM SYSGEN parameter.
No Responses Ready

Explanation: The entity could not complete the requested operation because the entity received no response.
No Such Action Verb

Explanation: The specified action verb is not supported by the entity.
No Such Argument

Explanation: You have specified one or more arguments that are not supported by the entity for the specified action.
No Such Attribute ID

Explanation: You have specified one or more attribute IDs that are not supported by the entity for the specified action.
No Such Entity

Explanation: The entity instance specified in the command does not exist.
No Such Object Instance

Explanation: The object instance specified in the command does not exist.
Not a Universal Attribute Group

Explanation: You have specified an unsupported attribute group.
Operation Failure

Explanation: You have specified an illegal operation.
Operation Not Supported

Explanation: You have specified an operation that is not supported by NCL.
Overflow While Filling Buffer

Explanation: The specified operation has resulted in a buffer overrun. Try increasing MAXBUF or the process quota.
Process Failure

Explanation: The entity raised an action-specific exception while attempting the specified action.
Read-only Attribute

Explanation: You have specified a non-read operation on a read-only attribute.
Requested Attribute Is Not Active

Explanation: You have specified action on an attribute that is not enabled.
Required Argument Omitted

Explanation: You have omitted one or more required arguments in the specified command.
Set List Error

Explanation: An error was detected while setting one or more of the requested attributes or a set value is improperly specified. For further information, refer to Section 1.4.3 in the Introduction of this manual.
Unknown CMIP Error Status

Explanation: The remote system is running a CMIP protocol that is not compatible with NCL, and/or you have mismatched versions of NCL, CML, or EMAA, or you are using an older version of DECnet-Plus to manage a new one.
Unknown EMAA Error Status

Explanation: The remote system is running an EMAA that is not supported by NCL, and/or you have mismatched versions of NCL, CML, or EMAA, or you are using an older version of DECnet-Plus to manage a new one.
Unknown Response Failure Code

Explanation: The operation has produced an error code that NCL does not support, and/or you have mismatched versions of NCL, CML, or EMAA, or you are using an older version of DECnet-Plus to manage a new one.
Write-only Attribute

Explanation: You have specified a non-write operation on a write-only attribute.
Wrong State

Explanation: The entity is in a state that is illegal for the attempted operation. (For specific information on legal states, see the command description for the specified entity.)


Appendix B
Common Data Types for NCL

B.1 Overview of Data Types

This appendix defines each supported NCL data type. The definitions include the values allowed for the type, any relations defined on each type (including equality and ordering relation), and any wildcard symbols that are allowed. Before going into the details of each data type, it is helpful to understand the ideas and terminology underlying the definitions.

B.1.1 What Is a Data Type?

The term data type is used throughout the computer industry. Commonly, a data type represents a set of values to which any given value must belong. This set may be represented either explicitly, by enumeration, or implicitly, by rules. For example, the data type boolean may be represented explicitly as the set (true or false). The data type latin1string, however, has an infinite number of possible values and must be described as a set of rules. The rules consist of restrictions on characters used and methods of quotation.


Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  NCL_PROFILE_034.HTML
  OSSG Documentation
   2-DEC-1996 12:48:59.22

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal