Documentation again! Error codes. Anybody? 2111

Question

Hi,
So, I have a server-side script error InDesign 2111 to resolve... Only I can't find _anywhere_ that lists InDesign error codes or their meanings.
I am _certain_ there is a very useful document out there somewhere, but it is opaque to google...
Please can somebody point me in the right direction?
Thanks,
G

Answer 1

For further analysis, write the properties of the error object to your log file / ESTK console / whatever.
E.g.
try { ...} catch( ex ) { for( n in ex ) $.writeln(n,"=",ex[n] ); }
Could it be that this is an error by the OS or any other subsystem (database, other connectivity) ?
Assuming an InDesign Error ID, those are allocated in the ID space of plugins. The same plugin should also provide a matching string and may even fill in placeholders in that string - as delivered in the alert or the one of the properties of the exception. That's the theory.
If you have the plugin SDK, you'd search for the 63th error in the header file for prefix 8, because 8*256+63=2111. That would be the file LayoutID.h . Unfortunately that file does not provide any error ID at all, and when I force that error myself there is also no string provided. I did not try InDesign Server, though.
Another place to look is the server's system output, which is separate from script accessible areas. Ask your admins to watch out for system log entries, and/or configure the server startup so that stderr output ends up in a file. On OSX refer to the man page for launchd, especially StandardErrorPath.
If you're lucky and have deployed on a Mac, make yourself familiar with dtrace or the Instruments application. There you can watch out for system calls that produce any error code, search for the 2111 and try to make sense from stack frames. On Windows, the SysInternals program may have similar tools.
Dirk