HDS-300 Commands for IBM PC/AT Dec. 2, 1987 ------------------------------ 1. Purpose The HDS-300 Commands for IBM PC/AT provide a useful method for transferring binary and ASCII files between an IBM PC/AT and a Motorola HDS-300 Hardware Development Station (CP/M-68K). This provides a path for modem file transfers using the PC/AT with any type of communications software and also allows usage of more powerful editors for editing HDS-300 macro files. 2. Installation a. The following files are needed: HDSINFO.TXT This information file you're reading now. HDSDEL.EXE Deletes HDS-300 file command. HDSDIR.EXE Directory for HDS-300 diskettes command. HDSREAD.EXE Copies (reads) HDS-300 file to DOS file command. HDSTYPE.EXE Display HDS-300 file contents command. HDSWRITE.EXE Copies (writes) DOS file to HDS-300 diskette command. b. An IBM PC/AT (or 100% compatible) with high capacity (1.2 MB) 5-1/4" floppy disk drive is required. c. Place all the HDS*.EXE files in your execution directory, e.g. \BIN. The HDSINFO.TXT file is not required to execute the commands. It is for informational purposes only. -- NOTE -- The MS-DOS "PATH" command must be properly set so it can find the directory where the HDS*.EXE files reside. 3. Command Syntax The following descriptions are presented in the structure of the HDS-300 Commands Reference Manual. If any command is invoked without any arguments, a one-line command syntax is displayed. Wildcard characters are permitted in DOS and HDS-300 filenames as per their usual conventions. HDSDEL Delete HDS-300 file -------------------------------- Description: The HDSDEL command allows files on a HDS-300 diskette to be deleted from the diskette. Syntax: HDSDEL [user]:[] where: selects the IBM PC/AT drive in which the HDS-300 diskette has been inserted. is the optional CP/M-68K user number for . Legal values are 0-15, with 0 as the default. is the HDS-300 filename to be deleted. Examples: HDSDEL A:TEST.MAC Deletes the TEST.MAC file on the HDS-300 diskette in drive A: of the IBM PC/AT. HDSDEL A9:TEST.SCR Deletes the TEST.SCR file under user 9 on the HDS-300 diskette in drive A: of the IBM PC/AT. HDSDIR Disk directory --------------------------- Description: The HDSDIR command allows filenames on a HDS-300 diskette to be displayed. Syntax: HDSDIR [user]:[] [/W] [/P] where: selects the IBM PC/AT drive in which the HDS-300 diskette has been inserted. is the optional CP/M-68K user number for . Legal values are 0-15. If omitted, all user numbers are searched. is an HDS-300 filename. /W is the normal MS-DOS option to produce a wide dis- play of the directory. /P is the normal MS-DOS option to pause when the screen is full. Examples: HDSDIR A: Lists all files for all user numbers on the HDS-300 diskette in drive A: of the IBM PC/AT. HDSDIR A3:*.MAC Lists all macro files under user number 3 on the HDS-300 diskette in drive A: of the IBM PC/AT. HDSDIR B: /P Lists all files for all user numbers on the HDS-300 diskette in drive B: of the IBM PC/AT and pauses when the screen becomes full. HDSREAD Copy HDS-300 file to DOS ------------------------------------- Description: The HDSREAD command allows files on a HDS-300 diskette to be copied to MS-DOS. It follows a command format similar to the MS-DOS "COPY" command. Syntax: HDSREAD [user]:[] where: selects the IBM PC/AT drive in which the HDS-300 diskette has been inserted. is the optional CP/M-68K user number for . Legal values are 0-15, with 0 as the default. is an HDS-300 filename to be read. is the MS-DOS destination path to be written. Examples: HDSREAD A:USERINIT.MAC C: Copies the USERINIT.MAC file on the HDS-300 diskette in drive A: of the IBM PC/AT to a DOS file on drive C:. HDSREAD A6:TMP.MAC TST.MAC Copies the TMP.MAC file under user number 6 on the HDS-300 diskette in drive A: of the IBM PC/AT to a DOS file named TST.MAC on the default drive. HDSREAD B:BIG.MAC . Copies the BIG.MAC file on the HDS-300 diskette in drive B: of the IBM PC/AT to a DOS file on the current drive/directory. HDSTYPE Display HDS-300 file contents ------------------------------------------ Description: The HDSTYPE command allows files on a HDS-300 diskette to be displayed. It follows a command format similar to the MS-DOS "TYPE" command. With this command, HDS-300 text files (.MAC, .SCR, .LOG) may be examined on the HDS-300 diskette without first copying them over to MS-DOS. Syntax: HDSTYPE [user]:[] where: selects the IBM PC/AT drive in which the HDS-300 diskette has been inserted. is the optional CP/M-68K user number for . Legal values are 0-15, with 0 as the default. is an HDS-300 filename to be read. Examples: HDSTYPE A:USERINIT.MAC Displays the USERINIT.MAC file on the HDS-300 diskette in drive A: of the IBM PC/AT on the console. HDSTYPE A15:TEST39.SCR Displays the TEST39.SCR file under user 15 on the HDS-300 diskette in drive A: of the IBM PC/AT on the console. HDSWRITE Copy DOS file to HDS-300 ------------------------------------- Description: The HDSWRITE command allows DOS files to be copied to a HDS-300 diskette. It follows a command format similar to the MS-DOS "COPY" command. Syntax: HDSWRITE [user]:[] where: is the MS-DOS source path to be read. selects the IBM PC/AT drive in which the HDS-300 diskette has been inserted. is the optional CP/M-68K user number for . Legal values are 0-15, with 0 as the default. is an HDS-300 filename to be written. Examples: HDSWRITE C:USERINIT.MAC A: Copies the USERINIT.MAC file on DOS drive C: to the HDS-300 diskette in drive A: using the same filename. HDSWRITE TMP.MAC A5:TST.MAC Copies the TMP.MAC file on the default DOS drive to the HDS-300 diskette in drive A: under user number 5 using the filename TST.MAC. 4. Restrictions a. It is not physically possible to format an HDS-300 diskette in an IBM PC/AT drive. Therefore, all formatting of HDS-300 disk- ettes MUST be done on the HDS-300 station using the supplied OFFLINE UTILITIES diskette for the matching SYSTEMS disk. The boot track was changed for later releases, so to ensure a boot- able diskette, always use the matching UTILITIES diskette. b. When using a DOS based editor to edit HDS-300 macro files, the following cautions should be noted: drive A: of the IBM PC/AT on the console. HDSWRITE Copy DOS file to HDS-300 ------------------------------------- Description: The HDSWRITE command allows DOS files to be copied to a HDS-300 diskette. It follows a command format similar to the MS-DOS "COPY" command. Syntax: HDSWRITE [user]:[] where: is the MS-DOS son to halt. Expansion of local symbols can also cause lines to become too long, so be careful. 3. The HDS-300 software only accesses files under user number 0. Therefore, any files written to other user numbers will not be accessible by the HDS-300 software. User number capability is provided for general CP/M-68K support. **EOF**