8. Error Codes and Messages

This is a reference to z/VM Cloud Connector 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 smut error: ‘%(err)s’.
300 10 300 7 Failed to live resize cpus of guest: ‘%(userid)s’, error: define new cpu to active failed with smut 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 smut error: ‘%(err)s’.
300 10 300 10 Failed to resize memory of guest: ‘%(userid)s’, error: replace user entry failed with smut error: ‘%(err)s’.
300 10 300 11 Failed to live resize memory of guest: ‘%(userid)s’, error: define standby memory failed with smut error: ‘%(err)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
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
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.
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’.
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
smut 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 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 ULTMVM0204E memory size did not end with suffix ‘G’ or ‘M’.
4 1 4 206 ULTMVM0204E Max memory size MAX_MEM_SIZE specified is less than initial memory size INIT_MEM_SIZE.
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
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