8. Error Codes and Messages¶
This is a reference to Feilong API error codes and messages.
overallRC |
modID |
rc |
rs |
errmsg |
|---|---|---|---|---|
Invalid API Input |
||||
100 |
400 |
100 |
1 |
Invalid API arg count, API: %(api)s, %(expected)d expected while %(provided)d provided. |
100 |
400 |
100 |
2 |
Invalid API arg type, API: %(api)s, expected types: ‘%(expected)s’, input types: ‘%(inputtypes)s’ |
100 |
400 |
100 |
3 |
Invalid API arg format, error: %(msg)s |
100 |
400 |
100 |
4 |
Missing required option: %(msg)s |
Operation on Guest failed |
||||
300 |
10 |
300 |
1 |
Database operation failed, error: %(msg)s |
300 |
10 |
300 |
2 |
Failed to add mdisks when creating guest, error: %(msg)s |
300 |
10 |
300 |
3 |
Failed to deploy image to userid: ‘%(userid)s’, unpackdiskimage failed with rc: %(unpack_rc)d, error: %(err)s |
300 |
10 |
300 |
4 |
Failed to deploy image to userid: ‘%(userid)s’, copy configure drive failed: %(err_info)s |
300 |
10 |
300 |
5 |
Failed to capture userid %(userid)s to generate image, error: %(msg)s |
300 |
10 |
300 |
6 |
Failed to resize cpus of guest: ‘%(userid)s’, error: update cpu definition in user entry failed with smt error: ‘%(err)s’. |
300 |
10 |
300 |
7 |
Failed to live resize cpus of guest: ‘%(userid)s’, error: define new cpu to active failed with smt error: ‘%(err)s’. |
300 |
10 |
300 |
8 |
Failed to live resize cpus of guest: ‘%(userid)s’, error: rescan cpus to hot-plug new defined cpus failed: ‘%(err)s’. |
300 |
10 |
300 |
9 |
Failed to resize memory of guest: ‘%(userid)s’, error: lock user entry failed with smt error: ‘%(err)s’. |
300 |
10 |
300 |
10 |
Failed to resize memory of guest: ‘%(userid)s’, error: replace user entry failed with smt error: ‘%(err)s’. |
300 |
10 |
300 |
11 |
Failed to live resize memory of guest: ‘%(userid)s’, error: define standby memory failed with smt error: ‘%(err)s’. |
300 |
10 |
300 |
12 |
Failed to deploy image to userid: ‘%(userid)s’, get unpackdiskimage cmd failed: %(err)s |
300 |
10 |
300 |
13 |
Failed to deploy image to userid: ‘%(userid)s’, ignition file is required when deploying RHCOS image |
300 |
10 |
300 |
14 |
Failed to deploy image to userid: ‘%(userid)s’, %(msg)s |
300 |
10 |
300 |
15 |
Failed to live resize cpus of guest: ‘%(userid)s’, error: enable new defined cpus failed: ‘%(err)s’. |
300 |
10 |
300 |
16 |
Failed to start the guest: ‘%(userid)s’, %(msg)s |
Operation on Network failed |
||||
300 |
20 |
300 |
1 |
Database operation failed, error: %(msg)s |
300 |
20 |
300 |
2 |
ZVMSDK network error: %(msg)s |
300 |
20 |
300 |
3 |
Failed to couple nic %(nic)s to vswitch %(vswitch)s on the active guest system, error: %(couple_err)s, and failed to revoke user direct’s changes, error: %(revoke_err)s |
300 |
20 |
300 |
4 |
Failed to create nic %(nic)s for %(userid)s on the active guest system, error: %(create_err)s, and failed to revoke user direct’s changes, error: %(revoke_err)s |
300 |
20 |
300 |
5 |
Failed to actively change network setting for user %(userid)s, error: %(msg)s |
Operation on Volume failed |
||||
300 |
30 |
300 |
1 |
Database operation failed, error: %(msg)s |
300 |
30 |
300 |
3 |
Volume %(vol)s has already been attached on instance %(inst)s |
300 |
30 |
300 |
4 |
Volume %(vol)s is not attached on instance %(inst)s |
300 |
30 |
300 |
5 |
Refresh bootmap fails, error code: %(errcode)s and reason: %(errmsg)s |
300 |
30 |
300 |
6 |
IUCV failed to get authorization from instance %(userid)s with reason %(msg)s |
300 |
30 |
300 |
7 |
Refresh bootmap timeout with reason %(msg)s |
300 |
30 |
300 |
8 |
Failed to attach volume to instance %(userid)s with reason %(msg)s |
300 |
30 |
300 |
9 |
Failed to detach volume from instance %(userid)s with reason %(msg)s |
300 |
30 |
300 |
10 |
Failed to refresh bootmap for RHCOS: transportfiles are required |
300 |
30 |
300 |
11 |
Failed to get volume connector of %(userid)s: %(msg)s |
300 |
30 |
300 |
12 |
PCHIDs info missing: %(msg)s |
Operation on Image failed |
||||
300 |
40 |
300 |
1 |
Database operation failed, error: %(msg)s |
300 |
40 |
300 |
2 |
No image schema found for %(schema)s |
300 |
40 |
300 |
3 |
Image import error: Failed to calculate the md5sum of the image |
300 |
40 |
300 |
4 |
Image import error: The md5sum after import is not same as source image, it is possible that the image has been broken during import |
300 |
40 |
300 |
5 |
Image import error: Failed to get the root disk size units of the image via hexdump |
300 |
40 |
300 |
6 |
Image import error: The header of image does not contain built-in disk size units |
300 |
40 |
300 |
7 |
Image import error: The image’s disk type is not valid. Currently only FBA or CKD type image is supported |
300 |
40 |
300 |
8 |
Image import error: Failed to get the physical size of image in bytes |
300 |
40 |
300 |
9 |
Import image from http server failed with reason %(err)s |
300 |
40 |
300 |
10 |
Image import error: Copying image file from remote filesystem failed with error %(err)s |
300 |
40 |
300 |
11 |
The specified remote_host %(rh)s format invalid |
300 |
40 |
300 |
12 |
Import image from local file system failed with error %(err)s |
300 |
40 |
300 |
13 |
Image import error: image name %(img)s already exist in image database |
300 |
40 |
300 |
14 |
Image import error: %(msg)s |
300 |
40 |
300 |
20 |
The image record of %(img)s does not exist |
300 |
40 |
300 |
21 |
Image Export error: Failed to copy image file to remote host with reason: %(msg)s |
300 |
40 |
300 |
22 |
Export image to local file system failed: %(err)s |
300 |
40 |
300 |
23 |
Image file of %(img)s does not exist, so failed to get its timestamp. |
Operation on Monitor failed |
||||
300 |
50 |
300 |
1 |
Database operation failed, error: %(msg)s |
REST API Request error |
||||
400 |
120 |
400 |
1 |
Invalid request |
The operated object does not exist |
||||
404 |
None |
404 |
1 |
%(obj_desc)s does not exist. |
404 |
None |
404 |
2 |
Not found error: ‘%(msg)s’ |
404 |
None |
404 |
3 |
%(obj_desc)s does not exist in directory although it is in DB. The guest could have been deleted out of z/VM Cloud Connector. |
The operated object status conflict |
||||
409 |
None |
409 |
1 |
Guest ‘%(userid)s’ is not in active status. |
409 |
None |
409 |
2 |
Failed to live resize cpus of guest: ‘%(userid)s’, error: current active cpu count: ‘%(active)i’ is greater than requested count: ‘%(req)i’. |
409 |
None |
409 |
3 |
Failed to resize cpus of guest: ‘%(userid)s’, error: maximum number of cpus is not defined in user directory. |
409 |
None |
409 |
4 |
Failed to resize cpus of guest: ‘%(userid)s’, error: the requested number of cpus: ‘%(req)i’ exceeds the maximum number of cpus allowed: ‘%(max)i’. |
409 |
None |
409 |
5 |
Failed to set vswitch %(vsw)s, error: %(msg)s |
409 |
None |
409 |
6 |
Failed to create nic %(vdev)s for guest %(userid)s, error: %(msg)s |
409 |
None |
409 |
7 |
Failed to create nic %(vdev)s for guest %(userid)s, error: %(obj)s is locked |
409 |
None |
409 |
8 |
Failed to delete nic %(vdev)s for guest %(userid)s, error: %(msg)s |
409 |
None |
409 |
9 |
Failed to delete nic %(vdev)s for guest %(userid)s, error: %(obj)s is locked |
409 |
None |
409 |
10 |
Failed to couple nic %(vdev)s of guest %(userid)s with vswitch %(vsw)s, error: %(msg)s |
409 |
None |
409 |
11 |
Failed to couple nic %(vdev)s of guest %(userid)s with vswitch %(vsw)s, error: %(obj)s is locked |
409 |
None |
409 |
12 |
Failed to uncouple nic %(vdev)s of guest %(userid)s error: %(msg)s |
409 |
None |
409 |
13 |
Failed to uncouple nic %(vdev)s of guest %(userid)s error: %(obj)s is locked |
409 |
None |
409 |
14 |
Failed to dedicate OSA %(osa)s to guest %(userid)s error: %(msg)s |
409 |
None |
409 |
15 |
Failed to dedicate OSA %(osa)s to guest %(userid)s error: %(obj)s is locked |
409 |
None |
409 |
16 |
Failed to delete dedicated device from guest %(userid)s %(vdev)s, error: %(msg)s |
409 |
None |
409 |
17 |
Failed to delete dedicated device from guest %(userid)s %(vdev)s, error: %(obj)s is locked |
409 |
None |
409 |
18 |
Failed to live resize memory of guest: ‘%(userid)s’, error: current active memory size: ‘%(active)i’m is greater than requested size: ‘%(req)i’m. |
409 |
None |
409 |
19 |
Failed to resize memory of guest: ‘%(userid)s’, error: user definition is not in expected format, cann’t get the defined/max/reserved storage. |
409 |
None |
409 |
20 |
Failed to resize memory of guest: ‘%(userid)s’, error: the requested memory size: ‘%(req)im’ exceeds the maximum memory size defined: ‘%(max)im’. |
409 |
None |
409 |
21 |
Failed to live resize memory of guest: %(userid)s, error: the memory size to be increased: ‘%(inc)im’ is greater than the maximum reserved memory size: ‘%(max)im’. |
409 |
None |
409 |
22 |
Failed to delete FCP Multipath Template, error: %(msg)s |
409 |
None |
409 |
23 |
Failed to create or update FCP Multipath Template, error: %(msg)s |
409 |
None |
409 |
24 |
Failed to edit FCP Multipath Template, error: %(msg)s |
The operated object is deleted |
||||
410 |
None |
410 |
The operated object is deleted |
|
ZVM SDK Internal Error |
||||
500 |
None |
500 |
1 |
Unexpected internal error in ZVM SDK, error: %(msg)s |
z/VM Cloud Connector service is unavailable |
||||
503 |
120 |
503 |
1 |
Max concurrent deploy/capture requests received, request is rejected. %(req)s |
smt errors |
||||
2 |
1 |
2 |
99 |
ULTSMP0311E On USERID, command sent through IUCV failed, rc in response string is not an integer. cmd: CMD, rc: RC, out: OUTPUT |
2 |
1 |
2 |
99 |
ULTSMP0312E On USERID, command sent through IUCV failed, reason code in response string is not an integer. cmd: CMD, rc: RC, rs: RS, out: OUTPUT |
2 |
1 |
1 |
None |
ULTSMP0313E On USERID, command sent through IUCV was not authorized or a generic Linux error occurred. cmd: CMD, rc: RC, rs: RS, out: OUTPUT |
2 |
1 |
2 |
None |
ULTSMP0314E IUCV client parameter error sending command to USERID. cmd: CMD, rc: RC, rs: RS, out: OUTPUT |
2 |
1 |
4 |
None |
ULTSMP0315E IUCV socket error sending command to USERID. cmd: CMD, rc: RC, rs: RS, out: OUTPUT |
2 |
1 |
8 |
None |
ULTSMP0316E On USERID, command sent through IUCV failed. cmd: CMD, rc: RC, rs: RS, out: OUTPUT |
2 |
1 |
16 |
None |
ULTSMP0317E File transport failure while processing command for USERID. cmd: CMD, rc: RC, rs: RS, out: OUTPUT |
2 |
1 |
32 |
None |
ULTSMP0318E On USERID, IUCV server file was not found. cmd: CMD, rc: RC, rs: RS, out: OUTPUT |
2 |
1 |
None |
None |
ULTSMP0319E Unrecognized IUCV client error encountered while sending a command through IUCV to USERID. cmd: CMD, rc: RC, rs: RS, out: OUTPUT |
3 |
1 |
64 |
None |
ULTSMP0320E On USERID, command sent through IUCV failed because timeout. cmd: CMD, rc: RC, rs: RS, out: OUTPUT |
3 |
1 |
415 |
None |
ULTGUT0415E Command failed: ‘CMD’, rc: RC out: OUTPUT |
4 |
1 |
4 |
1 |
ULTRQH0001E FUNCTION_NAME SUBFUNCTION_NAME subfunction’s operand at position OPERAND_POSITION (OPERAND) is not an integer: OPERAND_VALUE |
4 |
1 |
4 |
2 |
ULTRQH0002E FUNCTION_NAME’s SUBFUNCTION_NAME subfunction is missing positional operand (OPERAND) at position OPERAND_POSITION. |
4 |
1 |
4 |
3 |
ULTRQH0003E FUNCTION_NAME’s SUBFUNCTION_NAME subfunction KEYWORD keyword operand is missing a value. |
4 |
1 |
4 |
4 |
ULTRQH0004E FUNCTION_NAME’s SUBFUNCTION_NAME subfunction KEYWORD keyword operand is not an integer: KEYWORD_VALUE |
4 |
1 |
4 |
5 |
ULTRQH0005E FUNCTION_NAME’s SUBFUNCTION_NAME subfunction does not recognize keyword: KEYWORD |
4 |
1 |
4 |
6 |
ULTRQH0006E FUNCTION_NAME’s SUBFUNCTION_NAME subfunction encountered an unknown operand: OPERAND |
4 |
1 |
4 |
7 |
ULTRQH0007E Unrecognized function: FUNCTION_NAME |
4 |
1 |
4 |
8 |
ULTRQH0008E Specified function is not ‘HELP’ or ‘VERSION’: SPECIFIED_FUNCTION |
4 |
1 |
4 |
9 |
ULTRQH0009E Too few arguments specified. |
4 |
1 |
4 |
10 |
ULTRQH0010E Userid is missing |
4 |
1 |
4 |
11 |
ULTRQH0011E Subfunction is missing. It should be one of the following: VALID_SUBFUNCTIONS |
4 |
1 |
4 |
12 |
ULTRQH0012E The request data is not one of the supported types of list or string: REQUEST_DATA_TYPE |
4 |
1 |
4 |
13 |
ULTRQH0010E The desired state was: DESIRED_STATS. Valid states are: VALID_STATS |
4 |
1 |
4 |
14 |
ULTRQH0014E The option OPTION1 was specified but the option OPTION2 was not specified. These options must both be specified. |
4 |
1 |
4 |
15 |
ULTRQH0015E The file system was not ‘ext2’, ‘ext3’, ‘ext4’, ‘xfs’ or ‘swap’: FILE_SYSTEM |
4 |
1 |
4 |
16 |
ULTRQH0016E The scp Data Type was not ‘hex’, ‘ebcdic’, or ‘delete’: DATA_TYPE |
4 |
1 |
4 |
17 |
ULTRQH0017W The maxwait time MAX_WAIT sec is not evenly divisible by the poll interval POLL_INTERVAL sec. Maximum wait time will be RECOMMEND_MAX_WAIT sec or RECOMMEND_POLL_INTERVAL poll intervals. |
4 |
1 |
4 |
200 |
ULTGUT0200E The size of the disk is not valid: DISK_SIZE |
4 |
1 |
4 |
201 |
ULTGUT0201E Failed to convert DISK_SIZE to a number of blocks. |
4 |
1 |
4 |
202 |
ULTGUT0202E NUM_BLOCKS is not an integer size of blocks. |
4 |
1 |
4 |
203 |
ULTGUT0203E Failed to convert DISK_SIZE to a number of cylinders. |
4 |
1 |
4 |
204 |
ULTGUT0204E DISK_SIZE is not an integer size of cylinders. |
4 |
1 |
4 |
205 |
ULTMVM0205E memory size did not end with suffix ‘G’ or ‘M’. |
4 |
1 |
4 |
206 |
ULTMVM0206E Max memory size MAX_MEM_SIZE specified is less than initial memory size INIT_MEM_SIZE. |
4 |
1 |
4 |
207 |
ULTMVM0207E VDISK Size (swap disk) is greater than 2G. |
4 |
1 |
4 |
400 |
ULTGUT0400E The worker script SCRIPT_NAME does not exist. |
4 |
1 |
7 |
401 |
ULTGUT0401E Failed to punch FILE_LOCATION file to guest: USERID, out: OUTPUT |
4 |
1 |
5 |
402 |
ULTGUT0402E No information was found for the specified pool(s): DISK_POOL |
4 |
1 |
99 |
403 |
ULTGUT0403E Failed to purge reader file SPOOL_ID, out: OUTPUT |
4 |
1 |
8 |
404 |
ULTGUT0404E Failed to spool the punch to the specified class SPOOL_CLASS, out:OUTPUT |
4 |
1 |
6 |
405 |
ULTGUT0405E Unable to obtain information related to: KEYWORD. Command used was: CMD. Output was: OUTPUT |
4 |
1 |
9 |
406 |
ULTGUT0406E Failed to punch FILE_LOCATION because of VMUR timeout |
4 |
1 |
4 |
407 |
ULTGUT0407W Unable to spool reader to all classes, it is possible that there may be additional console files available that are not listed in the response. Response from CMD is OUTPUT |
4 |
1 |
4 |
408 |
ULTGUT0408E Error getting list of files in the reader to search for logs from user USERID. Response from CMD is OUTPUT |
4 |
1 |
4 |
409 |
ULTGUT0409E Unable to get console log for user USERID. The userid is either: not logged on, not spooling its console, or has not created any console output. Error rc=rs=8 returned from Image_Console_Get. |
4 |
1 |
4 |
410 |
ULTGUT0410E Unable to get console log for user USERID no spool files were found in our reader from this user, it is possible another process has already received them. |
4 |
1 |
4 |
411 |
ULTGUT0411E Unable to receive console output file. Reader not online. /sys/bus/ccw/drivers/vmur/0.0.000c/online = 0 |
4 |
1 |
4 |
412 |
ULTGUT0412E Malformed reply from SMAPI, unable to fill in performance information, exception: EXCEPTION, details: EXCEPTION_DETAILS, Response: OUTPUT |
4 |
1 |
4 |
423 |
ULTGUT0423W Unable to spool reader to all classes, it is possible that there may be additional console files available that are not listed in the response. Command: CMD, exception EXCEPTION, details EXCEPTION_DETAILS. Will attempt to continue processing. |
4 |
1 |
4 |
424 |
ULTGUT0424E Failed to transfer FILE_LOCATION file to guest: USERID, out: OUTPUT |
5 |
1 |
1 |
501 |
ULTGUT0501E Timeout Exception recevied on an attempt to execute a cmd: CMD, exception: EXCEPTION, details: EXCEPTION_DETAILS |
8 |
1 |
None |
None |
ULTSMP0300E SMAPI API failed: API_NAME, overall rc: OVERALLRC, rc: RC, rs: RS, errno: ERRNO, cmd: CMD, out: OUTPUT |
25 |
1 |
301 |
0 |
ULTSMP0301E SMAPI API failed: API_NAME, response header does not have the expected 3 values before the (details) string. cmd: CMD, response header: HEADER, out: OUTPUT |
25 |
1 |
302 |
0 |
ULTSMP0302E SMAPI API failed: API_NAME, word 1 in the response header is not an integer or in the range of expected values. word 1: WORD1, cmd: CMD, response header: HEADER, out: OUTPUT |
25 |
1 |
303 |
0 |
ULTSMP0303E SMAPI API failed: API_NAME, word 2 in the response header is not an integer. word 2: WORD2, cmd: CMD, response header: HEADER, out: OUTPUT |
25 |
1 |
304 |
0 |
ULTSMP0304E SMAPI API failed: API_NAME, word 3 in the response header is not an integer. word 3: WORD3, cmd: CMD, response header: HEADER, out: OUTPUT |
99 |
1 |
305 |
0 |
ULTSMP0305E Exception received on an attempt to communicate with SMAPI, cmd: CMD, exception: EXCEPTION, details: EXCEPTION_DETAILS |
99 |
1 |
99 |
413 |
ULTGUT0413E Userid ‘USERID’ did not enter the expected operating system state of ‘DESIRED_STATE’ in MAX_WAIT seconds. |
99 |
1 |
99 |
414 |
ULTGUT0414E Userid ‘USERID’ did not enter the expected virtual machine state of ‘DESIRED_STATE’ in MAX_WAIT seconds. |
99 |
1 |
99 |
416 |
ULTGUT0416E Command returned a response containing ‘KEYWORD’ but did not have at least NUM words following it. cmd: ‘CMD’, out: ‘OUTPUT’ |
99 |
1 |
99 |
417 |
ULTGUT0417E Command did not return the expected response containing ‘KEYWORD’, cmd: ‘CMD’, out: ‘OUTPUT’ |
99 |
1 |
99 |
418 |
ULTGUT0418E Userid USERID is not logged on to this system. |
99 |
1 |
99 |
419 |
ULTGUT0419E A relocation is not in progress for userid USERID. |
99 |
1 |
99 |
420 |
ULTGUT0420E An error occurred issuing a CMD for userid USERID. Please look up message(s): ERROR_CODE in the CP Messages book for more information. |
99 |
1 |
421 |
0 |
ULTGUT0421E Exception received on an attempt to execute a cmd: CMD, exception: EXCEPTION, details: EXCEPTION_DETAILS |
99 |
1 |
422 |
0 |
ULTGUT0422W Exception received on an attempt to execute a cmd: CMD, exception: EXCEPTION, details: EXCEPTION_DETAILS. Will attempt to continue processing. |
client errors |
||||
101 |
110 |
101 |
1 |
Request to zVM Cloud Connector failed: %(error)s |
101 |
110 |
101 |
2 |
Token file not found: %(error)s |
101 |
110 |
101 |
3 |
Request to url: %(url)s got unexpected response: status_code: %(status)s, reason: %(reason)s, text: %(text)s |
101 |
110 |
101 |
4 |
Get Token failed: %(error)s |
101 |
110 |
101 |
1 |
Failed to create client socket, error: %(error)s |
101 |
110 |
101 |
2 |
Failed to connect SDK server %(addr)s:%(port)s, error: %(error)s |
101 |
110 |
101 |
3 |
Failed to send all API call data to SDK server, only %(sent)d bytes sent. API call: %(api)s |
101 |
110 |
101 |
4 |
Client receive empty data from SDK server |
101 |
110 |
101 |
5 |
Client got socket error when sending API call to SDK server, error: %(error)s |
101 |
110 |
101 |
6 |
Client got socket error when receiving response from SDK server, error: %(error)s |
400 |
110 |
400 |
1 |
Invalid API name, ‘%(msg)s’ |
503 |
110 |
503 |
2 |
Service is unavailable. reason: %(reason)s, text: %(text)s |