Troubleshooting
Check the list below for help if you encounter a problem using the SDSF Java™ API.
| Problem | Solution |
|---|---|
| Not all columns returned for an object | Some columns are classified as "delayed" access, which means the data can be expensive to gather. These columns are not returned unless the delayed option is added to the request settings. Use the SDSF COLSHELP command to determine which columns are delayed. |
| Objects not returned | Be sure the request settings reflect the correct prefix and owner for a job. SDSF uses these settings when determining which objects to return. |
| Object not found or row token invalid | When you invoke a method on an object, such as cancel, the object must be valid. A job may be invalid, for example, if it has been purged and thus cannot be found. Examine the SDSF messages to determine why the request failed. |
| Too many objects returned | It is possible to generate requests that return an excessive number of objects. This may result in failures related to insufficient storage, or performance problems. Be sure to refine the request settings to return the fewest number of objects needed to satisfy a request. You should also limit the number of column values returned for each object. |
| Object no longer valid | A returned object contains a row token that SDSF uses to find the object on subsequent requests. The format of the token may vary across SDSF releases or maintenance levels. Therefore, it is expected that the object will be used on the same level of SDSF that gathered it. |
| Request failed with a non-zero return code | Be sure to examine the SDSF messages that describe any errors found by SDSF. To do this, use the getRunner().getRequestResults().getMessageList() method. |
| SDSF Java classes not found | The SDSF Java classes are packaged in a JAR file that by default is installed in /usr/include/java_classes/isfjcall.jar. Be sure this JAR file is in your application CLASSPATH. |
| Unsatisfied link error | The SDSF Java classes require that the SDSF DLL is included in your application LIBPATH. There are two versions of the DLL, based on whether your are running the 31-bit or 64-bit version of Java. By default, the DLLs are installed in /usr/lib/java_runtime (for 31-bit Java), and /usr/lib/java_runtime64 (for 64-bit Java). |
| Unable to modify an object property | You may not be authorized to modify the property. Even though you may be able to overtype the column interactively, the modify fails using SDSF Java. Verify that you are in the expected SDSF group. Use the who method of ISFRunner. Note that unless you are using SAF for security, your authority level may be different when using SDSF Java than when running interactively. |
| Method return code 16 (not authorized to SDSF) | Verify your authorization to use SDSF. Message ISF024I may have been issued to the system console. |