tcl.dialer-copy Verb: Access/TCL


Command tcl.dialer-copy Verb: Access/TCL
Applicable release versions: AP 6.1
Category TCL (746)
Description queues one or more items for copy to a remote system through the dialer subsystem.
The data is copied on the remote system into a file which has the same name as the source file. The item-ids are identical. The copy is unconditional.

"sysname" is the remote system name to which the data will be copied. The remote system must be known to the dialer subsystem. See the section 'dialer, Definition', and 'dialer, TCL' for more information on the dialer subsystem.

"account" is the optional account name on the remote system. If not specified, the account where the file is located on the local machine is used.

The copy does not actually take place at the time this command is issued. Requests are queued to the dialer for a batch copy at the time specified by the System Administrator in the remote system description.

Without the (C) option, the item is left in the original file. Therefore, the item must not be deleted after this command has dev'. been issued, else the actual transfer operation will not find the item and will fail. The (C) option copies the item to a spool file to allow deleting or modifying the item.
Syntax dialer-copy {dict} file.reference itemlist {(options}
to : sysname{!account}
Options B Suppresses the message 'n items copied'
C Copy items to a spool file.
I Supresses item-id displays during the copy.
dialer-copy bp demo
to system:dev
  Queue the item 'bp demo' for copy to the remote system 

select bp = 'test]'
dialer-copy bp (c
to system:dev!
  Queue a selected list of item(s) for copy to the remote system 
'dev', first copying the item to a spool file, so that they can be 
deleted or modified. The data is copied into the file 'bp' in the 
account '' on the remote system.
Related general.dialer