VERIFYV (VSAM)

Syntax:

VERIFYV(ddname)

Arguments:

ddname
is the 1 to 8 character name that identifies the data set you want to process. This name needs to have been previously associated with the data set, either via the ALLOCATE command or JCL DD statement, and opened via the OPEN function.

Module Name:

SWXVERFY

Service Description:

The VERIFYV function is used to correct information the catalog contains related to the location of the end of the data set. Before you can use the VERIFYV function you must first allocate and open (using the OPEN function) the data set associated with the ddname argument. If you do not, an error will occur.

The primary purpose of the VERIFYV function is to correct catalog information that may have been corrupted due to system failures. The action performed by the VERIFYV function is identical to the action performed by the IDCAMS VERIFY command.

Notes:

  1. The VERIFYV function has the extra "V" on the end of its name so as not to interfere with the REXX built-in function, VERIFY.
  2. VERIFYV changes the RPL options to '(CNV,SEQ,FWD)' prior to executing the VSAM VERIFY macro. If different RPL options are required for subsequent processing, your program must specify the new options itself.

Returned Information:

The VERIFYV function returns the VSAM VERIFY macro return code. If you CALL the VERIFYV function, the returned value is contained in the RESULT special variable.

After completion of a VERIFYV function call, two special REXX variables are populated with useful information. You should treat these variables as "read only" and make no attempt to modify any of them. The variables are:

RC
Contains the VSAM VERIFY return code. Zero means the operation was completed successfully.
REASON
Contains the VSAM VERIFY reason code.

Examples:

  1. Call the VERIFYV function to fix the catalog entry for the allocated (and opened) data set:
    call verifyv 'iodd'
    


© Copyright 1998 by Open Software Technologies, Inc.