VSAM Return Codes

The VSAM Reason Codes are listed here alphabetically, you may search for the one you want using your broswer, go down to the following selection list and click on the Return Code link to transfer directly to the message.


X'00'-000 X'01'-001 X'02'-002
X'03'-003 X'04'-004 X'05'-005
X'06'-006 X'07'-007 X'08'-008
X'09'-009 X'0A'-010 X'0B'-011
X'0C'-012 X'0D'-013 X'0E'-014
X'0F'-015 X'10'-016 X'11'-017
X'12'-018 X'13'-019 X'14'-020
X'18'-024 X'1C'-028 X'20'-032
X'22'-034 X'24'-036 X'28'-040
X'2C'-044 X'30'-048 X'32'-050
X'34'-052 X'38'-056 X'40'-064
X'41'-065 X'42'-066 X'43'-067
X'44'-068 X'45'-069 X'46'-070
X'47'-071 X'48'-072 X'4C'-076
X'4E'-078 X'4F'-079 X'50'-080
X'54'-084 X'58'-088 X'5C'-092
X'60'-096 X'64'-100 X'68'-104
X'6C'-108 X'6E'-110 X'70'-112
X'71'-113 X'72'-114 X'73'-115
X'74'-116 X'75'-117 X'76'-118
X'80'-128 X'84'-132 X'88'-136
X'8C'-140 X'90'-144 X'94'-148
X'98'-152 X'9C'-156 X'A0'-160
X'A1'-161 X'A5'-165 X'A6'-166
X'A7'-167 X'A8'-168 X'B4'-180
X'B8'-184 X'BC'-188 X'C0'-192
X'C4'-196 X'C8'-200 X'CC'-204
X'D0'-208 X'D4'-212 X'D8'-216
X'DC'-220 X'E4'-228 X'E8'-232
X'F8'-248 X'FC'-252 X'FE'-254
X'FF'-255

X'00' 000

Return Code=08 Action=CBMM
The execute form of MODCB, SHOWCB, or TESTCB was issued in an attempt to change a non-existent entry in the macro's parameter list.

Return Code=0C Action=CBMM
The GENCB, MODCB, SHOWCB, or TESTCB request was not executed because an error occurred while a VSAM phase was being loaded. Register 0 contains the return code from CDLOAD.

X'01' 001

Return Code=04 Action=CBMM
GENCB/MODCB/SHOWCB/TESTCB request is invalid.

X'02' 002

Return Code=>0 Action=CLOSE
CLOSE or TCLOSE found an invalid control block structure for this ACB. PROGRAMMER ACTION: Ensure that your program provides a properly generated ACB and does not inadvertently overlay the ACB, AMBL, AMDSB(s), or OAL before closing the ACB.

Return Code=04 Action=CBMN
The GENCB BLK = operand does not specify an ACB, RPL, or EXXLST, or the operand has been omitted from MODCB, SHOWCB, or TESTCB. The operand must be specified.

Return Code=08 Action=OPEN
OPEN found an invalid control block structure for this ACB. PROGRAMMER ACTION: Ensure that your program provides a properly generated ACB and does not inadvertenly overlay the ACB before opening it.

X'03' 003

Return Code=04 Action=CBMN

An invalid keyword has been specified for GENCB/MODCB/SHOWCB/TESTCB.

X'04' 004

Return Code=>0 Action=CLOSE
The ACB was already closed. PROGRAMMER ACTION: Change your application program to avoid attempts to close an ACB that was never opened, has already been closed, or was erroneously modified to to appear closed.

Return Code=00 Action=Request
VSAM detected an end-of-volume condition.

Return Code=04 Action=CBMN
The block or list at the indicated address is not of the type specified in MODCB, SHOWCB, or TESTCB.

Return Code=08 Action=OPEN
This ACB is already opened. PROGRAMMER ACTION: Change your application program to avoid attempts to open an ACB that is already open.

Return Code=08 Action=Request
VSAM encountered end of file (during sequential retrieval), or the search argument is greater than the highest existing key (or relative record number) in the file.

Return Code=0C Action=Request
VSAM failed to read data as requested. The error may be caused by such conditions as VSAM finding an unformatted record when expecting a formatted record, a volume containing data other than expected, or an I/O error. PROGRAMMER ACTION: Ensure that in the SYNAD exit routine your program issues a DUMP macro. Save the dump you obtain and the SYSLOG output for later problem determination.

X'05' 005

Return Code=04 Action=CBMN
SHOWCB or TESTCB tried to access a closed ACB; the ACB must be open.

X'06' 006

Return Code=04 Action=CBMN
The SHOWCB or TESTCB OBJECT operand refers to a non-esistent index.

X'07' 007

Return Code=04 Action=CBMN
The referenced EXLST does not contain an entry for the exit you specified in M0DCB or SHOWCB.

X'08' 008

Return Code=00 Action=Request
VSAM detected a non-unique key in the alternate index.

Return Code=04 Action=CBMN
Virtual storage available in the partition is insufficient to generate the requested block(s) or list(s) for GENCB. PROGRAMMER ACTION: Rerun the job in a larger virtual partition.

Return Code=08 Action=Request
An attempt was made to store a record with a duplicate key, or a duplicate record was found for an alternate index with the UNIQUEKEY option, or a record already exists at the accessed record location.

Return Code=0C Action=Request
VSAM failed to read index-set records of an index. The error may be caused by such conditions as VSAM finding as unformatted record when expecting a formatted record, a volume containing data other than that expected, or an I/O error. PROGRAMMER ACTION: Ensure that in the SYNAD exit routine your program issues a DUMP macro. Save the dump you obtain and the SYSLOG output for later problem determination.

X'09' 009

Return Code=04 Action=COMM
The work area provided in the program is too small to generate the requested block(s) or list(s) for GENCB or SHOWCB. PROGRAMMER ACTION: Recompile the progam with a larger work area specified.

X'0A' 010

Return Code=04 Action=COMM
One of your EXLST operands specifies the L subparameter, but does not provide a new address, or the operands specifies neither an address nor one of the subparameters A and N (GENCB or MODCB only).

X'0B' 011

Return Code=04 Action=COMM
MODCB tried to modify an active RPL; the RPL must be inactive.

X'0C' 012

Return Code=00 Action=Request
Issue a WRTBFR macro because there are no more unmodified buffers into which to read the contents of a control internal (shared resources only).

Return Code=04 Action=COMM
MODCB tried to modify an open ACB; the ACB must be closed.

Return Code=08 Action=Request
VSAM detected a record out of sequence in a key-sequenced or relative-record file (possibly a duplicate key or record number).

Return Code=0C Action=Request
VSAM failed to read sequence-set records of an index. The error may be caused by such conditions as VSAM finding an unformatted record when expecting a formatted record, a volume containing data other than that expected, or an I/O error.

X'0D' 013

Return Code=04 Action=COMM
The address in the EXLST field to be activated is O (MODCB only).

X'0E' 014

Return Code=04 Action=CBMN
The specified parameters are inconsistent ( GENCB, MODCB, SHOWCB, or TESTCB).

Return Code=08 Action=OPEN
The symbolic unit in the EXTENT statement is invalid. PROGRAMMER ACTION: Change your job control EXTENT statement(s) to specify logical unit(s) which are valid for the partion and rerun the job, or remove the logical unit specification from the EXTENT statement(s) to allow VSAM to automatically assign available logical units and rerun the job.

X'0F' 015

Return Code=04 Action=COMM
The work area provided in your program does not begin on a fullword boundary (GENCB or SHOWCB).

Return Code=08 Action=OPEN
Extent block processing failed. PROGRAMMER ACTION: Restructure your program so that fewer files are open concurrently. In a multiprogramming environment, rerun the job together with other jobs that require fewer extent blocks. If the problem persists, save the job stream and take a system dump before contacting your IBM Support Center.

X'10' 016

Return Code=00 Action=Request
A control-area split occurred because there was not enough space to make an index entry in a sequence set-record. Some data control intervals could not be used in the control area that was split.

Return Code=04 Action=COMM
An invalid control block address was specified in the {ACB|EXLST|RPL} = address parameter.

Return Code=08 Action=Request
No record found. If a relative-record file was being accessed, VSAM may have detected a deleted or invalid record (empty slot) at the accessed record location. This code can be issued for a file being accessed through a path if the pointer to the record is missing from the alternate index. Although the record is in the base cluster, VSAM cannot find it because the pointer to it is missing. This situation should only result from a system failure during UPGRADE processing.

Return Code=0C Action=Request
VSAM failed to write data as requested. The error may be caused by such conditions as VSAM finding an unformatted record when expecting a formatted record, a volume containing data other than that expected, or an I/O error. PROGRAMMER ACTION: Ensure that in the SYNAD exit routine your program issues a DUMP macro. Save the dump you obtain and SYSLOG output for later problem determination.

X'11' 017

Return Code=08 Action=OPEN
The address in an ASSGN statement for a VSAM volume was set to IGN. PROGRAMMER ACTION: Changes the device address in the ASSGN statement to that of the VSAM volume being opened.

X'12' 018

Return Code=08 Action=OPEN
The address in an ASSGN statement for a VSAM volume was set to UA. PROGRAMMER ACTION: Changes the device address in the ASSGN statement to that of the VSAM volume being opened.

X'13' 019

Return Code=08 Action=OPEN
Unable to assign a logical unit for the device on which the required volume is mounted. Either:

A programmer logical unit is not available in this partition (available programmer logical units have been used by ASSGN job control statements, or VSAM automatic assignments for files, catalogs or catalog recovery areas (CRA). For recoverable catalogs, VSAM always assigns a programmer logical unit for each CRA.
An entent block is not available in the system (temporary assignments use these)
The device on which the volume is mounted is reserved (Attention Routine VOLUME command).
The device on which the volume is mounted "down" (Job Control command DVCDN).

PROGRAMMER ACTION: The automatic assign function failed because the device with the required volume is in "down" status, reserve status, or because no programmer logical unit were available. Make sure that programmers logical units are available and rerun the job. If this is a multi-step job, separate it into several jobs. Instruct the operator to ensure that the device on which the volume mounting is done is in "up" status and unreserved before replying `NEWPAC'.

X'14' 020

Return Code=04 Action=CBMN
STRMAX or TRANSID were specified, but LSR was not specified in the ACB.

Return Code=08 Action=Request
The requested record is contained in a control interval that is already held in exclusive control by another request.

Return Code=0C Action=Request
VSAM failed to write index-set records of an index. The error may be caused by such conditions as VSAM finding an unformatted recorded when expecting a formatted record, a volume containing data other than that expected, or an I/O error. PROGRAMMER ACTION: Ensure that in the SYNAD exit routine your program issues a DUMP macro. Save the dump you obtain and the SYSLOG output for later problem determination.

X'18' 024

Return Code=08 Action=Request
The requested record is on a volume or extent that cannot be accessed because no extent blocks are available. PROGRAMMER ACTION: Try to find the reason for the nonavailabilty of the volume or extent. If circumstances indicate that no more extent blocks are available, rerun the job together with other jobs that require a smaller number of extent blocks (in a multiprogramming environment), or restructure your program so that it requires fewer extent blocks (in a 1-partition environment) and return the job. If you cannot correct the error situation, contact your IBM Support Center.

Return Code=0C Action=Request
VSAM fail to write sequence-set records of an index. The error may be caused by such condition as VSAM finding an unformatted record when expecting a formatted record, a volume containing data other than that expected, or an I/O error. PROGRAMMER ACTION: Ensure that in the SYNAD exit routine your program issues a DUMP macro. Save the dump you obtain and the SYSLOG output for later problem determination.

X'1C' 028

Return Code=00 Action=Request
The record retrieved by a GET-with-no-updata may be a duplicate of a record in another CI. Eliminate duplicate records by processing the data using keyed access with update. For sequential processing, this error code is set on for only the first record of the CI.

Return Code=08 Action=Request
All extents of the files are full, and VSAM cannot suballocate any additional extents to the file for one of following reason:

No secondary allocation was specified and no space of the required class was found to be available for primary space suballocate on an additional volume (if one was specified).
The maximum number of extensions for the file has been exceeded.
No space of the required class is available for additional secondary allocations.

X'20' 032

Return Code=00 Action=Request
For a SAM ESDS with variable length records, a POINT or direct GET was issued that specified an RBA of zero. Positioning has been done to the first record of the file, which is actually at RBA 8.

Return Code=08 Action=OPEN
The OPEN disposition specified for the file conflicts with other files characteristics.

DISP=NEW was specified for an input file.
DISP=NEW was specified for a file using local shared resources.

PROGRAMMER ACTION: Change your DLBL statement to specify DISP=OLD or change the ACB to specify MACRF=(OUT,NRS). Rerun the job.

Return Code=08 Action=Request
An invalid RBA has been specified.

X'22' 034

Return Code=08 Action=OPEN
The volume serial number(s) specified in the EXTENT statement(s) do not match those recorded in the catalog entry. An EXTENT statement is required for each volume to be accessed; for example, for each volume on which your base cluster and alternate index(es) reside. PROGRAMMER ACTION: Change your job control statement to either use simplified job control or to correctly decribe the volumes required to access your base cluster and its alternate indexes. To use simplified job control, eliminate EXTENT statements and ASSGN statements describing your VSAM clusters. The information about volumes is retrieved from the catalog, and programmer logical units are automatically assigned by VSAM. If you do not use simplified job control, use LISTCAT output to determine which volumes must be described in the EXTENT statements. Rerun the job.

X'24' 036

Return Code=08 Action=Request
The key of the record to be inserted does not fall into an existing key range in the file.

X'28' 040

Return Code=08 Action=OPEN
No space is available on any volume for primary allocation of a dynamic file. PROGRAMMER ACTION: Use LISTCAT to determine the volumes allocated to the file's primary allocation value, the file's USECLASS specification, and the space allocation status of these volumes. Either:

Delete obsolete files occupying data space with matching classes (CLASS, USECLASS parameters)
Define additional data space(s) of the required class on any of the volumes
Using the ALTER command ADDVOLUMES parameter, and volume(s) to the file that contains sufficient unallocated space of the required class to satisfy the file's primary allocation value.

Then rerun your job.

Return Code=08 Action=Request
VSAM could not obtain a sufficiently large contiguous area of virtual storage. PROGRAMMER ACTION: Rerun the job in a large partition.

X'2C' 044

Return Code=08 Action=Request
The work area you have supplied (in the AREA = addr operand for the RPL) is not large enough for the requested data record.

X'30' 048

Return Code=08 Action=OPEN
An attempt was made to open a NOALLOCATION file which is not reuable (REUSE). Such a file is really a model and not to be opened. PROGRAMMER ACTION: Make sure the file-id in your DLBL statement does not specify the name of a default model.

Return Code=08 Action=Request
One or more VSAM processing phases cannot be loaded because the virtual partition being used is too small. PROGRAMMER ACTION: Rerun the job in a larger virtual partition.

X'32' 050

Return Code=08 Action=OPEN
One or more VSAM processing modules cannot be loaded because either the GETVIS area or the partition is too small. PROGRAMMER ACTION: Specify SIZE = AUTO on the EXEC statement to increase the

X'34' 052

Return Code=08 Action=Request
An internal error occured in a VSAM routine. Note: VSAM produces an INDUMP of the region containing the VSAM control blocks, provide the SYSDMP is created and assigned. PROGRAMMER ACTION: Print the dump from SYSDMP. (Refer to VSE/VSAM Programmer's Reference for interpretation of the IDUMP output.) Contact your IBM Support Center, and make the program listing, console log, and the dump available for problem determination.

X'38' 056

Return Code=08 Action=Request
An error occurred during dynamic assignment of a volume. Either:

A programmer logical unit is not available is this partition (assignment statements for SYSnnn use these)
An extent block is not available in the system (temporary assignments use these)
The device on which the volume is mounted is "down" (job control command DVCDN).

X'40' 064

Return Code=08 Action=OPEN
An attempt was made to open a NOCIFORMAT file using an ACB. Non-CI format files are supported only by SAM access (DTF).

Return Code=08 Action=Request
As many requests are active as the number specified in the STRNO = n operand for the ACB or BLDVRP macro; therefore, another request cannot be started. PROGRAMMER ACTION: Change your program to use managed SAM to access the file, or change the DLBL statement to specify a file other than SAM ESDS. Rerun the job.

X'41' 065

Return Code=08 Action=OPEN
An attempt was made to open a SAM ESDS but the VSE/VSAM Space Managament for SAM Feature is not installed on the system. PROGRAMMER ACTION: Install the VSE/VSAM Space Management for SAM Feature in your system and rerun the job. If you do not want to install the VSE/VSAM Space Managment for SAM Feature, change the DLBL statement to specify a file other than SAM ESDS and rerun your job.

X'42' 066

Return Code=08 Action=OPEN
An attempt was made to open a DTF with file characteristecs that are incompatible with the file's cdharacteristics in the VSAM catalog. Examples of these incompatibilities are:

The DTF BLKSIZE is too large to fit in the maximum RECORDSIZE defined for the file.
The DTF implies a CI format file but the file is NOCIFORMAT. Only DTFPH may be used with NOCIFORMAT files.

Note: For DTFPH, BLKSIZE is taken to be the DTFPH CISIZE minus 7. PROGRAMMER ACTION: IF the file was explicitly defined, you must change your program to be compatible with the files, change the file by explicitly deleting it and redefining it to agree with your program, or use a different file. If the file was implicitly defined, you can cause open to implicitly DISP = NEW. During implicity deletion, the operator will be requested to authorize deletion if the expiration data previously specified for the file has not passed.

X'43' 067

Return Code=08 Action=OPEN
An attempt was made to open an unexpired file for output using a DTF. PROGRAMMER ACTION: The VSAM OPEN return code will be handled internally by the VSE/VSAM Space Management for SAM Feature by requesting operator authorization to delete the unexpired file. This message is accompanied by message 4233A. If authorization is granted, OPEN will complete successfully, assuming no other complications.

X'44' 068

Return Code=08 Action=OPEN
The file to be opened has a name which begins with "DEFAULT.MODEL.". This is an invalid prefix.

Return Code=08 Action=Request
The type of accessing for the request does not match the type of accessing in the ACB when the file was opened; for example:

ADR or CNV was specified, but keyed access is requested.
IN was specified (explicitly or by default), but an update request is made.
GET UPD ADR is requested but ADR was not specified on the ACB when the SHAREOPTIONS(4)KSDS was opened.

PROGRAMMER ACTION: Change your DLBL statement to specify a valid file-id and rerun the job.

X'45' 069

Return Code=08 Action=OPEN
An attempt was made to open a file which is not a SAM ESDS using a DTF. PROGRAMMER ACTION: Probable job control error. Make sure that your DLBL statement specifies a file-id which you know is a SAM ESDS.

X'46' 070

Return Code=08 Action=OPEN
An invalid file-id was detected during implicit define or implicit delete. PROGRAMMER ACTION: Probable job control error. Make sure that the file-id specified in your DLBL statement meets the criteria for a valid VSAM file-id.

X'47' 071

Return Code=08 Action=OPEN
Allocation specifications for implicit define conflict with the file characteristics specified in the DLBL. VSAM is not able to resolve the conflict. PROGRAMMER ACTION: Probable job control error. Make the average recordsize specified in the DLBL statement no larger that the blocksize specified in your DTF.

X'48' 072

Return Code=08 Action=OPEN
The file-id specified in your DLBL statement was not found in the catalog, and insufficient allocation information was specified for an implicit define. PROGRAMMER ACTION: Add space allocation parameters to your job control statements. This may be done by specifying the number of tracks and blocks in the EXTENT statement or by specifying RECORDS and RECSIZE on the DLBL statement for device independent allocation.

Return Code=08 Action=Request
Keyed access is requested for an entry-sequenced file.

X'4C' 076

Return Code=>0 Action=CLOSE
Disposition processing failed during close. System Action: Close processing continues to successful completion, assuming no other complications. Message 42261 will be issued at end-of-job step for this file. PROGRAMMER ACTION: Be aware that a file which you expected to be deleted may still exist, or a file which you expected to be unallocated may still be using space, or a file which you expected to be reset may still have secondary allocation. Use Access Method Service commands (for example: LISTCAT DELETE) to clean up files as required.

Return Code=08 Action=OPEN
Addressed or control-interval insertion is requested for a key-sequenced or relative-record file.

X'4E' 078

Return Code=08 Action=OPEN
A catalog management error was detected during implicit delete. Message 4A371 is issued to provide the catalog management return code and reason code which are used to diagnose the problem. PROGRAMMER ACTION: Use Appendix B to determine the cause of the error in message 4A371 and take the recommended corrective action. You can use the Access Method Services DELETE command to explicity clean up the file or you can rerun you job retry the implicit delete. If implicit delete only delete part of file, you must specified DELETE IGNOREERROR to delete the rest of the file.

X'4F' 079

Return Code=08 Action=OPEN
A catalog management error was detected during implicit define. Message 4A371 is issued to provide the catalog management return code and reason code which are used to diagnose the problem. PROGRAMMER ACTION: Use Appendix B to determine the cause of the error specified in message 4A371 and take the recommended action.

X'50' 080

Return Code=08 Action=OPEN
An attempt was made to have two volumes mounted on the same device when direct or keyed processing is specified in the ACB, or The operator did not mount the required volume. One of the following situations may have occurred.

You requested a programmer logical unit that was not system generated (IOTAB xxPRG).
You requested a programmer logical unit that was not system generated, but whose assignment has been changed to UA (unassigned) by the operator or by a previous program.
The operator specified `NEWPAC' in response to a mount message, but did not actually mount the volume. If this error is issued to a program using the ISAM Interface Program, the job is canceled.

PROGRAMMER ACTION: Request a programmer logical unit that was specified at system generation.

Reassign the programmer logical unit (ASSGN SYSxxx cuu) or request a device that is already assigned.
Ensure that the operator mounts the correct volume.

Return Code=08 Action=Request
An ERASE marco is issued for an entry-sequenced file (directly or via a path) or for a file for which control-interval processing has been specified.

X'54' 084

Return Code=08 Action=Request
Locate mode was specified for a PUT request of for processing in a user buffer.

X'58' 088

Return Code=08 Action=Request
Positioning error; the problem program:

Issued a sequential GET without having VSAM positioned for this GET.
Changed from addressed to key access without having VSAM positioned for keyed-sequential retrieval.
Issued a sequential PUT insert request for a relative-record file without having VSAM positioned for this request.
Attemped to improperly switch between forward and backward processing.

X'5C' 092

Return Code=04 Action=OPEN
Warning: MACRF = LSR (local shared resources) is specified, but no OPEN/CLOSE/TCLOSE message area was specified. Ignore this error code if there is no ACB with the option DFR specified in the resource pool.

Return Code=08 Action=Request
A PUT for update or an ERASE is issued without a preceding GET for update.

X'60' 096

Return Code=04 Action=OPEN
The file to be opened for input was found to be unusable because catalog recovery for this file failed. PROGRAMMER ACTION: Either correct the situation that caused the catalog recovery operation for this file to fail, or recreate the file.

Return Code=08 Action=Request
An attempt was made to change the prime key of a record that is being undated, or an attempt was made to change an alternate key that has the UNIQUEKEY attribute. A sequence error occurred during sequential updating. For example, during REPRO REPLACE, two separate updates to the same record were attempted.

X'64' 100

Return Code=08 Action=OPEN
OPEN encountered an empty alternate index that is part of an upgrade set.

Return Code=04 Action=Request
An attempt was made to change record length during update with addressed access or to change record length for a relative-record file.

X'68' 104

Return Code=04 Action=OPEN
The timestamp of the volume on which the file is stored is lower than the system timestamp in the file's catalog entry. The extent information in the catalog entry may not agree with the extent information in the volume's VTOC. PROGRAMMER ACTION: If problems occur due to inconsistent extent information, display the VTOC and execute the Access Method Services LISTCAT command and compare the extent information. Possibly the wrong volume was mounted. If the correct volume was mounted, recover the file to make sure that the volume and catalog timestamps agree. Rerun the job.

Return Code=08 Action=Request
Invalid or conflicting RPL options or parameters:

SKP together with BWD.
LRD without BWD.
COV together with BWD.
ARG parameter was not specified when required.
For Local Shared Resources, the ACB addr is not same as for a previous request that used the same RPL.

For shared resources, WRTBFR was issued, but:

TRANSID was greater than 31,or
The shared resource option (LSR) was not specified, or
The LSR percentage value was not between 0 and 100.

X'6C' 108

Return Code=04 Action=OPEN
The system timestamps of the data of a file and its index do not match; this indicates that either the data of the index has been undated separately and that data integrity problems may result if the file is processed now. PROGRAMMER ACTION: If data integrity problem arise, revert to a valid backup copy of the file.

Return Code=08 Action=Request
The RECLEN value specified in the RPL was one of the following:

Larger than the allowed maximum.
Equal to zero.
Smaller than to record (slot) size specified for a relative-record file.

For alternate index upgrade processing, the alternate index contains too many duplicate keys. Increase the maximum record length to accommodate more keys.

X'6E' 110

Return Code=08 Action=OPEN
You attempted to open for input only (ACB MACRF=IN) a file which was empty (no record in it) or a file was not properly closed on initial loading. Managed-SAM will simulate the open of an empty file for DTFSD TYPEFLE=INPUT requests. You are allowed to process the file, and managed-SAM will pass control to the EOFADDR routine upon encountering the file GET marco. To VSAM, however, the file is not really open, so close disposition processing does not take effect when the file is closed. If you want the file deleted after close, you must delete it using the Access Method Services DELETE command. PROGRAMMER ACTION: Change your program to specify MACRF=OUT in the ACB if you want to process empty files.

X'70' 112

Return Code=08 Action=Request
The length of the generic key specified for the RPL is too large or is equal to zero.

X'71' 113

Return Code=00 Action=OPEN
OPEN tried to execute the Catalog Check Service Aid in order to check the validity of this file's catalog records. Either the CDLOAD failed, or the service aid encountered I/O errors. The file has been opened successfully. PROGRAMMER ACTION: Run the Catalog Check Service Aid; it will identify catalog errors for you. Follow the directions for the error messages that is issues. The Catalog Check Service Aid is documented in VSE/VSAM Programmer's Reference.

X'72' 114

Return Code=00 Action=OPEN
The Catalog Check Service Aid was invoked during OPEN processing and detected a catalog irregularity, or there was insufficient storage for Catalog Check processing. PROGRAMMER ACTION: This access to the data is allowed, but there are errors in the catalog structure that you should find. Because this information was collected during OPEN processing, it cannot be printed. Run the Catalog Check Service Aid against the entire catalog; it will indentify catalog errors for you. Follow the directions for the error messages that it issues. The Catalog Check Service Aid is documented in VSE/VSAM Programmer's Reference. If Catalog Check finds no error, the problem was due to insufficient storage. Rerun the original job.

X'73' 115

Return Code=08 Action=OPEN
The Catalog Check Service Aid was invoked during OPEN processing and detected a severe catalog error. You cannot open the file for output because catalog errors might be propagated. You may, however, open the file for input. The problem may be due to insufficient storage for Catalog Check processing. PROGRAMMER ACTION: Because this information was collected during OPEN processing, it cannot be printed. Run the Catalog Check Service Aid against the entire catalog; it will identify catalog errors for you. Follow the directions for the error messages it issues. The Catalog Check Service Aid is documented in VSE/VSAM Programmer's Reference. After correcting errors, rerun the original job. If Catalog Check finds no errors, the problem was due to insufficient storge. Rerun the original job.

X'74' 116

Return Code=04 Action=OPEN
You tried to open a file that was not successfully closed the last time it was opened for output. One of the following has happened:

OPEN tried to verify the catalog record for the file but did not complete verification.
The file is a SAM ESDS in non-CI format, so OPEN did not try to verify its catalog records.
The file is an ESDS being opened in CNV mode. There are two ways this could happen.:
Your job stream contains a VERIFY command. (VERIFY opens files in CNV mode.) The verification is successful; ignore this error code.
You requested CNV mode on the RPL. Open did not try to verify the file's catalog records.
The previous time the file was opened was the initial load of the file, and SPEED was specified. OPEN did not try to verify its catalog records.

PROGRAMMER ACTION: Depends on the processing done during the preceding run. If record were only retrieved no programmer action is required. If records were added, deleted, or update, consult the explanation to message 42251.

Return Code=08 Action=Request
A request other than sequential or skip sequential PUT to insert record was issued during initial loading of the file, or a request other than PUT insert was issued during initial loading of a relative-record file. Possibly an attempted was made to read an empty file. This code can also indicate that you attempted to load an empty file (using REPRO REPLACE) when the input file contained duplicate records. Do not specify REPLACE under these circumstances.

X'75' 117

Return Code=08 Action=OPEN
The logical unit specified in the EXTENT statement is not assigned to a valid device type, or invalid extents are specified. PROGRAMMER ACTION: Change your job control statement to either use simplified job control or to correctly assign device to accommodate the volumes required for the cluster and its associated alternate indexes. To use simplifed job control, eliminate EXTENT statement and ASSGN statement describing your VSAM clusters. The information about volume is retrieved from the catalog, and programmer logical units are automatically assigned by VSAM. If you do not use simplified job control, use LISTCAT output to determine which volumes must be described in the EXTENT statements. Rerun the job.

X'76' 118

Return Code=00 Action=OPEN
You opened a file that was not closed on a previous open for output. OPEN verified the file's catalog records, and the catalog RBA values have been validated. The file has been opened successfully. PROGRAMMER ACTION: No action required. This information message indicates that the catalog records for this file are correct, but its catalog statistics may be incorrect. These statistics cannot cause any processing error, but be aware that LISTCAT output may contain erroneous information.

X'80' 128

Return Code=08 Action=OPEN
The DLBL statement for the file or catalog is missing, or the file name specified in that statement does not match the name of the ACB. PROGRAMMER ACTION: Compare your program's requirements and your job control statements to ensure that you have provided a corresponding DLBL statement for each ACB DDNAME. Make corrections to the DLBL statement and rerun the job.

Return Code=08 Action=Request
The VSAM catalog was accessed during processing of a request, and an error occurred during this catalog access. An example is GETVIS failure. PROGRAMMER ACTION: If a recoverable catalog was used, check whether all of the required EXTENT statements were provided; if a recoverable catalog was not used, provide a large virtual partition. Rerun the job. If the rerun fails, contact your IBM Support Center. You may wish to use the following for problem determination:

program listing
SYSLOG output
program dump, if available.

X'84' 132

Return Code=08 Action=OPEN
A permanent I/0 error occurred while VSAM was reading label information from the label information area. PROGRAMMER ACTION: Retry. If the problem persists, instruct your operator to issue the ROD command and to run EREP (see VSE/Advanced Functions SADP); contact your IBM Support Center, and have EREP and SYSLOG output available for problem determination.

Return Code=08 Action=Request
An attempt was made to retrieve a spanned record in locate mode.

X'88' 136

Return Code=>0 Action=CLOSE
VSAM could not obtain a contiguous area of virtual storage large enough for the work area needed by the CLOSE routine. PROGRAMMER ACTION: Have your program executed in a larger virtual partition.

Return Code=08 Action=OPEN
VSAM could not obtain a contiguous area of virtual storage larger enough to accommodate work area, control blocks, and buffers needed by VSAM. PROGRAMMER ACTION: Provide a large GETVIS area for VSAM by one of the following actions:

Specify the SIZE parameter in the EXEC statement (if missing), or
Allocate more virtual storage to the partition.

Return Code=08 Action=Request
An attempt was made to retrieve a spanned record of a keyed-sequenced file with addressed access.

X'8C' 140

Return Code=08 Action=Request
VSAM encountered an inconsistent spanned record (that is, one or more segments were incompletely updated to destroyed). If the request was a GET, the record (or as much of it as possible) was moved to the user's work area. The record may contain segments at different update levels. The RECLEN field of the RPL shows the length actually moved to the work area. If the request was sequential or skip-sequential (but not direct), the file remains positioned for update or subsequent sequential retrieval. An update of the record will update the status of all segments to a consistent level. If the error was in the AIX during path access (RPL FTNCD=X'02'), the base cluster is not accessed, and no record is moved to the work area. During sequential or skip-sequential access, a subsequent request will access records with a higher alternate key than the one in error.

X'90' 144

Return Code=>0 Action=CLOSE
One of the following has occcurred:

VSAM could not obtain a sufficiently large area of contiguous storage needed by the catalog routines for CLOSE processing.
An error occurred when the catalog was accessed during the processing of a CLOSE request. For example, a permanent I/0 error may have occurred when VSAM was reading or writing a catalog entry or catalog recovery area record.
A GETVIS failure, or a failure to load a VSAM phase occurred.
Not enough extent blocks were available to open the catalog recovery area if DASDFP has been specified at system generation.
Not enough programmer logical units were available. Increase the number of programmer logical units (IOTAB xxPGR sysgen macro) or, if this is a multi-step job, separate the job into several jobs.

PROGRAMMER ACTION: Retry. If the problem persists, instruct your operator to issue the ROD command and to run EREP (see VSE/Advanced Functions SADP); contact your IBM Support Center.

Return Code=08 Action=OPEN
An error occurred when the catalog was accessed during the processing of an OPEN request. For example, a permanent I/0 error may have occurred when VSAM was reading or writing a catalog entry or a catalog recovery area record. PROGRAMMER ACTION: Retry. If the problem persists, instruct your operator to issue the ROD command and to run EREP (see VSE/Advanced Functions SADP); contact your IBM Support Center, and have EREP and SYSLOG output available for problem determination.

Return Code=08 Action=Request
VSAM encountered a pointer in an alternater index without an associated base record.

X'94' 148

Return Code=08 Action=OPEN
No valid entry was found in the catalog for the ACB to be opened or for the alternate index structure related to this ACB. Your program may have (a) specified an incorrect cluster, alternate index, or pathname, or (b) failed to specify the correct catalog name, or to correctly assign the catalog, or (c) an Access Method Service DEFINE or DELETE may have failed. PROGRAMMER ACTION:

Verify that your program is using the correct cluster, alternate index, or path name.
Verify that your program is using the correct catalog.
Verify that the cluster, alternate index, or path was defined with the correct name and in the desired catalog, and that the catalog was correctly assigned.
Verify that a previous Access Method Service DEFINE or DELETE did not fail. Perform a LISTCAT to determine the contents of the catalog you are using.

Return Code=08 Action=Request
The maximum number of pointers in the alterenate index has been exceeded.

X'98' 152

Return Code=08 Action=OPEN
Security verification failed: the password specified in the ACB or supplied by the operator for a specific level of access does not match the password in the catalog for that level of access. PROGRAMMER ACTION: If you expect the operator to specify the password, ensure that he has the correct password available. If you specified the password in the ACB, change the specification to the correct password. Rerun the job.

Return Code=08 Action=Request
Not enough buffers are available to process the request (shared resources only). PROGRAMMER ACTION: Retry the request; additional buffers may have been freed.

X'9C' 156

Return Code=08 Action=Request
One or more records in this CI may contain duplicate data after an addressed GET-with-update. Any duplicates can be eliminated by processing the data set using keyed access.

X'A0' 160

Return Code=08 Action=OPEN
One of the following has occurred:

Keyed access was specified for the ACB (in the ACB or the GENCB macro), but the file is entry sequenced.
An attempt was made to load a key-sequenced file with an access type other than keyed.
An attempt was made to access a relative-record file with an access type other then keyed or control interval.
MACRF = LSR (local shared resources) has been specified together with UBF (user buffering).
MACRF = DFR (defer writes) has been specified without LSR (shared resources).
MACRF = DFR has been specified for a file that was defined with SHAREOPTIONS (4).
Both KEY and ADR/CNV access were specified in an ACB being opened for a share option 4 output file.
An attempt was made to access a file for input with conflicting or invalid disposition specified on the job control statements.

PROGRAMMER ACTION: Determine which of the error causes applies to your job. Correct the conflict and rerun the job.

X'A1' 161

Return Code=08 Action=OPEN
User buffers (ACB MACRF = USF) has been specified with keyed or addressed access; user buffers can be specified only with control interval access. PROGRAMMER ACTION: Specify ACB MACRF = NUB (no user buffers) of ACB MACRF = CNV (control interval access). Rerun the job.

X'A5' 165

Return Code=>0 Action=CLOSE
A permanent I/0 error was detected on the system lock file. PROGRAMMER ACTION: Consult with your system programmer to correct the problem. Rerun the job after the system problem is corrected.

Return Code=08 Action=OPEN
A permanent I/0 error was detected on the system lock file. PROGRAMMER ACTION: Consult with your system programmer to correct the problem. Rerun the job after the system problem is corrected.

X'A6' 166

Return Code=>0 Action=CLOSE
The system lock table is not large enough to accommodate the concurrent requests. PROGRAMMER ACTION: Rerun your job when there is less concurrent activity in the system.

Return Code=08 Action=OPEN
The system lock table is not large enough to accommodate the concurrent requests. PROGRAMMER ACTION: Rerun the job when there is less concurrent activity in the system.

X'A7' 167

Return Code=>0 Action=CLOSE
The system lock file is not large enough to accommodate the concurrent requests. PROGRAMMER ACTION: Rerun the job when there is less concurrent activity in the system. If this problem recurs often, it may be necessary for your system programmer to provide for a larger lock file using the DLF IPL command.

Return Code=08 Action=OPEN
The system lock file is not large enough to accommodate the concurrent requests. PROGRAMMER ACTION: Rerun the job when there is less concurrent activity in the system. If this problem recurs often, it may be necessary for your system programmer to move the lock file to a device type that will provide a larger lock file. (See "DLF Command" in VSE/VSAM Advice Functions System Control Statements.)

X'A8' 168

Return Code=08 Action=OPEN
The file is not available for one of the following reasons:

It is being updated by and under exclusive control of another ACB.
It is being loaded by and under control of another ACB.
It is being reset by another ACB.
OPEN with RESET was specified in the ACB and the file is being accessed by another ACB.
It was exported with the TEMPORARY and INHIBITSOURCE options and updating is not permited.
A copy of the file was exported with the INHBITSOURCE options and imported into this system. Updating is not permitted.
It was altered via the ALTER command with the INHIBIT option.
A SAM ESDS is being loaded or extended by another SAM access user (DTF).
A managed-SAM access user (DTF) has attempted to load or extend a SAM ESDS that is in use by another managed-SAM access user (DTF).
The ACB for a SHAREOPTIONS (4) KSDS indicates MACRF = ADR, MACRF
CNV but there are currently other ACBs open for keyed output access, or
The ACB for a SHAREOPTIONS (4) KSDS indicates MACRF = ADF, MACRF = CNV, or MACRF = KEY but there are currently other ABCs open for addressed output or control interval output access.
You attempted to open an ACB for a SHR(4) KSDS using MACRF=(KEY,CNV) or MACRF = (ADR).
The ACB for a SHAREOPTIONS(4) KSDS indicates MACRF = ADR or MACRF = CNV but the SHAREOPTIONS(4) file, which you are attempting to open for output, is already open for output from another processor. Only one processor may do output to SHAREOPTIONS(4) file at a time.

If the system which opened the file has become inoperative, the lock can be released via Attention Routine UNLOCK command. (See VSE/Advanced Functions Systems Control Statements.) PROGRAMMER ACTION: Determine if the file contention problem is caused within your program. If so, change your program to avoid the contention, or change the file definitions to allow your desired operations. Rerun your job. If you determine the contention is caused by other jobs (either in your system or another system) using the same files as your job, attempt to reschedule your job at a time when contending jobs will not be running.

X'B4' 180

Return Code=08 Action=OPEN
An error occurred in opening a catalog or CRA. Possible causes for this error code are:

An attempt to get virtual storage failed
An I/0 error occurred while VSAM was reading the VTOC
An extent block is not availabe in the system
Unable to assign a logical unit
The system lock table or system lock file of an I/0 error was detected on the system lock file
More than one volume with the same volume identifier (volume serial number) is mounted on the system.

PROGRAMMER ACTION: Specify SIZE on the EXEC statement to provide adequate GETVIS space. Ensure that the correct volume was mounted; check your job control statements defining the catalog of CRA for possible errors. Correct any errors and rerun the job. If the error occurred although the correct volume was mounted and there was no job control error, restore the catalog by using a backup copy or the catalog recovery function.

X'B8' 184

Return Code=>0 Action=CLOSE
An internal error occurred in a VSAM routine while VSAM was completing I/0 requests. PROGRAMMER ACTION: Ensure that your program issues a DUMP macro when this type of error occurs. Save the dump you obtain for later problem determination.

X'BC' 188

Return Code=>0 Action=CLOSE
The ACB to be close is currently being used; (for example, by a SHOWCB or TESTCB macro).

Return Code=08 Action=OPEN
The ACB to be opened is already being used. PROGRAMMER ACTION: Only one OPEN, CLOSE, or Control Block Manipulation macro may use an ACB at a time. Change your program to avoid task contention for the ACB. Rerun the program.

X'C0' 192

Return Code=08 Action=OPEN
The file to be opened for output was found to be unusable (catalog entry marked not usable) because (a) catalog recovery for this file failed, or (b) DELETE SPACE with FORCE has deleted a volume required by the file. Programmer Respone: Do one of the following:

Correct the problem that caused the preceding catalog recovery operation to fail.
Use Access Method Services EXPORTRA command to export the file for subsequent reimportation.
Redefine and reload the file.

Return Code=08 Action=Request
VSAM encountered an invalid relative-record number.

X'C4' 196

Return Code=08 Action=OPEN
Access to data was requested via an empty alternate index.

Return Code=08 Action=Request
An addressed request was issued for a relative-record file. PROGRAMMER ACTION: Use Access Method Services BLDINDEX command to initialize the alternate index. Rerun the job.

X'C8' 200

Return Code=08 Action=Request
An addressed or control-interval access is attempted via a path.

X'CC' 204

Return Code=08 Action=Request
The program issued a PUT to insert a record while in backward mode.

X'D0' 208

Return Code=08 Action=Request
For SHAREOPTIONS(4), a lock required for update or insert processing is held in exclusive control by another ACB. The other ACB is not in communication with the ACB under which the current request has been processed; however, the other ACB is being executed under the same VSE task. PROGRAMMER ACTION: One of the following techniques can be used to alleviate the problem:

Allow the processing of the request under the other ACB to be completed and then retry the failed request.
Merge the processing that was two ACBs so that only one ACB is required. (However, this can result in error code X'14' when the same situation occurs.)
Run both ACBs under Local Shared Resource so that they will be in communication with each other. (However, this can result in error code X'14' when the same situation occurs.)
Run each ACB under a separate VSE task.

X'D4' 212

Return Code=08 Action=OPEN
ACB MACRF = LSR (local shared resources) is specified, but the file being opened is empty (which implies that the file will be loaded).

Return Code=08 Action=Request
VSAM received a return code from the LOCK macro indicating that there is no space in the lock table to make a lock entry. PROGRAMMER ACTION: Use another program to load the file of specify ACB MACRF = NSR (non-shared resources) unit the file is loaded.

X'D8' 216

Return Code=08 Action=OPEN
ACB MACRF = LSR (local shared resources) is specified, but the key length of the file being opened is greater than the maximum key length specified in BLDVRP for the resource pool. PROGRAMMER ACTION: Change your program to build a resource pool that can accommodate the key length of the file being opened. Rerun the job.

Return Code=08 Action=Request
For SHAREOPTIONS(4), the file size is too large for the control area size. Specifically, this condition is diagnosed under the following circumstances:

The request would cause a control area to be allocated whose RBA would be greater than 64511 multiplied by the control area size in bytes.
The request would cause a sequence set record to be allocated whose RBA (within the index component) would be greater than 64511 multiplied by the size of the index control interval.
A GET UPD or PUT NUP request is for a control area whose data RBA is greater than 64511 multiplied by the control area size in bytes, or whose sequence set RBA (with the index component) is greater than 64511 multiplied by the size of the index control interval. This circumstance could occur only if the file was built to a large size with a sharing option other than SHAREOPTIONS(4), and then altered (via the ALTER command) to SHAREOPTIONS(4).

This will not restrict files that use a max-CA for the control area size. Only if very large flies were generated using a control area size significantly smaller than a max-CA would there be a danger of violating this restriction. PROGRAMMER ACTION: Regenerate the file specifying a larger primary and/or secondary allocation in the Access Method Service DEFINE command, so that a larger control area size will be used by VSAM.

X'DC' 220

Return Code=08 Action=OPEN
ACB MACRF = LSR (local shared resources) is specified, but the control interval size of the file being opened is greater than the larger buffer size specified in BLDVRP for the resource pool. PROGRAMMER ACTION: Change your program to build a resource pool that can accommodate the key length of the file being opened. Rerun your job.

X'E4' 228

Return Code=>0 Action=CLOSE
The VSAM shared resoure table (IKQVSRT) ID is invalid. PROGRAMMER ACTION: Take a system dump, contact your IBM Support Center and have the dump output, SYSLOG output, and a copy of the job stream available for problem determination.

Return Code=08 Action=OPEN
ACB MACRF = LSR (local shared resources) is specified, but there is no resource pool defined. There may have been problems in loading the resource table. PROGRAMMER ACTION: Change your program to build the resource pool before attempting to open any ACB that uses local shared resoures. Rerun your job.

X'E8' 232

Return Code=08 Action=OPEN
ACB MACRF = RST (reset) was specified for a non-reusable file and that file is not empty. Reset specification can result from MACRF = RST in your ACB, open disposition of NEW, or close disposition of DELETE in your DLBL statement. PROGRAMMER ACTION: Change the reset specification and rerun your job.

X'F8' 248

Return Code=08 Action=OPEN
IKQLAB or IKQSMVRJ (VSE/VSAM Space Management for SAM Feature) passed an invalid parameter list to the LABEL or EXTRACT marco. This is probably a system error. PROGRAMMER ACTION: Take a system dump, contact your IBM Support Center, and have the dump output, SYSDMP output , and a copy of the job stream available for problem determination.

X'FC' 252

Return Code=>0 Action=CLOSE
Automatic close of a DTF for a managed-SAM file failed.

X'FE' 254

Return Code=>0 Action=CLOSE
CLOSE detected an unexpected rerun code from the lock manager. NOTE: VSAM provides an IDUMP of the region containing the VSAM control blocks, provided the SYSDMP is created and assigned. PROGRAMMER ACTION: Rerun your job. If the problem persists print the dump from the SYSDMP. (Refer to VSE/VSAM Programmer's Reference for interpretation of the available for problem determination:

IDUMP output
Store dump of the supervisor lock tables
A dump of the lock file if one was specified at IPL time
Job stream

Return Code=08 Action=OPEN
OPEN detected an unexpected return code from the lock manager. NOTE: VSAM provides an IDUMP of the region containing the VSAM control blocks, provided the SYSDMP is assigned. PROGRAMMER ACTION: Rerun your job. If the problem persists print the dump from the SYSDMP. (Refer to VSE/VSAM Access Method Service Logic for interpretation of the IDUMP output.) Contact your IBM Support Center. The following may be helpful for problem determination.

IDUMP output
Storage dump of the supervisor lock tables
A dump of the lock file if one was specified at IPL
SYSLOG output
job stream

X'FF' 255

Return Code=>0 Action=CLOSE
An unexpected error occurred during catalog processing. The most common problems are:

Not enough partition GETVIS space.
Not enough programmer logical units for this partition.
Not enough extent blocks.
An error may have occurred during lock Manager processing.

Note: VSAM provides an IDUMP of the region cotaining the VSAM control blocks, provided the SYSDMP is assigned. PROGRAMMER ACTION: If you are using a recoverable catalog, check that all required EXTENT statements are present and correct, and that sufficient storage is available. If you suspect the problem is one of those listed above, perform the corresponding action:

Specify SIZE = AUTO on the EXEC statement to increase the size GETVIS area. If this does not work, rerun the job in a larger partition.
If this is a multi-step job, either divide it into separate jobs or provide ASSGN statements instead of simplified JCL. If you cannot separate the job into smaller jogs, SYSGEN a new supervisor with more programmer logic units (IOTAB xxPRG SYSGEN macro).
Specify the SYS EXTENT = command to increase the amount of space allocated for extent blocks.

If the problem persists print the dump from the SYSDMP. (Refer to VSE/VSAM Access Method Services Logic for ivterpretation of the IDUMP output.) Contact your IBM Support Center and make IDUMP output, the SYSLOG output, and job stream available for problem determination. To assist in problem diagnosis, you might wish to run a SNAP dump 0001, as described in the "Diagnosis Aids" section of VSE/VSAM/VSAM logic, Volume 1 or Volume 2.

Return Code=08 Action=OPEN
Same explanation as for CLOSE.