Item PL77971 APAR Identifier ...... PL77971 Last Changed ........ 92/06/10 OGL/370 RETURN CODES ARE NOT DOCUMENTED. MSGDZI0320I Symptom ...... DD MSGDZI0703I Status ........... CLOSED DOC Severity ................... 4 Date Closed ......... 91/06/12 Component .......... 568819101 Duplicate of ........ Reported Release ......... 100 Fixed Release ............ Component Name OGL/370 Special Notice Current Target Date .. Flags SCP ................... Platform ............ Status Detail: Not Available PE PTF List: PTF List: Parent APAR: Child APAR list: ERROR DESCRIPTION: NEITHER THE OGL/370 DIAGNOSIS GUIDE AND REFERENCE, LH400208 OR THE USER'S GUIDE AND REFERENCE, S5443702 PROVIDE THE MEANING OF RETURN CODES ISSUED BY OGL FINAL DISPOSITION MSGDZI0703I. RC8 RETURN CODE 8 IS ONLY A WARNING AND OUTPUT MAY BE ACCEPTABLE. A RC8 WOULD NORMALLY INDICATE A MAJOR ERROR AND THAT EXECUTION WILL PROBABLY NOT BE SUCCESSFUL. LOCAL FIX: PROBLEM SUMMARY: **************************************************************** * USERS AFFECTED: USERS OF OGL/370. * **************************************************************** * PROBLEM DESCRIPTION: THE RETURN CODES SET BY OGL/370 ARE NOT * * DOCUMENTED IN THE PUBLICATIONS. * **************************************************************** * RECOMMENDATION: REFER TO THE UPDATED DOCUMENTATION * **************************************************************** THE FOLLOWING TEXT WILL BE ADDED TO APPENDIX L OF THE USER'S GUIDE AND REFERENCE MANUAL, S5443702 WHEN NEXT UPDATED: THE FOLLOWING RETURN CODES ARE SET BY OGL/370 AND RETURNED TO THE USER THROUGH THE SYSTEM MESSAGE WHICH INDICATES JOB COMPLETION. FOR ALL RETURN CODES THROUGH 8, THE SAMPLE OVERLAY WILL ALWAYS BE GENERATED AND AVIALABLE FOR PRINT. FOR RETURN CODE 12, THE SAMPLE OVERLAY WILL GENERALLY BE CREATED AND AVAILABLE FOR PRINT. FOR RETURN CODE 16, THE SAMPLE OVERLAY WILL NOT BE GENERATED. FOLLOWING ARE THE RETURN CODES GENERATED WITH THEIR DESCRIPTION: RC=0 JOB COMPLETED SUCCESSFULLY WITH NO ERRORS. RC=4 JOB COMPLETED SUCCESSFULLY WITH INFORMATIONAL MESSAGES. THE OVERLAY IS COMPLETE AND CORRECT. THE INFORMATIONAL MESSAGES INDICATE PROCESSES PERFORMED BY OGL DURING THE COMPILATION. RC=8 JOB COMPLETED SUCCESSFULLY WITH WARNING MESSAGES. THE OVERLAY IS COMPLETE, BUT SOME PART OF THE OVERLAY, SUCH AS SOME TEXT THAT COULD NOT BE PRINTED, IS INDICATED IN THE JOB LISTING. THESE WARNINGS INDICATE THAT THE OVERLAY MAY NOT BE SATISFACTORY FOR A FINAL COPY AND THE SOURCE SHOULD BE CORRECTED AND RE-COMPILED. RC=12 OGL COMPLETED THE OVERLAY COMPILATION, BUT PARTS OF THE OVERLAY MAY NOT BE PRINTABLE DUE TO, FOR EXAMPLE, A RESOURCE SUCH AS A FONT, NOT BEING AVAILABLE TO OGL AT COMPILE TIME. TO MAKE THE OVERLAY ACCEPTABLE, YOU MUST CORRECT THE FAILURES INDICATED BY THE ERROR MESSAGES PRINTED IN THE COMPILED LISTING. RC=16 OGL HAS ENCOUNTERED A TERMINATING CONDITION WHICH WILL NOT ALLOW CONTINUED PROCESSING. AN EXAMPLE WOULD BE IF THE MESSAGE MODULES FOR THE LANGUAGE REQUESTED WHEN THE OVERLAY JOB WAS SUBMITTED COULD NOT BE LOADED BY THE OPERATING SYSTEM. OTHER EXAMPLES INCLUDE I/O FAILURES WHEN ATTEMPTING TO WRITE TO THE OUTPUT DATA SETS (OR READ FROM THE INPUT DATA SET), INSUFFICIENT STORAGE FOR OGL TO CREATE ITS INTERNAL DATA AND DATA BUFFERS (USUALLY AN ABEND), OR OTHER ABENDING CONDITIONS. PROBLEM CONCLUSION: THE OGL/370 USERS GUIDE AND REFERENCE (S5443702 - 00) WILL BE MODIFIED TO REFLECT THE RETURN CODES SET BY OGL/370 AND THEIR MEANINGS. THIS WILL BE CONTAINED IN THE MESSAGES/CODES APPENDIX (APPENDIX L). TEMPORARY FIX: COMMENTS: MODULES/MACROS: SRLS: S544370200 LH40020800 RTN CODES: CIRCUMVENTION: RP92/05/12 REPINNED FOR SUMMARY PAGE EDIT/AUTOPINE MESSAGE TO SUBMITTER: