Utility error messages

If the IXCMIAPU request fails, there are cases where Logger issues messages to the System Log. Check for IXGxxx messages in both the job log and the system log to assist in problem determination. Once there is an error, logger stops reading the input unless CONTINUE is specified.

The following section contains examples of IXCMIAPU Error Messages:

Error messages from IXCMIAPU:

ADMINISTRATIVE DATA UTILITY:  INPUT                        DATA TYPE = LOGR 

LINE #     CONTROL CARDS

     1      DATA TYPE(LOGR) REPORT(NO)
     2      DEFINE STRUCTURE NAME(LIST02) LOGSNUM(4)
     3      AVGBUFSIZE(4096) MAXBUFSIZE(32768)


ADMINISTRATIVE DATA UTILITY:  MESSAGES                     DATA TYPE = LOGR     

IXG005I LOGR POLICY PROCESSING LINE# 2
IXG013E STRUCTURE LIST02 ALREADY EXISTS 
IXG002E LOGR POLICY PROCESSING ENDED WITH RETCODE=00000008 RSNCODE=00000825
IXG003I LOGR POLICY PROCESSING ENCOUNTERED AN UNEXPECTED ERROR.
DIAGNOSIS INFORMATION: 00000000 00000000 050B000C 00000000

The RETCODE and RSNCODE can be found in mapping Macro IXGCON or IXGINVNT.

The 'DIAGNOSIS INFORMATION' is intended for IBM® Level 2 only.

The line number referenced (in this case '2') refers to where the Request type is located ('DEFINE').

Messages written to the SYSLOG:

ADMINISTRATIVE DATA UTILITY:  INPUT                        DATA TYPE = LOGR 

LINE #     CONTROL CARDS

     1      DATA TYPE(LOGR) REPORT(NO)
     2      DEFINE LOGSTREAM NAME(BAD.LOG.STREAM) LOWOFFLOAD(20)
     3      DASDONLY(NO) STG_SIZE(100) LS_SIZE(24) STG_DUPLEX(YES)
     4      DUPLEXMODE(UNCOND) STRUCTNAME(LIST02)
     5      LS_DATACLAS(NOTDEF)


ADMINISTRATIVE DATA UTILITY:  MESSAGES                     DATA TYPE = LOGR 
      
IXG005I LOGR POLICY PROCESSING LINE# 2
IXG007E A STORAGE MANAGEMENT SUBSYSTEM (SMS) ATTRIBUTE CLASS IS UNDEFINED.
IXG002E LOGR POLICY PROCESSING ENDED WITH RETCODE=00000008 RSNCODE=00000838
IXG003I LOGR POLICY PROCESSING ENCOUNTERED AN UNEXPECTED ERROR.
DIAGNOSIS INFORMATION: 00000004 000003F6 0107001B 00000000

--------------------

SYSLOG:

IXG251I IKJ56893I DATA SET IXGLOGR.BAD.LOG.STREAM.A0000000 NOT ALLOCATED+
IXG251I IGD01014I DATA SET ALLOCATION REQUEST FAILED -
IXG251I SPECIFIED DATACLAS NOTDEF DOES NOT EXIST

If logger encounters an error while processing any IXCMIAPU request, it terminates processing and ignores any other input.

ADMINISTRATIVE DATA UTILITY:  INPUT                        DATA TYPE = LOGR 

LINE #     CONTROL CARDS

     1      DATA TYPE(LOGR) REPORT(NO)
     2      DEFINE LOGSTREAM NAME(BAD.LOG.STREAM) LOWOFFLOAD(20)
     3              DASDONLY(NO) LS_SIZE(20) STG_DUPLEX(NO)
     4              STRUCTNAME(LISTXX)
     5      DEFINE LOGSTREAM NAME(GOOD.LOG.STREAM) STG_SIZE(100)
     6              LOWOFFLOAD(20) DASDONLY(YES) HIGHOFFLOAD(90)
     7              MAXBUFSIZE(32768)
     8              MAXBUFSIZE(32768)


ADMINISTRATIVE DATA UTILITY:  MESSAGES                     DATA TYPE = LOGR

IXG005I LOGR POLICY PROCESSING LINE# 2 
IXG018E STRUCTURE LISTXX DOES NOT EXIST
IXG002E LOGR POLICY PROCESSING ENDED WITH RETCODE=00000008 RSNCODE=00000827
IXG003I LOGR POLICY PROCESSING ENCOUNTERED AN UNEXPECTED ERROR.
DIAGNOSIS INFORMATION: 00000008 0000F801 05030004 050B000B

Ignore lines 5 to 8.

If CONTINUE is specified before system logger encounters an error, system logger continues to execute requests that follow the request in an error.

ADMINISTRATIVE DATA UTILITY:  INPUT                        DATA TYPE = LOGR 

LINE #     CONTROL CARDS

     1      DATA TYPE(LOGR) REPORT(YES)
     2      CONTINUE
     3      DEFINE LOGSTREAM NAME(BAD.LOG.STREAM) LOWOFFLOAD(20)
     4              DASDONLY(NO) LS_SIZE(20) STG_DUPLEX(NO)
     5              STRUCTNAME(LISTXX)
     6      DEFINE LOGSTREAM NAME(GOOD.LOG.STREAM) STG_SIZE(100)
     7              LOWOFFLOAD(20) DASDONLY(YES) HIGHOFFLOAD(90)
     8              MAXBUFSIZE(32768)
ADMINISTRATIVE DATA UTILITY:  MESSAGES                  DATA TYPE = LOGR
IXG005I LOGR POLICY PROCESSING LINE# 2
IXG004I LOGR POLICY PROCESSING ENDED WITHOUT ERROR
IXG005I LOGR POLICY PROCESSING INE# 3
IXG018E STRUCTURE LISTXX DOES NOT EXIST
IXG447I LOGR POLICY PROCESSING FOUND AN ERROR BUT CONTINUES
RETCODE=00000008 RSN=00000827
IXG003I LOGR POLICY PROCESSING ENCOUNTERED AN UNEXPECTED ERROR.
DIAGNOSIS INFORMATION: 00000008 0000F801 05030004 050B000B
IXG005I LOGR POLICY PROCESSING LINE# 6
IXG004I LOGR POLICY PROCESSING ENDED WITHOUT ERROR
IXG446E LOGR POLICY PROCESSING FOUND ERRORS BUT CONTINUED.
FIRST ERROR FOUND LINE# 3 RETCODE=00000008 RSNCODE=00000827
TOTAL NUMBER ERRORS FOUND: 1

Because CONTINUE is specified, system logger executes the request on line 6.

If a syntax error is found, processing of requests stops, although CONTINUE is specified.

ADMINISTRATIVE DATA UTILITY:  INPUT                     DATA TYPE = LOGR
      LINE #     CONTROL CARDS
           1      DATA TYPE(LOGR) REPORT(YES)
           2      CONTINUE
           3      DEFINE LOGSTREAM NAME(BAD.LOG.STREAM) LOWOFFLOAD(20)
           4              DASDONLY(YES) LS_SIZE(20) STG_DUPLEX(NO)
           5              STRUCTNAME(LISTXX)
           6      DEFINE LOGSTREAM NAME(WILL.NOT.BE.CREATED) STG_SIZE(100)
           7              LOWOFFLOAD(20) DASDONLY(YES) HIGHOFFLOAD(90)
           8              MAXBUFSIZE(32768)
      ADMINISTRATIVE DATA UTILITY:  MESSAGES               DATA TYPE = LOGR
      IXG005I LOGR POLICY PROCESSING LINE# 2
      IXG004I LOGR POLICY PROCESSING ENDED WITHOUT ERROR
      IXG005I LOGR POLICY PROCESSING LINE# 3
      IXG433E SYNTAX ERROR: WHEN DASDONLY(YES) IS SPECIFIED, 
                            THE FOLLOWING MAY NOT BE SPECIFIED: STRUCTNAME

The request specified on line 6 is not executed.