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