Technical References
In batch mode (when the command is entered on the command
line), nrcmd will not attempt to obtain a lock unless the
command is not one of the valid ones listed above. If a lock
is needed, it will then attempt to get it; if this fails, the
error issued is
408 Cannot lock cluster: Already locked: '<user>@<host>.<pid>
where <user>, <host>, and <pid> are as above.
Return codes
All nrcmd commands will return a status code as the first line of
output. The status codes are heavily influenced by SMTP and other
line oriented protocols. The first word of the line is a three
digit status code, and the remaining words on the line are
descriptive text that may or may not be constant for a given
status code. The first digit of the status code determines the
class of the status:
1xx - the command completed successfully, possibly with warnings
3xx there was some error in processing the command
4xx errors in communicating with the cluster database server
5xx there is was an internal error in the program
Property types
The properties that are manipulated by the set and get command
have specific data types which determine the syntactically valid
values. These types are:
AT_STRING - a string, valid inputs are:
* any text
AT_INT - an integer, valid inputs are:
* decimal digits, or
* 0x followed by hex digits.
AT_BOOL - a boolean value, valid inputs are:
* true, on, enabled, 1, or
* false, off, disabled, 0.
AT_DATE - a date, valid inputs are:
* 'forever'
* +<time value>
AT_TIME - a span of time, in seconds, valid inputs are:
* decimal number of seconds
* combination of numbers of weeks, days, hours,
minutes, and seconds for example: 1w2d3h4m5s.
AT_IPADDR - an ip address, valid inputs are:
* dotted quad format, for example 10.24.1.2
AT_MACADDR - a MAC address, valid inputs are:
* raw hex digits, for example: 010203040506
* hex digits separated by ':', '.', or '-', for example:
01:02:03:04:05:06, 01-02-03-04-05-06, 01.02.03.04.05.06
* type and length, followed by hex digits, for example:
1,6,ab:01:cd:02:ef:03