Error Messages From ssadm edit Component

The ssadm edit component's error messages follow:

• Usage: ssadm edit [-beim] [-I ip] [-U user] policy [-c command]

  Return code: 1

  Indicates that the user invoked the edit program incorrectly.

• Error illegal policy name policyname

  Return code: 1

  Indicates that the user specified an illegal policy name while invoking the editor.

• Discarding unsaved changes

  Return code:

  Indicates that the user chose to QUIT even though there are unsaved changes.

• Write Lock Held

  Return code:

  Indicates that the user asked for their "lock_status", and they currently hold the write lock.

• Read Lock Held

  Return code:

  Indicates that the user asked for their "lock_status", and they currently hold the read lock.

• Registry Version: #Policy Version: #

  Return code: 0

  Indicates that the user asked for the "version" currently being edited.

• no longer supported. use edit del request syntax

  Return code: 251

  Indicates that the user tried to delete a NAT Rule using the old ssadm nat or ssadm access command.

• There are unsaved changes

  Return code: 231

  Indicates that the user attempted to "quit" without saving unsaved changes.

• Cannot name Policy "lock"

  Return code: 232

  Indicates that the user attempted to save the policy as "lock", which is a reserved word.

• There are unsaved changes "Version."

  Return code: 233

  Indicates that the user attempted to save the policy as "Version", which is a reserved word.

• There are unsaved changes in "Registry"

  Return code: 234

  Indicates that the user attempted to save the policy as "Registry", which is a reserved word.

• Cannot save a versioned file with a new name

  Return code: 235

  Indicates that the user attempted to save a versioned policy with a new name.

• Registry objects redefined

  Return code:

  Indicates that an entry in the Registry (on disk) has more than one definition. All definitions after the first are lost upon the next "save."

• Registry objects redefined

  Return code:

  Indicates that an entry in the Registry (on disk) has more than one definition. All definitions after the first are lost upon the next "save."

• file not found

  Return code: 240

  Indicates that the policy given to be read did not exist.

• parse error

  Return code: 241

  Indicates that the Policy or Registry file on disk is corrupt and cannot be read. Make sure you have a back-up or a recent version saved.

• could not acquire read lock

  Return code: 242

  Indicates that the configuration editor could not acquire a read lock. Likely the lock file is corrupt or some process is hanging. ss_lock -c policy is likely to be needed.

• could not acquire write lock

  Return code: 243

  Indicates that a request to gain the write lock failed. Likely because some other process currently holds the write lock.

• lock not held

  Return code: 244

  Indicates that an attempt was made to "save" changes, but something has happened so that this process no longer holds the write lock. Perhaps someone else has issued a ss_lock -c policy and invalidated the lock.

• cannot modify "*"

  Return code: 247

  Indicates that an attempt was made to modify the Address or Screen object "*". This is a reserved name and cannot be modified.

• cannot modify "localhost"

  Return code: 248

  Indicates that an attempt was made to modify the Address "localhost". This is a reserved name and cannot be modified.

• lock unavailable

  Return code: 249

  Indicates that something happened to the lock files. ss_lock -c policy is likely needed to fix the situation.

• unresolved references

  Return code: 250

  Indicates that a reference is made to a named object in the global registry that does not exist in the registry.

• invalid input

  Return code: 251

  Indicates that a request was not well-formed.

• unknown operation

  Return code: 253

  Indicates that a request used an invalid operation.

• unknown data type

  Return code: 252

  Indicates that a request was issued for an invalid data type.

• internal error

  Return code: 255

  No longer used.

• Error: invalid input

  Return code: non-zero

• Warning: Adding ADMIN Interface to an routing machine.

  Indicates you added an ADMIN Interface to a routing machine. You probably want this to be an routing type Interface.

• Warning: Adding ADMIN Interface to an routing machine.

  Indicates you added an ADMIN Interface to an routing machine. You probably want this to be an routing type Interface.

• (ssadm interfaces) Warning: operation replaced the Administrative Interface

  Only appears as a result of an "add Interface" request

• (ssadm interfaces) Warning: operation replaced only EFS Interface

  Only appears as a result of an "add Interface" request

• (ssadm interfaces) Warning: operation replaced only SPF Interface

  Only appears as a result of an "add Interface" request

• (ssadm interfaces) Warning: operation left only one SPF Interface

  Only appears as a result of an "add Interface" request

• Error: certificate invalid input

  Return code: non-zero

Error messages can arise while editing the address, rule, and service configurations (and from the corresponding GUIs).

The expression, [ARGUMENTS], used in the following error messages means that the same set of arguments passed into ssadm* is echoed back. For example, if you type: "add address a b junk x y z" the error message is: "add address a b junk x y z: error_message".