LBR$Open

Open or create a library

LBR$Open is used to open an existing library or to create a new library.

Format:

LBR$Open context {options} {name}

Returns:

Returns a condition code.

Arguments:

context

The address of a 64-bit context returned by LIB_Ini_Control.

options

The address of a 64-bit value indicating the creation options. These options are a contiguous array of 64-bit integers containing the following items:

Offset	Description
0	Allocation size, in bytes, for the library file.
1	Internal clustersize, in bytes.
2	Reserved for furture use. Should be 0.

name

The address of a TSRB structure that points to the name of the library. If null, the name passed to LBR_INI_Control is used.

Description

The LBR_OPEN service must be used to open or create a library. When done, the library should be closed with LBR_Close.

Condition Codes Returned:

Code	Meaning
LBR_ILLCTL	Specified library control index is not valid.
LBR_ILLFMT	Specified library format is not valid.
LBR_LIBOPN	Specified library is already open.
SS_NORMAL	Successful completion.