Next Update

Command line:
tlapi ‑cNXTUPD [‑znPack] sPart
Library call:
nStatus = TLnxtupd (sPart, nPack)
Scripting call:
nStatus = NextUpdate ()

Function

Create a new TopLeaf update release for a specified partition.

Arguments

sPart

The path of the partition for which the new update is to be created. The scripting call uses the Partition property to determine the partition.

nPack

This has the same interpretation as the corresponding argument in the Pack call.

For additional command line arguments see “Common Flag Arguments”.

Notes

The specified partition must have been previously published using the Commit API call before a new update phase can be created.

A new update phase cannot be created if the partition is edit locked, or commit locked. A partition becomes commit locked after a successful call to the Commit API function.

You must commit a partition before you can extract a published partition document using the Get Data API call. Third party applications must fetch a copy of the published partition document to obtain published boundary markers.

If the Next Update call is made in error, the new update can be cancelled by the Remove Update API function.

Examples

Command line:

tlapi ‑cNXTUPD manuals/topix/volume1

Library call:

/* Create a new partition update, don't pack */
status = TLnxtupd("manuals/topix/volume1", 99999L);

Scripting call:

status = topleaf.NextUpdate();