PUBLISH

The PUBLISH command sets up a file in the current account for replication.

Format

PUBLISH {DICT} src.file {DICT} server:account:tgt.file ...

PUBLISH {DICT} src.file CANCEL server

PUBLISH {DICT} src.file CANCEL ALL

PUBLISH {DICT} src.file QUERY

PUBLISH {DICT} ALL QUERY

where

src.file

is the file to be published. This must be a reference to a VOC F-type record that defines a hashed file.

server

is the name of the server to which the file is to be exported. This must have been defined using SET.SERVER so that PUBLISH can validate the target file reference.

account

is the name of the account on server to which the file is to be exported.

tgt.file

is the name of the target file within account to which the file is to be exported.

The first form of the PUBLISH command marks the specified file as being exported to the specified target. Multiple targets may be specified in a single command or each target can be specified separately. Following successful execution of this command, all updates to the file will be logged for export.

The two forms with the CANCEL keyword terminate publication of the specified file. With a server name, publication to the specified server is terminated. With the ALL keyword, all publication of this file is terminated.

The two forms with the QUERY keyword show a list of replication targets, either for the specified file or for all files.

Adding or cancelling replication targets is restricted to users with administrator rights.