HP 3000 Manuals HP 3000 Manuals
Error Handling
The HPDESKERR JCW is used to obtain error codes. A value of 0 in this
JCW indicates that an action has been successful.
When an application attempts to suspend HP Desk, it should have a
procedure which will set up a variable for the HPDESKPROCCONTROL JCW.
In the case of a simple Interrupt Mode 1, it should set up a variable
containing the value of 1 and do a PUTJCW to set the value of
HPDESKPROCCONTROL to 1. It should then set up a buffer with HPDESKERR,
using FINDJCW to check that the value in HPDESKERR is zero (0). If it is
not 0, the procedure should report the error and perform the recovery.
Finally the application should suspend.
The other Interrupt Modes are carried out in the same way except that an
area of the program file is set up for the relevant data. For example,
for Interrupt Mode 2 (return file to HP Desk), the XDS field Description
in the program file will contain the filename and subject. Your
procedure should perform a DMOVOUT to write the filename and subject to
the HP Desk XDS and then suspend. Error checking is done in the same way
as for Interrupt Mode 1.
The error messages which could appear when using Application Data Passing
or the HP Menu Intrinsics are listed on the next page. Note that some
return values are negative. These are considered to be warnings and not
true errors by HP Desk, although your application may think differently!
1 to 255 - FS errors encountered handling the file.
1000 - No filename given or current object not set up.
1002 - Cannot find an item with the required subject name.
1003 | User does not have HP Desk create capability, therefore nothing can be
| created or returned.
1004 | Database full. The HP Desk database is full so the passed file cannot be
| copied into the database.
1005 | The item is too big. Its size exceeds the maximum size as set up by the
| administrator in the configurator Data menu.
1006 - Illegal value given in HPDESKPROCCONTROL.
1008 - Conversion to the requested type is not possible.
1009 - Could not read or set the current object.
1010 - Cannot access the current object number JCW (HPDESKOBJNUM).
1011 - Internal error processing request - action not completed.
1012 - Current object number out of range.
1013 - Cannot read or write the information in the XDS.
1014 - Item to be updated is composite, not basic, for example, a package.
1015 - Help page is not installed.
1016 | User returned without copying the Clipboard item anywhere from within HP
| Desk.
1017 - User returned without copying anything to the Clipboard in HP Desk.
1018 - User lacks SF capability.
1019 - Forms application not invoked while in forms package.
1020 - Too many items in the forms package (more than 2048).
1021 - Forms package has no batch files in it.
1022 - Initialize forms processing (Mode 7) must have been performed first.
1023 - Last interrupt to initialize forms processing did not succeed.
-1024 | No more forms files left. (This is a warning - Mode 7 can be used to
| reinitialize.)
1025 - User does not have HP Desk READ capability.
1026 - User does not have HP Desk COPY capability.
1027 - User does not have HP Desk EDIT capability.
1028 - Mode not allowed as user is already in interrupt.
1029 - Invalid help page number (<0 or >9999) referenced by HPDESKHELPPAGE JCW.
1030 - Invalid length given in keywords length field.
1031 - Invalid length given in comments length field.
1032 - Catalog name not given and cannot ask for it.
1033 | Catalog does not exist, or is not accessible to this user, or more than one
| with same name exists.
1034 - Failed to add entry to catalog (internal error).
1035 - Item is encrypted and user cannot be prompted for the key.
1036 - Item is currently being read/edited by someone.
-1037 - Item could not be converted to text. (This is a warning.)
1038 - Item is a package/message/folder.
1039 - User's Work Area is over their limit, file not copied in.
1040 - The area does not contain accessible items.
1041 - There is no item with that number.
1042 - The item has been deleted.
1043 - The item is offline or archived.
1044 - Son process still active.
-1045 - No new mail has been received. (This is a warning.)
1046 - Script file not accessible
1047 - Script file not fixed record text file