Alan Cox <[EMAIL PROTECTED]> writes:
> Ok now that bit does have an equivalent in its own unix
> think. Unix programs
> make heavy use of error codes when they exit. Thus you'll find the man
> pages fairly religiously document the error codes on exit

That's the same in mainframe environments too (hence the "Codes" part
of the "Messages and Codes" manual titles).  In online documentation
(e.g., CMS "HELP") these values are usually exlained as well.  For example,
"HELP COPY" produces (among the 992 lines of information) the following
tidbit.  Commands for the VM hypervisor (CP) are even easier - the return
code is the same as the numeric portion of the message identifier.

        Messages and Return Codes

        To display information on a specific error message enter HELP MSG and the
        message identifier, for example: HELP MSG DMS111E.

        DMS002E   File((s)) (fn (ft (fm))) not found (RC=28)
        DMS002E   Input file((s)) (fn (ft (fm))) not found (RC=28)
        DMS002E   Overlay file((s)) (fn (ft (fm))) not found (RC=28)
        DMS003E   Invalid option: option (RC=24)
        DMS024E   File fn ft fm already exists; specify REPLACE option (RC=28)
        DMS029E   Invalid parameter parameter in the option option field (RC=24)
        DMS030E   File fn ft fm already active (RC=28)
        DMS037E   Filemode mode((vdev)) is accessed as read/only (RC=36)
        DMS037E   Base file for fn ft fm is in a DIRCONTROL directory accessed 
read/only (RC=36)
        DMS042E   No fileid(s) specified (RC=24)
        DMS048E   Invalid filemode mode (RC=24)
        DMS054E   Incomplete fileid specified (RC=24)
        DMS062E   Invalid character char in fileid fn ft (fm) (RC=20)
        DMS063E   No (sort|translation|specification) list <entered|given> (RC=40)
        DMS064E   Invalid (translate) specification at or near list (RC=24)
        DMS065E   option option specified twice (RC=24)
        DMS066E   option1 and option2 are conflicting options (RC=24)
        DMS067E   Combined input files illegal with PACK or UNPACK options (RC=24)
        DMS068E   Input file fn ft fm not in packed format (RC=32)
        DMS069E   Filemode mode not accessed (RC=36)
        DMS101S   SPECS temp string storage exhausted at storarea (RC=88)
        DMS102S   Too many fileids (RC=88)
        DMS103S   Number of SPECS exceeds maximum nn (RC=88)
        DMS104S   Error nn reading file fn ft fm (RC=100)
        DMS105S   Error nn writing file fn ft fm on disk or directory (RC=100)
        DMS156E   FROM nnn not found--the file fn ft fm has only nnn records (RC=32)
        DMS157E   Label label not found in file fn ft fm (RC=32)
        DMS172E   TOLABEL label <equals|is an initial substring of> FRLABEL label 
(RC=24)
        DMS173E   No records were copied to output file fn ft fm (RC=40)
        DMS173E   Empty output file fn ft fm not created (RC=40)
        DMS173E   No records were copied to output file fn ft fm (RC=40)
        DMS901T   Unexpected error at vstor1: plist function fn ft fm at vstor2, base 
vstor3, rc nn (RC=256)
        DMS903T   Impossible PHASE code xx (RC=256)
        DMS904T   Unexpected UNPACK error at vstor1, base vstor2 (RC=256)
        DMS516E   An existing variable-length record in an SFS file cannot be replaced 
with one of a different length. (RC=32)
        DMS1141W  User filespace threshold (still) exceeded (for file pool filepoolid)
        DMS1144E  Implicit rollback occurred for work unit workunitid (RC=31)
        DMS1184E  File fn ft fm not found or you are not authorized for it (RC=28)
        DMS1229E  OVERLAY|INPUT file fn ft fm is empty (RC=32)
        DMS1252T  Rollback unsuccessful for file pool filepoolid
        DMS1258E  You are not authorized to write to file fn ft fm (RC=76)
        DMS1259E  File pool filepoolid has run out of physical space in the storage 
group (RC=40)
        DMS1262S  Error nnn closing file fn ft fm (RC=31)
        DMS2153E  File fileid1 is migrated and DFSMS/VM Recall processing is not 
active (RC=51)
        DMS2154E  File fileid1 is migrated and implicit RECALL is set to OFF (RC=50)
        DMS2155E  SFS error errorid in filepool filepoolid occurred during recall of 
file fn ft fm (RC=51)

>                                                           (an extreme
> example being sendmail)...

In this as in all other things!  :-)

Ross Patterson
Computer Associates

Reply via email to