4.348 ent-serial-num

Use this command to enter and lock  the NT serial number into the database for an EAGLE STP.

You must enter the serial number at least once without specifying the lock parameter. As long as you enter the command without the lock parameter, you can enter the system serial number as many time as needed. After the correct serial number is entered, you must use the lock=yes parameter to lock the serial number table. You cannot change the serial number with administration commands after the table is locked.

Parameters

serial (mandatory)

The system NT Serial Number.

Range:

aayyyyyyyy

Up to 10 alphanumeric characters; mixed case is allowed.

The first two characters (the prefix) must be letters. The remaining characters must be numbers. The serial number cannot contain spaces or special characters.

lock (optional)

This parameter is used to lock the Serial Number table when the serial number is entered for the system.

Caution:

After the serial number is locked, you cannot enter it again or change it in the database. You can use the command without the lock parameter to enter the serial number as many times as needed; then enter the command with the lock parameter and the correct serial number to lock the serial number table.

Range:

yes

Default:

Not locked

Example

ent-serial-num:serial=nt00000123

ent-serial-num:serial=nt00000123:lock=yes

Dependencies

The serial number must be entered at least once without specifying the lock parameter.

The system serial number that is entered when the lock parameter is specified must match the serial number that was previously entered in the Serial Number table by using the command without the lock parameter.

The system serial number cannot be entered again after the Serial Number table is locked.

The system serial number must start with two alphabetical characters.

The format of the serial number should be AANNNNNNNN where NNNNNNNN must be numeric digits (0 - 9).

The format of the serial number needs to be 2 alphabetical letters followed by 8 numbers (e.g., NT01234567.)

Notes

None

Output

ent-serial-num:serial=nt00000123

    rlghncxa03w 04-01-05 16:40:40 EST  EAGLE 31.3.0
    ENT-SERIAL-NUM:  MASP A - COMPLTD 
;