Received: from j.cc.purdue.edu by VM.CC.PURDUE.EDU ; Fri, 10 Jun 88 08:03:09 EST
Received: by j.cc.purdue.edu (5.54/1.14)
    id AA18698; Fri, 10 Jun 88 08:00:53 EST
Date: Fri, 10 Jun 88 08:00:53 EST
From: ain@j.cc.purdue.edu (Patrick White)
Message-Id: <8806101300.AA18698@j.cc.purdue.edu>
To: fys-ma@fintuvm.BITNET
Subject: comp.binaries.amiga, comp.sources.amiga:
 sources/amiga/volume5/eps-stp.d.sh binaries/amiga/volume6/eps-stp.d.sh
 
Newsgroups: comp.binaries.amiga, comp.sources.amiga
Subject: eps & stp (docs)
Keywords: eps, stp, process status, set task priority, docs
Approved: ain@j.cc.purdue.edu    (Patrick White)
 
Program Name:    eps & stp  (docs)
Submitted by:    jeff@novavax  (Jeffrey Bailey)
Summary:    eps -- extended process status, stp -- set task priority
Poster Boy:    Patrick White    (ain@j.cc.purdue.edu)
Archive Name:    sources/amiga/volume5/eps-stp.d.sh.Z
 binaries/amiga/volume6/eps-stp.d.sh.Z
Tested but not compiled.
 
NOTES:
   This contains two relates programs -- eps which prints out what processes
are running and their priorties, and stp which sets the task priorities.
   I redid the shar to separate docs, sources, and binaries.
 
 
-- Pat White   (co-moderator comp.sources/binaries.amiga)
ARPA/UUCP: j.cc.purdue.edu!ain  BITNET: PATWHITE@PURCCVM  PHONE: (317) 743-8421
U.S.  Mail:  320 Brown St. apt. 406,    West Lafayette, IN 47906
[How do you get to heaven?   Go to Pluto and hang a left.]
 
========================================
 
#    This is a shell archive.
#    Remove everything above and including the cut line.
#    Then run the rest of the file through sh.
#----cut here-----cut here-----cut here-----cut here----#
#!/bin/sh
# shar:    Shell Archiver
#    Run the following text with /bin/sh to create:
#    eps.man
#    stp.man
# This archive created: Fri Jun  3 12:13:33 1988
# By:    Patrick White (PUCC Land, USA)
echo shar: extracting eps.man '(2640 characters)'
cat << \SHAR_EOF > eps.man
NAME
 
    eps - Enhanced ps utility
 
SYNTAX
 
    eps
 
DESCRIPTION
 
    This program is an enhanced form of the ps utility.  It should be
    placed in the C: directory on your workbench disk.  It can only
    be run from the CLI.  When run, it produces output similar to
    the following:
 
Task Name        Pri  St  Address  P CLI I Command Name     Current Dir
---------------- ---- --- -------- - --- - ---------------- ----------------
Initial CLI         0 RUN   c04fd0 P   1 I c:eps            ASDG-RAM:
Workbench           1 WAI   c0f1a0 P   0 I
Background CLI     -1 WAI   c27a30 P   3 B c:cron           Workbench 1.2:
RAM                 0 WAI   c1e620 P
Background CLI      5 WAI   c23250 P   2 B c:loadavg        Workbench 1.2:
File System        10 WAI   c05dc0 P
VD0                 5 WAI   c2a028 P
input.device       20 WAI   c02672 T
trackdisk.device    5 WAI   c047a6 T
trackdisk.device    5 WAI   c01446 T
File System        10 WAI   c00a98 P
CON                 5 WAI   c06a90 P
 
    The following is a brief explanation of each field:
 
    TASK NAME -  This is the ASCII name found in the task structure.
 
    PRI -  This is the task's current priority printed in decimal.
 
    ST -  This is the task's current state.  All states are abbreviated
        to three letters.  For example, RUN means this is the currently
        executing task, RDY means that this task is ready for the CPU,
        WAI means this task is currently in a wait state, etc.
 
    ADDRESS -  This is the address of the task's TCB (Task Control Block)
        printed in hexadecimal.
 
    P -  This indicates whether the task is a task, or a process.  'T'
        indicates a task, 'P' indicates a process.
 
    CLI -  If the process is also a CLI process, the CLI task array number
        is printed in this field.
 
    I -  This field indicates whether the CLI process was started as
        an interactive 'I', or a background 'B' process.  Background
        processes are the result of the RUN command.
 
    COMMAND NAME -  This is the name of the command as DOS sees it in
        the filing system.
 
    CURRENT DIRECTORY -  This is the current working directory of the
        CLI process.
 
SEE ALSO
 
    stp
 
BUGS
 
    The TASK NAME, COMMAND NAME, and CURRENT DIRECTORY are
    truncated to a length of 16 characters each, for formatting
    purposes.
 
AUTHOR
 
    Jeffrey Bailey
    Programmer/Analyst
    Nova University
    Ft. Lauderdale, FL
    UUCP:...{ihnp4!codas, ucf-cs, allegra}!novavax!jeff
    UUCP:...{ihnp4!codas, ucf-cs, allegra}!novavax!regulus!jeff  (Private)
SHAR_EOF
if test 2640 -ne "`wc -c eps.man`"
then
echo shar: error transmitting eps.man '(should have been 2640 characters)'
fi
echo shar: extracting stp.man '(1024 characters)'
cat << \SHAR_EOF > stp.man
NAME
 
    stp - Set Task Priority
 
SYNTAX
 
    stp <hexadecimal TCB address> <decimal priority>
 
DESCRIPTION
 
    This command allows the dynamic adjustment of a task's priority for
    any task currently in the system.  A hexadecimal Task Control
    Block (TCB) address must be specified.  This address is checked
    for validity.  A decimal priority in the range of -128 to 127 must
    also be specified.  This is also checked for validity.
 
    The TCB is specified in hexadecimal, and the priority in decimal,
    because, by convention, this is the format used by most 'ps'
    type utilities.
 
SEE ALSO
 
    eps
 
BUGS
 
    This command allows the priority of ANY task in the system to be
    arbitrarily changed.  Changing system tasks' priorities is, in
    general, a BAD idea.
 
AUTHOR
 
    Jeffrey Bailey
    Programmer/Analyst
    Nova University
    Ft. Lauderdale, FL  33324
    UUCP:...{ihnp4!codas, ucf-cs, allegra}!novavax!jeff
    UUCP:...{ihnp4!codas, ucf-cs, allegra}!novavax!regulus!jeff  (Private)
SHAR_EOF
if test 1024 -ne "`wc -c stp.man`"
then
echo shar: error transmitting stp.man '(should have been 1024 characters)'
fi
#    End of shell archive
exit 0
