EGL Server Guide for iSeries


Diagnostic and informational messages

The following messages are sent as DIAGNOSTIC or INFORMATIONAL type messages to the program queue of the calling program. These messages are automatically posted in the job log. Programs that call EGL applications cannot monitor the activities of these messages. Use the WRKJOB(Work with JOB) command to view the job log. The Message Logging job attribute might filter some or all of these messages in some way. To ensure you get all messaged posted in the job log, use a message logging value of LOG(4 00 *SECLVL) in your iSeries jobs. See the iSeries commands WRKJOB and CHGJOB (Change Job) for more information.

GEN0002A new level of EGL Server for iSeries is required for program %1

Explanation: The generated COBOL program %1, attempting to run, is not compatible with the installed version of EGL Server for iSeries.

User Response: Contact the system administrator. Version %2 of EGL Server for iSeries should be installed.

GEN0005Date entered is not valid for defined date format %1

Explanation: Data entered into a form field defined with a date edit either does not meet the requirements of the format specification, or the month or day of the month is not valid.

It is not necessary to enter the separator characters shown in the message, but if they are omitted, enter leading zeros. For example, if the date format is MM/DD/YY, you can enter 070494.

User Response: Enter the date in the format %1.

GEN0009Overflow occurred because the target item is too short

Explanation: The target of a move or assignment statement is not large enough to hold the result without truncating significant digits. The value of special function word sysVar.handleOverflow is 1, which specifies that the application should end if this overflow condition occurs.

User Response: Have the application developer do one of the following:

GEN0014REPLACE attempted without preceding UPDATE option on %1.

Explanation: A replace option was attempted against a record that has not been successfully read by a get or open statement. The read for update might have been lost as the result of a commit or rollback.

This error also occurs if a replace is associated with a specific get or open statement, but that get or open statement was not the one used to select the record.

User Response: Have the application developer run this application with the test facility, tracing for process and statement group flow, to determine the application logic error.

GEN0021An error occurred in application %1 on EGL statement number %2.

Explanation: The actual error identifying the problem is explained in messages following this message in the job log.

User Response:

GEN0022Map group format member %1 could not be loaded

Explanation: The form group format member is a generated binary file that contains attributes that describe the format and constant fields for character/text based maps in a form group. Form group format members are stored as members of file %2 and are expected to be found by searching the job's library list.

Diagnostic messages preceding this message in the job log explain the nature of the error.

User Response: Contact your application or system programmer and report the sequence of messages including and preceding this message.

GEN0023The table %1 could not be loaded.

Explanation: A table is a generated binary file that contains application data. Tables are stored as members of file %2 and are expected to be found by searching the job's library list.

Diagnostic messages preceding this message in the job log explain the nature of the error.

User Response: Contact your application or system programmer, and report the sequence of messages including and preceding this message.

GEN0024EGL conversion table %1 could not be found

Explanation: Either the name specified on the sysLib.convert call was not a member of the QEGL/QEGLSCTB file or the member that was found is not a conversion table.

User Response: Have the application developer verify that the correct conversion table name was specified in the sysLib.convert call. If the table name was not correct, then change the EGL application and regenerate it. If the table name is correct, verify that the correct conversion table was installed. The conversion table is a member in the file QEGLSCTB in QEGL library.

GEN0026A calculation caused a "maximum value" overflow.

Explanation: During a calculation in an arithmetic statement, an intermediate result exceeded the maximum value (18 significant digits). This condition also occurs when division by zero occurs. If the sysVar.handleOverflow switch is set to either 0 or 1, the application ends.

User Response: Have the application developer correct the application logic either to avoid the error or to handle the error using the special function words sysVar.handleOverflow and sysVar.overflowIndicator.

GEN0027The data on character to numeric move is not valid.

Explanation: The statement in error involves a move from a character to a numeric data item. The character data item contains nonnumeric data.

User Response: Have the application developer change the application to make sure that the source operand contains valid numeric data.

GEN0031A call to program %1 failed.

Explanation: Called programs are expected to be found by searching the job's library list.

Diagnostic messages preceding this message in the job log will explain the nature of the error.

User Response: Contact your application or system programmer, and report the sequence of messages including and preceding this message.

GEN0033Call to function %1 returned exception code %2

Explanation: An exception code was returned on a call to the specified function, indicating that one of the arguments passed to the function was invalid. Refer to the EGL reference guide for further details.

The run unit ends.

User Response: The developer should fix the program so that it does not pass invalid arguments to the function.

GEN0034Application %1 was defined as a MAIN application and cannot be called.

Explanation: The specified application was defined as either a main textUI program or as a main basic program. It cannot be called by another program.

User Response: If using the call statement to invoke application %1 is valid, have the application developer define %1 as a called application. If application %1 must remain a main application, then have the application developer use transfer statements to invoke it from another main application.

GEN0035Data type error in input - enter again

Explanation: The data in the first highlighted field is not valid numeric data. The field was defined as numeric.

User Response: Enter only numeric data in this field, or press a bypass edit key to bypass the edit check. In either situation, the application continues.

GEN0036Input minimum length error - enter again

Explanation: The data in the first highlighted field does not contain enough characters to meet the required minimum length.

User Response: Enter enough characters to meet the required minimum length, or press a bypass edit key to bypass the edit check. In either situation, the application continues.

GEN0037Input not within defined range - enter again

Explanation: The data in the first highlighted field is not within the range of valid data defined for this item.

User Response: Enter data that conforms to the required range, or press a bypass edit key to bypass the edit check. In either situation, the application continues.

GEN0038Table edit validity error - enter again

Explanation: The data in the first highlighted field does not meet the table edit requirement defined for the variable field.

User Response: Enter data that conforms to the table edit requirement, or press the bypass edit key to bypass the edit check. In either situation, the application continues.

GEN0039Modulus check error on input - enter again

Explanation: The data in the first highlighted field does not meet the modulus check defined for the variable field.

User Response: Enter data that conforms to the modulus check requirements, or press a bypass edit key to bypass the edit check. In either situation, the application continues.

GEN0040No input received for required field - enter again

Explanation: No data was typed in the field designated by the cursor. The field is required.

User Response: Enter data in this field, or press a bypass validation key to bypass the edit check. Blanks or nulls will not satisfy the data input requirement for any type of field. In addition, zeros will not satisfy the data input requirement for numeric fields. The application continues.

GEN0041A message file prefix was not specified for an application: EZEMNO = %1, NLS code = %2.

Explanation: A user message was requested, but a user message table prefix was not defined for the application.

User Response: Have the application developer do one of the following:

GEN0045Error retrieving user application message, EZEMNO = %1, NLS code %2. See previous messages.

Explanation: A user message was requested. The previous message in the job log explains the reason for the error.

User Response: Most problems occur because the message file or the specific message cannot be found or access to the message file is not authorized. If the application can not find the message file and you know the library name that contains the message file, you can add the library to your library list (ADDLIBLE command). For other problems, contact your system or application programmer.

GEN0046Call to printer mapping services program %1 failed.

Explanation: Printer mapping services programs are expected to be found by searching the job's library list.

Diagnostic messages preceding this message in the job log explain the nature of the error.

User Response: Contact your application or system programmer and report the sequence of messages including and preceding this message.

GEN0050Number of allowable significant digits exceeded - enter again

Explanation: The user entered data into a numeric field that was defined with decimal places, a sign, currency symbol, or numeric separator edits. The number of significant digits that can be displayed within the editing criteria was exceeded by the input data; the number entered is too large. The number of significant digits cannot exceed the field length, minus the number of decimal places, minus the places required for editing characters.

User Response: Enter a number with fewer significant digits.

GEN0051Map %1 was not found in map group %2.

Explanation: The specified form name is not in the form group.

User Response: Have the application developer generate the form group and the application again.

GEN0057DELETE attempted without preceding UPDATE on record %1.

Explanation: A delete statement ran for a record that was not successfully read by an open or get statement. The read for update might have been lost as the result of an commit or rollback.

User Response: Have the application developer run this application in the EGL debugger to determine the application logic error.

GEN0073SQL error, command = %1, SQL code = %2

Explanation: The SQL database manager returned an error code for an SQL statement. Application processing ends following an SQL request whenever the SQLCODE in the SQL communications area (SQLCA) is not 0, and either of the following is true:

This message is followed by the actual DB2 message describing the SQL error code.

User Response: Have the application developer or system programmer determine the cause of the problem from the SQL code and the SQL error information. Either correct the application or the database definition. Refer to the appropriate Database Manager messages and codes manual for information on the SQL code and SQL error information.

GEN0074SQL error message: %1

Explanation: This message accompanies message GEN0073 when an SQL error occurs. It displays the relational database manager description of the error and is repeated as many times as necessary to display the complete description.

User Response: Use the information from this message and GEN0073 to correct the error.

GEN0076The data on character to hexadecimal move or compare is not valid.

Explanation: The current statement involves either a move from a character data item to a hexadecimal data item, or a comparison between a character data item and a hexadecimal data item. The characters in the character data item all must occur in the following set for the move or compare to complete successfully:

a b c d e f A B C D E F 0 1 2 3 4 5 6 7 8 9

One or more of the characters in the character data item is not in this set. This condition causes an application program error.

User Response: Have the application developer change the application to make sure that the character data item contains valid data when the character to hexadecimal move compare operation occurs. To do so, the application developer can use the hexadecimal map edit characteristic to make sure that input from a variable field contains valid characters.

GEN0080Hexadecimal data is not valid

Explanation: The data in the variable field identified by the cursor must be in hexadecimal format. One or more of the characters you entered does not occur in the following set:

a b c d e f A B C D E F 0 1 2 3 4 5 6 7 8 9

User Response: Enter only hexadecimal characters in the variable field. The characters are left-justified and padded with the character zero. Embedded blanks are not allowed.

GEN0086%1 - No active SETINQ, SETUPD, or UPDATE

Explanation: A get, get next, replace, or delete statement cannot run because a required get or open statement was not run previously in the same application. All rows selected for scanning or updating are released when an application returns to a calling application.

User Response: Have the application developer modify the application.

GEN0093An error occurred in application %1, process or group %2.

Explanation: An error occurred in the specified application. Other information about the error is given in the messages that follow this message.

User Response: Refer to the error messages following this message to determine the cause of the error.

GEN0096A mixed data operand is not valid

Explanation: An operand in a move statement involving an item of type MBCHAR contains an invalid mixture of double-byte and single-byte data.

User Response: Have the application developer verify that all operands in the move statement contain valid data.

GEN0109FIRST MAP must be map %1, not map %2, for application %3.

Explanation: The initial form expected by this application is not the form identified in the message. This error occurs when the application starts.

User Response: Record what function you were using before the error occurred, and have the application developer correct the arguments used to start program %3.

GEN0111Length of FIRST MAP %1 is not valid.

Explanation: The length of the form %1 received by an application is not the length defined for the form in application %2.

User Response: Have the application developer generate both the application receiving the form and the application that shows the form.

GEN0119Applications %1 and %2 are not compatible.

Explanation: An application started by a transfer or call statement is not compatible with the initial application in the transaction or job because the application was generated for a different environment.

User Response: Have the application developer regenerate one or both applications so that the target environments for the applications are the same.

GEN0127A requested function is not supported for map %1, map group %2.

Explanation: An application requested an action that is not supported for the specified form and form group. The form group was modified after it was generated and before the application was generated. Some aspects of the form group when the application was generated (for example, use of help maps or use of the msgField property) were not in the form group when the form group was generated.

User Response: Have the application developer generate the form group and the application again.

GEN0137SQL error occurred in work database operation

Explanation: An error occurred during use of the work database when it was implemented using SQL. This message is accompanied by additional SQL diagnostic messages, including GEN0073, that provide additional information about the error.

The run unit ends. Messages are logged.

User Response: Determine the cause of the problem from the SQL code and the SQL error information in related message GEN0074, and correct the database definition.

GEN0184Application %1 and mapping services program %2 are not compatible.

Explanation: The specified application and mapping services program are generated for different systems.

User Response: Have the application developer generate the mapping services program for the same environment as the application.

GEN0185Length of %1 for record %2 is not valid and conversion ended.

Explanation: Conversion of a variable length record between the workstation format and host format cannot be performed because of one of the following conditions:

User Response: Have the application developer modify the application to set the record length so that it ends on a valid field boundary.

GEN0186A mixed string in a conversion operation is not valid

Explanation: Conversion of a mixed field from EBCDIC to ASCII or from ASCII to EBCDIC cannot be performed because the double-byte data value is not valid.

User Response: Have the application developer modify the application to make sure that the records to be converted contain valid data.

GEN0187Conversion table %1 does not support DBCS character conversion.

Explanation: Conversion of a mixed or DBCHAR field from ASCII to EBCDIC or EBCDIC to ASCII cannot be performed because the specified conversion table does not include conversion tables for double-byte characters.

User Response: Have the application developer modify the application to specify a conversion table that contains the double-byte conversion tables valid for the DBCHAR or MBCHAR data being converted.

GEN0188Conversion Error. Function: %1, Return Code: %2, Table: %3

Explanation: A system function was called to perform code page conversion for data used in a client/server program. The function failed.

Possible causes for the failure are:

User Response: Correct the cause of the error.

GEN0191Application %1, generation date %2, time %3.

Explanation: An error in application %1 has occurred. Diagnostic messages in the job log explain the nature of the error. Changes to individually generated components of the application may have caused the error.

User Response: Have the application developer verify the generation date and time of the application with that of other generated components.

GEN0192Mapping services program %1, generation date %2, time %3.

Explanation: An error in mapping services program %1 has occurred. Diagnostic messages in the job log explain the nature of the error. Changes to individually generated components of the application may have caused the error.

User Response: Have the application developer verify the generation date and time of the mapping services program with that of other generated components in the application.

GEN0195Map format member %1, generation date %2, time %3.

Explanation: An error in map format member %1 has occurred. Diagnostic messages in the job log explain the nature of the error. Changes to individually generated components of the application may have caused the error.

User Response: Have the application developer verify the generation date and time of the map format member with that of other generated components in the application.

GEN0210EGL Server number %1 is not valid.

Explanation: An attempt was made to start an EGL routine that does not exist or that is not valid.

User Response: Have the application developer generate and compile the application again to ensure the generated COBOL code has not been modified. Afterward, run the refreshed application. If the problem persists, have the system administrator do all of the following:

GEN0232Map %1 in map group %2 is not defined or is not supported.

Explanation: The specified form does not exist or is not defined for the type of device being used.

User Response: Have the application developer either define the form for your device type or select the device for the form. Generate the form group again.

GEN0233%1 error on file %2, EZERT8 = %3.

Explanation: An I/O operation failed for the specified file. This message specifies the COBOL verb performed and the EGL file name associated with the operation.

sysVar.errorCode contains either the COBOL status key value or EGL file return code.

User Response: Use the appropriate COBOL publication or the EGL reference guide to diagnose the error, and take the recommended corrective action.

GEN0260%1 bytes of UI record won't fit in %2 byte buffer.

Explanation: The program issued a statement for presenting a UI record. There was not enough room in the communications buffer for the record. The buffer needs space for the record plus any message information written using function sysLib.setError.

User Response: Modify the program to reduce the size of the user interface record or write fewer or smaller error messages.

GEN0261EZEUIERR message information and inserts won't fit in %1 byte buffer.

Explanation: The program issued one or more calls to the system function sysLib.setError to write messages associated with a UI record. The information associated with the last message written will not fit in the buffer used by the program for communicating with user.

User Response: Modify the program to write fewer or smaller error messages.

GEN0262Web transaction program and user interface record bean %1 are incompatible.

Explanation: An action program was started with information from a UI record bean that isn't known to the program or whose definition is not compatible with the UI record declaration with which the program was generated.

User Response: Insure that the specified bean is defined as the inputPageRecord for the program. Regenerate the program and the Java Beans from the same user interface record declaration.

GEN0263Number of occurs value %1 is out of range for record array at offset %2

Explanation: An action program could not write a UI record because the "number of elements" value set by the program for an array was less than 0 or greater than the maximum number of elements defined for the array.

User Response: Correct the program logic so that it sets the number of elements to a value within the allowed range.

GEN0264Input data entered by the user doesn't fit in user interface record.

Explanation: An action program received input data from the Web server that doesn't fit in the UI record. The transaction program and the Java Bean associated with the UI record record may have been generated at different times with incompatible UI record declarations.

User Response: Regenerate the program and the Java Beans from the same definitions. Contact your IBM representative if this doesn't correct the problem.

GEN0265Segmented converse is not supported within current function stack.

Explanation: The program issued a converse statement with sysVar.segementedMode set to 1 (segmented converse) and at least one of the functions in the current function stack uses parameters or local items or records. The generated program is not able to save parameters or local storage data over a segmented converse.

User Response: Modify the program so that the converse statement is not used within a function that has parameters or local data.

GEN0266MQ function %1, Completion Code %2, Reason Code %3.

Explanation: The MQ function did not complete successfully, as indicated by the following completion codes:

The reason for the completion code is set in the reason code field by MQSeries. Some common reason codes are:

User Response: Please refer to the MQSeries Application Programming Reference for further information on MQSeries completion and reason codes.

GEN0267Queue Manager Name %1.

Explanation: This is the name of the queue manager associated with the failing MQ function call listed in message GEN0266.

If the failing MQ function was MQOPEN, MQCLOSE, MQGET, or MQPUT, the name identifies the name identifies the queue manager specified with the object name when the queue was opened. Otherwise, the name is the name of the queue manager to which the program is connected (or trying to connect).

If the queue manager name is blank, the queue manager is the default queue manager for your system.

User Response: Please refer to the MQSeries Application Programming Reference for further information on the MQSeries completion and reason code listed message GEN0266.

GEN0268Queue Name %1.

Explanation: This is the name of the queue object associated with the failing MQ function call listed in message GEN0266.

User Response: Please refer to the MQSeries Application Programming Reference for further information on MQSeries completion and reason codes reported in message GEN0266.

GEN2001The table %1 is not valid for application %2

Explanation: The reason code is %3. The explanations follow:

User Response: Have the application developer replace dataTable %1 with a correctly generated version.

If the reason code indicates that the table data is corrupted, ensure that the table was transmitted to the host system as a binary image file.

If the reason code indicates the table was generated for an ASCII-based host system, ensure that the table is regenerated for the same target system as the application attempting to use it.

If the reason code indicates the table could not be opened see previous messages in the job log.

GEN2002EGL Server does not support DBCS data type.

Explanation: EGL Server does not support the DBCHAR data type because COBOL does not support DBCHAR.

User Response: Have the application developer change EGL DBCHAR primitive types to MBCHAR data types and regenerate the application.

GEN2004Character conversion from CCSID %1 to %2 is not supported

Explanation: Character conversion is not supported between the two Coded Character Set IDs (CCSID) %1 and %2.

User Response: Have the application developer verify that the specified Coded Character Sets IDs (CCSID) are valid and that conversion between the two CCSIDS is supported. The EGL application may have to be regenerated.

GEN2005Error %1 occurred when converting record %2.

Explanation: sysLib.convert encountered error code %1 during the call.

User Response: Have the application developer verify that the application logics record %2 with data that matches its definition. The EGL application then needs to be regenerated.

GEN2006The map group %1 is not valid for application %2.

Explanation: The reason code is %3. The explanations follow:

User Response: Have the application developer replace form group %1 with a correctly generated version.

If the reason code indicates that the form group data is corrupted, ensure that the form group was transmitted to the host system as a binary image file.

If the reason code indicates the form group could not be opened see previous messages in the job log.

GEN2007Press Enter to continue.

Explanation:

User Response:

GEN7025Error encountered allocating memory.

Explanation: An error was encountered while allocating memory. The system has run out of memory.

User Response: Make sure that you have enough memory on your system as specified in the Software/hardware requirements for the product. Stop the execution of some of your other applications on your system.

Do as follows:

  1. Record the message number and the message text. (The error message includes the information on where the error occurred and the type of internal error.)
  2. Record the situation in which this message occurs.
  3. Contact your IBM representative.

GEN7030The format of the data descriptor is incorrect. The hex value of the data descriptor in error is %1.

Explanation: The format of the data descriptor is incorrect. A header descriptor is found within the data descriptor.

User Response: Do as follows:

  1. Record the message number and the message text. (The error message includes the information on where the error occurred and the type of internal error.)
  2. Record the situation in which this message occurs.
  3. Contact your IBM representative.

GEN7035The format of the data descriptor is incorrect.

Explanation: The format of the data descriptor is incorrect. An End Of Description descriptor is not found.

User Response: Do as follows:

  1. Record the message number and the message text. (The error message includes the information on where the error occurred and the type of internal error.)
  2. Record the situation in which this message occurs.
  3. Contact your IBM representative.

GEN7040The format of the data descriptor is incorrect. An unknown data code %1 was found.

Explanation: The format of the data descriptor is incorrect. An unknown data code was found in the data description.

User Response: Do as follows:

  1. Record the message number and the message text. (The error message includes the information on where the error occurred and the type of internal error.)
  2. Record the situation in which this message occurs.
  3. Contact your IBM representative.

GEN7055The Conversion Descriptor structure is not valid.

Explanation: The Conversion Descriptor structure CMCVOD required by the conversion routine is incorrect.

User Response: Do as follows:

  1. Record the message number and the message text. (The error message includes the information on where the error occurred and the type of internal error.)
  2. Record the situation in which this message occurs.
  3. Contact your IBM representative.

GEN7065The data descriptor for parameter %1 is not valid.

Explanation: The data descriptor for the parameter is not valid.

User Response: Do as follows:

  1. Record the message number and the message text. (The error message includes the information on where the error occurred and the type of internal error.)
  2. Record the situation in which this message occurs.
  3. Contact your IBM representative.

GEN9003EGL Server encountered a critical internal processing error.

Explanation: A critical internal processing error was detected. This may include such things as corrupted run unit control blocks, an unexpected return code from an internal function, or illogical code path entry.

Diagnostic messages preceding this message in the job log explain the nature of the error. In most cases, the application or system programmer will need to adjust your application system to correct the problem.

User Response: Either print the job log or record the messages along with the following:

You can view or print the job log with the DSPJOBLOG command. If no diagnostic messages precede this message, ensure that your job logged all messages by checking the 'Message Logging' or LOG value of your job definition or job description, depending on whether the job is interactive or batch. For interactive jobs, command DSPJOB OPTION(*DFNA) will display the 'Message Logging' value.

Contact your application or system programmer with the information you gathered.

GEN9004EGL Server COBOL error handler was invoked to end the run unit.

Explanation: A function check has caused the run unit to end. A database rollback has been issued and heap storage released.

Diagnostic messages preceding this message in the job log explain the nature of the error. In most cases, the application or system programmer will need to adjust your application system to correct the problem.

User Response: Either print the job log or record the messages along with the following:

You can view or print the job log with the DSPJOBLOG command. If no diagnostic messages precede this message, ensure that your job logged all messages by checking the 'Message Logging' or LOG value of your job definition or job description, depending on whether the job is interactive or batch. For interactive jobs, command DSPJOB OPTION(*DFNA) will display the 'Message Logging' value.

Contact your application or system programmer with the information you gathered.


[ Top of Page | Previous Page | Next Page | Table of Contents ]