TBEXEC error messages

Error and audit messages generated by the batch utility program TBEXEC are identified and described in alphabetical order in the following table.

Table 89. tableBASE batch utility messages

Message

Text

Meaning/Instructions

Change definition failed

The attempt to change the definition of the table has failed for the reasons noted above the message.

Change is not for Alternate Index

The CHANGE ALT= command specified a table that is not an Alternate Index. Use the CHANGE TBL= version of the command.

Change key size/location failed

The attempt to change the key size and/or key location has failed for reasons noted in preceding messages or to the right of this message.

Change maxgen failed

The attempt to change the number of generations to be kept has failed for reasons noted in preceding messages or to the right of this message.

Change not made for reasons above

None of the changes in the above change were performed. The reason for the rejection of this command is noted above the message.

Change successful

The table definition has been changed as requested.

Information only.

CMD requires specified table to be open

This command requires the specified table to be open. This error should not occur when using TBEXEC.

Command is invalid

The specified command is not a TBEXEC command.

Command is invalid for an Alternate Index

The command cannot be performed on an Alternate Index.

Command rejected for reason above

The preceding TBEXEC Command was rejected for the reasons noted above the message.

Command requires more parms than given

TBEXEC called tableBASE incorrectly.

Copy complete

The requested operation completed successfully.

Copy complete except where indicated

The requested copy operation was successfully completed except as noted above the message.

Copy failed

The requested operation failed. Diagnostic messages are issued to give the reason(s) for the failure.

Copy of table (all generations) complete

The requested copy operation of all generations of a table was successfully completed.

Create Alternate Index definition failed

The attempt to create an Alternate Index definition failed for the reasons noted in preceding messages or to the right of this message.

Create Alternate Index definition successful

The Alternate Index definition has been created successfully.

Information only.

Data table index must be defined as P

TBEXEC attempted to invoke an Alternate Index of a table that is not defined to be type P (indexed or pointer).

Defaults have been set

The defaults entered have been set.

DEFINE TEMPORARY TABLE FAILED

Internal error defining temporary table for <filename>.

Please increase TSR size and rerun.

Delete failed

The requested delete operation has failed for reasons noted in preceding messages or to the right of this message.

Delimiter is invalid, = was expected

The next symbol after a keyword must be an equal sign.

Density parameter must be from 1-999

The density must be numeric and in the range 1-999.

Destination library too small

The destination library is too small to hold the table(s) to be copied.

Directory is empty

The directory on the specified library is empty.

DT command (maxgen parm) must be 1-9

The maximum generations to be kept must be numeric in the range 1-9 inclusive.

Duplicate keyword for this command

The same keyword was specified twice for a command. Fix the command sequence and try again.

Fix the command sequence and try again.

End of data – tableBASE utility ended

End of data has been reached on CNTLCARD, the TBEXEC input file.

Information only.

Error In table definition

An error has been detected in the table definition created from the parameters supplied. Refer to the TBCALL Error Code for the reason.

Estimated number-of-rows is out of range

The estimated number of rows is non-numeric, or is too large.

Expand library failed

The requested operation failed. Diagnostic messages are issued to give the reason(s) for the failure.

Expand library successful

The requested operation completed successfully.

Information only.

Expansion factor must be from 1 To 999

The expansion factor must be numeric and in the range 1-999.

Field is greater than 8 characters

All of the keywords and keyword values have a maximum length of eight characters.

Ensure field is 8 characters or less.

Format of library incompatible with Version 6 and higher versions.

The library format has changed starting with Version 6. It needs to be converted to be compatible. Please see the tableBASE Installation Guide, Appendix B.

Generation number specified is invalid

The generation must be numeric and in the range 0-255.

Generation requested has been copied

The COPY operation has been completed successfully. A new table (generation number 1) has been added to the target library.

Information only.

Index parameter must be P, T or blank

The Index field must be T for true tables, P for indexed (Pointer) tables or blank.

In previous releases, tableBASEallowed two types of tables: Pointer and True. Starting with Version 6, the concept of True tables still exists, however they are treated within tableBASE as Pointer tables as all memory is now in segmented memory that requires Indexes. The True table Indexes will be transparent to the application program.

Initialization successful

The new tableBASE library has been initialized successfully.

Information only.

Insufficient local tableSPACE region

The TSR is not large enough to contain the table and tableBASE internal tables. tableBASE uses a small part of the TSR for its own internal tables.

Insufficient space on new library

There is not enough space on the target library for the tables being copied.

INV storage-mode-code: Must be R, Blank

The storage mode code (SMC) must be R or blank.

Key size invalid: must be 1-256

The key size must be a number from 1-256, inclusive.

Keyword and value are incompatible

If the keyword requires a numeric value, the value specified with it must be numeric. Alternatively, the ALLGEN keyword must be followed by = YES.

Keyword invalid for this command

The keyword specified was not recognized.

Keyword is incomplete

The keyword has not been followed by an equal sign (=) and a value.

Keyword is invalid

The keyword specified is not used with this command.

KLOC invalid: must be 1 to row-size

The key location must be numeric in the range 1 to the row size, inclusive.

Library is not empty

The target or destination library of an EXPAND LIBRARY request contains at least one table. The target library must be empty for an EXPAND operation.

Library not initialized

For the reason cited to the right of this message, the library was not initialized.

Load failed

The requested operation failed. Diagnostic messages are issued to give the reason(s) for the failure.

Mthd/org parameters are incompatible

This combination of search method and organization will not work. Valid combinations are:

Organization Method
R, U S
S, D S, B, C
H H

New generation loaded successfully

A new generation of this table has been created from the contents of the FROM dataset.

Information only.

Newlib DDNAME not Assigned — check JCL

The requested initiation of the DDNAME specified by the NEWLIB parameter could not be performed since the DDNAME is not defined in the JCL.

Alter JCL as required.

nnnnn/mmmmm tables exported successfully

nnnnn tables were exported from the tableBASE library successfully. mmmmm tables were requested to be exported.

Information only.

nnnnn/mmmmm tables imported successfully

nnnnn tables were imported to the tableBASE library successfully. mmmmm tables were requested to be imported.

Information only.

No changes specified

A change command did not identify any fields to be changed.

Identify fields as required.

Not copied, new name same as old name

A COPY table request specified the same value for NEWNAME as for TBL.

Not enough space on library

There is not enough space on the tableBASE library for the table being defined, copied, loaded, or expanded.

Old Alternate Index definition deleted

During a copy of an Alternate Index definition, the old definition was deleted from the target library, but the new definition could not be copied from the source library to the target library.

On dest lib – insufficient space for copy

The copy operation has been requested to a destination library with insufficient space on it to receive all generations of the tables on the FROM library.

Org parm invalid: must be R, U, S, D or H

The Organization must be R, U, S, D, or H.

Paged tables are not supported

Starting with Version 6, paged tables are no longer supported.

Print request completed successfully

The requested print operation has finished with no errors. The listing can be found in TBRPT.

Information only.

Rename failed

The requested operation failed. Diagnostic messages are issued to give the reason(s) for the failure.

Rename successful

The requested rename operation was successfully performed.

Information only.

Requested generation has been cleared

A new generation of this table has been created using the definition of the generation specified. This new generation contains no items.

Information only.

Requested generation has been deleted

The generation of the table specified has been deleted.

Information only.

Requested generation(s) deleted

The requested operation completed successfully.

Information only.

Required keyword missing for this command

One of the required keywords for this command was not contained in the command sequence.

Correct command sequence as required.

RN failed. New name already exists.

The table was not renamed because a table with the new name already exists on the library.

Row size invalid: must be 1-32767

The row size must be numeric in the range 1-32767 inclusive.

Search-method incompatible with organization

The search method must be S, Q, B, C, or H and must match the organization. Valid combinations are:

Organization Method
R, U S
S, D S, B, C
H H

Semi-colon is missing from command

The command and its keywords must be followed by a semicolon (;) to indicate the end of the keyword list for the command sequence.

Source library is empty

The source library in a copy operation contains no tables.

Table already exists on library

The table could not be defined on, or copied to, the new library because a table of the same name already exists on the target library.

tableBASE error detected

The requested operation failed. Diagnostic messages are issued to give the reason(s) for the failure.

tableBASE internal program error – xxxx

The requested operation failed. Diagnostic messages are issued to give the reason(s) for the failure.

Table definition successful

The table was defined successfully and generation 1 was stored on the library.

Table is not closed

This error should not occur when using TBEXEC.

Contact Technical Support.

Table is not found

The table was not found on the given library.

Table name specified is invalid

A valid tableBASE table name is a string of 8 bytes that are not all blanks, all low values, all high values, or :TMPNAME.

Table opened for read cannot be stored

A table has been opened for read-only access and a store or write command has been issued.

Table type is invalid

The table type must be F, V, A, or X.

Table unavailable. No wait in effect

TBEXEC could not store the table because it is locked by another application. The NO WAIT parameter is in effect.

Table unloaded successfully

The specified generation of the specified table has been unloaded to the TO dataset.

Information only.

Table updated as requested

The requested update operations on the specified table were performed successfully.

Information only.

Table updated successfully

The requested operation completed successfully.

Information only.

Table xxxxxxxx could not be opened

For reasons noted in preceding messages or to the right of this message, the table xxxxxxxx could not be opened. Since the table must be opened to perform this TBEXEC command, the TBEXEC command could not be successfully completed.

Table xxxxxxxx export failed

The export of table xxxxxxxx failed for the reasons given in other messages.

Table xxxxxxxx import failed

The import of table xxxxxxxx failed for the reasons given in other messages.

Table xxxxxxxx import replace failed

The import of table xxxxxxxx failed for the reasons given in other messages.

Table xxxxxxxx sort error

The sort required for this operation failed for the reason noted.

Table xxxxxxxx was not stored

The table xxxxxxxx was not stored for the reasons noted in preceding messages or to the right of this message.

tablebase error detected

A TBLBASE error was detected in the processing of this command. The explanation of the error is found to the right of this message.

The count specified is invalid

The count is less than one, or greater than the number of rows in the table.

The key will not fit within the row

The end of the key cannot exceed the end of the row.

The library DDNAME does not exist

The LIB=DDNAME is not in the JCL.

Alter JCL as required.

The library status is invalid

tableBASE library disposition must be NEW for new libraries, and SHR or OLD for existing libraries.

The password supplied is invalid

An incorrect password has been specified.

The specified command is invalid

The specified command is not a valid TBEXEC command.

The specified library is not suitable

There are a number of conditions that can create this error. See tableBASE error codes.

Write password is missing or incorrect

The operation requires access to a write-protected table, but the write password has not been specified or specified incorrectly.

xxxxxxxx field is greater than 8 characters

All keywords and keyword values must be eight characters or fewer.

<tablename> NOT FOUND IN SOURCE LIBRARY

Specified table is not in the source library.

Please specify correct table associated with EXCLUDE parameter and/or EXCLFILE parameter file.