Allocate (AL)

Command title

Allocate Library

Description

This command dynamically allocates a tableBASE library or any other dataset to the region.

COBOL syntax

 
MOVE 'AL'                    TO xxxx-COMMAND.
CALL 'TBLBASE' USING         TB-PARM
                             xxxx-COMMAND-AREA
                             DDNAME
                             LIBRARY-ALLOC.

C syntax

 
memcpy( tbCommArea.tbCommand, "AL", 2 );
TBLBASE( &tbParm, &tbCommArea, pDDname, &tbLibraryAlloc );

Parameters

DDNAME—the library name that the application will use to refer to the allocated library.

LIBRARY-ALLOC—the Dataset Name, and the share status of the dataset.

Explanation

The dataset must exist and be catalogued or the allocation fails.

This command is valid only for the MVS batch, TSO/ISPF, or IMS interfaces. The commands AL and UL will return an error code if they are used with DDNAMEs that are permanently allocated through JCL or the TSO ALLOCATE command.

Return value

None

Notes

None

Exceptions

None

See also

None