Google
 

Trailing-Edge - PDP-10 Archives - BB-FI82B-DD_1989 - 2,5/crscpy.hlp
There are 5 other files named crscpy.hlp in the archive. Click here to see a list.
Commands to CRSCPY are of the general form:

     COMMAND argument

and  are  of  three  types,  Action,  Status  setting,   and   Report,
Disposition or Move selection.


1. Action commands

The action commands are:

CLEAR filespec          Mark  the  specified  file  as   having   been
                        processed  so  that  MONBTS  can  dump  on  it
                        without operator intervention.

COPY filespec=filespec  Copy input filespec to output filespec, make a
                        log entry, and clear the unprocessed dump bit.

DISPOSTION filespec     Give a one line disposition  of  the  crash(s)
                        specified  by  filespec  after  the  crash  is
                        analyzed.   Note  that  filespec  is  the  one
                        stored in CRASH.SYS by the COPY command.  Both
                        the filename and extension may  be  wildcarded
                        and  a  device  of  DSK:,  ALL:, or XPN:  will
                        match any entry.  It is much more efficient to
                        dispose   using   a   command   of   the  form
                        DISPOSITION/SEQUENCE:nn  since  the   sequence
                        number  allows  CRSCPY  to index directly into
                        CRASH.SYS.

MOVE filespec=filespec  Move the crash specified by the input filespec
                        to the output filespec and update the entry in
                        CRASH.SYS to reflect the new location  of  the
                        crash  file.   Note that the input filespec is
                        the  one  stored  in  CRASH.SYS  by  the  COPY
                        command.  The filename may be wildcarded and a
                        device of DSK:, ALL:, or XPN:  will match  any
                        entry.   It  is  much  more  efficient to move
                        crashes using  a  command  of  the  form  MOVE
                        filespec=filespec/SEQUENCE:nn:mm   since   the
                        sequence  number  allows   CRSCPY   to   index
                        directly into CRASH.SYS.  Note that if none of
                        [NO]UNDISPOSED, [NO]INACTIVE, or [NO]ACTIVE is
                        specified,  the  default  for  this command is
                        /NOINACTIVE.  CRSCPY  preserves  the  creation
                        date/time, the access date, the data mode, the
                        protection  (if  no  /PROTECTION  switch   was
                        specified), the version number and the spooled
                        name of the input file when it moves it.

PURGE FILE              Delete  the  contents  of  SYS:CRASH.SYS   but
                        retain  the  header so that the crash sequence
                        numbers do not start at 1.  The  use  of  this
                        command  is  prefered  to  simply deleting the
                        file for this reason.  The argument "FILE"  is
                        required to insure that the user does not type
                        the command by accident.

REPORT filespec         Generate a report on the specified file of the
                        contents of SYS:CRASH.SYS.

The action commands cause something to happen as opposed to setting  a
flag  or  value  for later processing.  All action commands except the
DISPOSITION command will fully  default  the  arguments  if  they  are
omitted.  Defaults are as follows:

     CLEAR SDL:CRASH.EXE[1,4]
     COPY STR:sssnnn.EXE[10,1]=SDL:CRASH.EXE[1,4]
     MOVE DSK:inputfilename.EXE[10,1]=DSK:*.EXE[10,1]
     REPORT TTY:CRASH.LOG[-] or DSK:CRASH.LOG[-]

where SDL:  is all structures in the system dump list,  STR:   is  the
structure  with  the  most  free  space  selected  from  the STRUCTURE
command, sss is the STOPCD name, and nnn is a sequence number obtained
from  the  header of SYS:CRASH.SYS and incremented each time a dump is
copied.

The default output file for the REPORT command is the terminal only if
no  part of a file specification is typed (including per-file switches
such as /PROTECTION).  Otherwise, it will default to DSK:CRASH.LOG.


2. Status setting commands

The status setting commands are:

INFORM name             Select  destination  of  all  output.    Legal
                        values  of name are USER and OPR.  USER is the
                        default if CRSCPY is run manually, OPR is  the
                        default if CRSCPY is run by the system.

STRUCTURE <str:blk,str:blk,...>,<str:blk,str:blk,...>,...

                        Select the structures  to  which  CRSCPY  will
                        copy   crashes   if  no  output  structure  is
                        specified in the COPY command or if it is  run
                        by the system.  str is the name of a structure
                        and blk is the number  of  blocks  which  must
                        remain  on  the  structure  after  the copy in
                        order for CRSCPY  to  copy  a  crash  to  that
                        structure.     The    angle   brackets   group
                        structures into  sets.   CRSCPY  will  copy  a
                        crash  to  the  structure in a set which meets
                        the block restrictions and  will  contain  the
                        most  space  after the copy.  If no structures
                        in a set meet the restrictions, CRSCPY goes on
                        to the next set.  This command usually appears
                        in SWITCH.INI with a line of the form:

     CRSCPY/STRUCTURE:(<str:blk,str:blk,...>,<str:blk,...>,...)

The status selection commands simply set flags or values for use  when
one of the action commands is typed.


3. Report, disposition, or move selection commands/switches

The report, disposition, or move selection commands are:

ACTIVE                  Process only those  crashes  which  have  been
                        disposed, but not deleted.  NOACTIVE restricts
                        the command to those crashes which have either
                        not  been  disposed,  or those which have been
                        both disposed and deleted.

BEGIN date:time         Process only those crashes which  were  dumped
                        after the specified date and time.

CBEGIN date:time        Process only those crashes which  were  copied
                        after the specified date and time.

CEND date:time          Process only those crashes which  were  copied
                        before the specified date and time.

DELETE                  Delete the crash file  when  it  is  disposed.
                        NODELETE  is the complement and the default if
                        no value is specified.

DETAIL value            Generate reports with  more  detail  than  the
                        default  report.   Legal  values  are  ALL and
                        DISPOSITION.

END date:time           Process only those crashes which  were  dumped
                        before the specified date and time.

HEADER                  Give a header  line  on  the  REPORT  command.
                        NOHEADER  is  the  complement  and  causes the
                        header to be suppressed.

INACTIVE                Process only those crash dumps which have been
                        deleted.   NOINACTIVE restricts the command to
                        the crashes which haven't been deleted yet.

MONVER n                Process only those crashes which were  running
                        the specified monitor version.

PRIMETIME               Process  only  those  crashes  which  occurred
                        during  prime  time (weekdays between 0800 and
                        1700).

SEQUENCE m:n            Process  only  those  crashes  with   sequence
                        numbers  between  m and n, inclusive.  If only
                        one number is specified it is taken to be both
                        the lower and upper bounds.

STOPCD xxx              Process  only  those  crashes  which  occurred
                        because  of  the  specified  STOPCD.   xxx may
                        contain the wildcard characters "?" or "*".

SUMMARY value           Produce a summary at the  end  of  the  report
                        listing   according   to  the  given  keyword.
                        keywords are ALL to include both a summary  by
                        stopcode name and totals, STOPCODES to include
                        just the stopcode name summary, and TOTALS  to
                        include  just  the total number of undisposed,
                        active, and reload stopcodes.

UNDISPOSED              Process only those crashes which have not  yet
                        been  disposed.   NOUNDISPOSED  restricts  the
                        command to those crashes  which  have  already
                        been disposed.

The report, disposition, or move selection  commands  simply  restrict
the  scope  of  which  entries  in  SYS:CRASH.SYS are processed by the
REPORT, DISPOSTION, or MOVE commands.  They  have  no  effect  on  any
action command other than REPORT, DISPOSITION, or MOVE.  Any report or
disposition selection command may also be given as  a  switch  on  the
REPORT,  DISPOSITION,  or  MOVE commands.  If this is done, the switch
only applies to this command and any sticky  defaults  specified  will
apply to the next command.


Any non-action command may be specified in SWITCH.INI with a  line  of
the form:

     CRSCPY/COMMAND:argument


For more information on CRSCPY commands  and  its  internal  workings,
refer to CRSCPY.MEM and CRSCPY.DOC.