LL_OPEN
Open a linked list on the file stack
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
VSupported on OpenVMS
|
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)