VSAM Configuration File

Overview

VSAM configuration file specifies the VSAM accessor and related attribute of each VSAM file used in ART CICS runtime. VSAM configuration file is generated by Oracle Tuxedo Application rehosting Workbench and should not be modified.

ART CICS runtime will find VSAM configuration file through the environment variable $DD_VSAMFILE, which could be exported or defined in the envfile and used to indicate the location of VSAM configuration file.

VSAM Configuration Parameters

Table 5‑1 lists and defines VSAM file configuration parameters available to be referenced by the CICS application.

The filename is desc.vsam.

 

Table 5‑1 VSAM Configuration Parameters

Field Name	Type	Values	Description
NAME	X(8)	Mandatory	Name of the VSAM file. Logical name of VSAM file used in EXEC CICS related to this file.
ACCESSOR	X(256)	Mandatory	Name of the VSAM accessor referenced by CICS application according to the corresponding VSAM file. The VSAM accessor is generated by ART Workbench.
ORGANIZATION	X(1)	Mandatory	I/i: Indexed Record R/r: Relative Record S/s: Sequential Record
RECORD TYPE	X(1)	Mandatory	F/f: Fixed Length Record I/i: Indefinited Length Record
RECORD LENGTH	NUM 1-32768	Mandatory, if TYPE is Fixed	The length of each fixed record in VSAM file.
KEY POSITION	NUM 1 - 32768	Mandatory, if ORGANIZATION is Indexed	The start position of KEY of each record in VSAM file.
KEY LENGTH	NUM 1 - 256	Mandatory, if ORGANIZATION is Indexed	The length of KEY of each record in VSAM file.
STATUS	X(9)	ENABLED DISABLED UNENABLED	Specifies the initial status of the file (the default is ENABLED): ENABLED: Normal processing is allowed against this file. DISABLED. Any request against this file from a command-level application program causes the DISABLED condition to be passed to the program. UNENABLED: This prevents the file being opened by an implicit open from an application program. Any such attempt to access the file raises the NOTOPEN condition. By contrast, an explicit request to open the file (for example, EXEC CICS SET FILE OPEN command) changes the status to ENABLED before attempting to open the file.
OPENTIME	X(8)	STARTUP FIRSTREF	Specifies when the file is opened. Default STARTUP. STARTUP: The file is opened immediately after CICS initialization, unless the status of the file is UNENABLED when the file is left closed. FIRSTREF: The file remains closed until a request is made to open it by using one of the following methods: • A master terminal command • An EXEC CICS SET FILE OPEN command in an application program • An implicit open

Note:

The file status, after CICS Runtime is booted up, is ENABLESTATUS(ENABLED) and OPENSTATUS(OPEN).