DB-FREE

DB-FREE releases file resources and:
Restriction: This topic applies only when the AppMaster Builder AddPack has been installed, and applies only to Windows platforms.
  • Ends a sequential DB-OBTAIN browse.
  • Unlocks a held record (a record held by a DB-OBTAIN HOLD) when DB-OBTAIN is not followed by DB-MODIFY or DB-ERASE.

Target:

VSAM Online

Syntax:

DB-FREE REC recordname|ALL
... [VIEW keyname]
... [ENDBR] [UNLOCK] [REQID number]
... [SYSID systemname] [DDN ddname]

Syntax Rules:

  1. UNLOCK and ENDBR are default keywords. De-activate either one by:
    • Coding only ENDBR makes UNLOCK inactive
    • Coding only UNLOCK makes ENDBR inactive
  2. When ALL is coded and UNLOCK and ENDBR are active, a single DB-FREE call (located in a central paragraph) works for the entire program.

Parameters:

ALL

Process all subschema records. When coded with SYSID, all files must reside on the same region.

DDN ddname

Specify file ddname; can be a literal or data name defined as PIC X(8). Supply a value to the name option of CICS DATASET.

ENDBR

End active browse; generate CICS ENDBR co