dos.copypick.r83

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 \1993\SALES). 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.