tcl.copydos Verb: Access/DOS

tcl.copydos

Command tcl.copydos Verb: Access/DOS
Applicable release versions: AP, R83
Category DOS (25)
Description copies data, in Pick storage format, from a DOS partition into the Pick partition.

The syntax for the "DOS.path" parameter is as follows:

drive:{subdirectory...}DOS.filename

For example:
drive:subdirectory1subdirectory2DOS.filename
drive:DOSfilename

If neither "r" nor "s" is specified in the options, the "s" option is assumed.

If neither the "f" nor "t" option is specified, COPYDOS translates the DOS character X'0D' to X'FE'. This causes every DOS line delimited with a carriage return to become a Pick attribute. The linefeed X'0A' and null X'00' characters are deleted.

If the optional Pick item-id is not input following the TO:( prompt, the DOS filename (from the DOS.path parameter) is used as the Pick item-id.

If the DOS file is larger than 25000 bytes and the "m" option is not specified, the "copydos" process automatically splits the file into Pick items and assigns the names "item-id0", "item-id1", etc., unless the "l" option is specified.
Syntax copydos DOS.path {(options)}
to: (file.reference {item-id})
Options d Displays diagnostic information while accessing the DOS file system. It is intended to be used as a diagnostic tool when data transfer operations do not complete as expected. If a lower case d option is specified, the diagnostic information will be routed to the Spooler.

f Flag characters. The system prompts for further information. The f option is available to flag up to 16 different hex bytes by placing a hex'00' in front of the flagged hex character. Entering in different hex bytes in response to the 'REPLACE:' and 'WITH FLAGGED' prompts, results in a Translation, with the resultant Pick byte preceded with hex'00'. Entering in the same hex byte in response to both prompts, results in passing that byte unchanged and preceding it with hex'00'. Note that this is in contrast with the "T" option, where specifying the same character, deletes that character. If an "f" option is in effect, upon entering the 'TO:( ' response the system will display: REPLACE: After entering the hex character to translate or pass, the system displays: WITH FLAGGED: Upon entry of the same character or a replacing character, the system will prompt for up to 15 additional hex characters to Flag. The system will prompt for additional characters, until a <return> is entered at the REPLACE: prompt. A <return> causes the system to display: OKAY(Y/N): An n response allows re-entry of the Flag specifications. Note: Should multiple occurrences of the same replace character be present, the last occurrence will take precedence.

l Creates list-type (indirect) item. (R83 release 2.2)

m Creates multiple (Pick) items. This allows for regulation of the size of the targeted Pick items. This flexibilty can be very useful in aligning DOS data with Pick attributes. After entering a response to the ' TO:( ' prompt the system displays: ENTER LENGTH OF RECORD (OR Dn): The user may elect to enter a numeric response indicating how many bytes each data portion of the Pick item will be, or a d followed by a number to indicate how many Pick attributes (lines) each Pick item will be. Using the "dn" response assumes that the default translate of carriage return/line feed to attribute marks will be performed. When the DOS file is converted to multiple items, the items will be created with boundries established by attribute marks, provided that they exist in the translated file. Should no attribute marks exist, items will contain a single attribute with the specified number of bytes. The Pick item-ids are generated by concatenating the itemname used in the 'TO:(' specification with 0 , 1 , 2 , etc. No new Pick item with just the itemname alone will be created. Entering a <return> after the appropriate response causes the "copydos" process to begin or, if an "f" or "t" option is in effect, further prompting as noted below.

o Overwrites (duplicate) Pick item{s}.

p Strips most significant bit off characters as they are converted, except for flagged and/or translated characters. (R83 release 2.2)

r Indicates DOS data is in a random file.

s Indicates DOS data is in a sequential file.

t Translate characters. The "t" option is available to translate up to 16 different hex bytes. Upon entering a response to the 'TO:( ' prompt, the system will display: REPLACE: After entering the hex character to replace, the system displays: WITH: Entering identical hex strings in response to both REPLACE: and WITH:, causes that character to be deleted from the file. After entering a response to the WITH: prompt, the system will again display: REPLACE: Entering a <return> after the REPLACE: prompt, terminates further hex character prompting. The system displays: OKAY(Y/N): An "n" response allows the user to re-enter all of the Translate specifications. A "y" response causes the COPYDOS process to begin.

x Creates hexadecimal image of DOS file. When file type ("s" or "r" option) is omitted, the default is "s". Note that when this is executed without the "t" and "f" options, DOS end-of-line characters (carriage returns or x'0d') are automatically converted to attribute marks (x'fe'). Line feeds (x'0a' and nulls x'00') are deleted. This option allows data such as graphics images to be stored in a Pick item without concern for any special character (segment marks for instance, Hex 'FF').
Example
Purpose
Related tcl.import.pick
tcl.dos.bridge
tcl.copydos.link
tcl.dos.bridge.link
tcl.dos.bridge.r83.link