Previous Topic: Return Code 02 - INVALID TABLE NAMENext Topic: Return Code 04 - INVALID RECORD ID


Return Code 03 - INVALID KEY NAME

Reason:

An invalid key name has been detected.

Action:

See the following internal return code for details.

Return Code 03 Internal Return Codes

Dec

Hex

M

B

Explanation

User Response

001

01

Y

N

LARGE KEY INTERNAL ERROR

Contact CA Support with the recommended dumps.

002

02

S

N

1RQ1 KEY LENGTH TOO SMALL
You are using a 1RQ1 request area and the input key length specified in this request area was less than the sum of the key field lengths. Therefore, you did not pass a full key.

Change the input key length and value so that they contain the entire key.

003

03

Y

N

XCF LARGE KEY INTERNAL ERROR
A job running through XCF attempted to pass a large key to Multi-User, but an internal control block needed for this large key has not been allocated. The most likely cause is the Multi-User had reached its memory limit when the XCF connection was established.

Pursue the possibility that the Multi-User region has insufficient memory. One way to determine this is to check the OUT_OF_MEMORY_COUNT in the MUF_MEMORY_SUMMARY Dynamic System Table. Increase the Multi-User region size if it is insufficient.

004

04

N

N

LARGE KEY REQUIRES SORT
You attempted to run either a DBUTLTY LOAD or RETIX of a data area which includes a key larger than 180 bytes and you have not specified the SORT option.

The SORT option is required for large keys. Specify the SORT option using the SORT keyword and provide a value greater than 0.

005

05

N

N

NON 1RQ1 REQUEST FOR LARGE KEY
A request was made using a Key Name which corresponds to a key whose total length of its key fields is greater than 180 and you did not use a 1RQ1 request style request area.

Provide a 1RQ1 request area as is required for large keys.

006

06

N

N

1RQ1 KEY LENGTH GREATER THAN 999
You are using a 1RQ1 request area and the input key length specified in this request area is greater than 999.

Change the input key length to 999 or less, which is the maximum supported value.

027

1B

N

N

Either the key name presented in
the Request Area is not defined
as a key in the CA Datacom/DB Directory, or the key name was changed during the processing of
a LOCNE, LOCNK, LOCNX, RDUNE, RDUNX, REDNE, or REDNX command.

Either define the key to the CA Datacom/DB Directory or correct the key name in the Request Area, then reissue the request.