Running CDBOOT.EXE allows you to configure and install CD Boot/2 from any OS/2 window or fullscreen, even from the OS/2 fullscreen you can obtain by booting OS/2 into a OS/2 fullscreen session via ALT+F1 (however, in that case the settings in CB2.INI will not be used, because access to INI files is only possible if PM is up and running).
Running CDBOOT.EXE usually looks like (where P: is a virtual diskette drive, that is a kind of RAM-Drive that is much faster to access than a real floppy disk):
In above example, CD Boot/2 prompts you to enter the removeable media (at question CB20081Q) where CD Boot/2 should install its enhanced Boot Loader CD2BOOT onto and the Timeout Period (at message CB20083Q) after which boot continues from the default selection (customizeable via the commandline parameter ????? to be def. ?????).
Another example, running the commandline CDBOOT /Drive P /Timeout 10 might result in the following log:
In this example, CD Boot/2 runs without any further manual intervention from the user. This can be useful if you want to run CD Boot/2 unattendedly.
If you want to run CD Boot/2 interactively, I suggest to use the PM version CDBOOTPM.EXE as it looks much better and allows user friendly fine tuning of all options.
There are mainly two ways to run CDBOOTPM.EXE:
Now let's take a look into the details. The first window is the Logo (or About) window, which shows the application your are running and the status messages (to display status and error messages).
While running the PM version of CD Boot/2, the Logo window contains a single multiline statustext that shows the last message CD Boot/2 considered important for you to know. When CD Boot/2 has finished execution, a Close pushbutton will be displayed, and the single multiline statustext changes to a multiline entryfield where you can scroll through all messages that were displayed while you had be running CD Boot/2.
More important is the CD Boot/2 Configuration Dialog window, which is the center where you control how CD Boot/2 will behave once installed onto a removeable media.
The dialog consists of the following main areas:
Beside the following error messages, a bootable OS/2 CD-ROM modified by CD Boot/2 might not work if the file CD2BOOT is not continuous, that is when it is fragmented. As the removeable media is formatted with a FAT filesystem you can use any FAT defragmenter to clean up that situtation. However, I've never experienced such a problem, so I think it is more a theoretical one.
The following error messages might be displayed during execution of the CD Boot/2 executables CDBOOT and CDBOOTPM:
CB20050I CD20051I |
CD Boot/2 could not understand the commandline you supplied and shows the supported options. Please spedify a valid commandline. |
CB20052E | CD Boot/2 detected that you specified the commandline option /DRIVE d, however the option is either incomplete (e.g. d is missing) or invalid (e.g. d is not a drive letter in the (case insensitive) range A to Z). Please correct that option. |
CB20053E | CD Boot/2 detected that you specified the commandline option /TIMEOUT tt, however the option is either incomplete (e.g. tt is missing) or invalid (e.g. tt is not numeric or not in the range of 1 to 60). Please correct that option. |
CB20054E | CD Boot/2 requires that you use the commandline options /DRIVE d and /TIMEOUT tt simultaneously, because only when both are supplied CD Boot/2 is able to run unattendedly. Please be sure you specify both options or none of them at all. |
CB20055E | CD Boot/2 requires that you do not use the commandline options /HARDDISK and /REMOVEABLE simultaneously, because only one can be specified. Please be sure you specify only one options or none of them at all. |
CB20056I | CD Boot/2 could successfully parse the commandline options /DRIVE d, /TIMEOUT tt, /MSG? message and /PASSWORD password you specified. Note, that does not mean that you specified all of the mentioned parameters, just that the ones you specified have been accepted. They will be used to run CD Boot/2 unattendedly |
CB20057E | CD Boot/2 detected that you specified one or more of the commandline options /MSG1 message, /MSG2 message and/or /MSG3 message, however at least one of those options has an excessive length (e.g. message is longer than the allowed number of 79 characters). Please correct that option. |
CB20058E | CD Boot/2 detected that you specified the commandline option /PASSWORD password, however the option either has an excessive length (e.g. password is longer than the allowed number of 79 characters) or contains invalid characters (e.g. one or more characters of password do not fall into the characterset 0...9, A...Z and a...z). Please correct that option. |
CB20070E | CD Boot/2 needs to display a PM window, however an anchor block could not be created. Please report this problem |
CB20071E | CD Boot/2 needs to display a PM window, however a message queue could not be created. Please report this problem |
CB20072E | CD Boot/2 needs to display a PM window, however the CD Boot/2 dialog window could not be created. Please report this problem |
CB20073E | CD Boot/2 failed to open the removeable drive (you specified for CD Boot/2 to modify), be sure that a medium is inserted into the drive. |
CB20074E | CD Boot/2 failed to lock the removeable drive (you specified for CD Boot/2 to modify), be sure that this drive is not in use by another program like e.g. FDISK or LVM. If the problem still persists after a report, please report this problem |
CB20075E | CD Boot/2 failed to read or write the boot sector of the removeable drive (you specified for CD Boot/2 to modify), be sure that the medium is accessible (e.g. by running VMDISK against it). If the problem still persists after a report, please report this problem |
CB20076E | CD Boot/2 failed to close the removeable drive (you specified for CD Boot/2 to modify), be sure that a medium is inserted into the drive. |
CB20077E | CD Boot/2 failed either to read the file CD2BOOT from the directory CD Boot/2 was installed into, or failed to write the file CD2BOOT onto the removeable drive (you specified for CD Boot/2 to modify). For reading, be sure that CD Boot/2 is installed correctly, for writing, be sure that a medium is inserted into the drive. |
CB20078E | CD Boot/2 detected that the contents of the file CD2BOOT in the directory CD Boot/2 was installed into did not match the expectations but seem to be currupted. Please reinstall CD Boot/2 and retry, |
CB20079E | CD Boot/2 detected that the boot sector of the removeable drive (you specified for CD Boot/2 to modify) does not look like a boot sector of a removeable FAT media. Be sure that you have inserted a OS/2 FAT formatted media containing the files required to be bootable (e.g. by running SYSINSTX d: against that drive) |
If you haven't installed CD Boot/2 correctly (which is just uncompressing the archive you downloaded), other error messages might complain about missing files. In that case I would recommend to reinstall CD Boot/2 and if the problem persists to contact me.
CD Boot/2, that is both CDBOOT.EXE and CDBOOTPM.EXE, returns the following return codes to the calling program.
0 | CD Boot/2 returns 0 for a successful completion. | 1 | CD Boot/2 returns 1, if the specified parameter of a commandline option is syntactically invalid. Please ensure to correct the commandline. | 2 | CD Boot/2 returns 2, if the specified parameter of a commandline option or entered interactively was syntactically correct but semantically invalid (e.g. a drive letter of a drive that does not contain a removeable media). Please ensure that you specify a valid parameter. |
CD Boot/2 uses library code (UStartup.?pp) that allows reuse of the code required to start up typical AVIO and PM C++ applications, resulting in shorter development cycles. Thus there are 2 types of commandline options:
For the commandline options that are handled by CD Boot/2 itself the following symbols are used for the table below:
CD Boot/2 supports the following commandline options, other options specified on the commandline will be simply ignored:
/? -? |
This option allows you to display the available commandline options of CD Boot/2. This option is handled by the library code. | ||
/Drive d -Drive d /Timeout tt -Timeout tt |
The option /Drive d allows you to specify the drive letter you want
CD Boot/2 to modify the boot process.
Only the letters A to Z (or a to z) are valid for d.
The option /Timeout tt allows you to specify the Timeout Period you want CD Boot/2 to use in the modified boot process. Only one or two numeric characters together being in the range of 1 to 60 are valid for tt. These options are only valid if specified simultaneously, as both are required to run CD Boot/2 unattendedly. | ||
/HARDDISK -HARDDISK /REMOVEABLE -REMOVEABLE |
These options allow you to specify from where CD Boot/2 will boot by default,
that is from which media CD Boot/2 will continue boot if the Timeout Period
expires.
As both options are conflicting, you may only specify one of them or none at all
which causes CD Boot/2 to default to option /HARDDISK.
Usually you would leave the default option /HARDDISK, that is CD Boot/2 will continue booting from the first Harddisk after the Timeout Period expires, because that allows you to leave the media inserted in the drive without any need to care about it for normal boots (e.g. useful when the CD-ROM is just used for one-time installations). However, if you intend to use the removeable media only when you really want to boot from it (e.g. for a diagnostics CD-ROM), you may select the option /REMOVEABLE instead, so that CD Boot/2 continues to boot from the removeable media when the Timeout Period expires. | ||
/CLEAR -CLEAR |
This option allows you to specify that CD Boot/2 will clear the screen before
it displays its menu (thus removing any messages BIOS may have left) and also
immediately before booting from the selected media (thus removing the messages
displayed by CD Boot/2 itself).
| ||
/Msg1 message -Msg1 message /Msg2 message -Msg2 message /Msg3 message -Msg3 message |
This option allows you to optionally specify up to 3 messages that will be displayed in the
boot menu of CD Boot/2 when booting from the removeable media.
Each message can be up to 79 characters in size, and you can specify any combination of them, however CD Boot/2's menu will display them sequentially without representing empty messages by empty lines. You could however specify an empty line by e.g. /MSG2 " ", that is not an empty line but a line containing a single space. | ||
/Password password -Password password |
This option allows you to optionally specify a password that has to be
entered correctly in order for CD Boot/2 to boot from the removeable media.
You can select to boot from the first harddisk without having to enter that
password (as you could boot from the first harddisk by removing the removeable
media anyway).
The password is case sensitive and can be up to 7 characters in size, where each character must be in the range of 0...9, A...Z and a...z. Please note that the password is not completely secure, but nevertheless certainly not trivial as it will be encrypted. | ||
/Language ll -Language ll |
This option allows you to specify the language CD Boot/2 uses other than
the default or the one saved into CB2.INI from the last invocation of CD Boot/2.
CD Boot/2 is NLS (National Language Support) enabled and ships in 2 languages,
that is English (Us) and German (Gr).
This option is handled by the library code.
For example, if you want to display all texts in English you would launch
CD Boot/2 with the command:
CD Boot/2 tries to use the language of the country you specified in your CONFIG.SYS, for example, I usually run the US version of OS/2 with German country settings, so CD Boot/2 will use German messages initially (that is, as long as you haven't overwritten it with the /Language option and saved it into the profile CB2.INI (Note! Only when PM (Presentation Manager) is up and running, that profile will used, e.g. when booting to an OS/2 fullscreen via ALT+F1 the profile can not be accessed). As I can only provide the two mentioned languages, it is up to volunteers to translate CD Boot/2 into additional languages, any donations for that are welcome (please contact me if you're ready to offer your help, thanks)! |
||
/Log [logfile] -Log [logfile] |
This option allows you to specify a logfile where all messages are logged into.
If you omit the optional parameter logfile, the file CB2.LOG will
be written into the directory CD Boot/2 was started from, otherwise logfile
should be a fullly qualified filename.
This option is handled by the library code.
The logfile can be used to debug problems or to log messages when running CD Boot/2 unattendedly. If the logfile can't be written, CD Boot/2 displays an error message but continues. |
With that in mind, the following commandline is an example for running CD Boot/2 unattendedly while you still can set the options according to your preferences: cdboot[pm] /removeable /password OS2 /clear /msg1 "Welcome to the bootable ..." /msg3 "Copyright (C) ..." /msg2 "For new installations ..." /drive p /timeout 15 /log
Changes between Version 1.50 and 1.40.
Changes between Version 1.40 and 1.30.
Changes between Version 1.30 and 1.20.
Changes between Version 1.20 and 1.10.
Changes between Version 1.10 and 1.00.
Version 1.00 was the first publicly available version.
You would need:
As the archive SOURCE.ZIE containing the source is encrypted, you need to run the command PROTECT cb2v150 Source.zie to get SOURCE.ZIP which you can then unzip as usual. (In case you wonder, that way anyone interested in the source needs to have installed OS/2 as I make the decryption program available for OS/2 but certainly not for Windows ;-).