Previous Topic: SyntaxNext Topic: Usage


Parameters

segment-name

Specifies the segment associated with the file. Segment-name must identify an existing segment defined to the dictionary.

If you do not specify the segment name, you must establish a current segment as described in 7.3.3, "Entity Currency".

file-name

Specifies the name of the file. File-name must be a 1- through 18-character name that follows the conventions described in 7.3, "Naming Conventions".

File-name must be unique within the segment associated with the file.

ASSIGN TO

Specifies an external file name. Every external file name in a DMCL definition must be unique. If you do not specify an ASSIGN TO clause, you must do one of two things:

In z/VSE without DYNAM/D, every file must have an external file name. In other environments, if the external file name is not specified, a data set name or VM virtual address must be specified.

ddname

Specifies the external name for the file under z/OS or z/VM. Ddname must be a 1- through 8-character value that follows operating system conventions for ddnames.

filename

Specifies the external name for the file under z/VSE. Filename must be a 1- through 7-character value that follows operating system conventions for filenames.

NULL

Sets the external file name to blanks. This is equivalent to not specifying an external file name for a file. This option is not valid under z/VSE unless DYNAM/D is being used.

DSNAME data-set-name

For z/OS and z/VSE and OS-format data sets under z/VM, specifies the name of the data set to be used when dynamically allocating the file. You must include this parameter if the file has no external file name assigned.

Data-set-name must conform to host operating system rules for forming data set names.

A data set name that includes embedded periods must be enclosed in single or double quotation marks.

Under z/VM, you can specify the DSNAME parameter or VM VIRTUAL ADDRESS and USERID parameters, or both.

Note: For more information about allocating files dynamically under z/VSE and z/VM, see the "Usage" topic in this section.

NULL

In ALTER statements, removes any previous data-set name specification for the file.

DISP

For z/OS and z/VM systems, specifies the disposition to be assigned when the file is dynamically allocated.

OLD

Indicates that the data set used for the file will be available to only one DC/UCF system or local mode application at a time.

Under z/VM, DISP OLD causes a link with an access mode of multiple write (MW).

SHR

Indicates that the data set used for the file will be available to multiple DC/UCF systems and local mode applications at the same time.

Under z/VM, DISP SHR causes a link with an access mode of multiple read (MR).

SHR is the default when you do not include the DISP parameter in a CREATE FILE statement.

VM VIRTUAL ADDRESS 'virtual-address'

For z/VM systems, specifies the virtual address of the minidisk to be used for the file. Virtual-address is a hexadecimal value in the range X'0001' to X'FFFF' with all four digits specified.

VM VIRTUAL ADDRESS NULL

On ALTER statements, removes any previous virtual address specification for the file.

VM USERID vm-user-id

For z/VM systems only, identifies the owner of the minidisk to be used for the file. Vm-user-id is a 1- to 8-character value.

You must specify a user ID for an OS-format data set. The user ID is optional for CMS-format files.

If you do not specify a user ID for a CMS-format file, CA IDMS/DB assumes that the owner of the minidisk is the user ID of the virtual machine in which CA IDMS/DB is running.

NULL

Removes any previous minidisk owner specification for the file.

NONVSAM

Identifies the access method for the file as BDAM, or DAM. BDAM is a synonym for NONVSAM. NONVSAM is the default file access method.

VSAM

Identifies the access method for the file as VSAM.

Specify VSAM for VSAM database files.

ESDS

Identifies the structure of a native VSAM file to be accessed by CA IDMS/DB as ESDS (entry-sequenced data set).

RRDS

Identifies the structure of a native VSAM file to be accessed by CA IDMS/DB as RRDS (relative-record data set).

KSDS

Identifies the structure of a native VSAM file to be accessed by CA IDMS/DB as KSDS (key-sequenced data set).

PATH

Identifies a native VSAM path (alternate index) on ESDS or KSDS native VSAM files.

FOR CALC

Specifies that CALC access to records in the area associated with the file is to be translated into either primary key access (for a KSDS file) or alternate index access (for a PATH file). Only 1 file (KSDS or PATH) associated with an area may contain the FOR CALC clause.

FOR SET set-name

Indicates that set access for the named set is to be translated into either primary key access (for KSDS file) or alternate index access (for a path file). Set-name is the name of a set defined by a schema SET statement with the VSAM INDEX clause. A given set-name can be specified in only one FOR SET clause for files within a segment.

AREas

Displays or punches all areas with which the file is associated.

DETails

Displays or punches details about the file.

HIStory

Displays or punches:

ALL

Displays or punches all information about the file. ALL is the default action for a DISPLAY or PUNCH verb.

NONe

Displays or punches the name of the file.