LL_OPEN

Open a linked list on the file stack

WSupported on Windows

USupported on Unix

VSupported on OpenVMS

NSupported in Synergy .NET

xcall LL_OPEN(control, record_size[, channel])

Arguments

control

Returned with the linked-list control structure. (a)

record_size

The size of the linked-list records. (n)

channel

(optional) The file-stack channel to use. (n)

Discussion

LL_OPEN opens a new linked list on a new file-stack level.

If channel is not passed, the default file stack will be used. If channel is not passed and there is no default file stack, or if channel is zero, a new file stack will be activated.

D_LL_CTLSIZE (defined in tools.def) should be used in declaring a control structure for the linked-list subroutine. Alternatively, use the structure defined in lnklst.def.

Examples

The following example will create a linked list on a new level of the default file stack. The size of the linked-list records will be 50, and the control structure will be returned in lnkctl.

xcall ll_open(lnkctl, 50)