Address Space › Common Address Space Shell › CASRV Operator Commands › ALLOCATE Command (CASRV)

ALLOCATE Command (CASRV)

The ALLOCATE command lets you dynamically allocate a data set or path.

Syntax

ALLOCATE DDNAME=ddname [,DUMMY] [,DSNAME=dsname] [,MEMBER=member] [,GDG=name] [,MEMBER=member] [,GDREL#=relID] [,PATH=path] [,SYSOUT=sysout] [,DEST=destination] [,VOLUME=volID] [,UNIT=name] [,OPTIONS=option]

Parameters

DDNAME=

DDNAME to be used by the allocation.

DUMMY

(Optional ) Keyword for “dummy” allocation.

Keywords DSNAME=, GDG=, PATH= and SYSOUT= are not applicable.

DSNAME=

(Optional) Data set name of the library to be allocated.

The DSNAME= keyword is mutually exclusive with keywords GDG=, PATH= and SYSOUT=.

MEMBER=

(Optional) Keyword to specify the MEMBER of a PDS(E).

Only valid if DSNAME= is specified.

GDG=

(Optional) Data set name of the GDG to be allocated.

The GDG= keyword is mutually exclusive with keywords DSNAME=, PATH= and SYSOUT=.

GDREL#=

(Optional) Keyword to specify the relative generation. Only valid if GDG= is specified.

If the relative generation is not specified, MVS allocates the concatenated set of GDG data sets.

If GDGREL#= is specified, it must be “+0” or “-nnn” (for example, “-2”).

PATH=

(Optional) Path name of the library to be allocated.

The PATH= keyword is mutually exclusive with keywords DSNAME=, GDG= and SYSOUT=. To preserve the case of the string, enclose the path name in single quotes.

SYSOUT=

(Optional) Indicates a SYSOUT data set is to be allocated.

If specified, use:

SYSOUT=(class,<,writer,form>)

For example, SYSOUT=(X) allocates a class “X” sysyout data set. The class is required. The SYSOUT= keyword is mutually exclusive with keywords DSNAME=, GDG= and PATH=.

DEST=

(Optional) 1- to 8-character DEST.

Only valid if SYSOUT= is specified.

VOLUME=

(Optional) 1- to 6-character volume serial of the data set being allocated.

Only valid if DSNAME= is specified.

UNIT=

(Optional) 1- to 8-character unit name of the data set being allocated.

Only valid if DSNAME= is specified.

OPTIONS=

(Optional) Indicates options for the allocation.

If specified, use:

OPTIONS=(option,option,…)

If multiple specifications affect a setting, the last specification is the one used.

MIGRATE:

By default, the allocation does not let data set be migrated back.

NOMOUNT:

By default, the allocation lets a mount take place.

XATTR:

By default, flags S99ACUCB, S99DSABA, and S99TIOEX are off. Use this option to turn them on.

NOXATTR:

Formal option to assert that XATTR is not to be in effect.