Error Codes
Use error codes to determine application problems.
The following table lists InfoSphere® DataStage® API error codes in alphabetic order:
| Error Token | Code | Description |
|---|---|---|
| DSJE_ACCOUNTPATHFAILED | -140 | Failed to get account path. |
| DSJE_ADDPROJECTBLOCKED | -134 | Another user is adding a project. |
| DSJE_ADDPROJECTFAILED | -135 | Failed to add project. |
| DSJEBADBOOLEANVALUE | -118 | Invalid value given for a boolean environment variable. |
| DSJE_BADENVVAR | -116 | Environment variable does not exist. |
| DSJE_BADENVVARNAME | -108 | Invalid environment variable name. |
| DSJE_BADENVVARTYPE | -109 | Invalid environment variable type. |
| DSJE_BADENVVARPROMPT | -110 | No prompt supplied. |
| DSJE_BADHANDLE | -1 | Invalid JobHandle. |
| DSJE_BADLINK | -9 | LinkName does not refer to a known link for the stage in question. |
| DSJE_BADLISTVALUE | -120 | Invalid value given for a list environment variable. |
| DSJE_BADNAME | -12 | Invalid project name. |
| DSJE_BADNUMERICVALUE | -119 | Invalid value given for an integer environment variable. |
| DSJE_BADPARAM | -3 | ParamName is not a parameter name in the job. |
| DSJE_BADPROJECT | -1002 | ProjectName is not a known InfoSphere DataStage project. |
| DSJE_BADPROJLOCATION | -130 | Invalid path name supplied. |
| DSJE_BADPROJNAME | -128 | Invalid project name supplied. |
| DSJE_BADPROPERTY | -104 | Unknown property name. |
| DSJE_BADPROPVALUE | -106 | Invalid value for this property. |
| DSJE_BADSTAGE | -7 | StageName does not refer to a known stage in the job. |
| DSJE_BADSTATE | -2 | Job is not in the right state (compiled, not running). |
| DSJE_BADTIME | -13 | Invalid StartTime or EndTime value. |
| DSJE_BADTYPE | -5 | Information or event type was unrecognized. |
| DSJE_BAD_VERSION | -1008 | The engine does not support this version of the InfoSphere DataStage API. |
| DSJE_BADVALUE | -4 | Invalid MaxNumber value. |
| DSJE_CLEARSCHEDULEFAILED | -127 | Failed to clear scheduled jobs for project. |
| DSJE_DECRYPTERR | -15 | Failed to decrypt encrypted values. |
| DSJE_DELETEPROJECTBLOCKED | -138 | Project locked by another user. |
| DSJE_DELPROJFAILED | -124 | Failed to delete project definition. |
| DSJE_DELPROJFILESFAILED | -125 | Failed to delete project files. |
| DSJE_DUPENVVARNAME | -115 | Environment variable being added already exists. |
| DSJE_ENCODEFAILED | -123 | Failed to encode an encrypted value. |
| DSJE_GETDEFAULTPATHFAILED | -129 | Failed to determine default project directory. |
| DSJE_INCOMPATIBLE_SERVER | -1009 | The engine version is incompatible with this version of the InfoSphere DataStage API. |
| DSJE_ISADMINFAILED | -101 | Failed to determine whether user is an administrator. |
| DSJE_ISPARALLELLICENCED | -122 | Failed to determine if parallel jobs are available. |
| DSJE_INVALIDPROJECTLOCATION | -131 | Invalid path name supplied. |
| DSJE_JOBDELETED | -11 | The job has been deleted. |
| DSJE_JOBLOCKED | -10 | The job is locked by another process. |
| DSJE_LICENSEPROJECTFAILED | -136 | Failed to license project. |
| DSJE_LISTSCEDULEFAILED | -126 | Failed to get list of scheduled jobs for project. |
| DSJE_LOGTOFAILED | -141 | Failed to log to UV account. |
| DSJE_NOACCESS | -16 | Cannot get values, default values, or design default values for any job except the current job. |
| DSJE_NO_DATASTAGE | -1003 | InfoSphere DataStage is not installed on the system. |
| DSJE_NOERROR | 0 | No InfoSphere DataStage API error has occurred. |
| DSJE_NO_MEMORY | -1005 | Failed to allocate dynamic memory. |
| DSJE_NOMORE | -1001 | All events matching the filter criteria have been returned. |
| DSJE_NOTADMINUSER | -100 | User is not an administrator. |
| DSJE_NOTAPROJECT | -139 | Failed to log to project. |
| DSJE_NOT_AVAILABLE | -1007 | The requested information was not found. |
| DSJE_NOTINSTAGE | -8 | Internal engine error. |
| DSJE_NOTUSERDEFINED | -117 | Environment variable is not user-defined and therefore cannot be deleted. |
| DSJE_OPENFAIL | -1004 | The attempt to open the job failed - perhaps it has not been compiled. |
| DSJE_OPENFAILED | -132 | Failed to open UV.ACCOUNT file. |
| DSJE_OSHVISIBLEFLAG | -107 | Failed to get value for OSHVisible. |
| DSJE_PROPNOTSUPPORTED | -105 | Unsupported property. |
| DSJE_PXNOTINSTALLED | -121 | Environment variable is specific to parallel jobs which are not available. |
| DSJE_READENVVARDEFNS | -111 | Failed to read environment variable definitions. |
| DSJE_READENVVARVALUES | -112 | Failed to read environment variable values. |
| DSJE_READPROJPROPERTY | -102 | Failed to read property. |
| DSJE_READUFAILED | -133 | Failed to lock project create lock record. |
| DSJE_RELEASEFAILED | -137 | Failed to release project create lock record. |
| DSJE_REPERROR | -99 | General engine error. |
| DSJE_SERVER_ERROR | -1006 | An unexpected or unknown error occurred in the engine. |
| DSJE_TIMEOUT | -14 | The job appears not to have started after waiting for a reasonable length of time. (About 30 minutes.) |
| DSJE_UNKNOWN_JOBNAME | -201 | The supplied job name cannot be found in the project. |
| DSJE_WRITEENVVARDEFNS | -113 | Failed to write environment variable definitions. |
| DSJE_WRITEENVVARVALUES | -114 | Failed to write environment variable values. |
| DSJE_WRITEPROJPROPERTY | -103 | Property not supported. |
| DSJE_WRONGJOB | -6 | Job for this JobHandle was not started from a call to DSRunJob by the current process. |
The following table lists InfoSphere DataStage API error codes in numeric order:
| Code | Error Token | Description |
|---|---|---|
| 0 | DSJE_NOERROR | No InfoSphere DataStage API error has occurred. |
| -1 | DSJE_BADHANDLE | Invalid JobHandle. |
| -2 | DSJE_BADSTATE | Job is not in the right state (compiled, not running). |
| -3 | DSJE_BADPARAM | ParamName is not a parameter name in the job. |
| -4 | DSJE_BADVALUE | Invalid MaxNumber value. |
| -5 | DSJE_BADTYPE | Information or event type was unrecognized. |
| -6 | DSJE_WRONGJOB | Job for this JobHandle was not started from a call to DSRunJob by the current process. |
| -7 | DSJE_BADSTAGE | StageName does not refer to a known stage in the job. |
| -8 | DSJE_NOTINSTAGE | Internal engine error. |
| -9 | DSJE_BADLINK | LinkName does not refer to a known link for the stage in question. |
| -10 | DSJE_JOBLOCKED | The job is locked by another process. |
| -11 | DSJE_JOBDELETED | The job has been deleted. |
| -12 | DSJE_BADNAME | Invalid project name. |
| -13 | DSJE_BADTIME | Invalid StartTime or EndTime value. |
| -14 | DSJE_TIMEOUT | The job appears not to have started after waiting for a reasonable length of time. (About 30 minutes.) |
| -15 | DSJE_DECRYPTERR | Failed to decrypt encrypted values. |
| -16 | DSJE_NOACCESS | Cannot get values, default values, or design default values for any job except the current job. |
| -99 | DSJE_REPERROR | General engine error. |
| -100 | DSJE_NOTADMINUSER | User is not an administrator. |
| -101 | DSJE_ISADMINFAILED | Failed to determine whether user is an administrator. |
| -102 | DSJE_READPROJPROPERTY | Failed to read property. |
| -103 | DSJE_WRITEPROJPROPERTY | Property not supported. |
| -104 | DSJE_BADPROPERTY | Unknown property name. |
| -105 | DSJE_PROPNOTSUPPORTED | Unsupported property. |
| -106 | DSJE_BADPROPVALUE | Invalid value for this property. |
| -107 | DSJE_OSHVISIBLEFLAG | Failed to get value for OSHVisible. |
| -108 | DSJE_BADENVVARNAME | Invalid environment variable name. |
| -109 | DSJE_BADENVVARTYPE | Invalid environment variable type. |
| -110 | DSJE_BADENVVARPROMPT | No prompt supplied. |
| -111 | DSJE_READENVVARDEFNS | Failed to read environment variable definitions. |
| -112 | DSJE_READENVVARVALUES | Failed to read environment variable values. |
| -113 | DSJE_WRITEENVVARDEFNS | Failed to write environment variable definitions. |
| -114 | DSJE_WRITEENVVARVALUES | Failed to write environment variable values. |
| -115 | DSJE_DUPENVVARNAME | Environment variable being added already exists. |
| -116 | DSJE_BADENVVAR | Environment variable does not exist. |
| -117 | DSJE_NOTUSERDEFINED | Environment variable is not user-defined and therefore cannot be deleted. |
| -118 | DSJE_BADBOOLEANVALUE | Invalid value given for a boolean environment variable. |
| -119 | DSJE_BADNUMERICVALUE | Invalid value given for an integer environment variable. |
| -120 | DSJE_BADLISTVALUE | Invalid value given for a list environment variable. |
| -121 | DSJE_PXNOTINSTALLED | Environment variable is specific to parallel jobs which are not available. |
| -122 | DSJE_ISPARALLELLICENCED | Failed to determine if parallel jobs are available. |
| -123 | DSJE_ENCODEFAILED | Failed to encode an encrypted value. |
| -124 | DSJE_DELPROJFAILED | Failed to delete project definition. |
| -125 | DSJE_DELPROJFILESFAILED | Failed to delete project files. |
| -126 | DSJE_LISTSCHEDULEFAILED | Failed to get list of scheduled jobs for project. |
| -127 | DSJE_CLEARSCHEDULEFAILED | Failed to clear scheduled jobs for project. |
| -128 | DSJE_BADPROJNAME | Invalid project name supplied. |
| -129 | DSJE_GETDEFAULTPATHFAILED | Failed to determine default project directory. |
| -130 | DSJE_BADPROJLOCATION | Invalid path name supplied. |
| -131 | DSJE_INVALIDPROJECTLOCATION | Invalid path name supplied. |
| -132 | DSJE_OPENFAILED | Failed to open UV.ACCOUNT file. |
| -133 | DSJE_READUFAILED | Failed to lock project create lock record. |
| -134 | DSJE_ADDPROJECTBLOCKED | Another user is adding a project. |
| -135 | DSJE_ADDPROJECTFAILED | Failed to add project. |
| -136 | DSJE_LICENSEPROJECTFAILED | Failed to license project. |
| -137 | DSJE_RELEASEFAILED | Failed to release project create lock record. |
| -138 | DSJE_DELETEPROJECTBLOCKED | Project locked by another user. |
| -139 | DSJE_NOTAPROJECT | Failed to log to project. |
| -140 | DSJE_ACCOUNTPATHFAILED | Failed to get account path. |
| -141 | DSJE_LOGTOFAILED | Failed to log to UV account. |
| -201 | DSJE_UNKNOWN_JOBNAME | The supplied job name cannot be found in the project. |
| -1001 | DSJE_NOMORE | All events matching the filter criteria have been returned. |
| -1002 | DSJE_BADPROJECT | ProjectName is not a known InfoSphere DataStage project. |
| -1003 | DSJE_NO_DATASTAGE | InfoSphere DataStage is not installed on the system. |
| -1004 | DSJE_OPENFAIL | The attempt to open the job failed - perhaps it has not been compiled. |
| -1005 | DSJE_NO_MEMORY | Failed to allocate dynamic memory. |
| -1006 | DSJE_SERVER_ERROR | An unexpected or unknown error occurred in the engine. |
| -1007 | DSJE_NOT_AVAILABLE | The requested information was not found. |
| -1008 | DSJE_BAD_VERSION | The engine does not support this version of the InfoSphere DataStage API. |
| -1009 | DSJE_INCOMPATIBLE_SERVER | The engine version is incompatible with this version of the InfoSphere DataStage API. |
The following table lists some common errors that might be returned from the lower-level communication tiers:
| Error Number | Description |
|---|---|
| 39121 | The InfoSphere DataStage license has expired. |
| 39134 | The InfoSphere DataStage user limit has been reached. |
| 80011 | Incorrect system name or invalid user name or password provided. |
| 80019 | Password has expired. |