dos.copypick.r83 Verb: TCL1/DOS

dos.copypick.r83

Command dos.copypick.r83 Verb: TCL1/DOS
Applicable release versions: R83 3.1, R83 3.0, R83 2.2, R83 2.1, R83 2.0
Category DOS (25)
Description allows data contained in the Pick partition to be transferred to the DOS partition. A Pick-to-DOS transfer is done from the DOS partition.

When invoked, the following menu appears:
------------------------------------------------
COPYPICK

1 - Copy files from R83 partition
Versions supported: XT 2.0 / AT 2.0 / AT 2.1
2 - Copy files from R83 disk partition
Versions supported: AT 2.2 and above
3 - Copy files from Advanced PICK partition
4 - Display notes for R83 versions
5 - Display notes for AP versions

Select number to continue:
------------------------------------------------

Selections 4 and 5 display notes on how to use the copypick utility.

** WARNING **

Although R83's "copypick" utility says it is for use with Advanced Pick, starting with AP 5.2.0, it no longer operates properly. The user should use the "copypick (AP)" utility instead.

After the main selection has been chosen, the system will ask for options. The options (if any) are entered at this time.

The sytem will then ask for the following information:

"PICK account name". The Pick account name is entered at this time.

"PICK file". The Pick file name is entered at this time. The normal Pick "file.reference" conventions may be used. If an invalid file name is entered, the system will display the following error message:

FILE "filename" IN ACCOUNT "accountname" NOT FOUND

"DOS file". The DOS pathname and file name is entered at this time. A DOS path name includes the DOS device (such as A: or C:), and optionally a directory and subdirectory path (such as 1993SALES). The file name may be any valid DOS filename (such as NOV_SALES.DAT). The "DOS file" prompt occurs before the request for the Pick item-id(s), so several items may be imported into the same DOS file.

"PICK item or * for all:" If a single Pick item-id is entered, the system will import the item into the DOS file, and display a message. If an "*" is entered, the system will import all the items from the Pick file into the DOS file, and display a message.

As each item is imported, the system displays a message indicating the number of items imported, and the number of attributes moved.

The system will continue to ask for additional item-ids. As item-ids are entered each Pick item is concatenated to the DOS file. A <return> will display a summary total of items and attributes imported, and ask for another Pick file name.

A <return> at the Pick item-id, Pick file name, and Pick account name prompt concludes the transfer.

During the transfer process, Pick attribute marks (x'FE') are replaced with a DOS carriage return / line feed (x'0D0A'). This effecively makes each Pick attribute value a DOS record in the DOS file.

Note: A single item with the item-id of "*" cannot be imported.
Syntax
Options D Diagnostic mode. The diagnostic mode operation has two levels. If the "D" is the first character in the option string, then a summary set of diagnostic messages is displayed. If the "D" is the second or third character, then a more detailed set of diagnostic messages is displayed.

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

N Transfers multiple items in within a numeric range. Rather than prompting for a single item-id, the system will request a range of (numeric) item-ids. All items within the range are transferred.
Example
C:>COPYPICK

Options: <cr>
PICK Account Name: SYSPROG
PICK File (DICT FILE or FILE or FILE,DATA): BP
DOS File: PROG.BAS
PICK Item or * for all: FIND
1 Item(s) Converted
47 Attribute(s) Moved
PICK Item or * for all: <cr>
1 Item(s) Converted
47 Attribute(s) Moved
PICK File (DICT FILE or FILE or FILE,DATA): <cr>
DOS File: <cr>

C:>

This will transfer the item FIND from the BP file in the SYSPROG account to the 
DOS file PROG.BAS.
Purpose
Related tcl.import.r83
tcl.import.dos
tcl.import
tcl.copydos.r83
dos.copypick
tcl.export.r83
tcl.export.unix
tcl.export