(Command definition taken directly from from Lt. Kernal Manual - Note: The primary use of the ICQUB command is described below.  However, ICQUB is also used to build a CP/M file system)


ICQUB  (Image Capturing Quick Utility Backup)
command

Syntax: ICQUB or filename

filename is the name of an auto-loader built by the ICQUB utility.

ICQUB (pronounced 'icecube') permits you to capture and save to the hard disk certain copy protected software.

SOFTWARE CAPTURED BY ICQUB CANNOT BE USED ON ANY OTHER COMMODORE COMPATIBLE DISK DRIVES.

ICQUB functions only in the C-64 mode. ICQUB is designed NOT to be a 'pirating tool'. The 'copies' it creates of the protected software require the Lt. Kemal hardware to be present in order for them to run.

ICQUB does allow you to back up many of your own(ed) copy protected software packages on the Lt. Kemal. It does so by allowing you to load protected software into your computer from a floppy disk, then capturing a running image of the program. This technique will not allow you to run software which periodically re-checks its protection scheme, unless you are willing to have the protected disk in your floppy disk drive continually while using the captured copy. (see 'config' command, F3 option)

Since ICQUB actually snap shots a numing program, some software which appears not to work when ICQUB'd may work if you choose another time or stage of operation at which to capture the copy. Once a working copy is captured, it should work every time. Don't give up on a package just because your first try didn't produce a working program. Most software will ICQUB on the first try - but not all packages will.

ICQUB; is simple to use, and for the most part it is self-documenting. Be sure that you are logged on to the LU on which you wish the capture to take place before invoking ICQUB.

When you type the ICQUB command, you will be presented with a menu. You may:

• (1) Select from ICQUB files already on any LU

• (2) Run the 'current' (last) capture file on this LU

• (3) Assign a new name to the current capture file on this LU

• (4) Capture a new program via ICQUB on this LU

• (5) Return to Basic

OPTION #1 You will be presented with a files list similar to that which AUTODEL and AUTOCOPY produce from which to select your program. From this list you will also be permitted to select a file for which to build an 'auto-loader'. Once built, the auto-loader may be directly invoked just by typing its name at the READY prompt

OPTION #2 You can test the current ICQUBCAPTUREFILE without bothering to search the list above.

OPTION #3 You may give ICQUBCAPTUREFILE a new name. Actually, ICQUBCAPTUREFILE is copied into the new file so that ICQUBCAPTUREFILE will not have to be re-built for option #4. The new filename will be your own selected 12 character name followed by the suffix -.ICQ- (i.e. MYFILECAPTUR.ICQ).

OPTION #4 You may capture a new program into ICQUBCAPTUREFILE. If ICQUBCAPTUREFILE does not exist on the currently logged LU when you select this option, it will be built. It may take as long as a minute to allocate capture space. Once the space is allocated, the computer will seem to 'reset'. and return to a normal power-up screen, as if the Lt. Kemal were NOT present.

This is the point at which you LOAD your protected software from the floppy disk. When the program has progressed to the point at which you wish to capture it, press the ICQUB button on your Lt. Kemal Host Adaptor. When the capture is complete, the Lt. Kemal will return to control.

Here's a brief hint on capturing. The ICQUB; button performs much the same function as the RESTORE key on your computer. An example will show you how that affects captures.

Let's say you have a wordprocessor running which always returns to its 'main menu' when you press RUN/STOP and RESTORE simultaneously. The proper way to capture that software would be to allow it to get to a point where you COULD return to the main menu, then to hold down RUN/STOP and instead of pressing RESTORE, to then press the ICQUB button.

When the captured version is run, it will go directly to the main menu! You will have to experiment. Each software package ICQUB's a little differently.

OPTION #5 You may return to BASIC. Things will be a little 'messed-up' if you attempt to get back to BASIC any way other than via option#5, and you'll probably have to reset your computer to get back to proper operation.

NOTE: Make sure your screen border color is NOT black or you will get a blank screen. Use CONFIG to change to any other color.