NGL reason codes and return codes
This topics contains the reason codes and return codes that appear in many Next Generation Logger (NGL) messages.
The following table describes the return codes that appear in many NGL messages.
Return code | Description |
|---|---|
0 | The function was successful. |
4 | A warning condition has occurred, but processing continues. |
8 | An error has occurred. |
12 | A severe error has occurred. |
29 | A catastrophic error has occurred. |
NO ACT FLA | A task was inactive and the Pause Element Token release failed. |
The following table describes the reason codes that appear in many NGL messages.
Reason code | Identifier | Description |
|---|---|---|
Global reason codes | ||
4 | NGL_Parameter_error | The parameter list is incomplete or was not passed to the routine. |
8 | NGL_Registry_Not_ACtive | The NGL registry is not active. |
10 | NGL_DBCAPI_Error | An error occurred while issuing a command to the DBC API. |
11 | NGL_DBC_LQSRVC_Error | An error occurred while reading or writing data to the DBC local queue. |
12 | NGL_Not_Active | NGL is not active. |
13 | NGL_Storage_Obtain_Error | A storage obtain error occurred. |
14 | NGL_Storage_Free_Error | A storage free error occurred. |
15 | NGL_Name_Token_Ret_Error | A name token retrieval error occurred. |
16 | NGL_Name_Token_Cre_Error | A name token create error occurred. |
17 | NGL_Name_Token_Del_Error | A name token delete error occurred. |
40 | NGL_Latch_Obtain | A latch obtain error occurred. |
41 | NGL_Latch_Release | A latch release error occurred. |
42 | NGL_PET_Pause | A Pause Element Token pause error occurred. |
43 | NGL_PET_Release | A Pause Element Token release error occurred. |
255 | NGL_Abend_Occurred | An abend occurred during execution. |
NGL Agent Component | ||
20 | CMDP_Start_Logset_Parm_Error | Invalid parameters were found on the START LOGSET command. |
21 | CMDP_Start_Logset_Parm_Value | Invalid parameter value was entered on the START LOGSET command. |
23 | CMDP_Start_Logset_Activate_Err | LOGSET activation failed. |
24 | CMDP_Start_Logset_CCB_AllocErr | An NGL control block allocation failed on a LOGSET start. |
25 | CMDP_Start_Logset_ALESERVError | An ALESERV request to the client address space failed. |
NGL Client Component | ||
104 | CAGT_Parameter_error | The parameter list from the client product is missing a required parameter. |
105 | CAGT_Function_error | The function requested in the client product parameter list is invalid. |
106 | CAGT_Token_error | The token supplied in the client product parameter list is invalid. |
107 | CAGT_DBCAPI_Load_Error | The DBC API module failed to load properly |
108 | CAGT_DBCAPI_Init_failed | The DBC API initialization call failed. |
109 | CAGT_NGLCore_load_failed | An error occurred while loading the NGL core module NGL9KCMC. |
110 | CAGT_DBCAPI_Send_failed | An error occurred while sending a request to the DBC API. |
111 | CAGT_Attach_connect_monitor | The attach of the connection monitor retry task failed. |
112 | CAGT_Retry_not_allowed | The DBC connection is inactive, but retry is not allowed. |
113 | CAGT_Retry_In_Progress | The NGL client manager is in retry and the client request cannot be processed. |
114 | CAGT_Retry_At_Max | The maximum number of retries has been tried. |
115 | CAGT_Logset_Token_error | The NGL client token from the client call is invalid. |
116 | CAGT_Product_Not_Active | The NGL server is not active. |
117 | CAGT_Logset_Not_Active | The requested LOGSET is not active. |
118 | CAGT_DBCAPI_BLDL_Error | BLDL failure while loading the DBC API module. |
119 | CAGT_Storage_Obtain_Error | A storage obtain error occurred during an attempt to obtain private area storage. |
120 | CAGT_ALCB_Lock_Error | A lock could not be obtained for the ALCB chain. |
121 | CAGT_Core_Init_Error | The NGL core module did not initialize properly. |
122 | CAGT_Connection_Inactive | The connection to the DBC server is not active. |
123 | CAGT_Core_Not_Active | The NGL core is not active in the NGL server address space. |
124 | AGT_NGL_Service_NotActive | The NGL service agent did not activate. |
126 | CAGT_Retrieval_Failed | A retrieve or continue request failed. |
NGL Services Component | ||
203 | ACTL_Logset_Not_Active | The requested LOGSET is not active. |
204 | ACTL_Logset_Currently_Active | The requested LOGSET is currently active. |
205 | ACTL_No_XML_Buffer | A buffer to parse the XML document could not be obtained. |
206 | ACTL_XML_Parser_Failed | The parser for the XML failed. |
207 | ACTL_XML_Validate_Error | The LOGSET XML failed validation. |
208 | ACTL_Getstor_Failed | Work area storage could not be obtained. |
209 | ACTL_Registry_Error | Error occurred in reading or writing the registry. |
210 | ACTL_LOGSET_Already_Defined | The LOGSET being defined is already defined. |
214 | ACTS_STRUCTURE_Currently_Active | The structure requested for deletion is active. |
215 | ACTS_No_XML_Buffer | A buffer to parse the XML document cannot be obtained. |
216 | ACTS_XML_Parser_Failed | The parser for the XML failed. |
217 | ACTS_XML_Validate_Error | The structure XML failed validation. |
218 | ACTS_Getstor_Failed | Work area storage could not be obtained. |
219 | ACTS_Registry_Error | Error occurred in reading or writing the registry. |
224 | QSRB_Parameter_Error | The parameter list for the local queue service routine is missing required parameters. |
225 | QSRB_Storage_Error | Storage obtain error occurred in the local queue service routine. |
231 | WAITL_List_Full | The NGL ECB list full. |
232 | WAITL_Task_Terminated | An NGL attached task failed. |
233 | WAITL_SRB_Mode_Caller | The NGL attach routine was called by a SRB mode caller. |
234 | WAITL_Parameter_Error | The parameter list for the NGL attach routine is missing required parameters. |
240 | WORKQ_Add_WQE_Lock_Error | An error occurred while a work queue element was being added. |
241 | WORKQ_Delete_WQE_Lock_Error | An error occurred while a work queue element was being deleted. |
242 | WORKQ_Release_Error | An error occurred while a pause element was being released for a work queue element. |
NGL Core Component | ||
600 | MMGR_Parm_Error_NoTERMECB | No terminate ECB was provided for an MM request. |
601 | MMGR_Parm_Error_NoMMIB | No MMIB was provided for an MM request. |
602 | MMGR_Parm_Error_NoMMRE | No MMRE was provided for an MM request. |
603 | MMGR_Parm_Error_NoDDname | No ddname was provided for an MM connect request. |
604 | MMGR_Storage_Obtain_Error | Work area storage could not be obtained. |
605 | MMGR_PGFIX_Error | A page fix service failed. |
606 | MMGR_Format_Error | The formatting of a log file failed. |
607 | MMGR_Connect_Error | The connect request to a log file failed. |
608 | MMGR_PGFREE_Error | A page free error occurred while fixed pages were being freed. |
610 | MMGR_IOError | An I/O error occurred during the reading or writing of a log file. |
640 | LDSM_Allocate_Failed | A dynamic allocation of the LOGSET log file failed. |
641 | LDSM_Registry_Error | A read or update to NGL registry failed. |
642 | LDSM_Open_Failed | A connection to the LOGSET log file failed. |
643 | LDSM_Dynalloc_Failed | A dynamic allocation function failed. |
644 | LDSM_Connect_Failed | A connection to the LOGSET log file failed. |
645 | LDSM_Format_Failed | The formatting of a LOGSET log file failed. |
646 | LDSM_Catalog_Error | An error occurred while information was being retrieved from the z/OS catalog. |
647 | LDSM_GETDSAB_Error | A get request of a DSCB failed. |
648 | LDSM_UCBLOOK_Error | A UCBLOOK function failed. |
649 | LDSM_ReadCP_Error | An error occurred during the reading of the control page from a log file. |
650 | LDSM_No_Candidate | No LGDE candidate is available for log switch. |
651 | LDSM_Invalid_Status | An invalid LGDE status occurred on archive completion. |
652 | LDSM_Disconnect_Failed | A disconnect request to a log file failed. |
653 | LDSM_No_Logset_Active | There are no active LOGSETs. |
654 | LDSM_Logset_Not_Active | The requested LOGSET is not active. |
655 | LDSM_Service_Request_Failed | A service request for the LOGSET failed. |
656 | LDSM_Not_Archive_Logset | The requested LOGSET is does not have archive options specified in the LOGSET definition. |
660 | KI00_Invalid_Control_Page | The NGL control page on the log file is invalid or the log file was improperly formatted. |
661 | KI00_ReadCP_Failed | A read of a log file control page failed. |
662 | KI00_WriteCP_Failed | A write of a log file control page failed. |
663 | KI00_LSDB_Not_Found | A LOGSET descriptor block for the LOGSET was not found. |
664 | KI00_LSSB_Not_Found | A block descriptor for the structure was not found. |
665 | KI00_Pagefix_Failed | A PGFIX request failed. |
666 | KI00_PageUnfix_Failed | A PGUNFIX request failed. |
699 | KCMC_Invalid_Function | An internal function failed due to an invalid function request from caller. |
700 | KC00_Storage_Obtain_Error | An error occurred during a storage obtain request. |
701 | KC00_Initial_Read_Error | A read request to a LOGSET log file failed during LOGSET start. |
720 | KCMI_Logset_Start_Failure | The start of a LOGSET failed. |
721 | KCMI_LGSPC_NSTARTED | The LOGSET has never been started. |
722 | KCMI_LGSPC_ASTARTED | The LOGSET is already started. |
723 | KCMI_LGSPC_STARTING | The LOGSET is in a STARTING status. |
724 | KCMI_LGSPC_TERMINATING | The LOGSET is in a TERMINATING status. |
725 | KCMI_LGSPC_TERMINATED | The LOGSET is in a TERMINATED status. |
726 | KCMI_SKP_SERVER_ADRSPC | The requested function is not allowed in the NGL server address space. |
727 | KCMI_ALREADY_OWNED | The LOGSET is currently owned by another NGL on the sysplex. |
728 | KCMI_CA_NMTOK_CRT | A name token create error occurred for the CA at the system level. |
729 | KCMI_JL_NMTOK_CRT | A name token create error occurred for the CA at the job step level. |
730 | KCMI_JL_NMTOK_RET | A name token retrieval error occurred for the CA at the job step level. |
731 | KCMI_LATCH_OBTAIN | An OBTAIN LATCH failed. |
732 | KCMI_LATCH_RELEASE | A LATCH RELEASE request failed. |
733 | KCMI_TASK_START | A task is starting. |
734 | KCMI_TASK_HUNG | A task is hung. |
735 | KCMI_JOBSTEP_STORAGE | An obtain request failed for job step storage. |
736 | KCMI_ENQDEQ_ERROR | An enqueue or dequeue failed. |
740 | KCMT_Wrong_Mode | The wrong mode was specified for function request. |
741 | KCMT_Core_Anchor_Not_Found | The CA address was not found. |
742 | KCMT_Logset_Not_Started | The requested LOGSET is inactive. |
743 | KCMT_Logset_Start_Active | The LOGSET is in a start active status. |
744 | KCMT_Logset_Terminating | The LOGSET is in a terminating status. |
745 | KCMT_Logset_Terminated | The LOGSET is already terminated. |
746 | KCMT_Task_Hung_At_Term | NGL core tasks are still active at NGL LOGSET termination. |
760 | KCML_Record_Length_Invalid | The source record length is invalid on a LOG request. |
761 | KCML_Index_Length_Invalid | The index length is invalid on a LOG request. |
762 | KCML_Logset_Buffers_Full | The LOGSET buffers are full. |
763 | KCML_Logset_Not_Available | The LOGSET is not available or inactive. |
764 | KCML_Chunk_Too_Small | The chunk size is too small to hold the requested record. |
765 | KCML_No_Structure | There is no structure definition for LOGSET and KEYBUFF is zeros. |
766 | KCML_Rectype_Not_Found | A record type was not found in the structure definition. |
770 | KIRW_WriteChunk_Failed | The write request of a chunk failed. |
771 | KIRW_PageFix_Failed | A pagefix request failed. |
772 | KIRW_PageUnfix_Failed | A page unfix failed. |
773 | KIRW_Latch_Obtain | Error occurred while a latch was being acquired. |
774 | KIRW_Latch_Release | Error occurred while a latch was being freed. |
775 | KIRW_No_Buffers_Avail | No buffers are available to write a chunk. |
780 | KIRD_ReadChunk_Failed | The read request of a chunk failed. |
781 | KIRD_PageFix_Failed | A page fix error occurred. |
782 | KIRD_PageUnfix_Failed | A page free error occurred. |
790 | KCMR_No_Retrieve_Token | The NGL token required to retrieve data is not supplied. |
791 | KCMR_Invalid_Retrieve_Token | The NGL token required to retrieve data is not valid. |
792 | KCMR_No_Keybuff_Parm | The KEYBUFF parameter is omitted or is zeros. |
793 | KCMR_No_Keybuff_Address | The KEYBUFF parameter points to a zero buffer address. |
794 | KCMR_Invalid_Key_Length | The key length supplied for a read request is invalid. |
795 | KCMR_No_Recbuff_Parm | The RECBUFF parameter is omitted or is zeros. |
796 | KCMR_No_Recbuff_Address | The RECBUFF parameter points to a zero buffer address. |
797 | KCMR_Invalid_Rec_Length | The record length specified is invalid or greater than the maximum value. |
798 | KCMR_No_Rectype_Parm | No record type parameter was specified on the retrieve call. |
799 | KCMR_Invalid_Type_Length | The record type length is invalid for a read request. |
800 | KCMR_Recbuff_Full | The caller record buffer is full and more data is available to return. |
801 | KCMR_No_Bufflen_Parm | The BUFFLEN parameter is omitted or is zeros. |
802 | KCMR_No_Data_Matches | No data records match the retrieval request key information. |
803 | KCMR_Recbuff_Too_Small | The buffer specified for a retrieval is too small to hold the requested data. |