Open topic with navigation

Instructions for Adept Utility Programs 

DISKCOPY

File Name	Program Name	File Type	Description
DISKCOPY.V2	a.diskcopy	B	Disk copy utility

Overview

• Copy an entire diskette to another diskette.

• Copy a V+ system from one disk to another.

• Copy individual or multiple files (using wildcards) from one disk to another or from one subdirectory to another on the same disk.

• Delete individual or multiple files (using wildcards) from a disk.

Certain file-copy operations cannot be performed with the V+ FCOPY monitor command or with the READ and WRITE program instructions. The disk-copy utility program can be used to perform those operations. For example, you can use this program to copy from one diskette to another using a single diskette drive.

Protected disk files cannot be copied with the FCOPY command. This program copies protected files to a hard disk.

Operations on multiple files cannot be performed interactively with the FCOPY or FDELETE commands. This utility permits interactive operations to copy and delete files.

Requirements

Before you can run DISKCOPY:

• The V+ system must be loaded from the system disk.

• If you are using a robot system, the robot must be calibrated and COMP mode must be selected on the manual control pendant, or the DRY.RUN system switch must be enabled, or the program can be executed as a program task other than #0.

Usage Considerations

The DISKCOPY  program defines several real-valued variables with the prefix dc. that must not be modified by you or by other programs. (All these variables are deleted from memory when the program exits normally, or when a DELETE command is used to delete the program from memory, as described earlier.)

The entire DISKCOPY program may be loaded into memory by the CONFIG_C program. Thus, if the CONFIG_C utility is in memory, many *Program already exists* error messages may be displayed when the DISKCOPY program is loaded from disk. These messages can be ignored.

When you try to copy a protected file (i.e., one with the 'P' attribute shown in its directory entry) from a diskette to the Compact Flash or hard drive, the program may indicate that the output disk must first be secured. If you indicate that it is okay for the program to do that, the disk is secured and the program is copied. A secured disk is totally compatible with the V+ system.

Menu Structure

Menu	Description
EXIT to system monitor	Exits the program and return to the V+ monitor.
COPY V+ SYSTEM to another disk	Copies a V+ system from one disk to another. This can be from a distribution diskette to the Compact Flash or hard disk, or from the Compact Flash or hard disk to a diskette.
COPY DISK image to another disk	Copies an entire diskette to another disk not a Compact Flash or hard disk.
COPY multiple FILES	Copies multiple files from one disk to another (or from one subdirectory to another on the same or different disks.
DELETE multiple FILES	Deletes multiple files from one disk to another (or from one subdirectory to another on the same or different disks.

NOTE: To exit the program at any prompt, press CTRL+Z.

COPY V+ SYSTEM to another disk

This menu selection initiates copying a V+ system from one disk to another. This can be used to copy a V+ system from a distribution diskette to the Compact Flash or hard disk, or from the Compact Flash or hard disk to a diskette. (If you want to copy a V+ system from one diskette to another, you must use menu item #2.)

All of the following items are copied when a V+ system is copied:

• V+ system file

• V+ configuration file

• V+ boot file

• \SYSTEM\ subdirectory containing device-module files

• \CALIB\ subdirectory containing robot calibration program files

COPY DISK image to another disk

This option copies an entire diskette to another disk.

NOTE: This selection does not copy a disk image from a diskette to the Compact Flash or hard disk, since the result is that the Compact Flash or hard disk must have the same storage capacity as a floppy disk. The selection "Copy multiple files" copies files from a diskette to the Compact Flash or hard disk (see below). You also cannot copy a disk image from a double-density floppy to a high-density floppy disk or vice versa.

If you specify a copy operation that uses the same diskette drive for both input and output, the contents of the input diskette are stored in system memory during the copy operation. Then, you are asked to exchange the input and output diskettes. The buffered disk contents are then written to the output disk. Keep the following in mind when performing a one-drive copy operation:

• When you are asked to change the diskette in the drive, make sure you insert the correct diskette.

  NOTE: The program does not perform any check to verify that the right diskette is present.

• If there is not enough memory available to hold the entire contents of the input disk, you must exchange the input and output diskettes more than once during the copy operation.

• If other program tasks, which can be consuming memory, are active, you are asked whether it is okay for the copy operation to continue.

• After the copy is complete, you have the option of creating another copy.

COPY multiple FILES

This option copies files from one disk to another. This function allows you to:

• Copy multiple files from one disk to another (or from one subdirectory to another on the same or different disks)
  

  NOTE: You can perform the copy operations with individual FCOPY monitor commands. However, with this program function it may be possible to specify all the files to be copied with a single file specification containing wildcard characters. The FCOPY monitor command does not accept wildcard characters in its file specifications.

• Copy protected files from a diskette to the Compact Flash or hard disk. The FCOPY monitor command cannot be used to copy protected files.

This menu selection copies protected and read-only files onto the Compact Flash or hard disk (and from one subdirectory to another on that disk), provided that the Compact Flash or hard disk is properly secured. If the output disk is not secured, the program gives you the option of securing the disk.

NOTE: If you specify that a disk should be secured for exclusive use by the current system, then it is not possible to use that disk with any other system until it is reformatted. (Formatting erases everything stored on the disk.)

1. The program first asks for the input and output disk devices to be accessed. In addition to local disk units (for example, 'A', 'C', or 'D'), the responses can include specifications for the type of devices to be accessed (for example, "NFS>" for an AdeptNFS device).

2. Next, you are asked:

   Do you want to verify the copy operations (Y/N)?

   If the output is going to a diskette, the copy operation can be noticeably slower if you request verification. For other disk devices, requesting verification has very little effect on the speed of the copy operation.

3. Next, you are asked to enter a file specification string. (To exit this menu selection and return to the main menu, press ENTER without a file specification).

   Wildcard characters (asterisks, '*') can be used in the file specification. A wildcard character within a file name or extension indicates that any single character should be accepted in that position. A wildcard character at the right end of a file name or extension indicates that any trailing characters are acceptable. For example, the file specification '*.*' references all the files on the input disk.

   An optional subdirectory specification can be included in the (input) file specification. If no subdirectory specification is included, the file(s) are copied from the subdirectory shown before the prompt. If a subdirectory is specified, it supersedes or is combined with the default shown. (For an explanation of how subdirectories are combined, see Using Files or the description of the DEFAULT).

4. The following prompt is displayed next:

   Enter output subdirectory (default is \xxx\):

   If a subdirectory specification is entered, it supersedes or is combined with the default shown, and all of the selected files are copied to the resulting subdirectory on the output disk. If ENTER is pressed without a subdirectory specification, all the files copied are directed to the default subdirectory on the output disk.

NOTE: If you specified that the copy operation is to use the same diskette drive for both input and output, you are asked at this point to confirm that you want to continue.

When the input file specification omits either the name or the extension, or includes a wildcard character (and the copy operation is between two disk drives in the Adept controller) the program displays the prompt

Do you want existing files automatically superseded (Y/N)?

If you enter Y, the program deletes (without warning) any file on the output disk with the same name as a file to be copied. If you enter N and the program encounters a file on the input disk that has the same name as an existing file on the output disk, the program displays a warning and asks if you want to supersede the file on the output disk.

The name of each file on the input disk that matches the file specification is displayed, and you are asked whether the file should be copied to the output disk. One of the following responses must be entered:

Response	Meaning
Y	Yes, copy the file
N (or press ENTER )	No, do not copy the file
G	Go, copy this file and all subsequent files without asking again
Q	Quit without copying this file

If you specify a copy operation between two disk devices, or between two subdirectories on one device, the copy operation is very straightforward. The program simply copies from the input to the output.

If you specify a copy operation between floppy disks in the Adept controller, the procedure for the copy operation is slightly different. In this case, the contents of the input file are stored in system memory, you are asked to remove the input diskette and insert the output diskette, and the buffered file contents are written to the output disk. Because of this mode of operation, there are some issues of which to be aware when performing a one-drive copy operation:

• When you are asked to change the diskette in the drive, be careful to make sure you insert the correct diskette.

  NOTE: The program does not perform any check to verify that the right diskette is present.

• If there is not enough memory available to hold the entire contents of the input file, you must exchange the input and output diskettes more than once during the copy operation.

• If other program tasks, which can be consuming memory, are active you are asked whether it is okay for the copy operation to continue.

• After the output disk is written, you have the option of writing another copy of the output.

DELETE multiple FILES

You are asked to specify a disk unit to access. You can specify a local disk unit (for example, 'A' or 'D') or a remote disk device and unit (for example, "NFS>XC:" for the mount named XC on the AdeptNFS device).

Next, you are asked to enter a file specification string, which can include a directory path. (You can press ENTER without a file specification to exit this menu selection and return to the main menu.)

The file specification string can contain the '*' wildcard character as part of the file name or file extension. A wildcard character within a file name or extension indicates that any single character should be accepted in that position. A wildcard character at the right end of a file name or extension indicates that any trailing characters are acceptable. For example, the file specification "test*" causes all the files on the disk with names beginning with "test" (with any extension, since ".*" is assumed when no extension is specified) to be considered for deletion.

An optional subdirectory specification can be included in the file specification. If no subdirectory specification is included, files contained in the default subdirectory on the specified input disk are referenced.

The program displays the name of each file that matches the given file specification, and asks whether the file should be deleted. One of the following responses must be entered:

Response	Meaning
Y	Yes, delete the file
N (or press ENTER )	No, do not delete the file
G	Go, delete this file and all subsequent files without asking again
Q	Quit without deleting this file

Submit comments to: techpubs@adept.com
Last modified on: 4/1/2010
Copyright © 2006 - 2009. Adept Technology, Inc.