home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / statis-1.24.lha / Statis-1.24 / statis.doc < prev    next >
Encoding:
Text File  |  1994-03-29  |  5.0 KB  |  151 lines
  1.  
  2.                       STATIS : A Status Improvement
  3.                       =============================
  4.  
  5.     STATIS V1.24, © Dominique Lorre, 1994 All rights reserved.
  6.  
  7.     This software is in the public domain. You can distribute it freely
  8.     as long as the copyright notice and documentation remains intact.
  9.  
  10. Format:     STATIS [<process>] [FULL] [TCB] [CLI|ALL] [RC] [EXT|EXTENDED] 
  11.             [CIO] [COM|COMMAND <command>] [ARGS|ARGUMENTS <arguments>]
  12. Template:   PROCESS/N,FULL/S,TCB/S,CLI=ALL/S,RC/S,EXT=EXTENDED/S,CIO/S,
  13.             COM=COMMAND/K,ARGS=ARGUMENTS/K:
  14. Purpose:    As the C: command STATUS, to list information about processes
  15.  
  16.  
  17. History:    While I frequently use the STATUS command, I had a great need
  18.             of knowing exactly what arguments have been passed to each
  19.             shell process, specially when I compile more than one program
  20.             at a time, creating many processes of the same name.
  21.             Thus, I have wrote a little command to fix the problem.
  22.             After that, I have thought that it could be useful to the Amiga
  23.             community and decided to release it in the public domain.
  24.  
  25.  
  26. What does STATIS ?
  27.  
  28.             STATIS reacts much like the command STATUS (as far as I
  29.             know ;-) ) but have five great improvements :
  30.  
  31.  
  32.             - STATIS tells you if a process have been run in the background
  33.             by printing the # flag in front of the process number :
  34.  
  35.             STATIS
  36.     PROCESS COMMAND
  37.         1   At prompt
  38.     #   2   ConClip
  39.     #   3   Workbench
  40.         4   At prompt
  41.     #   5   list
  42.     #   6   STATIS
  43.  
  44.             - STATIS displays the result codes of a process if you specify
  45.             the RC option :
  46.             STATIS RC
  47.     PROCESS COMMAND    RC RES2
  48.         1   At prompt   0   0
  49.     #   2   ConClip     0   0
  50.     #   3   Workbench   0   0
  51.         4   At prompt  20 205
  52.     #   5   list        0   0
  53.     #   6   STATIS      0   0
  54.  
  55.             Here, you can see that the process 4 failed because the file was
  56.             not found.
  57.  
  58.             - STATIS prints the arguments of the command. For example
  59.             STATIS EXT could give the following result :
  60.  
  61.     PROCESS COMMAND    ARGUMENTS
  62.         1   At prompt
  63.     #   2   ConClip
  64.     #   3   Workbench
  65.         4   At prompt
  66.     #   5   list       sys: all LFORMAT "Echo %S%S"
  67.     #   6   STATIS     EXT
  68.  
  69.             - STATIS allows search of a command by NAME, by ARGUMENTS, by
  70.             both NAME and ARGUMENTS and also supports PATTERN MATCHING !
  71.             For example :
  72.             STATIS COM=S#?
  73.             would give :
  74.      6
  75.  
  76.             STATIS ARG=% ; this means which processes do not have any
  77.             argument ?
  78.              would give :
  79.      1
  80.      2
  81.      3
  82.      4
  83.      6
  84.             STATIS COM=% ; which processes do not have any command loaded ?
  85.             would give:
  86.      4
  87.             STATIS FULL COM=STATIS ARG=FOO
  88.             would give no answer because there is no STATIS FOO command
  89.             actually loaded.
  90.  
  91.             If the ARG or COM options find a command, then STATIS will
  92.             return with a WARN.
  93.  
  94.             - STATIS search for the CURRENT IO of a command with the CIO
  95.             option:
  96.             STATIS CIO
  97.  
  98.     PROCESS COMMAND    INPUT      OUTPUT
  99.         1   At prompt  CON:       CON:
  100.     #   2   ConClip    NIL:       NIL:
  101.     #   3   Workbench  NIL:       NIL:
  102.         4   At prompt  CON:       CON:
  103.     #   5   list       NIL:       NIL:
  104.     #   6   STATIS     NIL:       Ram Disk:AZTempResult199C53
  105.  
  106.             which makes you find a lot of things ! (thank you Jean-Michel)
  107.  
  108.             The FULL option is very complete and can be a little confusing in
  109.             case of very long commands and/or redirections :
  110.  
  111.     STATIS FULL
  112.     PROCESS STACK GVT PRI COMMAND    RC RES2 ARGUMENTS  INPUT      OUTPUT
  113.         1   20000 150   0 At prompt   0   0             CON:       CON:
  114.     #   2    4000 150   0 ConClip     0   0             NIL:       NIL:
  115.     #   3    6000 150   1 Workbench   0   0             NIL:       NIL:
  116.         4   20000 150   0 At prompt  20 205             CON:       CON:
  117.     #   5   20000 150   0 list        0   0  sys: all LFORMAT "Echo %S%S" NIL:       NIL:
  118.     #   6    4096 150   0 STATIS      0   0  FULL       NIL:       Ram Disk:AZTempResult199C53
  119.  
  120.             STATIS requires the dos.library of version 37 or greater (V2.04).
  121.             If not found, the program would exit with the FAIL code set.
  122.  
  123. KNOWN BUGS
  124.             Sometimes, if STATIS is called just when a command is being
  125.             unloaded, some trash can appear.
  126.  
  127.             The length of the strings is limited to 80 characters.
  128.             Bigger strings might produce unexpected results.
  129. WARNING
  130.             The results codes are those of the preceding command only.
  131.             If a command display some codes, it doesn't mean that the
  132.             command has failed but that the PRECEDING one has failed.
  133.  
  134. CONCLUSION
  135.             You can send any question, commentary, suggestions or flames at :
  136.  
  137.             Dominique Lorre, Bois Jonquié 84240 La Tour d'Aigues, FRANCE
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.