home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / CPM3 / CPMP.HZP / CPM+.HLP
Text File  |  2000-06-30  |  45KB  |  1,595 lines
  1. CP/M PLUS COMMAND FORMAT
  2. CONTROL CHARACTERS
  3. THE COPYSYS FUNCTION    
  4. SETTING THE DATE        
  5. DEVICE      
  6. THE DIR COMMANDS       
  7. THE DUMP COMMAND       
  8. ED, THE EDITOR          
  9. HOW TO ERASE A FILE
  10. FILESPEC    
  11. GENCOM      
  12. GET         
  13. USING THE HELP PROGRAM
  14. HEXCOM      
  15. INITDIR     
  16. PATCH       
  17. PIP (COPY)  
  18. PUT         
  19. RENAME      
  20. THE SAVE COMMAND       
  21. THE SET COMMAND        
  22. SETDEF      
  23. SHOW        
  24. THE SUBMIT COMMAND     
  25. THE TYPE COMMAND       
  26. THE USER COMMAND       
  27.  
  28.  
  29.  
  30.  
  31. Go to second CPM PLUS menu
  32. : CP/M 3 Command Format:
  33.  
  34.         A>COMMAND {command tail} <cr>
  35.  
  36.   A CP/M 3 command line is  composed  of  a  command,  an  optional
  37.   command  tail, and a carriage return.  The command is the name or
  38.   filename of a program to be executed.  The optional command  tail
  39.   can   consist   of  a  drive  specification,  one  or  more  file
  40.   specifications, and some options or parameters.
  41.  
  42.                COMMAND CONVENTIONS
  43.  
  44.   The following special symbols define command syntax.
  45.  
  46.   {}   surrounds an optional item.
  47.   |    separates alternative items in a command line.
  48.   <cr> indicates a carriage return.
  49.   ^    indicates the Control Key.
  50.   n    substitute a number for n.
  51.   s    substitute a string (group) of characters for s.
  52.   o    substitute an option or option list for o.
  53.   []   type square brackets to enclose an option list.
  54.   ()   type parens to enclose a range of options within an option list.
  55.   RW   Read-Write attribute - opposite of RO
  56.   RO   Read-Only attribute - opposite of RW
  57.   SYS  System attribute - opposite of DIR
  58.   DIR  Directory attribute - opposite of SYS
  59.    ... preceding element can be repeated as many times as desired.
  60.   *    wildcard: replaces all or part of a filename and/or filetype.
  61.   ?    wildcard: replaces any single character
  62.        in the same position of a filename and/or filetype.
  63. : Control Characters
  64.  
  65.   Control Character                      Function
  66.  
  67.   CTRL-A    moves cursor one character to the left.  Banked  system
  68.             only.
  69.  
  70.   CTRL-B    moves cursor from beginning to end of command line  and
  71.             back without affecting command.  Banked system only.
  72.  
  73.   CTRL-C    stops executing program  when  entered  at  the  system
  74.             prompt or after CTRL-S.
  75.  
  76.   CTRL-E    forces  a  physical  carriage  return  without  sending
  77.             command to CP/M 3.
  78.  
  79.   CTRL-F    moves cursor one character to the right. Banked  system
  80.             only.
  81.  
  82.   Control Character                      Function
  83.  
  84.   CTRL-G    deletes character at current cursor position if in  the
  85.             middle of a line.  Banked system only.
  86.  
  87.   CTRL-I   same as the TAB key.
  88.  
  89.   CTRL-H    delete character to the left of cursor.
  90.  
  91.   CTRL-J    moves cursor to the left of the command line and  sends
  92.             command  to  CP/M  3.  Line  feed,  has  same effect as
  93.             carriage return.
  94.  
  95.   CTRL-K    deletes character at cursor and all characters  to  the
  96.             right.
  97.  
  98.   CTRL-M    same as carriage return.
  99.  
  100.   CTRL-P    echoes console output to the list device.
  101.  
  102.   Control Character                      Function
  103.  
  104.   CTRL-Q    restarts screen scrolling after a CTRL-S.
  105.  
  106.   CTRL-R    retypes the characters to the left of the cursor  on  a
  107.             new line; updates the command line buffer.
  108.  
  109.   CTRL-S    stops screen scrolling.
  110.  
  111.   CTRL-U    updates  the  command  line  buffer  to   contain   the
  112.             characters  to  the left of the cursor; deletes current
  113.             line.
  114.  
  115.   CTRL-W    recalls previous command line if current line is empty;
  116.             otherwise moves cursor to end of line.  CTRL-J,-M,-R,-U
  117.             and RETURN update the command line  buffer  for  recall
  118.             with CTRL-W.  Banked system only.
  119.  
  120.   CTRL-X    deletes all characters to the left of the cursor.
  121.  
  122. :COPYSYS
  123.  
  124.   Syntax:
  125.  
  126.        COPYSYS
  127.  
  128.   Explanation:
  129.  
  130.   COPYSYS copies the CP/M 3 system from a CP/M 3 system diskette to
  131.   another  diskette.  The new diskette must have the same format as
  132.   the original system diskette.
  133.  
  134.   Example:
  135.  
  136.        A>COPYSYS
  137.  
  138. :DATE
  139.  
  140.   Syntax:
  141.  
  142.        DATE {CONTINUOUS}
  143.        DATE {time-specification}
  144.        DATE SET
  145.  
  146.   Explanation:
  147.  
  148.   The DATE command lets you display and set the date  and  time  of
  149.   day.
  150.  
  151.   Examples
  152.  
  153.   A>DATE
  154.  
  155.        Displays the current date and time.
  156.  
  157.   A>DATE C
  158.  
  159.        Displays the date and time continuously.
  160.  
  161.   A>DATE 08/14/82 10:30:0
  162.  
  163.        Sets the date and time.
  164.  
  165.   A>DATE SET
  166.  
  167.        Prompts for date and time entries.
  168.  
  169. :DEVICE
  170.  
  171.   Syntax:
  172.  
  173.           DEVICE { NAMES | VALUES | physical-dev | logical-dev}
  174.           DEVICE logical-dev=physical-dev {option}
  175.                                        {,physical-dev {option},...}
  176.           DEVICE logical-dev = NULL
  177.           DEVICE physical-dev {option}
  178.           DEVICE CONSOLE [ PAGE | COLUMNS = columns | LINES = lines]
  179.  
  180.   Explanation:
  181.  
  182.   DEVICE displays current logical device assignments  and  physical
  183.   device  names.  DEVICE  assigns  logical  devices  to  peripheral
  184.   devices  attached  to  the  computer.   DEVICE  also   sets   the
  185.   communications  protocol  and  speed  of a peripheral device, and
  186.   displays or sets the current console screen size.
  187.  
  188.   DEVICE Options:
  189.  
  190.               [ XON | NOXON | baud-rate ]
  191.  
  192.   XON         refers to  the   XON/XOFF   communications  protocol.
  193.  
  194.   NOXON       indicates no protocol and the computer  sends data to
  195.               the  device  whether  or  not  the device is ready to
  196.               receive it.
  197.  
  198.   baud-rate   is the    speed   of   the    device.    The   system
  199.               accepts the following baud rates:
  200.  
  201.                       50       75         110        134
  202.                       150      300        600        1200
  203.                       1800     2400       3600       4800
  204.                       7200     9600       19200
  205.  
  206.   Examples:
  207.  
  208.   A>DEVICE
  209.  
  210.        Displays the physical devices and   current  assignments  of
  211.        the logical devices in the system.
  212.  
  213.   A>DEVICE NAMES
  214.  
  215.        Lists the physical devices with a   summary  of  the  device
  216.        characteristics.
  217.  
  218.   A>DEVICE VALUES
  219.  
  220.        Displays  the  current  logical  device assignments.
  221.  
  222.   A>DEVICE CRT
  223.  
  224.        Displays the attributes  of  the  physical device CRT.
  225.  
  226.   A>DEVICE CON
  227.  
  228.        Displays the  assignment  of  the  logical device CON:
  229.  
  230.   A>DEVICE CONOUT:=LPT,CRT
  231.  
  232.        Assigns  the  system   console    output  (CONOUT:)  to  the
  233.        printer (LPT) and the screen (CRT).
  234.  
  235.   A>DEVICE AUXIN:=CRT2 [XON,9600]
  236.  
  237.        Assigns the auxiliary logical input   device   (AUXIN:)   to
  238.        the   physical   device   CRT   using  protocol XON/XOFF and
  239.        sets the transmission rate for the device  at  9600.
  240.  
  241.   A>DEVICE LST:=NULL
  242.  
  243.        Disconnects the list output logical device (LST:).
  244.  
  245.   A>DEVICE LPT [XON,9600]
  246.  
  247.        Sets  the  XON/XOFF  protocol  for  the physical device  LPT
  248.        and sets the transmission speed at 9600.
  249.  
  250.   A>DEVICE CONSOLE [PAGE]
  251.  
  252.        Displays the current console  page  width  in  columns   and
  253.        length in lines.
  254.  
  255.   A>DEVICE CONSOLE [COLUMNS=40 LINES=16]
  256.  
  257.        Sets the screen size to 40 columns and 16 lines.
  258.  
  259. :DIR
  260.  
  261.   The DIR  command  displays   the   names   of   files   and   the
  262.   characteristics associated with the files.
  263.  
  264.   The DIR command has three distinct references:
  265.  
  266.           DIR
  267.           DIRS
  268.           DIR with Options
  269.  
  270.   DIR and DIRS are built-in  utilities.   DIR  with  Options  is  a
  271.   transient utility and must be loaded into memory from the disk.
  272.  
  273.   Syntax -- built-in:
  274.  
  275.           DIR  {d:}
  276.           DIR  {filespec}
  277.  
  278.           DIRS {d:}
  279.           DIRS {filespec}
  280.  
  281.   Explanation:
  282.  
  283.   The DIR and DIRS Built-in commands  display  the  names  of files
  284.   cataloged   in  the  directory of an on-line disk.  DIR lists the
  285.   names of files in the current user number that have the Directory
  286.   (DIR)  attribute.  DIR  accepts the * and ? wildcards in the file
  287.   specification.
  288.  
  289.   Examples:
  290.  
  291.   A>DIR
  292.  
  293.        Displays all files in user  0  on  drive  A  that  have  the
  294.        Directory attribute.
  295.  
  296.   A>DIR B:
  297.  
  298.        Displays all DIR files in user 0 on drive B.
  299.  
  300.   2A>DIR C:ZIPPY.DAT
  301.  
  302.        Displays the name ZIPPY.DAT if the file  is  in  user  2  on
  303.        drive C.
  304.  
  305.   4A>DIR *.BAS
  306.  
  307.        Displays all DIR files with filetype BAS in user 4 on  drive
  308.        A.
  309.  
  310.   B3>DIR X*.C?D
  311.  
  312.        Displays all DIR files in user 3 on drive B  whose  filename
  313.        begins with the letter X, and whose three character filetype
  314.        contains the first character C and last character D.
  315.  
  316.   A>DIRS
  317.  
  318.        Displays all files for user 0 on  drive  A  that  have   the
  319.        system (SYS) attribute.
  320.  
  321.   A>DIRS *.COM
  322.  
  323.        Displays all SYS files with filetype COM on drive A in  user
  324.        0.  A  command  (.COM)  file  in  user  0  with  the  system
  325.        attribute can be accessed  from  any  user  number  on  that
  326.        drive,  and from any drive in the search chain (see SETDEF).
  327.  
  328.   Syntax -- With Options:
  329.  
  330.           DIR {d:} [options]
  331.           DIR {filespec} {filespec} ... [options]
  332.  
  333.   Explanation:
  334.  
  335.   The DIR command with options is an enhanced version of   the  DIR
  336.   built-in  command  and  displays your files in a variety of ways.
  337.   DIR can search for files on any or all  drives, for  any  or  all
  338.   user  numbers.  One  or  two letters is sufficient to identify an
  339.   option. You need not type the right hand square bracket.
  340.  
  341.   Options:
  342.  
  343.   Option                     Function
  344.  
  345.   ATT        displays the file attributes.
  346.  
  347.   DATE       displays date and time stamps of files.
  348.  
  349.   DIR        displays only files that have the DIR attribute.
  350.  
  351.   DRIVE=ALL  displays files on all on-line drives.
  352.  
  353.   Option                     Function
  354.  
  355.   DRIVE=(A,B,C,...,P)
  356.              displays files on the drives specified.
  357.  
  358.   DRIVE=d    displays files on the drive specified by d.
  359.  
  360.   EXCLUDE    displays  files  that   DO   NOT   MATCH   the   files
  361.              specified in the command line.
  362.  
  363.   FF         sends an initial form feed to the  printer  device  if
  364.              the printer has been activated by CTRL-P.
  365.  
  366.   Option                     Function
  367.  
  368.   FULL       shows the name, size, number of 128-byte records,  and
  369.              attributes  of  the  files.  If  there  is a directory
  370.              label   on   the   drive,  DIR  shows   the   password
  371.              protection mode and the time stamps.  If  there  is no
  372.              directory  label,  DIR displays  two file entries on a
  373.              line,  omitting  the  password and time stamp columns.
  374.              The display is alphabetically sorted. (See  SET for  a
  375.              description  of   file   attributes, directory labels,
  376.              passwords and protection modes.)
  377.  
  378.   LENGTH=n   displays n lines of printer output  before   inserting
  379.              a table heading.  n is a number between 5 and 65536.
  380.  
  381.   MESSAGE    displays the names of drives and user numbers  DIR  is
  382.              searching.
  383.  
  384.   Option                     Function
  385.  
  386.   NOSORT     displays files in the order it finds them on the disk.
  387.  
  388.   RO         displays  only  the  files  that  have  the  Read-Only
  389.              attribute.
  390.  
  391.   RW         displays only the files that are set to Read-Write.
  392.  
  393.   SIZE       displays the filename  and  size  in  kilobytes  (1024
  394.              bytes).
  395.  
  396.   SYS        displays only the files that have the SYS attribute.
  397.  
  398.   USER=ALL   displays all files in all user numbers for the default
  399.              or specified drive.
  400.  
  401.   USER=n     displays the files in the user number specified by  n.
  402.  
  403.   USER=(0,1,...,15)
  404.              displays files under the user numbers specified.
  405.  
  406.   Examples:
  407.  
  408.   A>DIR C: [FULL]
  409.  
  410.        Displays full set of characteristics for all files in user 0
  411.        on drive C.
  412.  
  413.   A>DIR C: [DATE]
  414.  
  415.        Lists the files on drive C and their dates.
  416.  
  417.   A>DIR D: [RW,SYS]
  418.  
  419.        Displays all files in user 0 on  drive  D   with  Read-Write
  420.        and System attributes.
  421.  
  422.   3A>DIR [USER=ALL, DRIVE=ALL]
  423.  
  424.        Displays all the files in all user numbers (0-15) in all on-
  425.        line drives.
  426.  
  427.   B6>DIR [exclude] *.DAT
  428.  
  429.        Lists all the files on drive B in user 6 that do not have  a
  430.        filetype of .DAT.
  431.  
  432.   3B>DIR [SIZE] *.PLI *.COM *.ASM
  433.  
  434.        Displays all the files  of  type  PLI,  COM, and ASM in user
  435.        3 on drive B in size display format.
  436.  
  437.   A>DIR [drive=all user=all] TESTFILE.BOB
  438.  
  439.        DIR  displays  the  filename TESTFILE.BOB if it is found  on
  440.        any drive in any user number.
  441.  
  442.   A>DIR [size,rw] D:
  443.  
  444.        DIR lists  each  Read-Write file  that  resides on Drive  D,
  445.        with  its  size in kilobytes.  Note that D: is equivalent to
  446.        D:*.*.
  447.  
  448. :DUMP
  449.  
  450.   Syntax:
  451.  
  452.       DUMP filespec
  453.  
  454.   Explanation:
  455.  
  456.   DUMP displays the contents of a  file  in  hexadecimal and  ASCII
  457.   format.
  458.  
  459.   Example:
  460.  
  461.       A>DUMP ABC.TEX
  462.  
  463. :ED
  464.  
  465.   Format:
  466.  
  467.        ED input-filespec {d:|output-filespec}
  468.  
  469.   Explanation:
  470.  
  471.   Character file editor.  To redirect or rename the new version  of
  472.   the file specify the destination drive or destination filespec.
  473.  
  474.   ED Commands:
  475.  
  476.                          ED Command Summary
  477.  
  478.   Command              Action
  479.  
  480.   nA
  481.         append n lines from original file to memory buffer
  482.  
  483.   0A
  484.         append file until buffer is one half full
  485.  
  486.   #A
  487.         append file until buffer is full (or end of file)
  488.  
  489.   B, -B
  490.         move CP to the beginning (B) or bottom (-B) of buffer
  491.  
  492.   nC, -nC
  493.         move CP n characters forward (C) or back (-C) through buffer
  494.  
  495.   Command              Action
  496.  
  497.   nD, -nD
  498.         delete n characters before (-D) or from (D) the CP
  499.  
  500.   E
  501.         save new file and return to CP/M-86
  502.  
  503.   Fstring{^Z}
  504.         find character string
  505.  
  506.   H
  507.         save new file, reedit, use new file as original file
  508.  
  509.   I<cr>
  510.         enter insert mode
  511.  
  512.   Istring{^Z}
  513.         insert string at CP
  514.  
  515.   Command              Action
  516.  
  517.   Jsearch_str^Zins_str^Zdel_to_str
  518.         juxtapose strings
  519.  
  520.   nK, -nK
  521.         delete (kill) n lines from the CP
  522.  
  523.   nL, -nL, 0L
  524.         move CP n lines
  525.  
  526.   nMcommands
  527.         execute commands n times
  528.  
  529.   n, -n
  530.         move CP n lines and display that line
  531.  
  532.   n:
  533.         move to line n
  534.  
  535.   Command              Action
  536.  
  537.   :ncommand
  538.         execute command through line n
  539.  
  540.   Nstring{^Z}
  541.         extended find string
  542.  
  543.   O
  544.         return to original file
  545.  
  546.   nP, -nP
  547.         move CP 23 lines forward and display 23 lines at console
  548.  
  549.   Q
  550.         abandon new file, return to CP/M-86
  551.  
  552.   R{^Z}
  553.         read X$$$$$$$.LIB file into buffer
  554.  
  555.   Command              Action
  556.  
  557.   Rfilespec{^Z}
  558.         read filespec into buffer
  559.  
  560.   Sdelete string^Zinsert string
  561.         substitute string
  562.  
  563.   nT, -nT, 0T
  564.         type n lines
  565.  
  566.   U, -U
  567.         upper-case translation
  568.   V, -V
  569.         line numbering on/off
  570.   0V
  571.         display free buffer space
  572.   nW
  573.         write n lines to new file
  574.  
  575.   Command              Action
  576.  
  577.   0W
  578.         write until buffer is half empty
  579.   nX
  580.         write or append n lines to X$$$$$$$.LIB
  581.  
  582.   nXfilespec{^Z}
  583.         write n lines to filespec;
  584.         append if previous xcommand applied to same file
  585.  
  586.   0x{^Z}
  587.         delete file X$$$$$$$.LIB
  588.  
  589.   0xfilespec{^Z}
  590.         delete filespec
  591.   nZ
  592.         wait n seconds
  593.  
  594.   Command              Action
  595.  
  596.   Note:  CP points to the current character being referenced in
  597.          the edit buffer.  Use {^Z} to separate multiple commands
  598.          on the same line.
  599.  
  600.   Examples:
  601.  
  602.        A>ED TEST.DAT
  603.        A>ED TEST.DAT B:
  604.        A>ED TEST.DAT TEST2.DAT
  605.        A>ED TEST.DAT B:TEST2.DAT
  606.  
  607. :Erase
  608.  
  609.   Syntax:
  610.  
  611.        ERASE {filespec} {[CONFIRM]}
  612.  
  613.   Explanation:
  614.  
  615.   The ERASE command  removes   one   or   more   files   from   the
  616.   directory  of  a  disk.  Wildcard  characters are accepted in the
  617.   filespec.  Directory and data space are  automatically  reclaimed
  618.   for  later  use  by  another  file.  The  ERASE  command  can  be
  619.   abbreviated to ERA.
  620.  
  621.   Option:
  622.  
  623.      [CONFIRM]  option  informs  the  system   to   prompt   for
  624.                 verification   before  erasing  each  file  that
  625.                 matches   the   filespec.    CONFIRM   can   be
  626.                 abbreviated to C.
  627.  
  628.   Examples:
  629.  
  630.   A>ERASE X.PAS
  631.  
  632.        Removes the file X.PAS from the disk in  drive A.
  633.  
  634.   A>ERA *.PRN
  635.   Confirm (Y/N)?Y
  636.  
  637.        All files with the filetype PRN are removed from  the   disk
  638.        in drive A.
  639.  
  640.   B>ERA A:MY*.* [CONFIRM]
  641.  
  642.        Each file on drive A with a filename that begins with MY  is
  643.        displayed  with a question mark for confirmation.  Type Y to
  644.        erase the file displayed, N to keep the file.
  645.  
  646.   A>ERA B:*.*
  647.   Confirm (Y/N)?Y
  648.  
  649.        All files on drive B are removed from the disk.
  650.  
  651. :FILESPEC
  652.  
  653.                            FILESPEC FORMAT
  654.  
  655.   CP/M 3 identifies every file by its  unique  file  specification,
  656.   which  can  consist  of  four parts: the drive specification, the
  657.   filename, the filetype and the  password.   The  term  "filespec"
  658.   indicates  any  valid  combination  of  the  four parts of a file
  659.   specification, all separated  by  their appropriate   delimiters.
  660.   A   colon  must  follow  a drive letter.  A period must precede a
  661.   filetype. A  semicolon must precede a password.
  662.  
  663.   The   symbols   and  rules  for  the   parts    of     a     file
  664.   specification follow:
  665.  
  666.   d:          drivespec  optional    single alpha character (A-P)
  667.   filename    filename               1-8 letters and/or numbers
  668.   typ         filetype   optional    0-3 letters and/or numbers
  669.   password    password   optional    0-8 letters and/or numbers
  670.  
  671.   Valid combinations of the elements of a CP/M 3 file specification
  672.   are:
  673.  
  674.                 filename
  675.                 d:filename
  676.                 filename.typ
  677.                 d:filename.typ
  678.                 filename;password
  679.                 d:filename;password
  680.                 filename.typ;password
  681.                 d:filename.typ;password
  682.  
  683.   If you do not include a drive  specifier,  CP/M  3  automatically
  684.   uses the default drive.
  685.  
  686.   Some CP/M 3 commands accept wildcard (* and ?) characters in  the
  687.   filename   and/or filetype parts of the command tail.  A wildcard
  688.   in the command line can in one command  reference  many  matching
  689.   files  on  the  default  or specified user number and drive. (See
  690.   Commands).
  691.  
  692. :GENCOM
  693.  
  694.   Syntax:
  695.  
  696.           GENCOM {COM-filespec} {RSX-filespec} ...
  697.                      {[LOADER | NULL | SCB=(offset,value)]}
  698.  
  699.   Explanation:
  700.  
  701.   The GENCOM command creates a special COM file with  attached  RSX
  702.   files.   The  GENCOM  command  can  also  restore  a   previously
  703.   GENCOMed file to the original COM file  without  the  header  and
  704.   RSX's.  GENCOM can also attach header records to COM files.
  705.  
  706.   Options:
  707.  
  708.   LOADER      sets a flag to keep the program loader active.
  709.  
  710.   NULL        indicates that only RSX files are specified.   GENCOM
  711.               creates   a   dummy  COM file for the RSX files.  The
  712.               output COM filename is taken from the filename of the
  713.               first RSX-filespec.
  714.  
  715.   SCB=(offset,value)
  716.               sets the System Control Block  from  the  program  by
  717.               using the hex values specified by (offset,value).
  718.  
  719.   Examples:
  720.  
  721.   A>GENCOM MYPROG PROG1 PROG2
  722.  
  723.        Generates a new COM file  MYPROG.COM   with  attached  RSX's
  724.        PROG1 and PROG2.
  725.  
  726.   A>GENCOM PROG1 PROG2 [NULL]
  727.  
  728.        Creates a COM file PROG1.COM  with  RSX's PROG1 and PROG2.
  729.  
  730.   A>GENCOM MYPROG
  731.  
  732.        GENCOM takes  MYPROG.COM,   strips   off  the   header   and
  733.        deletes all attached RSX's to restore it to its original COM
  734.        format.
  735.  
  736.   A>GENCOM MYPROG PROG1 PROG2
  737.  
  738.        GENCOM looks at the  already-GENCOMed file MYPROG.COM to see
  739.        if PROG1.RSX and PROG2.RSX are already attached RSX files in
  740.        the module.  If  either  one  is  already  attached,  GENCOM
  741.        replaces  it  with  the  new  RSX module.  Otherwise, GENCOM
  742.        appends the specified RSX files to the COM file.
  743.  
  744. :GET
  745.  
  746.   Syntax:
  747.  
  748.   GET {CONSOLE INPUT FROM} FILE filespec{[{ECHO|NO ECHO} | SYSTEM]}
  749.   GET {CONSOLE INPUT FROM} CONSOLE
  750.  
  751.   Explanation:
  752.  
  753.   GET  directs the system to take console input from a file for the
  754.   next system  command  or  user  program entered at the console.
  755.  
  756.   Console input  is  taken  from   a   file   until   the   program
  757.   terminates.  If  the  file  is  exhausted before program input is
  758.   terminated, the program  looks  for  subsequent  input  from  the
  759.   console.  If  the  program  terminates  before exhausting all its
  760.   input, the system reverts back to the console for console  input.
  761.  
  762.   With  the  SYSTEM  option,  the  system  immediately  goes to the
  763.   specified file for console input.  The  system  reverts  to   the
  764.   console   for  input  when it reaches the end of file.  Re-direct
  765.   the system to the  console  for   console   input  with  the  GET
  766.   CONSOLE INPUT FROM CONSOLE command as a command line in the input
  767.   file.
  768.  
  769.   Options:
  770.  
  771.   ECHO      specifies that input is echoed to  the  console.   This
  772.             is the default option.
  773.  
  774.   NO ECHO   specifies that  file   input   is  not  echoed  to  the
  775.             console.  The program output and the system prompts are
  776.             not affected by this option and are still   echoed   to
  777.             the console.
  778.  
  779.   SYSTEM    specifies that all  system  input  is immediately taken
  780.             from  the disk file specified in the command line.  GET
  781.             takes system and program input from the file until  the
  782.             file  is  exhausted  or  until  GET reads a GET console
  783.             command from the file.
  784.  
  785.   Examples:
  786.  
  787.   A>GET FILE XINPUT
  788.   A>MYPROG
  789.  
  790.        Tells the system to  activate the GET utility.  Since SYSTEM
  791.        is  not specified, the system reads the next input line from
  792.        the console and   executes   MYPROG.    If  MYPROG   program
  793.        requires  console  input,  it is taken from the file XINPUT.
  794.        When MYPROG terminates,  the  system  reverts  back  to  the
  795.        console for console input.
  796.  
  797.   A>GET FILE XIN2 [SYSTEM]
  798.  
  799.        Immediately  directs   the   system    to    get  subsequent
  800.        console  input from file XIN2 because it includes the SYSTEM
  801.        option.  The system reverts  back   to   the   console   for
  802.        console  input  when it reaches the end of file in XIN2.  Or
  803.        XIN2 may redirect the system  back  to  the  console  if  it
  804.        contains a  GET CONSOLE command.
  805.  
  806.   A>GET CONSOLE
  807.  
  808.        Tells the system to get console   input  from  the  console.
  809.        This  command may be used in a file (previously specified in
  810.        a GET FILE command), which is already  being  read   by  the
  811.        system   for   console  input.  It is used  to re-direct the
  812.        console input back to  the console  before the   end-of-file
  813.        is reached.
  814.  
  815. :HELP
  816.  
  817.   Syntax:
  818.  
  819.      HELP {topic} {subtopic1 ... subtopic8} {[NOPAGE|LIST]}
  820.  
  821.   Explanation:
  822.  
  823.   HELP  displays  a  list  of  topics   and   provides   summarized
  824.   information for CP/M 3 commands.
  825.  
  826.   HELP topic displays information about that topic.
  827.   HELP topic subtopic displays information about that subtopic.
  828.  
  829.   One or two letters is enough to identify the topics.  After  HELP
  830.   displays   information   for   your  topic,   it   displays   the
  831.   special  prompt  HELP> on your screen,  followed  by  a  list  of
  832.   subtopics.
  833.  
  834.    -  Enter ? to display list of main topics.
  835.    -  Enter a period and subtopic name to access subtopics.
  836.    -  Enter a period to redisplay what you just read.
  837.    -  Press the RETURN key to return to the CP/M 3 system prompt.
  838.    -  [NOPAGE] option disables the 24 lines per page console display.
  839.    -  Press any key to exit a display and return to the HELP> prompt.
  840.  
  841.   Examples:
  842.  
  843.        A>HELP
  844.        A>HELP DATE
  845.        A>HELP DIR OPTIONS
  846.        A>HELP>.OPTIONS
  847.        HELP>SET
  848.        HELP>SET PASSWORD
  849.        HELP>.PASSWORD
  850.        HELP>.
  851.        HELP><cr>
  852.  
  853. :HEXCOM
  854.  
  855.   Syntax:
  856.  
  857.       HEXCOM filename
  858.  
  859.   Explanation:
  860.  
  861.   The HEXCOM Command generates a command file (filetype .COM)  from
  862.   a   .HEX  input  file.  It  names  the  output file with the same
  863.   filename as the input file but with filetype .COM.  HEXCOM always
  864.   looks for a file with filetype .HEX.
  865.  
  866.   Example:
  867.  
  868.   A>HEXCOM B:PROGRAM
  869.  
  870.        Generates a command file PROGRAM.COM from the input hex file
  871.        PROGRAM.HEX.
  872.  
  873. :INITDIR
  874.  
  875.   Syntax:
  876.  
  877.       INITDIR {d:}
  878.  
  879.   Explanation:
  880.  
  881.   The INITDIR Command  initializes a disk directory  to  allow date
  882.   and time stamping of files on that disk. INITDIR can also recover
  883.   time/date directory space.
  884.  
  885.   Example:
  886.  
  887.       A>INITDIR C:
  888.  
  889.       INITDIR WILL ACTIVATE TIME-STAMPS FOR SPECIFIED DRIVE.
  890.       Do you want to re-format the directory on C: (Y/N)?Y
  891.  
  892. :PATCH
  893.  
  894.   Syntax:
  895.  
  896.       PATCH filename{.typ} {n}
  897.  
  898.   Explanation:
  899.  
  900.   The PATCH command displays or installs patch  number  n   to  the
  901.   CP/M  3  system  or  command  files.  The  patch number n must be
  902.   between 1 and 32 inclusive.
  903.  
  904.   Example:
  905.  
  906.   A>PATCH SHOW 2
  907.  
  908.        Patches the  SHOW.COM  system  file  with patch number 2.
  909.  
  910.  
  911.  
  912. :PIP (copy)
  913.  
  914.   Syntax:
  915.               DESTINATION              SOURCE
  916.  
  917.     PIP d:{Gn} | filespec{[Gn]} = filespec{[o]},... | d:{[o]}
  918.  
  919.   Explanation:
  920.  
  921.   The file copy program  PIP  copies  files,  combines  files,  and
  922.   transfers  files  between  disks,  printers,  consoles,  or other
  923.   devices attached to your computer.  The  first  filespec  is  the
  924.   destination. The  second filespec is the source.  Use two or more
  925.   source filespecs separated by commas to combine two or more files
  926.   into  one file.  [o] is any combination of the available options.
  927.   The [Gn] option in the destination filespec  tells  PIP  to  copy
  928.   your file to that user number.
  929.  
  930.   PIP with no command tail displays an *  prompt  and  awaits  your
  931.   series  of  commands,  entered  and processed one line at a time.
  932.   The source or destination can be any CP/M 3 logical device.
  933.  
  934.   Examples:
  935.  
  936.   COPY A FILE FROM ONE DISK TO ANOTHER
  937.  
  938.        A>PIP b:=a:draft.txt
  939.        A>PIP b:draft.txt = a:
  940.  
  941.        B3>PIP myfile.dat=A:[G9]
  942.        A9>PIP B:[G3]=myfile.dat
  943.  
  944.   COPY A FILE AND RENAME IT
  945.  
  946.        A5>PIP newdraft.txt=oldraft.txt
  947.        C8>PIP b:newdraft.txt=a:oldraft.txt
  948.  
  949.   COPY MULTIPLE FILES
  950.  
  951.        A>PIP b:=draft.*
  952.        A>PIP b:=*.*
  953.        B>PIP b:=c:.*.*
  954.        C>PIP b:=*.txt[g5]
  955.        C>PIP a:=*.com[wr]
  956.        B>PIP a:[g3]=c:*.*
  957.  
  958.   COMBINE MULTIPLE FILES
  959.  
  960.        A>PIP b:new.dat=file1.dat,file2.dat
  961.  
  962.   COPY, RENAME AND PLACE IN USER 1
  963.  
  964.        A>pip newdraft.txt[g1]=oldraft.txt
  965.  
  966.   COPY, RENAME AND GET FROM USER 1
  967.  
  968.        A>PIP newdraft.txt=oldraft.txt[g1]
  969.  
  970.   COPY TO/FROM LOGICAL DEVICES
  971.  
  972.        A>PIP b:funfile.sue=con:
  973.        A>PIP lst:=con:
  974.        A>PIP lst:=b:draft.txt[t8]
  975.        A>PIP prn:=b:draft.txt
  976.  
  977.   PIP Options:
  978.  
  979.   A    Archive. Copy only files that have been  changed  since  the
  980.         last copy.
  981.   C    Confirm. PIP prompts for confirmation before each file copy.
  982.   Dn   Delete any characters past column n.
  983.   E    Echo transfer to console.
  984.   F    Filter form-feeds from source data.
  985.   Gn   Get from or go to user n.
  986.   H    Test for valid Hex format.
  987.   I    Ignore :00 Hex data records and test for valid Hex format.
  988.   K    Kill display of filespecs on console.
  989.   L    Translate upper case to lower case.
  990.   N    Number output lines
  991.   O    Object file transfer, ^Z ignored.
  992.   Pn   Set page length to n.  (default n=60)
  993.   Qs^Z Quit copying from source at string s.
  994.   R    Read files that have been set to SYStem.
  995.   Ss^Z Start copying from the source at the string s.
  996.   Tn   Expand tabs to n spaces.
  997.  
  998.   PIP Options:
  999.  
  1000.   U    Translate lower case to upper case.
  1001.   V    Verify that data has been written correctly.
  1002.   W    Write over Read Only files without console query.
  1003.   Z    Zero the parity bit.
  1004.  
  1005.   All  options  except  C,G,K,O,R,V  and  W  force  an  ASCII  file
  1006.   transfer, character by character, terminated by a ^Z.
  1007.  
  1008. :PUT
  1009.  
  1010.   Syntax:
  1011.  
  1012.       PUT CONSOLE {OUTPUT TO} FILE filespec {option} | CONSOLE
  1013.       PUT PRINTER {OUTPUT TO} FILE filespec {option} | PRINTER
  1014.       PUT CONSOLE {OUTPUT TO} CONSOLE
  1015.       PUT PRINTER {OUTPUT TO} PRINTER
  1016.  
  1017.   Explanation:
  1018.  
  1019.   PUT puts console or printer  output  to  a  file  for   the  next
  1020.   command  entered at the console,  until  the  program terminates.
  1021.   Then  console  output  reverts  to the console.  Printer   output
  1022.   is   directed   to   a   file   until   the   program terminates.
  1023.   Then printer output is put back to the printer.
  1024.  
  1025.   PUT  with  the    SYSTEM    option   directs   all     subsequent
  1026.   console/printer   output  to  the  specified  file.  This  option
  1027.   terminates when you  enter  the  PUT  CONSOLE  or   PUT   PRINTER
  1028.   command.
  1029.  
  1030.   PUT Options:
  1031.  
  1032.              [ {ECHO | NO ECHO} {FILTER | NO FILTER} | {SYSTEM} ]
  1033.  
  1034.   ECHO        specifies that output is echoed to the console.  This
  1035.               is  the default option when you direct console output
  1036.               to a file.
  1037.  
  1038.   NO ECHO     specifies that file  output  is  not  echoed  to  the
  1039.               console.  NO ECHO  is the default for the PUT PRINTER
  1040.               command.
  1041.  
  1042.   FILTER      specifies  filtering  of  control  characters,  which
  1043.               means  that  control  characters  are  translated  to
  1044.               printable  characters.   For   example,   an   ESCape
  1045.               character is translated to ^[.
  1046.  
  1047.   NO FILTER   means   that   PUT   does   not   translate   control
  1048.               characters.  This is the default option.
  1049.  
  1050.   PUT Options:
  1051.  
  1052.   SYSTEM      specifies that  system  output  as  well  as  program
  1053.               output  is  written  to   the   file   specified   by
  1054.               filespec.  Output is written  to  the  file  until  a
  1055.               subsequent   PUT   CONSOLE  command redirects console
  1056.               output back to the console.
  1057.  
  1058.   Examples:
  1059.  
  1060.   A>PUT CONSOLE OUTPUT TO FILE XOUT [ECHO]
  1061.  
  1062.        Directs console output to file  XOUT  with the output echoed
  1063.        to the console.
  1064.  
  1065.   A>PUT PRINTER OUTPUT TO FILE XOUT
  1066.   A>MYPROG
  1067.  
  1068.        Directs  the  printer  output  of  program  MYPROG  to  file
  1069.        XOUT.  The output is not echoed to the printer.
  1070.  
  1071.   PUT Examples:
  1072.  
  1073.   A>PUT PRINTER OUTPUT TO FILE XOUT2 [ECHO,SYSTEM]
  1074.  
  1075.        Directs all printer output to file XOUT2 as well as  to  the
  1076.        printer   (with ECHO option), and the PUT is in effect until
  1077.        you enter a PUT PRINTER OUTPUT TO PRINTER command.
  1078.  
  1079.   A>PUT CONSOLE OUTPUT TO CONSOLE
  1080.  
  1081.        Directs  console  output  back  to  the console.
  1082.  
  1083.   A>PUT PRINTER OUTPUT TO PRINTER
  1084.  
  1085.        Directs  printer  output  back  to  the printer.
  1086.  
  1087. :RENAME
  1088.  
  1089.   Syntax:
  1090.  
  1091.        RENAME {new-filespec=old-filespec}
  1092.  
  1093.   Explanation:
  1094.  
  1095.   RENAME lets you change the name of a  file in the directory of  a
  1096.   disk.  To  change several filenames in one command use the * or ?
  1097.   wildcards in the file specifications.  The RENAME command can  be
  1098.   abbreviated REN.  REN prompts you for input.
  1099.  
  1100.   Examples:
  1101.  
  1102.   A>RENAME NEWFILE.BAS=OLDFILE.BAS
  1103.  
  1104.        The file OLDFILE.BAS changes to NEWFILE.BAS on drive A.
  1105.  
  1106.   RENAME Examples:
  1107.  
  1108.   A>RENAME
  1109.  
  1110.   The system prompts for the filespecs:
  1111.  
  1112.           Enter New Name:X.PRN
  1113.           Enter Old Name:Y.PRN
  1114.           Y      .PRN=X        .PRN
  1115.           A>
  1116.  
  1117.   File X.PRN is renamed to Y.PRN on drive A.
  1118.  
  1119.   B>REN A:PRINTS.NEW = PRINCE.NEW
  1120.  
  1121.        The file PRINCE.NEW on drive  A  changes  to  PRINTS.NEW  on
  1122.        drive A.
  1123.  
  1124.   RENAME Examples:
  1125.  
  1126.   A>RENAME S*.TEX=A*.TEX
  1127.  
  1128.        The  above  command   renames   all   the   files   matching
  1129.        A*.TEX to files with filenames S*.TEX.
  1130.  
  1131.   A>REN B:NEWLIST=B:OLDLIST
  1132.  
  1133.        The file OLDLIST changes to NEWLIST on drive B.   Since  the
  1134.        second  drive specifier, B:  is implied by the first one, it
  1135.        is unnecessary in this example.  The command line above  has
  1136.        the same effect as the following:
  1137.  
  1138.           A>REN B:NEWLIST=OLDLIST
  1139.                      or
  1140.           A>REN NEWLIST=B:OLDLIST
  1141.  
  1142. :SAVE
  1143.  
  1144.   Syntax:
  1145.  
  1146.        SAVE
  1147.  
  1148.   Explanation:
  1149.  
  1150.   SAVE copies the contents of memory to  a  file.  To   use   SAVE,
  1151.   first issue the SAVE command, then run your program which reads a
  1152.   file into memory.  Your  program exits to the SAVE utility  which
  1153.   prompts  you  for  a filespec to which it copies the  contents of
  1154.   memory, and  the beginning and ending address of the memory to be
  1155.   SAVEd.
  1156.  
  1157.   SAVE Example:
  1158.  
  1159.        A>SAVE
  1160.  
  1161.   Activates the SAVE utility.  Now enter the name  of  the  program
  1162.   which loads a file into memory.
  1163.  
  1164.        A>SID dump.com
  1165.  
  1166.   Next, execute the program.
  1167.  
  1168.        #g0
  1169.  
  1170.   When the program exits, SAVE intercepts the return to the  system
  1171.   and prompts the user for the filespec and the bounds of memory to
  1172.   be SAVEd.
  1173.  
  1174.        SAVE Ver 3.0
  1175.        Enter file (type RETURN to exit):dump2.com
  1176.  
  1177.   If file DUMP2.COM exists already, the system asks:
  1178.  
  1179.        Delete dump2.com? Y
  1180.  
  1181.   Then the system asks for the bounds of memory to be saved:
  1182.  
  1183.        Beginning hex address: 100
  1184.        Ending hex address: 400
  1185.  
  1186.   The contents of memory from 100H (Hexadecimal) to 400H is  copied
  1187.   to file DUMP2.COM.
  1188. :SET
  1189.  
  1190.   Syntax:
  1191.  
  1192.           SET [options]
  1193.           SET d: [options]
  1194.           SET filespec [options]
  1195.  
  1196.   Explanation:
  1197.  
  1198.   SET  initiates  password   protection   and   time  stamping   of
  1199.   files.  It  also  sets  the file and drive attributes Read-Write,
  1200.   Read-Only, DIR and SYS.  It  lets  you  label a disk and password
  1201.   protect  the  label.  To  enable  time  stamping  of  files,  you
  1202.   must  first  run INITDIR to format the disk directory.
  1203.  
  1204.   Using SET to label diskettes:
  1205.  
  1206.   Syntax:
  1207.  
  1208.           SET {d:} [NAME=labelname.typ]
  1209.           SET [PASSWORD=password]
  1210.           SET [PASSWORD=<cr>
  1211.  
  1212.   Examples:
  1213.  
  1214.   A>SET [NAME=DISK100]
  1215.  
  1216.        Labels the disk on the default drive as DISK100.
  1217.  
  1218.   A>SET [PASSWORD=SECRET]
  1219.  
  1220.        Assigns SECRET to the  disk  label.
  1221.  
  1222.   SET Examples:
  1223.  
  1224.   A>SET [PASSWORD=<cr>
  1225.  
  1226.        Nullifies the existing password.
  1227.  
  1228.   Passwords:
  1229.  
  1230.           SET [PROTECT=ON]
  1231.           SET [PROTECT=OFF]
  1232.           SET filespec [PASSWORD=password]
  1233.           SET filespec [PROTECT=READ]
  1234.           SET filespec [PROTECT=WRITE]
  1235.           SET filespec [PROTECT=DELETE]
  1236.           SET filespec [PROTECT=NONE]
  1237.           SET filespec [attribute-options]
  1238.  
  1239.   SET Modes:
  1240.  
  1241.               Password Protection Modes
  1242.  
  1243.   Mode                        Protection
  1244.  
  1245.   READ           The password  is  required  for  reading,  copying
  1246.                  writing, deleting or renaming the file.
  1247.  
  1248.   WRITE          The password is required for writing, deleting  or
  1249.                  renaming  the file.  You do not need a password to
  1250.                  read the file.
  1251.  
  1252.   DELETE         The password is  only  required  for  deleting  or
  1253.                  renaming  the file.  You do not need a password to
  1254.                  read or modify the file.
  1255.  
  1256.   NONE           No password exists for the file.   If  a  password
  1257.                  password  exists,  this  modifier  can  be used to
  1258.                  delete the password.
  1259.  
  1260.   SET Attributes:
  1261.  
  1262.   RO             sets the file attribute to Read-Only.
  1263.  
  1264.   RW             sets the file attribute to Read-Write.
  1265.  
  1266.   SYS            sets the file attribute to SYS.
  1267.  
  1268.   DIR            sets the file attribute to DIR.
  1269.  
  1270.   ARCHIVE=OFF    means  that  the  file  has  not  been  backed  up
  1271.                  (archived).
  1272.  
  1273.   ARCHIVE=ON     means that the file has been backed up (archived).
  1274.                  The  Archive  attribute can be turned on by SET or
  1275.                  by PIP when copying a group of files with the  PIP
  1276.                  [A]  option.  SHOW  and  DIR  display  the Archive
  1277.                  option.
  1278.  
  1279.   SET Attributes:
  1280.  
  1281.   F1=ON|OFF      turns on or off the user-definable file  attribute
  1282.                  F1.
  1283.  
  1284.   F2=ON|OFF      turns on or off the user-definable file  attribute
  1285.                  F2.
  1286.  
  1287.   F3=ON|OFF      turns on or off the user-definable file  attribute
  1288.                  F3.
  1289.  
  1290.   F4=ON|OFF      turns on or off the user-definable file  attribute
  1291.                  F4.
  1292.  
  1293.   SET Examples:
  1294.  
  1295.   SET [PROTECT=ON]
  1296.  
  1297.        Turns on password protection for all the files on the  disk.
  1298.        You  must  turn on password protection before you can assign
  1299.        passwords to files.
  1300.  
  1301.   SET [PROTECT=OFF]
  1302.  
  1303.        Disables password protection for the files on your disk.
  1304.  
  1305.   A>SET MYFILE.TEX [PASSWORD=MYFIL]
  1306.  
  1307.        MYFIL is the password assigned to file MYFILE.TEX.
  1308.  
  1309.   SET Examples:
  1310.  
  1311.   B>SET *.TEX [PASSWORD=SECRET, PROTECT=WRITE]
  1312.  
  1313.        Assigns the password SECRET to all the TEX files on drive B.
  1314.        Each  TEX  file  is  given  a  WRITE protect mode to prevent
  1315.        unauthorized editing.
  1316.  
  1317.   A>SET MYFILE.TEX [RO SYS]
  1318.  
  1319.        Sets MYFILE.TEX to Read-Only and SYStem.
  1320.  
  1321.   Default:
  1322.  
  1323.   A>SET [DEFAULT=dd]
  1324.  
  1325.        Instructs the system to use dd as a password if you  do  not
  1326.        enter a password for a password-protected file.
  1327.  
  1328.   SET Time-Stamps:
  1329.  
  1330.   Syntax:
  1331.  
  1332.           SET [CREATE=ON]
  1333.           SET [ACCESS=ON]
  1334.           SET [UPDATE=ON]
  1335.  
  1336.   Explanation:
  1337.  
  1338.   The above SET commands allow you to keep a  record  of  the  time
  1339.   and  date  of file creation and update, or of the last access and
  1340.   update of your files.
  1341.  
  1342.   Time Stamp Options:
  1343.  
  1344.   [CREATE=ON]    turns on CREATE time stamps on  the  disk  in  the
  1345.                  default   or   specified   drive.  To  record  the
  1346.                  creation time of a file, the CREATE option must be
  1347.                  turned on before the file is created.
  1348.  
  1349.   [ACCESS=ON]    turns on ACCESS time stamps on  the  disk  in  the
  1350.                  default  or  specified  drive.  ACCESS  and CREATE
  1351.                  options are mutually exclusive; only one can be in
  1352.                  effect  at a time.  If you turn on the ACCESS time
  1353.                  stamp on  a  disk  that   previously   had  CREATE
  1354.                  time     stamp,   the   CREATE   time   stamp   is
  1355.                  automatically turned off.
  1356.  
  1357.   [UPDATE=ON]    turns on UPDATE time stamps on  the  disk  in  the
  1358.                  default  or  specified  drive.  UPDATE time stamps
  1359.                  record the time the file was last modified.
  1360.  
  1361.   Time Stamp Examples:
  1362.  
  1363.           A>SET [ACCESS=ON]
  1364.           A>SET [CREATE=ON,UPDATE=ON]
  1365.  
  1366.   SETting Drives:
  1367.  
  1368.   Syntax:
  1369.  
  1370.           SET {d:} [RO]
  1371.           SET {d:} [RW]
  1372.  
  1373.  
  1374.   Example:
  1375.  
  1376.   A>SET B: [RO]
  1377.  
  1378.        Sets drive B to Read-Only.
  1379. :SETDEF
  1380.  
  1381.   Syntax:
  1382.  
  1383.           SETDEF { d: {,d: {,d: {,d:}}}} {[ TEMPORARY = d: ] |
  1384.                                           [ ORDER = (typ {,typ}) ]}
  1385.           SETDEF [DISPLAY | NO DISPLAY]
  1386.  
  1387.           SETDEF [PAGE | NOPAGE]
  1388.  
  1389.   Explanation:
  1390.  
  1391.   SETDEF allows the user to display or define  up  to  four  drives
  1392.   for  the program search order, the drive for temporary files, and
  1393.   the file type search order.   The   SETDEF   definitions   affect
  1394.   only   the   loading   of programs  and/or  execution  of  SUBMIT
  1395.   (SUB) files.  SETDEF turns on/off the system Display and  Console
  1396.   Page  modes. When   on, the system displays the location and name
  1397.   of programs loaded or SUBmit  files  executed,  and  stops  after
  1398.   displaying one full console screen of information.
  1399.  
  1400.   SETDEF Examples:
  1401.  
  1402.   A>SETDEF
  1403.  
  1404.        Displays current SETDEF parameters.
  1405.  
  1406.   A>SETDEF [TEMPORARY=C:]
  1407.  
  1408.        Sets disk drive C as the drive  to  be  used  for  temporary
  1409.        files.
  1410.  
  1411.   A>SETDEF C:,*
  1412.  
  1413.        Tells the system to search for a program on drive  C,  then,
  1414.        if not found, search for it on the default drive.
  1415.  
  1416.   A>SETDEF [ORDER=(SUB,COM)]
  1417.  
  1418.        Instructs the system to search for a SUB  file  to  execute.
  1419.        If no SUB file is found, search for a COM file.
  1420.  
  1421.   SETDEF Examples:
  1422.  
  1423.   A>SETDEF [DISPLAY]
  1424.  
  1425.        Turns on the system display mode.   Henceforth,  the  system
  1426.        displays  the name and location of programs loaded or submit
  1427.        files executed.
  1428.  
  1429.   A>SETDEF [NO DISPLAY] Turns off the system Display mode.
  1430.  
  1431. :SHOW
  1432.  
  1433.   Syntax:
  1434.  
  1435.        SHOW {d:}{[SPACE |LABEL |USERS |DIR |DRIVE]}
  1436.  
  1437.   Explanation:
  1438.  
  1439.   The SHOW command displays the following disk drive information:
  1440.  
  1441.      Access mode and the amount of free disk space
  1442.      Disk label
  1443.      Current user number and
  1444.      Number of files for each user number on the disk
  1445.      Number of free directory entries for the disk
  1446.      Drive characteristics
  1447.  
  1448.   SHOW Examples:
  1449.  
  1450.   A>SHOW
  1451.  
  1452.        A>SHOW [SPACE]
  1453.  
  1454.        Instructs the system to display access mode  and  amount  of
  1455.        space left on logged-in drives.
  1456.  
  1457.   A>SHOW B:
  1458.  
  1459.        Show access mode for drive B and amount  of  space  left  on
  1460.        drive B.
  1461.  
  1462.   A>SHOW B:[LABEL]
  1463.  
  1464.        Displays label information for drive B.
  1465.  
  1466.   SHOW Examples:
  1467.  
  1468.   A>SHOW [USERS]
  1469.  
  1470.        Displays the current user number and all the users on  drive
  1471.        A and the corresponding number of files assigned to them.
  1472.  
  1473.   A>SHOW C:[DIR]
  1474.  
  1475.        Displays the number of free directory entries on drive C.
  1476.  
  1477.   A>SHOW [DRIVE]
  1478.  
  1479.        Displays the drive characteristics of drive A.
  1480.  
  1481. :SUBMIT
  1482.  
  1483.   Syntax:
  1484.  
  1485.        SUBMIT {filespec} {argument} ... {argument}
  1486.  
  1487.   Explanation:
  1488.  
  1489.   The SUBMIT command lets  you   execute   a   group   (batch)   of
  1490.   commands from a SUBmit file (a file with filetype of SUB).
  1491.  
  1492.   Subfile:
  1493.  
  1494.   The SUB file can contain the following types of lines:
  1495.  
  1496.       Any valid CP/M 3 command
  1497.       Any valid CP/M 3 command with SUBMIT parameters ($0-$9)
  1498.       Any data input line
  1499.       Any program input line with parameters ($0 to $9)
  1500.  
  1501.   The command line cannot exceed 135 characters.
  1502.  
  1503.   The following lines illustrate the variety of lines which may
  1504.   be entered in a SUB file:
  1505.  
  1506.           DIR
  1507.           DIR *.BAK
  1508.           MAC $1 $$$4
  1509.           PIP LST:=$1.PRN[T$2 $3 $5]
  1510.           DIR *.ASM
  1511.           PIP
  1512.           <B:=*.ASM
  1513.           <CON:=DUMP.ASM
  1514.           <
  1515.           DIR B:
  1516.  
  1517.   SUBMIT Execution:
  1518.  
  1519.   Syntax:
  1520.  
  1521.           SUBMIT
  1522.           SUBMIT filespec
  1523.           SUBMIT filespec argument ... argument
  1524.  
  1525.   Examples:
  1526.  
  1527.           A>SUBMIT
  1528.           A>SUBMIT SUBA
  1529.           A>SUBMIT AA ZZ SZ
  1530.           A>SUBMIT B:START DIR E:
  1531.  
  1532.   PROFILE.SUB
  1533.  
  1534.   Everytime you power up or reset your computer, CP/M 3 looks for a
  1535.   special SUBmit file named PROFILE.SUB to execute.  If it does not
  1536.   exist, CP/M 3 resumes normal operation.  If the PROFILE.SUB  file
  1537.   exists,  the system executes the commands in the file.  This file
  1538.   is convenient to use if you regularly execute a set  of  commands
  1539.   before you do your regular session on the computer.
  1540.  
  1541. :TYPE
  1542.  
  1543.   Syntax:
  1544.  
  1545.           TYPE {filespec {[ PAGE | NOPAGE ]}}
  1546.  
  1547.   Explanation:
  1548.  
  1549.   The  TYPE  command   displays   the   contents   of   an    ASCII
  1550.   character file on your screen.
  1551.  
  1552.   [PAGE]    Causes the console listing to  be  displayed  in  paged
  1553.             mode;   i.e.,  stop automatically after listing n lines
  1554.             of text, where n normally  defaults  to  24  lines  per
  1555.             page.
  1556.  
  1557.   [NOPAGE]  Turns off Console Page Mode and continuously displays a
  1558.             typed file on the screen.
  1559.  
  1560.   TYPE Examples:
  1561.  
  1562.   A>TYPE MYPROG.PLI
  1563.  
  1564.        Displays the contents of the file MYPROG.PLI on your screen.
  1565.  
  1566.   A>TYPE B:THISFILE [PAGE]
  1567.  
  1568.        Displays the contents  of the file THISFILE from drive B  on
  1569.        your screen twenty four lines at a time.
  1570.  
  1571. :USER
  1572.  
  1573.   Syntax:
  1574.  
  1575.           USER {number}
  1576.  
  1577.   Explanation:
  1578.  
  1579.   The USER command sets  the  current  user   number.    The   disk
  1580.   directory  can  be  divided  into  distinct groups according to a
  1581.   "User Number."  User numbers range from 0 through 15.
  1582.  
  1583.   USER Examples:
  1584.  
  1585.   A>USER
  1586.   Enter User#:5
  1587.   5A>
  1588.  
  1589.        The current user number is now 5 on drive A.
  1590.  
  1591.   A>USER 3
  1592.   3A>
  1593.  
  1594.        This command changes the current User Number to 3.
  1595.