ZD&T response error codes

If an error occurs when you use REST APIs, refer to the response error codes for detailed description.

Table 1. Response error codes
Error ID Description
10001 The source system already exists.
10002 The source system does not exist.
10003 The target environment already exists.
10004 The target environment does not exist.
10005 The image storage server already exists.
10006 The image storage server does not exist.
10007 The Licensing system ${hostname} already exists.
10008 The Licensing system ${hostname} does not exist.
10009 The Token system already exists.
10010 The Token system does not exist.
10011 The IBM® Application Discovery system already exists.
10012 The IBM Application Discovery system does not exist.
10013 The application image already exists.
10014 The application image does not exist.
10015 The component already exists.
10016 The component does not exist.
10017 The volume already exists.
10018 The volume does not exist.
10019 The cloud platform already exists.
10020 The cloud platform does not exist.
10027 Target environment hostname ${hostname} is not reachable.
10028 Create entity ${hostname} failed. Reason: ${lLocalizedMessage}
10029 Retrieve entity ${hostname} failed. Reason: ${errorMessage}
10030 Update entity ${hostname} failed. Reason: ${errorMessage}
10031 Delete entity ${hostname+componentName} failed. Reason: ${localizedMessage}
10101 Failed to connect to the remote host ${sshHost} on port ${sshPort}. Reason: ${localizedMessage}
10102 Token expired.
10200 Failed to connect to the server ${hostname} on port ${port}. Reason: ${localizedMessage}
10201 Connection refused.
10202 Invalid user ID or password.
10203 Invalid base directory.
10204 Invalid hostname for server ${httpsURL}
10205 Connection closed without indication.
10206 Failed to set the file transfer type.
10207 Failure when storing content on the image storage server.
10208 Failure when retrieving content from the image storage server.
10209 Failed to create directory ${pathElement+in+path / path} on the image storage server.
10210 Unable to access the directory ${pathElement+in+path / baseDirectory} on the image storage server.
10213 Internal Error.
11001 Installation files download failed.
11003 Deploy request parameter not passed.
11007 Invalid Linux platform of target system. Supported platforms are: Ubuntu 16.04, RedHat 6.x, and RedHat 7.x
11011 zPDT® installation script error: Parameters invalid.
11012 zPDT installation script error: Primary licensing server is required.
11013 zPDT installation script error: zPDT package name is required.
11014 zPDT installation script error: zPDT installation failed.
11015 zPDT installation script error: Init gen2 failed.
11016 zPDT installation script error: Client Config failed.
11020 Deploy script error: Parameters invalid.
11021 Deploy script error: Devmap required.
11022 Deploy script error: Devmap does not exist.
11023 Deploy script error: Parameter loadparam required.
11024 Deploy script error: Parameter IODF address required.
11025 Deploy script error: Emulator start up message not found.
11026 Deploy script error: Parameter device number required.
11027 Deploy script error: Z is not on.
11028 You cannot deploy to the same system running IBM Z Development and Test Environment Enterprise Edition.
11029 Target server is not available for deploy.
11030 Failed to create directory on the target environment.
11031 Changing the owner of volume/devmap to be ibmsys1 on the target system failed.
11032 Copying script file to /home/ibmsys1 failed.
11033 IBM Z Development and Test environment was not started successfully.
11034 The IPL of z/OS® running on IBM Z Development and Test Environment was not successful.
11035 Internal script error when installing ZD&T with missing path.
11036 Patch installation failed when installing zD&T.
11100 Some volume image files failed deploying.
11101 Changing the owner of volume image files failed.
11102 Executing command ${comand} on target environment ${hostname} failed.
11103 Generating devmap failed.
11104 Changing owner of devmap failed.
12000 A Failure occurred reading the devmap file.
12001 A Failure occurred parsing the devmap file.
12002 A Failure occurred writing the devmap file.
12003 Create application failed.
12004 The devmap file does not exist in the specified location.
12005 You do not have the permissions to access the devmap.
12006 You do not have the permissions to access the volume file.
12007 The IPL command for importing a zD&T image was not provided.
20001 Authorization token has expired. Login again.
20002 Authorization token was not supplied.
20003 User already exists.
20004 User does not exist.
21001 Tools server has a network error.
21002 Failed executing ssh command on ${sshHost}.
21003 Failed executing sftp command on ${sshHost}.
21004 Remote command execution at ${sshHost} has been running for too long.
21005 Sending/receiving files to/from ${sshHost} failed when ${doing}
30000 Source system hostname is required.
30001 Source system hostname is invalid.
30002 Application name is required.
30003 Application name is invalid.
30004 Authorization is required.
30005 Authorization is invalid.
30006 Application is required.
30007 Application is invalid.
30008 The application schedule date is invalid.
30009 The application schedule time is invalid.
30010 The application schedule date is required.
30011 The application schedule time is required.
30012 The application schedule timezone is invalid.
30013 The application schedule timezone is required.
30014 You cannot choose more than one component that contains system residence volumes.
30020 Component name is required.
30021 Component name is invalid.
30022 Volumes are required.
30023 Volumes are invalid.
30024 A dataset name filter string is required.
30025 The data set name filter string can not be * or **
30026 The selected data set list is required.
30040 Deploy preference is required.
30041 Deploy preference is invalid.
30042 Image storage server is required.
30043 Component is required.
30044 Licensing information is required.
30045 Target environment is required.
30046 Number of CPs is invalid.
30047 Memory size is invalid.
30048 Deployment label is required.
30049 Not enough CPs to start the emulator.
30050 Not enough memory to start the emulator
30051 Type of storage server is required (for example FTP or SFTP)
30052 The cloud platform label is required.
30053 The user name who created the cloud platform configuration is required.
30054 The user name to login the cloud is required.
30055 The password of the user to login the cloud is required.
30056 The scope of the cloud is required.
30057 The deployment label is already existed.
30058 The deployment label is not found.
30059 The scope of the cloud is invalid.
30060 Request to import zDT image failed due to lack of input parameter.
30080 Target environment is required.
30081 Target environment is invalid.
30082 Source system is required.
30083 Source system is invalid.
30084 Image storage server is required.
30085 Image storage server is invalid.
30086 The IBM Application Discovery system is required.
30087 The IBM Application Discovery system information is invalid or empty.
30088 Port is invalid.
30089 The cloud platform is required.
30090 The endpoint URL of the cloud platform is required.
30091 The scope of the cloud platform is required.
30092 The domain name URL of the cloud platform is required.
30093 The project name URL of the cloud platform is required.
30094 The type of the cloud platform is required.
30095 The username of the cloud platform is required.
30096 The password of the cloud platform is required.
30097 No catalog found on the cloud platform.
30098 Authentication of the cloud platform has failed.
30099 Query on the cloud platform has failed.
30100 Credential is required.
30101 Credential is invalid.
30102 Token is required.
30103 Token is invalid.
30104 Target environment hostname is required.
30105 Target environment hostname is invalid.
30106 SSH port is required.
30107 SSH port is invalid.
30108 User id is required.
30109 Password is required.
30110 Your password has expired.
30111 Target environment label is required.
30112 Target environment label is invalid.
30113 A private key file is required.
30114 Saving private key for user ${username} failed!
30115 The file size cannot exceed 50KB.
30120 MVSDSALLOCATE is required.
30121 MVSDSALLOCATE is invalid.
30122 Parameter json string is required.
30123 Parameter json string is invalid.
30124 Image storage server hostname is required.
30125 Image storage server hostname is invalid.
30140 User is required.
30141 User is invalid.
30142 Username is required.
30143 Username is invalid.
30144 ADCD name is required.
30145 ADCD name already exists.
30146 User role is required.
30147 User role is invalid.
30148 User role does not exist.
31100 Cannot find the related record for given application and target environment.
31101 IPL parameters creation failed.
31102 Read properties file failed.
31103 Input stream contains a malformed Unicode escape sequence.
31104 Internal server error when attempting to read ADCD property file.
31105 No ADCD files.
31106 Wrong arguments passed to the configuring ADCD script.
31107 The specified log ${javaLogsPath} is not found.
31108 The application image size is 0 and could not be deployed to cloud platform.
31109 Deployment to this target system has already been started.
31110 Can not deploy to cloud using this REST API.
31111 Can not deprovision a target cloud instance while it is being provisioned.
31112 Can not deprovision a target cloud instance while it is being deployed.
31114 Can not deprovision a target cloud instance while it is being deprovisioned.
31300 Failed to list volumes.
31301 Missing or invalid parameters.
31302 Error allocating a file.
31303 Could not get the SMS settings.
31304 Could not get the spool volumes.
31305 Could not get the proclibs.
31306 Could not get the APF list.
31307 Could not get the TCP/IP settings.
31308 No SYSPRINT/stdout.
31309 The load library for the z/OS extraction tool is not APF authorized. Review section 6.1.7 in the Program Directory for IBM Z Development and Test Environment Enterprise Edition (Program Number 5725-G39, FMID HALMB00) for more information.
31310 READ access is not granted to the SAF profile in the class DASDVOL.
31311 The Volume image file cannot be opened: ${output}.
31312 Compression initialization failed - internal error.
31313 Cannot open the volume - internal error.
31314 Command invoked cannot execute.
31315 Command not found.
31316 Invalid argument given to the exit statement.
31317 Fatal error signal with return code ${retCode}.
31318 Dataset allocated failed.
31319 Volume ${volumeFileName} extraction failed.
31320 Failed to list data set.
31321 Failure retrieving IBM Z system information, return code: ${retCode}
31322 Retrieving volume information for data sets failed.
31323 No volume information retrieved for selected data sets.
31324 An ABEND occurred on the IBM Z with the following output. Please send this output along with the System Log to IBM support for further support. ${output}
31325 These data sets cannot be extracted because your user ID has insufficient access to read them: ${dsNames}
31326 These data sets cannot be extracted because their containing volume(s) cannot be found : ${dsNames}
31327 These data sets cannot be extracted because of unknown errors: ${dsNames}
31600 Parameter object required.
31601 Image service is not available on the cloud.
31602 The Openstack cloud image could not be found.
31603 The label of the cloud platform is required.
31604 The label of the cloud platform already exists.
31605 Network is required.
31606 The selection of flavor is required.
31607 The selection of server image is required.
31608 Compute service is not available on the cloud.
31609 Cannot find the specific flavor.
31612 ID is invalid.
31649 The default user ID is required.
31700 Target system still contains application image, so could not be deleted.
70999 Internal error acquiring information from z/OS.
79999 Error connecting to z/OS: ${zosName}.
99998 Unexpected exception.
99999 Unknown error.