tcl.export.r83 Verb: Access/DOS

tcl.export.r83

Command tcl.export.r83 Verb: Access/DOS
Applicable release versions: R83 3.1
Category DOS (25)
Description transfers a Pick item to a DOS diskette.

"file.reference" is the source Pick file name.

"item-id" is the item to export. If "*" is used, then export will use the active list.

"DOS.path" is the DOS drive and directory. If no directory is specified, the current working directory is assumed. Complete pathnames must be used if the files are not on the current working directory. The syntax for the "DOS.path" parameter is as follows:

drive:{subdirectory...}DOS.file

"DOS.file" is the explicit name of the source MS-DOS file.
For example:

drive:subdirectory1subdirectory2DOS.file
drive:DOS.file

Note: The drive specification can only be a diskette device (A: or B:), and not the hard drive (C: or D:).

If the name of the destination file is not provided, the given item-id is used as the name of the destination file.

If a directory is specified, no spaces may be specified between "dir.path" and "DOS.file". The directory must be preceded by a "", i.e."C:1993SALES.DAT".
Syntax export file.reference [item-id|*] {(options}
to : {DOS.file}
Options A Appends a segment mark (x'FF') at the end of the Pick item(s). When used with the "T" option, Pick items are separated and DOS files are terminated with the specified character.

C Concatenates (combines) Pick selected item(s) into one DOS file. Unless the "A" option is used, Pick files are not separated by any character.

D Displays diagnostic information during transfer. May be combined with the "P" option.

E Appends a specified character at the end of the Pick item(s). The system will ask "Terminator: ". Enter the hex value of the ASCII character (x'01' - x'FF') to append to each transferred item. Not compatible with the "A" option. Also, not available in v3.1 Jul-04-90.

I Includes Pick item-id(s) as the first field in the DOS file(s). Each item is preceded by a linefeed character.

N Sorts Pick item-ids numerically before exporting.

O Overwrites the DOS file, if a duplicate exists.

P Directs output to system printer, via the Spooler.

S Creates DOS file using the same name as the Pick item-id.

T Translates specified characters to new characters.

The system will ask: "REPLACE: ". The user enters the ASCII value (in hex) of the character to scan for. An entry of <cr> will quit the replace session.

The system will then ask: "WITH: ". The user enters in the new replacing ASCII value (in hex). The system will ask for up to 15 additional characters to replace. If the same character is entered twice, only the most recent entry is used.

The system will finally ask: "OKAY(Y/N): ". An answer of "Y" indicates all the entries are correct. An answer of "N" will wipe out all the entries and start over.

The "T" option is not compatible with the "F" or "X" options.
Example
EXPORT CUST * (AITCN
to: A:CUSTOMERS.DAT

REPLACE: FE   WITH: 2C
REPLACE: FF   WITH: 0D0A
REPLACE:
OKAY(Y/N): Y

This will export the entire customer file to a DOS file called 
"CUSTOMERS.DAT". Each attribute (field) will be translated into a 
comma. Each item (record) will be delimited with a <CR/LF>.
Purpose
Related tcl.import.dos
tcl.import
tcl.import.pick
file.reference
active.list
dos.copypick
dos.copypick.r83
tcl.export.unix
tcl.export
tcl.export.r83.link