OpenFrame/HiDB Error Codes

This chapter describes the scope of error codes and individual errors associated with OpenFrame/HiDB.

1. Overview

The following is an overview of the scope of error codes and associated modules in OpenFrame/HiDB (hereafter HiDB).

Error Code Base Module Description

-2000

HiDB

An error that occurs in HiDB.

-3000

IMS

Manages various control blocks that the user must configure to use HiDB.

2. HiDB (-20000)

HiDB module is TmaxSoft’s hierarchical database. It is a counterpart to the IBM’s IMS database and Hitachi’s ADM database.

This section lists error codes that can occur in the HiDB module, descriptions of errors and suggested corrective actions.

HIDB_ERR_DUPLICATE_RECORD (-20001)

Description

There is a duplicate record.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_DUPLICATE_KEY (-20002)

Description

There is a duplicate key.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_NOT_FOUND (-20003)

Description

The requested record does not exist.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_END_OF_FILE (-20004)

Description

Reached the end of a file while executing sequential READ commands for a record.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_LENGTH_ERROR (-20005)

Description

An attempt was made to save a record to a fixed length data set that has a length different from the one in the data set definition or to save a record to a variable length data set that is longer than the maximum length of the record defined in the data set definition.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_INVALID_REQUEST (-20006)

Description

An invoked function is not supported.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_MEMORY_ALLOC (-20007)

Description

Failed to allocate memory.

Action

Contact the system administrator.

Note

HIDB_ERR_INTERNAL (-20008)

Description

There is an internal error in the HiDB library.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_NOT_IMPLEMENTED (-20009)

Description

An attempt was made to use access methods or functions that are not supported.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_TSAM_DEADLOCK (-20010)

Description

A deadlock occurred in TSAM when running a DL/I operation.

Action

Retry the operation when the deadlock is resolved.

Note

HIDB_ERR_INVALID_PCB_TYPE (-20101)

Description

An unsupported PCB type was used.

Action

Verify the PCB type is supported by the system.

Note

HIDB_ERR_INVALID_DLI_ACCESS (-20102)

Description

An unsupported DL/I access method was used.

Action

Verify the DL/I access method is supported by the system.

Note

HIDB_ERR_INVALID_SYS_ACCESS (-20103)

Description

An unsupported system access method was used.

Action

Verify the system access method is supported by the system.

Note

HIDB_ERR_INVALID_LCHLD_PTRS (-20104)

Description

The POINTER definition of a logical child is invalid.

Action

Verify that the logical relationships between DBDs are defined correctly.

Note

HIDB_ERR_INVALID_LPARNT_DBD (-20105)

Description

The DBD name definition of a logical parent is invalid.

Action

Verify that the logical relationships between DBDs are defined correctly.

Note

HIDB_ERR_INVALID_LCHILD_DBD (-20106)

Description

The DBD name definition of a logical child is invalid.

Action

Verify that the logical relationships between DBDs are defined correctly.

Note

HIDB_ERR_INVALID_SOURCE_DBD (-20107)

Description

The source DBD definition is invalid.

Action

Verify that the logical relationships between DBDs are defined correctly.

Note

HIDB_ERR_LPARENT_SEMANTICS (-20108)

Description

The semantic definition of a logical parent is invalid.

Action

Verify that the logical relationships between DBDs are defined correctly.

Note

HIDB_ERR_LPAIRED_SEMANTICS (-20109)

Description

The semantic definition of a logical sibling is invalid.

Action

Verify that the logical relationships between DBDs are defined correctly.

Note

HIDB_ERR_INVALID_SEGMENT_NAME (-20201)

Description

An invalid name has been specified for a database.

Action

Verify that the segment name that appears in the manipulation statement is correct.

Note

HIDB_ERR_INVALID_SEG_SEQUENCE (-20202)

Description

An invalid segment order has been specified for a database.

Action

Verify that the segment order in the manipulation statement is correct.

Note

HIDB_ERR_INVALID_INDEX_NAME (-20203)

Description

An invalid index name has been specified for a database.

Action

Verify that the index name that appears in the manipulation statement is correct.

Note

HIDB_ERR_INVALID_FIELD_NAME (-20204)

Description

An invalid field name has been specified for a database.

Action

Verify that the field name that appears in the manipulation statement is correct.

Note

HIDB_ERR_INVALID_DBD_NAME (-20205)

Description

An invalid DBD name has been specified for a database.

Action

Verify that the DBD name that appears in the manipulation statement is correct.

Note

HIDB_ERR_INVALID_PCB_NAME (-20206)

Description

An invalid PCB name has been specified for a database.

Action

Verify that the PCB name that appears in the manipulation statement is correct.

Note

HIDB_ERR_NOT_CONNECTED (-20601)

Description

The database is not connected.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_NO_PRIMARY_INDEX (-20604)

Description

The primary key index has not been found.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_DDNAME_NOT_FOUND (-20605)

Description

The DDNAME has not been found.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_NO_SSA_QUALIFICATION (-20606)

Description

The SSA qualification has not been found.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_INSERT_SSA_MISSING (-20607)

Description

The inserted SSA is missing.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_INDEX_KEY_LENGTH (-20608)

Description

The index key length is invalid.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_SEQ_FIELD_LENGTH (-20609)

Description

The sequential field is invalid.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_SSA_NOT_MATCHED (-20610)

Description

The SSA value does not match the expected value.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_MAX_DATASET_COUNT (-20611)

Description

The data set counts exceed the maximum number.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_INVALID_DATASET_TYPE (-20612)

Description

The data set type is invalid.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_DATASET_NOT_INITIALIZED (-20613)

Description

The data set has not been initialized.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_INVALID_DATASET_PARAM (-20614)

Description

The length of the data set to use in HiDB is not identical to that of the data set described in DBD or its specification is not identical to that of CISIZE.

Action

Verify that the data set length and the CISIZE specification are correct.

Note

HIDB_ERR_INVALID_PCB_KEY_LENGTH (-20615)

Description

The value of KEYLEN described in PCB is smaller than the maximum length of cascading keys.

Action

Correct the KEYLEN of PCB.

Note

HIDB_ERR_INVALID_SEGMENT_LENGTH (-20616)

Description

The segment length specified in DBD has been configured larger than the database data set record length.

Action

Configure the value described in the BYTES item of the SEGMENT statement of DBD to be the same or smaller than the database data set record length. The length of the segment prefix area must be in line with the database access method.

Note

HIDB_ERR_ALREADY_PREPARED_PSB (-20617)

Description

An attempt was made to allocate the same PSB in a single program to memory multiple times.

Action

Modify the program so that the memory of a specific PSB in a single program can be allocated only once.

Note

HIDB_ERR_NOT_PREPARED_PSB (-20618)

Description

An attempt was made to deallocate the PSB that was not allocated to memory.

Action

Examine if the PSB has previously been allocated to memory and modify the program accordingly.

Note

HIDB_ERR_BUFFER_ALLOC_ALREADY (-20701)

Description

There was a request to allocate the buffer that had already been allocated.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_BUFFER_NOT_ALLOCATED (-20702)

Description

The buffer has not been allocated.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_BUFFER_NOT_FOUND (-20703)

Description

The buffer does not exist.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_BUFFER_DCB_TYPE (-20704)

Description

The buffer DCB type is invalid.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_BUFFER_VSAMTYPE (-20705)

Description

The buffer type is not VSAM.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_BUFFER_DEAD_LOCK (-20706)

Description

There was a deadlock in the buffer.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_BUFFER_REMAIN_LOCK (-20707)

Description

The buffer remains locked.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_BUFFER_MISSING_LOCK (-20708)

Description

The buffer lock is missing.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_BUFFER_DIRTY_UNLOCK (-20709)

Description

Failed to unlock the dirty buffer.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_BUFFER_DUP_RECORD (-20710)

Description

A duplicate record exists in the buffer.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_BUFFER_DIRTY_LOCKED (-20711)

Description

The dirty buffer is still locked.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_DLI_CODE_BASE (-20900)

Description

A DL/I status code is invalid.

Action

Contact the TmaxSoft technical support team.

Note

HIDB_ERR_SSA_HIERARCHY (-20901)

Description

The parameter given as an SSA does not match the hierarchy. (DL/I status code AC)

Action

Correct the SSA parameter to match the hierarchy defined in PSB.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_FUNCTION_CODE (-20902)

Description

The function code given to the DL/I interface is invalid. (DL/I status code AD)

Action

Use only the function codes defined in the DL/I interface.

Note

The function codes supported by HiDB are GU, GN, GNP, ISRT, REPL, and DLET.

HIDB_ERR_REQUIRE_ONE_SSA (-20903)

Description

There is no SSA parameter to execute the given request, which requires one or more SSAs. (DL/I status code AH)

Action

Specify an SSA parameter to call a function. Verify that only the required SSAs are entered.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_OPEN_DATASET (-20904)

Description

There was a problem while opening a data set. (DL/I status code AI)

Action

Verify that the data set exists.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_AN_INVALID_SSA (-20905)

Description

The string given as an SSA is invalid. (DL/I status code AJ)

Action

Verify that the SSA string is grammatically correct.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_SSA_FIELD_NAME (-20906)

Description

The field name specified in an SSA is invalid. (DL/I status code AK)

Action

Verify that the field name is correct by checking the DBD of the database in use.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_NOT_ALLOWED (-20907)

Description

An attempt was made to execute a request which is not allowed in the database. (DL/I status code AM)

Action

Modify the application so that it only executes requests that are allowed in the database.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_SEQ_FLD_CHANGED (-20908)

Description

An attempt was made to change the sequential field content while modifying a segment. (DL/I status code DA)

Action

Change the application so that it does not change the sequential field content.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_SEGMENT_NOT_HELD (-20909)

Description

An attempt was made to change or delete specific segments which must be located with the HOLD option before the operation. (DL/I status code DJ)

Action

Search for the segment with the HOLD option before changing or deletion.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_VIOLATE_DLET_RULE (-20910)

Description

The segment deletion rules have been violated. (DL/I status code DX)

Action

Modify the application so that it does not violate the segment deletion rules.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_END_OF_DATABASE (-20911)

Description

The end of the database has been reached while sequentially searching segments. (DL/I status code GB)

Action

Allow the program logic that has been defined for this case (reaching the end of the database) to be executed.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_SEGMENT_NOT_FOUND (-20912)

Description

No segment matches the given SSA conditions. (DL/I status code GE)

Action

Allow the program logic that has been defined for this case (inability to find the segment) to be executed.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_OUT_OF_PARENTAGE (-20913)

Description

The parentage is exceeded in sequential search. (DL/I status code GE)

Action

Modify the program to end the sequential search.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_NO_PARENTAGE_EST (-20914)

Description

A request that uses parentage was executed without specifying a parentage. (DL/I status code GP)

Action

Execute a request to set the parentage before executing the request that uses parentage.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_DUPLICATE_SEGMENT (-20915)

Description

A segment with the same key as that of an existing segment was added. (DL/I status code II)

Action

Specify and run the program logic that is defined for a case where a duplicate segment exists.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_VIOLATE_ISRT_RULE (-20916)

Description

The segment insert rules have been violated while adding a segment. (DL/I status code IX)

Action

Change the program so that it does not violate the segment rules.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_LOAD_DUPLICATE (-20917)

Description

A segment was loaded that had the same key as an existing segment in the database. (DL/I status code LB)

Action

Check the data and delete the segment with the duplicate key.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_LOAD_HIERARCHY (-20918)

Description

Segments are not arranged in hierarchical order when loading a database. (DL/I status code LC)

Action

Make a database backup by extracting the data in hierarchical order.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_DUP_INDEX_SEGMENT (-20919)

Description

An attempt was made to add a duplicate segment to a segment with an index that does not allow duplication. (DL/I status code NI)

Action

Change the application logic so that duplicate segment is not added.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_NO_QUAL_SSA_FOR_ISRT (-20920)

Description

The SSA parameter was not included in an ISRT call. (DL/I status code GD)

Action

If you make an ISRT statement with an application, check whether SSA is specified, and change the logic.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_INVALID_PARM_COUNT (-20921)

Description

The number of parameters that were described when calling a DL/I function is invalid. For instance, when an application calls CHKP with more than 3 parameters. (DL/I status code AP)

Action

If you make a DL/I call with an application, check the number of parameters you specified, and change the logic.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_INVALID_SEGMENT_POINTER (-20922)

Description

An invalid segment pointer was specified. The segment pointer stored in the segment prefix area points to the wrong segment address. (DL/I status code GG)

Action

Check if data is loaded normally.

If you load data with a COBOL application, and if you want to terminate it, use the GOBACK statement instead of the STOP RUN statement. The STOP RUN statement terminates the process without the post-processing routine, so the loaded data are not committed.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_VARIABLE_SEGMENT_LENGTH (-20923)

Description

The length of an invalid variable-length segment was specified. The value that exceeded the permitted range of the segment specified in the segment statement of the DBD was specified when you were inserting or updating segment data. (DL/I status code V1)

Action

When you are inserting or updating segment data in application programs, check if the value that exceeds the range of the minimum and maximum length of the segment specified in the segment statement of the DBD is entered, and then change the value.

Note

Refer to OpenFrame HiDB Guide.

HIDB_ERR_DLI_CODE_LAST (-20999)

Description

The DL/I status code is invalid.

Action

Contact the TmaxSoft technical support team.

Note

3. IMS (-30000)

The IMS module manages various control blocks that are necessary for using HiDB.

This section lists error codes that can occur in the IMS module, descriptions of errors and suggested corrective actions.

IMS_ERR_INVALID_REQUEST (-30001)

Description

There is an internal error in the IMS library.

Action

Contact the TmaxSoft technical support team.

Note

IMS_ERR_MEMORY_ALLOC (-30002)

Description

Failed to allocate memory.

Action

Contact the system administrator.

Note

IMS_ERR_INTERNAL (-30003)

Description

There is an internal error in the IMS library. This error code is no longer used.

Action

Contact the TmaxSoft technical support team.

Note

IMS_ERR_NOT_IMPLEMENTED (-30004)

Description

Unsupported access methods or functions were executed.

Action

Contact the TmaxSoft technical support team.

Note

IMS_ERR_INVALID_PARAM_COUNT (-30005)

Description

The parameter count is invalid.

Action

Contact the TmaxSoft technical support team.

Note

IMS_ERR_DUMMY_INTERFACE (-30006)

Description

A dummy interface was invoked.

Action

Contact the TmaxSoft technical support team.

Note

IMS_ERR_BUFFER_OVERFLOW (-30007)

Description

A buffer overflow took place while an IMS library was used.

Action

Contact the TmaxSoft technical support team.

Note

IMS_ERR_CONFIGURATION (-30101)

Description

There is a problem setting the ims subject of OpenFrame configuration.

Action

Check the ims subject of OpenFrame configuration and correct the problem.

Note

For more information about the ims subject, refer to OpenFrame Configuration Guide.

IMS_ERR_OPEN_DBD_FILE (-30102)

Description

There is a problem opening a specified DBD script.

Action

Verify that the DBD script file is located in the specified file path.

Note

IMS_ERR_PARSE_DBD_FILE (-30103)

Description

There is a problem parsing a specified DBD script.

Action

Verify that the DBD script has no grammatical errors.

Note

IMS_ERR_OPEN_PSB_FILE (-30104)

Description

There is a problem opening a specified PSB script.

Action

Verify that the PSB script file is located in the specified file path.

Note

IMS_ERR_PARSE_PSB_FILE (-30105)

Description

There is a problem parsing a specified PSB script.

Action

Verify that the PSB script has no grammatical errors.

Note

IMS_ERR_ACBLIB_ALLOCATE (-30106)

Description

The ACBLIB has not been allocated.

Action

Contact the TmaxSoft technical support team.

Note

IMS_ERR_RESLIB_ALLOCATE (-30107)

Description

The RESLIB has not been allocated.

Action

Contact the TmaxSoft technical support team.

Note

IMS_ERR_ACB_NOT_FOUND (-30108)

Description

The ACB has not been defined for the program to be executed.

Action

Define ACB for each PSB used in the IMS online program.

Note

IMS_ERR_RES_NOT_FOUND (-30109)

Description

The resources has not been defined for the program to be executed.

Action

Define resources for each DBD used in the IMS online program.

Note

IMS_ERR_RESLIB_FORMAT (-30110)

Description

There is a problem with the format of the resource definition file.

Action

Verify that the resource definition file format is correct.

Note

IMS_ERR_READ_DBD_FILE (-30111)

Description

There is a problem reading a DBD control block.

Action

Verify that the DBD control block exists in the specified DBDLIB library.

Note

The default DBDLIB library is set in the ims subject of OpenFrame configuration. For more information, refer to OpenFrame Configuration Guide.

IMS_ERR_WRITE_DBD_FILE (-30112)

Description

There is a problem writing a DBD control block.

Action

Check whether the user has the write permission for the specified DBDLIB library.

Note

The default DBDLIB library is set in the ims subject of OpenFrame configuration. For more information, refer to OpenFrame Configuration Guide.

IMS_ERR_READ_PSB_FILE (-30113)

Description

There is a problem reading a PSB control block.

Action

Verify that the PSB control block exists in the specified PSBLIB library.

Note

The default PSBLIB library is set in the ims subject of OpenFrame configuration. For more information, refer to OpenFrame Configuration Guide.

IMS_ERR_WRITE_PSB_FILE (-30114)

Description

There is a problem writing a PSB control block.

Action

Check whether the user has write permission for the specified PSBLIB library.

Note

The default PSBLIB library is set in the ims subject of OpenFrame configuration. For more information, refer to OpenFrame Configuration Guide.

IMS_ERR_DBD_OBJECT_VER (-30121)

Description

The DBD control block version does not match the expected one.

Action

Recreate the DBD control block using dbdgen.

Note

IMS_ERR_PSB_OBJECT_VER (-30122)

Description

The PSB control block version does not match the expected one.

Action

Recreate the PSB control block using psbgen.

Note

IMS_ERR_MDA_OBJECT_VER (-30123)

Description

The MDA control block version does not match the expected one.

Action

Recreate the MDA control block using imsdaloc or dabgen.

Note

IMS_ERR_OPEN_MDA_FILE (-30131)

Description

There is a problem opening a specified MDA script.

Action

Verify that the MDA script file exists in the specified path.

Note

IMS_ERR_PARSE_MDA_FILE (-30132)

Description

There is a problem parsing a specified MDA script.

Action

Verify that the script has no grammatical errors.

Note

Refer to "6.6. imsdaloc" in OpenFrame Tool Reference Guide.

IMS_ERR_READ_MDA_FILE (-30133)

Description

There is a problem reading an MDA control block.

Action

Verify that the MDA control block exists in the specified RESLIB library.

Note

The default RESLIB library is set in the ims subject of OpenFrame configuration. For more information, refer to OpenFrame Configuration Guide.

IMS_ERR_WRITE_MDA_FILE (-30134)

Description

There is a problem writing an MDA control block.

Action

Check whether the user has write permission for the specified RESLIB library.

Note

The default RESLIB library is set in the ims subject of OpenFrame configuration. For more information, refer to OpenFrame Configuration Guide.

IMS_ERR_OPEN_DAB_FILE (-30135)

Description

There is a problem opening a specified DAB script.

Action

Verify that the DAB script file exists in the specified path.

Note

IMS_ERR_CDLI_ALREADY_SCHEDULED (-30201)

Description

An attempt was made to reschedule a PSB that had been scheduled in the Command Level DL/I interface.

Action

Delete the code that tries to reschedule the PSB.

Note

IMS_ERR_CDLI_NOT_SCHEDULED (-30202)

Description

An attempt was made to use a PSB without scheduling it in the Command Level DL/I interface.

Action

Add the code that schedules the PSB in the program.

Note

IMS_ERR_CDLI_UNSUPPORTED_PCBTYPE (-30203)

Description

The PCB type is not supported in the Command Level DL/I interface.

Action

Verify that the PCB type used in the program is supported.

Note

IMS_ERR_CDLI_INVALID_SSA (-30204)

Description

An SSA is not specified correctly in the Command Level DL/I interface.

Action

Verify that the SSA type is specified correctly in the program.

Note