Return codes
The Common Information Model (CIM) return codes provide information on the status of CIM agent operations.
Common Information Model
This table is a condensed list of possible CIM return codes.
Important: Some codes may not apply to your system.
CIM return code | Description | Method | Explanation |
---|---|---|---|
0 | Success | GetFreeExtends()
ListConfiguration Backups() |
The parameters are valid. The method completed successfully. |
AddNode() | The node was successfully added. | ||
CheckValidity() | The information about the certificate was successfully obtained. | ||
DeleteAccount() | The account was successfully deleted. | ||
GenerateCIMOM
Certificate() EnableAuto Generation() DisableAuto Generation() |
The certificate was successfully deleted. | ||
CreateCode() | The new account was successfully created. | ||
SetDefault
Validity() |
The validity was successfully set. | ||
GrantGlobal
Access() GrantSystem Access() |
The role was successfully changed. | ||
CreateGatewayID()
AddHardwareIDs ToCollection() |
The collection was successfully created. | ||
DeleteStorage
HardwareID() |
The StorageHardwareID was successfully deleted. | ||
CreateStorage
HardwareID() |
The StorageHardwareID was successfully created. | ||
0 | Success (continued) | AttachDevice() | The volume was successfully attached. |
DeleteProtocol
Controller() |
The controller was successfully deleted. | ||
CreateProtocol
ControllerWith Ports() |
A clone was successfully created. | ||
DeleteRemote
Cluster Partnership() |
The clustered system partnership was successfully deleted. | ||
CreateRemote
Cluster Partnership() |
The clustered system partnership was successfully established. | ||
DeleteHardwareID
Collection() |
The collection was successfully created. | ||
DeleteCertificate() | The certificate was successfully deleted. | ||
DeleteSynchronized
Set() |
The SynchronizedSet was successfully deleted. | ||
Modify
Synchronization() |
The method was successfully run. | ||
EvictNode() | The node was successfully evicted. | ||
0 | Success (continued) | RestartService() | The CIMOM restarts. |
Shutdown() | The shutdown for the node/clustered system was successfully initiated. | ||
SetLocale() | The locale was set. | ||
SetTimezone() | The time zone for the clustered system was successfully set. | ||
SetPasswords()
ModifyReset Password ChangeFeature() |
The passwords were changed. | ||
GetResetPassword
ChangeFeature Status() |
The feature status was successfully retrieved. | ||
StartStatistics
Collection() |
The statistics collection was started. | ||
DetachDevice() | The volume was successfully detached. | ||
StopStatistics
Collection() |
The statistics collection was stopped. | ||
Backup
Configuration() |
A backup was successfully created. | ||
Reload
Configuration() |
The configuration was reloaded. | ||
Restore
Configuration() Delete Configuration Backup() |
A restore was successfully made. | ||
AttachReplica() | The copy relationship was successfully established. | ||
CreateSynchronized
Set() |
The SynchronizedSet was successfully created. | ||
SetPassword() | The password was successfully changed. | ||
0 | Job that is completed with no error | CreateOrModify
StoragePool() |
The pool was successfully created. |
CreateOrModify
ElementFrom StoragePool() |
The volume was successfully created. The pool was successfully modified. | ||
DeleteStorage
Pool() |
The pool was successfully deleted. | ||
ReturnToStorage
Pool() |
The volume was successfully deleted. | ||
RequestDiscovery() | BackendVolume discovery was successful. | ||
SetIOGroup() | The change was successful. | ||
SetQuorum() | The method was successful. | ||
IncludeBackend
Volume() |
The volume was successfully included. | ||
ModifySynchronized
Set() |
The CLI command was successfully run. | ||
0 | Job started successfully | MigrateVolume()
MigrateVolumeTo lmageMode() |
The migration job was started. |
1 | Not supported | SetLocales() | The clustered system does not support locales. |
SetPasswords() | The clustered system does not support password change (CISCO). | ||
ModifyReset
PasswordChange Feature() GetResetPassword ChangeFeature Status() |
The clustered system does not support the reset password change feature. | ||
Upgrade() | The method was called on a clustered system configuration service. | ||
2 | Failed | Dump() Clean() Enter() Exit() Clean() GetDump() ClearLog() GetRecord()
GetAllRecords() FixRecord() UnfixRecord()
ModifyError
Settings() Create2062 Cluster() |
An unexpected error occurred. A CLI command failed. |
GetDump() | Failure during command processing. The file was not found. | ||
Reload
Configuration() |
Failed to reload the configuration. | ||
CreateCode() | Failed to create the account. | ||
GrantGlobal
Access() GrantSystem Access() |
Failed to change the role. | ||
SetPassword() | Failed to change the password. | ||
DeleteAccount() | Failed to delete the account. | ||
2 | Unknown error | GenerateCIMOM
Certificate() DeleteCertificate() |
Failed to generate new certificate due to provider internal reasons. |
EnableAuto
Generation() DisableAuto Generation() |
Failed due to provider internal reasons. | ||
SetDefault
Validity() |
Failed to set validity. | ||
CheckValidity() | Failed to obtain information about certificate. | ||
4 | Failed | GenerateCIMOM
Certificate() DeleteCertificate() |
Unexpected error occurred. Failed to generate new certificate due to truststore problems. |
5 | Wrong Parameter Set | Delete
Configuration Backup() |
The wrong number or type of parameters were passed. The backup might not be found. |
Modify
Synchronization() |
The wrong number or type of parameters were passed or other parameter checking failed. | ||
CreateCode()
GrantGlobal Access() SetPassword() GrantSystem Access() DeleteAccount() DeleteCertificate() SetDefault Validity() CheckValidity() |
One of the parameters is not valid. | ||
5 | Parameter not valid | Dump(),
GetDump() PositionToFirst RecordRoot() GetRecord() FixRecord() UnfixRecord() |
One of the mandatory parameters is missing. |
ModifyIP
Address() Create2062 Cluster() Add2062Cluster() Add2145Cluster() Reset2062Node() Reload2062Node() |
One of the mandatory parameters is missing or not valid. | ||
CreateOrModify
StoragePool() CreateOrModify ElementFrom StoragePool() Delete StoragePool() ReturnTo StoragePool() |
At least one of the parameters is not valid. | ||
CreateGatewayID()
GenerateCIMOM Certificate() |
One of the parameters was not valid. | ||
PositionAtRecord() | One of the mandatory parameters is missing or having a negative number of records is not supported. | ||
6 | CopyType not supported | ModifySynchronized
Set() |
The type of copy passed in was different from 3 or 4. |
6 | Operation not supported | ModifySynchronized
Set() |
The operation code submitted is not valid for the copy type of the synchronized set. |
6 | SynchronizedSet is not empty | DeleteSynchronized
Set() |
There are still StorageSynchronized associations in the set. All StorageSynchronized associations must be removed before deletion of the set can be run or the Force flag must be set. |
6 | User ID already exists | CreateCode() | The user ID that you submitted exists in another account. |
6 | In use | GenerateCIMOM
Certificate() |
Failed to generate new certificate. Existing certificate is still valid and in use. |
7 | StorageSynchronized not in the Set | The synchronized storage does not exist in the set. | |
8 | StorageSynchronized already in the Set | The synchronized storage already exists in the set and cannot be added. | |
9 | StorageSynchronized incompatible with Set | The synchronized storage is not compatible with the Set. For example, a FlashCopy is synchronized to a Sync Copy set. | |
0x1000 | Parameters checked – Job started | The CLI copy command was run and a job object was returned. | |
0x1000 | LogicalDevices associated to other ProtocolControllers not deleted | DeleteProtocol
Controller() |
At least one of the attached storage volumes is attached to another controller so it cannot be deleted. |
0x1000 | LogicalDevice instance not valid | AttachDevice() | The device is not a volume of the RedundancyGroup of the controller. |
0x1000 | LogicalDevice not associated to Controller | DetachDevice() | The device has no ProtocolControllerForUnit association to this controller. |
0x1000 | ID already created | CreateStorage
HardwareID() |
The WWPN is already assigned to an existing storage hardware ID. |
0x1000 | Specified instance not found | DeleteStorage
HardwareID() |
The storage hardware ID might not be found. |
0x1000 | HardwareID instance not valid | CreateGateway
ID() AddHardwareIDs ToCollection() |
The storage hardware ID might not be found or is already a member of another collection. |
0x1001 | Size not supported | CreateOrModify
ElementFrom StoragePool() |
The requested size is not supported by the primordial pools. The size parameter contains the nearest supported size larger than the requested one. The size requested was not a multiple of 512. The nearest supported size that can be requested is returned in size. |
0x1001 | Device Number Conflict | AttachDevice() | The specified device number is already occupied. |
0x1001 | Hardware implementation does not support specified IDType | CreateStorage
HardwareID() |
The type of ID is different from 2. |
0x8000 | ComputerSystem not valid | AddNode() | The submitted ComputerSystem was not a IBMTSSVC_ CandidateNode. |
EvictNode() | The submitted ComputerSystem was not a IBMTSSVC_Node. | ||
Shutdown() | The submitted ComputerSystem was not a IBMTSSVC_Node of IBMTSSVC_Cluster. | ||
0x8000 | Locale not valid | SetLocale() | The submitted Locale was greater than 9. |
0x8000 | Type not valid | Dump() | A type greater than 2 was passed in. |
0x8000 | Connection refused | GetDump() | A connection was lost to the clustered system or failed to connect to a node (CISCO only). |
0x8000 | Backup not found | Restore
Configuration() |
The specified backup was not found. |
0x8000 | Delete failed | Delete
Configuration Backup() |
The deletion of the backup directory failed. The failure might be caused by a sharing violation. |
0x8000 | IOGroup must have Nodes aggregated | SetIOGroup() | The I/O group does not have any nodes. |
0x8000 | ID not valid | SetQuorum() | The quorum ID is a number greater than 2. |
0x8000 | Volume not valid | IncludeBackend
Volume() |
The volume is not expelled. |
0x8000 | CopyType not supported | AttachReplica() | The type of copy that is passed in was different from 2 or 3. |
CreateReplica() | The type of copy that is passed in was different from 3 or 4. | ||
0x8000 | Ports are from multiple IOGroups | CreateProtocol
ControllerWith Ports() |
All ports are required to belong to the same I/O group. |
0x8000 | HardwareID still bound to AuthorizationSubject. Force required | DeleteStorage
HardwareID() |
The hardware ID has access that is granted to a storage volume and Force was not specified. |
0x8000 | Host is member of a LUN mapping | DeleteHardware
IDCollection() |
To delete this host either use this host to run the RemoveAccess method for each privilege and controller this host is associated to or set “Force” equal to “True.” |
0x8000 | Record(s) not found | GetRecord() GetAllRecords() | No records were found. |
0x8000 | Cannot connect to clustered system | Create2062
Cluster() Add2062 Cluster() |
Unable to connect to the clustered system. |
0x8000 | Connection to clustered system refused | Add2145Cluster() | The connection to the clustered system was refused. |
0x8000 | Connection to switch refused | Reset2062Node()
Reload2062Node() |
The connection to the switch was refused. |
0x8000 | Management IP not found | RemoveCluster() | The IP for the clustered system cannot be found. |
0x8001 | Maximum number of nodes for clustered system exceeded | AddNode() | All I/O groups already have two nodes that are assigned to them. |
0x8001 | Prefix not valid | Dump() | A file prefix and feature log type were passed in at the same time. |
0x8001 | File not found | GetDump() | The given file path was not found (CISCO). |
0x8001 | Backup script failed | Backup
Configuration() |
The backup script that is returned with an error. |
0x8001 | Restore script failed | Restore
Configuration() |
The backup script that is returned with an error. |
0x8001 | Operation that is not supported for current state | Modify
Configuration() |
The operation that is submitted is not supported in the current state of the synchronized storage. For example, you cannot have a “prepare” operation on a synchronized storage in “synchronized” state. |
0x8001 | Operation that is not supported for current SyncState | Modify
Synchronized Set() |
The operation is not supported by the current SyncState of the set. |
0x8001 | Unsupported protocol | CreateProtocol
ControllerWith Ports() |
Protocol != 2. |
0x8001 | Syntax error in ClusterName | Create2062
Cluster() Add2062Cluster() Reset2062Node() Reload2062Node() |
The clustered system name is not valid because of a syntax error. |
0x8002 | ExtraCapacitySet not valid | AddNode() | The submitted ExtraCapacitySet was not a IBMTSSVC_ IOGroupSet. |
0x8002 | Secure copy failed | Backup
Configuration() |
The download of the backup file that uses secure copy failed. |
0x8002 | Secure copy failed | Upload
Configuration() |
The upload of the backup file that uses secure copy failed. |
CreateStorage
HardwareID() |
The name of the element and setting are required to be null. | ||
0x8002 | Syntax error in Node or Node is not valid | Create2062
Cluster() Add2062Cluster() Reset2062Node() Reload2062 Node() |
The node contains a syntax error, or the specified node is not valid. |
0x8003 | Maximum number of Nodes for IOGroup exceeded | AddNode() | The submitted I/O group set already has two nodes that are assigned to it. |
0x8003 | Creation of backup directory failed | Backup
Configuration() |
The backup directory cannot be created. |
0x8003 | Clear command failed | Upload
Configuration() |
The clustered system /tmp/ directory cannot be cleared. |
0x8003 | Username or password not valid (only ResetNode) | Add2062Cluster()
Reset2062Node() Reload2062Node() |
The user name or password are not valid. |
0x8004 | Delete/rename of old backup files failed | N/A | The backup directory cannot be renamed or deleted. |
0x8004 | Wrong SwitchIP / cant connect to switch | Create2062
Cluster() Add2062Cluster() |
The IP for the switch is not correct, so a connection to the switch cannot be made. |
0x8004 | SwitchIP is not configured | Reset2062Node() Reload2062Node() | The IP for the switch is not configured. |
0x8005 | Syntax error in IP of clustered system | N/A | The IP for the clustered system contains a syntax error. |
0x8006 | Slot not valid | N/A | The slot is not valid. |
0x8007 | Cannot upload public key to switch | N/A | The public key cannot be uploaded to the switch. |
0x8100 | Clustered system scope violation | N/A | One or more parameters were out of the clustered system scope. |
0x8200 | N/A | N/A | The method was run successfully but one or more parameters were ignored. |