home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Club Amiga de Montreal - CAM
/
CAM_CD_1.iso
/
files
/
198.lha
/
JDisk_v1.0
/
jdisk.doc
< prev
next >
Wrap
Text File
|
1988-12-27
|
5KB
|
126 lines
/* Copyright 1988 by I2(EYE) Systems. JDISK.DOC - Version 1.0
*
*
* JDISK - Disk (Volume) Requester Program
*
* This software may be freely distributed provided that this notice
* is retained. It may be hacked or used as is in any product as long
* as you credit me for it.
*
* If you find this program useful for enhancing your script file
* capabilities, please send $5.00 to:
*
* I2(EYE) Systems
* 6620 Hunter Road
* Elkridge, MD 21227
* Attn: J. Barshinger
*
* USENET or ARPANET: barsh@stsci
*
* Note: if you send $10.00, I'll send you the source and the
* latest enhancements.
* Planned enhancements include a re-entrant version so
* that it can be made resident and a mouse-move capability
* that will automatically move the pointer to the default
* gadget.
*
* JDISK - Disk (Volume) Requester Program
* ---------------------------------------
*
* JDISK is a disk requester program that can be used in your startup-
* sequence or any AmigaDos script file. It will allow the user to
* specify the disk (volume) name that is desired in a particular
* drive. When the correct disk is inserted in the specified drive
* JDISK will automatically exit with no error. If the user clicks
* on the positive gadget (CANCEL), JDISK will return WARN (5) to
* AmigaDos, much like a positive response from the AmigaDos 1.3 ASK
* command. If the user selects the negative gadget (RETRY), JDISK
* will check to see if the correct disk has been inserted and if the
* disk is found, return success (0).
*
* You can move the "requester" to the bottom of the screen or to the front
* or back of other screens if you don't want to answer it at the moment.
*
* JDISK Parameters
* ---------------
*
* -r This parameter specifies the "requester" text. This is
* the question you want to ask.
*
* This is a REQUIRED parameter. (40 character max.)
*
* EXAMPLE: "-rPLEASE insert LATTICE_5_0_2 in DF1:"
* = PLEASE insert LATTICE_5_0_2 in DF1: in the requester box.
* (put quotes around the string to put spaces in the text)
*
* -v This parameter specifies the name of the disk you want
* in a given drive.
*
* This is a REQUIRED parameter. (20 character max.)
*
* EXAMPLE: -vLATTICE_5_0_2
* = LATTICE_5_0_2 is the name of the desired disk.
*
* -x This parameter specified which drive you want the specified
* disk put in. This is a hex integer.
* The following are valid inputs:
* 1 = df0:, 2 = df1:, 4 = df2:, 8 = df3:,
* 10 = df4:, 20 = df5:, 40 = df6:, 80 = df7:
* You can also specify a combination of disks by
* adding the above numbers. (i.e. say you want the
* disk in df2 or df5 or df7, add 4 + 20 + 80 = A4,
* remember we're adding in hex).
*
* Another way to look at it is: consider that each bit position
* specifies a drive number, it the bit is set, that means we
* want to look at that drive. Currently, we only look at bits
* 0 - 7, I can't believe you have more drives than that...
* If bit 0 is set, you have selected df0:
* If bit 1 is set, you have selected df1:
* If bit 2 is set, you have selected df2:
* If bit 7 is set, you have selected df7:
* If bits 1, 2, 7 are set, you have selected df1, df2, and df7.
* Now just convert that to hex and pass it in this parameter.
*
* This is a REQUIRED parameter.
*
* EXAMPLE: -x3 = look for the disk in drives df0: and df1:
*
* -p This specifies the text for the positive (left) gadget.
* When this gadget is selected, WARN (5) will be returned.
* (put quotes around the string to put spaces in the text)
* DEFAULT: CANCEL (12 character max.)
* EXAMPLE: "-pGIVE UP" = GIVE UP in the left gadget.
*
* -n This specifies the text for the negative (right) gadget.
* When this gadget is selected, 0 will be returned (success).
* (put quotes around the string to put spaces in the text)
* DEFAULT: RETRY (12 character max.)
* EXAMPLE: -nREADY = READY in the right gadget.
*
* -t This will specify a timeout period in seconds. When the
* timeout period expires, the default answer will be returned.
* DEFAULT: wait forever
* EXAMPLE: -t10 = wait 10 seconds.
*
* -d This parameter specifies which gadget is the default (safe)
* answer. It does two things:
* a) determines if the positive or negative answer is
* to be default.
* b) makes a more extravagant border for the specified
* gadget.
* n specifies the negative answer, p specifies the positive
* answer.
* DEFAULT: if this is not specified, both gadgets will look
* the same, but the positive (CANCEL) gadget will
* be returned.
* EXAMPLE: -dp = Fancy gadget rendered on positive and positive
* is the default answer.
*
* -q This specifies whether you want the "requester" quick or if
* you want the "requester" to scroll up.
* DEFAULT: the "requester" scrolls up to it final position.
* EXAMPLE: -q = turn off the scrolling effects.
*
*/