Chapter 4: SYMCLI Return Codes

Return code handling for Windows and UNIX

Return code handling for Windows and UNIX The following lists the possible status or error codes that can be returned by the various SYMCLI commands on a Windows or UNIX platform (for example, in a UNIX C shell, returned using echo $status).

1

2

Code

0

SUCCESS

FAIL

Code symbol

DB_FILE_IS_LOCKED

3

4

5

6

7

8

9

10

11

12

13

14

15

SYM_IS_LOCKED

NOT_ALL_SYNCHRONIZED

NONE_SYNCHRONIZED

NOT_ALL_UPDATED

NONE_UPDATED

NOT_ALL_PINGED

NONE_PINGED

NOT_ALL_SYNCHED

NONE_SYNCHED

NOT_ALL_RESTORED

NONE_RESTORED

NOT_ALL_VALID

NONE_VALID

Description

CLI call completed successfully.

CLI call failed.

Another process has an exclusive lock on the Host database file.

Another process has an exclusive lock on the

Symmetrix.

NOT all of the mirrored pairs are in the 'Synchronized' state.

NONE of the mirrored pairs are in the 'Synchronized' state.

NOT all of the mirrored pairs are in the 'Updated' state.

NONE of the mirrored pairs are in the 'Updated' state.

NOT all of the remote

Symmetrix units can be pinged.

NONE of the remote Symmetrix units can be pinged.

NOT all of the mirrored pairs are in the 'Synchronized' state.

NONE of the mirrored pairs are in the 'Synchronized' state.

NOT all of the pairs are in the

'Restored' state.

NONE of the pairs are in the

'Restored' state.

NOT all of the mirrored pairs are in a valid state.

NONE of the mirrored pairs are in a valid state.

864 EMC Solutions Enabler CLICommand Reference

16

SYM_NOT_ALL_LOCKED

17

SYM_NONE_LOCKED

18

19

ALREADY_IN_STATE

GK_IS_LOCKED

20

WP_TRACKS_IN_CACHE

21

NEED_MERGE_TO_RESUME

22

NEED_FORCE_TO_PROCEED

23

NEED_SYMFORCE_TO_PROCEED

24

NOT_IN_SYNC

30

31

28

29

25

26

27

NOT_ALL_SPLIT

NONE_SPLIT

NOT_ALL_SYNCINPROG

NONE_SYNCINPROG

NOT_ALL_RESTINPROG

NONE_RESTINPROG

NOT_ALL_SUSPENDED

Chapter 4: SYMCLI Return Codes

NOT all of the specified

Symmetrix units have an exclusive Symmetrix lock.

NONE of the specified

Symmetrix units have an exclusive Symmetrix lock.

The Device(s) is (are) already in the desired state or mode.

All GateKeeper devices to the

Symmetrix unit are currently locked.

Operation cannot proceed because the target device has

Write Pending I/O in the cache.

Operation cannot proceed without first performing a merge of the RDF Track Tables.

Operation cannot proceed in the current state except if you specify a force flag.

Operation cannot proceed in the current state except if you specify a symforce flag.

The Symmetrix configuration and the database file are NOT in sync.

NOT all of the mirrored pairs are in the 'Split' state.

NONE of the mirrored pairs are in the 'Split' state.

NOT all of the mirrored pairs are in the 'SyncInProg' state.

NONE of the mirrored pairs are in the 'SyncInProg' state.

NOT all of the pairs are in the

'RestInProg' state.

NONE of the pairs are in the

'RestInProg' state.

NOT all of the mirrored pairs are in the 'Suspended' state.

Return code handling for Windows and UNIX 865

Chapter 4: SYMCLI Return Codes

32

NONE_SUSPENDED

33

NOT_ALL_FAILED_OVER

36

37

34

35

38

39

NONE_FAILED_OVER

NOT_ALL_UPDATEINPROG

NONE_UPDATEINPROG

NOT_ALL_PARTITIONED

NONE_PARTITIONED

NOT_ALL_ENABLED

40

NONE_ENABLED

41

NOT_ALL_SYNCHRONIZED_AND_ENABLED

42

43

44

45

46

NONE_SYNCHRONIZED_AND_ENABLED

NOT_ALL_SUSP_AND_ENABLED

NONE_SUSP_AND_ENABLED

NOT_ALL_SUSP_AND_OFFLINE

NONE_SUSP_AND_OFFLINE

NONE of the mirrored pairs are in the 'Suspended' state.

NOT all of the mirrored pairs are in the 'Failed Over' state.

NONE of the mirrored pairs are in the 'Failed Over' state.

NOT all of the mirrored pairs are in the 'R1 UpdInProg' state.

NONE of the mirrored pairs are in the 'R1 UpdInProg' state.

NOT all of the mirrored pairs are in the 'Partitioned' state.

NONE of the mirrored pairs are in the 'Partitioned' state.

NOT all of the mirrored pairs are in the 'Enabled' consistency state.

NONE of the mirrored pairs are in the 'Enabled' consistency state.

NOT all of the mirrored pairs are in the 'Synchronized' rdf state and the 'Enabled' consistency state.

NONE of the mirrored pairs are in the 'Synchronized' rdf state and in the 'Enabled' consistency state.

NOT all of the mirrored pairs are in the 'Suspended' rdf state and

'Enabled' consistency state.

NONE of the mirrored pairs are in the 'Suspended' rdf state and the 'Enabled' consistency state.

NOT all of the mirrored pairs are in the 'Suspended' rdf state and

'Offline' link suspend state.

NONE of the mirrored pairs are in the 'Suspended' rdf state and the 'Offline' link suspend state.

866 EMC Solutions Enabler CLICommand Reference

60

61

62

47

WONT_REVERSE_SPLIT

48

49

50

CONFIG_LOCKED

DEVS_ARE_LOCKED

MUST_SPLIT_PROTECT

51

PAIRED_WITH_A_DRV

58

59

56

57

54

55

52

53

PAIRED_WITH_A_SPARE

NOT_ALL_COPYINPROG

NONE_COPYINPROG

NOT_ALL_COPIED

NONE_COPIED

NOT_ALL_COPYONACCESS

NONE_COPYONACCESS

CANT_RESTORE_PROTECT

NOT_ALL_CREATED

NONE_CREATED

NOT_ALL_READY

Chapter 4: SYMCLI Return Codes

Performing this operation at this time will not allow you to perform the next BCV split as a reverse split.

Access to the configuration server is locked.

One or more devices are locked.

If a device was restored with the protect option, it must be split with the protect option.

The function can not be performed since the STD device is already paired with a DRV device.

NOT all of the Snap pairs are in the 'Copy in progress' state.

NOT all of the pairs are in the

'CopyInProgress' state.

NONE of the pairs are in the

'CopyInProgress' state.

NOT all of the pairs are in the

'Copied' state.

NONE of the pairs are in the

'Copied' state.

NOT all of the pairs are in the

'CopyonAccess' state.

NONE of the pairs are in the

'CopyonAccess' state.

The protected restore operation can not be completed because there are write pendings or the

BCV mirrors are not synchronized.

NOT all of the pairs are in the

'Created' state.

NONE of the pairs are in the

'Created' state.

NOT all of the BCVs local mirrors are in the 'Ready' state.

Return code handling for Windows and UNIX 867

Chapter 4: SYMCLI Return Codes

63

NONE_READY

64

STD_BKGRND_SPLIT_IN_PROG

71

72

69

70

67

68

65

66

SPLIT_IN_PROG

NOT_ALL_COPYONWRITE

NONE_COPYONWRITE

NOT_ALL_RECREATED

NONE_RECREATED

NOT_ALL_CONSISTENT

NONE_CONSISTENT

MAX_SESSIONS_EXCEEDED

78

79

76

77

80

81

73

74

75

NOT_ALL_PRECOPY

NONE_PRECOPY

NOT_ALL_PRECOPY_CYCLED

NONE_PRECOPY_CYCLED

CONSISTENCY_TIMEOUT

NOT_ALL_FAILED

NONE_FAILED

CG_NOT_CONSISTENT

NOT_ALL_CREATEINPROG

868 EMC Solutions Enabler CLICommand Reference

NONE of the BCVs local mirrors are in the 'Ready' state.

The operation cannot proceed because the STD Device is splitting in the Background.

The operation cannot proceed because the pair is splitting.

NOT all of the pairs are in the

'CopyOnWrite' state.

NONE of the pairs are in the

'CopyOnWrite' state.

Not all devices are in the

'Recreated' state.

No devices are in the

'Recreated' state.

NOT all of the mirrored pairs are in the 'Consistent' state.

NONE of the mirrored pairs are in the 'Consistent' state.

The maximum number of sessions has been exceeded for the specified device.

Not all source devices are in the

'Precopy' state.

No source devices are in the

'Precopy' state.

Not all source devices have completed one precopy cycle.

No source devices have completed one precopy cycle.

The operation failed because of a Consistency window timeout.

NOT all of the pairs are in the

'Failed' state.

NONE of the pairs are in the

'Failed' state.

CG is NOT RDF-consistent.

NOT all of the pairs are in the

96

97

94

95

98

91

92

93

87

88

85

86

89

90

82

83

84

NONE_CREATEINPROG

NOT_ALL_RECREATEINPROG

NONE_RECREATEINPROG

NOT_ALL_TERMINPROG

NONE_TERMINPROG

NOT_ALL_VERIFYINPROG

NONE_VERIFYINPROG

NOT_ALL_VERIFIED

NONE_VERIFIED

RDFG_TRANSMIT_IDLE

NOT_ALL_MIGRATED

NONE_MIGRATED

NOT_ALL_MIGRATEINPROG

NONE_MIGRATEINPROG

NOT_ALL_INVALID

NONE_INVALID

EMPTY_BACKUP

Chapter 4: SYMCLI Return Codes

'CreateInProg' state.

None of the pairs are in the

'CreateInProg' state.

NOT all of the pairs are in the

'RecreateInProg' state.

None of the pairs are in the

'RecreateInProg' state.

NOT all of the pairs are in the

'TerminateInProg' state.

None of the pairs are in the

'TerminateInProg' state.

NOT all of the pairs are in the

'VerifyInProg' state.

None of the pairs are in the

'VerifyInProg' state.

NOT all of the pairs are in the requested states.

NONE of the pairs are in the requested states Note: This message is returned when multiple states are verified at once.

RDF group is operating in

SRDF/A Transmit Idle.

Not all devices are in the '

Migrated' state.

None of devices are in the

'Migrated' state.

Not all devices are in the

'MigrateInProg' state.

None of devices are in the

'MigrateInProg' state.

Not all devices are in the

'Invalid' state.

None of devices are in the

'Invalid' state.

Cannot create an empty backup file.

Return code handling for Windows and UNIX 869

Chapter 4: SYMCLI Return Codes

99

NOT_ALL_BOUND

100

NONE_BOUND

101

NOT_ALL_BINDING

102

NONE_BINDING

103

NOT_ALL_ALLOCATING

104

NONE_ALLOCATING

105

NOT_ALL_DEALLOCATING

106

NONE_DEALLOCATING

107

NOT_ALL_DRAINING

108

NONE_DRAINING

109

NOT_ALL_UNBOUND

110

NONE_UNBOUND

111

NOT_ALL_NONPOOLED

112

NONE_NONPOOLED

113

NOT_ALL_DRAINWAIT

114

NONE_DRAINWAIT

115

NOT_ALL_DISABLED

116

NONE_DISABLED

117

NOT_ALL_DEACTIVATED

870 EMC Solutions Enabler CLICommand Reference

Not all devices are in the

'Bound' state.

None of the devices are in the

'Bound' state

Not all devices are in the

'Binding' state.

None of the devices are in the

'Binding' state.

Not all devices are in the

'Allocating' state.

None of the devices are in the

'Allocating' state

Not all devices are in the

'Deallocating' state.

None of the devices are in the

'Deallocating' state.

Not all devices are in the

'Draining' state.

None of the devices are in the

'Draining' state.

Not all devices are in the

'Unbound' state.

None of the devices are in the

'Unbound' state.

Not all devices are in the

'Nonpooled' state.

None of the devices are in the

'Nonpooled' state.

Not all devices are in the

'Drainwait' state.

None of the devices are in the

'Drainwait' state.

Not all devices are in the

'Disabled' state.

None of the devices are in the

'Disabled' state.

Not all devices are in the

'Deactivated' state.

118

NONE_DEACTIVATED

119

NOT_ALL_UNBINDING

120

NONE_UNBINDING

121

NOT_ALL_RECLAIMING

122

NONE_RECLAIMING

123

NOT_ALL_BALANCING

124

NONE_BALANCING

125

DEVMASK_VALDTE_FAILED

126

DEVMASK_FREQNT_CHANGES

127

STAR_INV_STATE

128

STAR_ALLOWED_FROM_WKLD

129

STAR_INV_DEF_FILE_FMT

130 STAR_ACTN_FILE_ERROR

131 STAR_DEF_FILE_ERROR

132 STAR_SETUP_REQD

133 STAR_SETUP_INV_OPMODE

134 STAR_OPMODE_REQD

135

STAR_CTL_SITE_REQD

Chapter 4: SYMCLI Return Codes

None of the devices are in the

'Deactivated' state.

Not all devices are in the

'Unbinding' state.

None of the devices are in the

'Unbinding' state.

Not all devices are in the

'Reclaiming' state.

None of the devices are in the

'Reclaiming' state.

Not all devices are in the

'Balancing' state.

None of the devices are in the

'Balancing' state.

The device masking data contains inconsistencies.

The device masking data is continuously changing. Please try again.

The operation is not allowed in the current Star state.

The operation is allowed from workload site only.

The Star definition file format is not valid.

An error occured while accessing the Star action file.

An error occured while accessing the Star definition file.

The Star Setup action is required.

The specified Star mode of operation is not valid.

The Star mode of operation is required for this operation.

The Star control site name is required for this operation.

Return code handling for Windows and UNIX 871

Chapter 4: SYMCLI Return Codes

136

STAR_WKLD_SITE_REQD

137

STAR_WKLD_OP_REQD

138

STAR_CREATE_GROUP_FAIL

139

STAR_FULL_COPY_REQD

140

STAR_INV_ACTION_WOF

141

STAR_BUILDCG_REQD

142

NOT_ALL_FAILEDBACK

143

NONE_FAILEDBACK

144

NOT_ALL_STOPPED

145

NONE_STOPPED

146

NOT_ALL_CONSISTENT_NOINVALIDS

147

NONE_CONSISTENT_NOINVALIDS

148

NOT_ALL_SYNCHRONOUS

149

NONE_SYNCHRONOUS

150

NOT_ALL_SEMISYNCHRONOUS

151

NONE_SEMISYNCHRONOUS

152

NOT_ALL_ASYNCHRONOUS

The Star workload site name is required for this operation.

The Star workload site name and Star mode of operation is required for this operation.

An error occured while creating

Star group.

Star differential resync is not available. The FULL_COPY flag is required.

Operation can not be performed except if force flag is used.

The Star Buildcg action is required.

Not all devices are in the

'Failedback' state.

None of the devices are in the

'Failedback' state.

Not all devices are in the

'Stopped' state.

None of the devices are in the

'Stopped' state.

Not all devices are in the

'Consistent with no invalid tracks' state.

None of the devices are in the

'Consistent with no invalid tracks' state

Not all devices are in the

'Synchronous RDF' mode.

None of the devices are in the

'Synchronous RDF' mode.

Not all devices are in the 'Semi-

Synchronous RDF' mode.

None of the devices are in the

'Semi-Synchronous RDF' mode.

Not all devices are in the

'Asynchronous RDF' mode.

872 EMC Solutions Enabler CLICommand Reference

153

NONE_ASYNCHRONOUS

154

NOT_ALL_ACP_WP

155

NONE_ACP_WP

156

NOT_ALL_ACP_DISK

157

NONE_ACP_DISK

158

NOT_ALL_COMPRESSING

159

NONE_COMPRESSING

160

NOT_ALL_UNCOMPRESSING

161

NONE_UNCOMPRESSING

162

NOT_ALL_ESTABLISHED

163

NONE_ESTABLISHED

164

NOT_ALL_ESTINPROG

165

NONE_ESTINPROG

166

NOT_ALL_LINKED

167

NONE_LINKED

168

NOT_ALL_DEFINED

169

NONE_DEFINED

170

NOT_ALL_CIPLINKED

Chapter 4: SYMCLI Return Codes

None of the devices are in the

'Asynchronous RDF' mode.

Not all devices are in the

'Adaptive Copy Write Pending

RDF' mode.

None of the devices are in the

'Adaptive Copy Write Pending

RDF' mode.

Not all devices are in the

'Adaptive Copy Disk RDF' mode.

None of the devices are in the

'Adaptive Copy Disk RDF' mode.

Not all devices are in the

'Compressing' state.

None of the devices are in the

'Compressing' state.

Not all devices are in the

'Uncompressing' state.

Not all devices are in the

'Established' state.

Not all devices are in the

'Established' state.

None of the devices are in the

'Established' state.

Not all devices are in the

'Estinprog' state.

None of the devices are in the

'Estinprog' state.

Not all devices are in the

'Linked' state.

None of the devices are in the

'Linked' state.

Not all devices are in the

'Defined' state.

None of the devices are in the

'Defined' state.

Not all linked devices are in the

'Copyinprog' state.

Return code handling for Windows and UNIX 873

Chapter 4: SYMCLI Return Codes

171

NONE_CIPLINKED

172

NOT_ALL_COPIEDLINKED

173

NONE_COPIEDLINKED

174

NOT_ALL_DESTAGED

175

NONE_DESTAGED

176

NOT_ALL_FREEING_ALL

177

NONE_FREEING_ALL

178

NOT_ALL_ACTIVE

179

NONE_ACTIVE

180

NOT_ALL_DRAINED

181

NONE_DRAINED

182

NOT_ALL_ACTIVEACTIVE

183

NONE_ACTIVEACTIVE

184

NOT_ALL_ACTIVEBIAS

185

NONE_ACTIVEBIAS

None of the linked devices are in the 'Copyinprog' state.

Not all linked devices are in the

'Copied' state.

None of the linked devices are in the 'Copied' state.

Not all devices are in the

'Destaged' state.

None of the devices are in the

'Destaged' state.

Not all devices are in the

'FreeingAll' state.

None of the devices are in the

'FreeingAll' state.

Not all devices are in the 'Active' state.

"None of the devices are in the

'Active' state.

Not all devices are in the

'Drained' state.

None of the devices are in the

'Drained' state.

Not all devices are in the

'ActiveActive' state.

None of the devices are in the

'ActiveActive' state.

Not all devices are in the

'ActiveBias' state.

None of the devices are in the

'ActiveBias' state.

874 EMC Solutions Enabler CLICommand Reference