Cisco CNS Network Registrar CLI Reference Guide, 5.0
Appendix: Codes and Formats

Table of Contents

Codes and Formats

Codes and Formats

This appendix provides information about the status codes, and the import and export formats.

Status Returns

Network Registrar returns status information on the first line of information written to the standard output stream. If there is more data, Network Registrar displays this information on additional lines.

The first line of the status is similar to a status line from an FTP server. The first token on the line is the status code. It is an integer number intended to be machine-readable; the remainder of the line is text that is intended to be human-readable.

The status codes are all three-digit integer decimal numbers. The first digit corresponds to the values described in Table A-1.


Table A-1: Status Information
Value Description

1

Normal return

2

Informational (warning)

3 or 4

Error

5

Fatal Error



For anything other than an error, Network Registrar assumes that the requested operation was completed; however, some warning messages signal a condition that must be corrected. Unless a fatal error occurs, the command line interface will keep running in interactive mode. Fatal errors imply that something serious happened and that you must restart the Network Registrar command line processor.

Import and Export File Formats

This section describes the import leases and export leases file format.

The syntax is:

field1|field2|field3|

The fields are listed next. If, in the import file, you chose not to supply the information for an optional field, you need to use delimiters ( | ) so that the number of fields is still 12. For example, type xyz|abc||123.

  • MAC address in xx:xx:xx::xx format (required)

  • MAC address type (required)

  • MAC address length (required)

  • IP address in dotted decimal format, a.b.c.d (required)

  • Start of lease time (GMT) (optional)

  • Lease expiration time (GMT) (optional)

  • Allowable extension time (GMT)(optional)

  • Last transaction time (GMT) (optional)

  • IP address of the DHCP server (optional)

  • Host name (without domain) (optional)

  • Domain name (optional)

  • Client ID (optional)


    Note   For all the time fields, you can use either the number of seconds since 1970, or day, month, date, time, year format (Mon Apr 13 16:35:48 1998).

Use-Macaddress Token

The format for this name is:

<char><type>-<length>-<octet1>-<octet2>--<octetn>

For example:

x1-6-00-a0-24-2e-9c-20