Google
 

Trailing-Edge - PDP-10 Archives - bb-d549g-sb - crscpy.doc
There are 3 other files named crscpy.doc in the archive. Click here to see a list.


CRSCPY.DOC -- Program to copy crashes dumped by the monitor, V1(24)
June 1980






























COPYRIGHT (C) 1979,1980 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.


THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND  COPIED
ONLY  IN  ACCORDANCE  WITH  THE  TERMS  OF  SUCH  LICENSE AND WITH THE
INCLUSION OF THE ABOVE COPYRIGHT NOTICE.  THIS SOFTWARE OR  ANY  OTHER
COPIES  THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY
OTHER PERSON.  NO TITLE TO AND OWNERSHIP OF  THE  SOFTWARE  IS  HEREBY
TRANSFERRED.

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE  WITHOUT  NOTICE
AND  SHOULD  NOT  BE  CONSTRUED  AS  A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR  RELIABILITY  OF  ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
CRSCPY.DOC                                                      Page 2


CRSCPY.DOC -- Program to copy crashes dumped by the monitor, V1(24)
June 1980



1.0  SUMMARY

The 7.01 monitor includes a fast monitor resident  bootstrap  (MONBTS)
which  has  the  capability  of  very fast dump/reload and continuable
STOPCD dump.   In  addition,  the  monitor  provides  a  mechanism  to
automatically  start  up  a  program  which will copy the dump(s) just
taken.  CRSCPY is an example of a program which can be run to do this.
CRSCPY,  as  described  in this .DOC and the associated .MEM file is a
prototype that you may use to help you in  understanding  the  monitor
interface  and  the  tasks  that  must be performed by such a program.
CRSCPY is being supplied to serve as a basis for the program  you  may
wish  to  write  to  tailor  the  copy procedure to your installation.
Every installation will have varying needs and procedures with  regard
to   crash   copying,  and  may  indeed  already  have  some  form  of
semi-automatic procedure  to  copy  crashes.   Therefore,  it  is  not
expected that CRSCPY will be used without change by each installation.
The Digital-supplied prototype supports automatic copy of crashes when
invoked  by  the  monitor,  manual  copy  of  crashes  when  run by an
operator, and a log and report feature of the crashes that it  copied.
See  CRSCPY.MEM and CRSCPY.HLP for more detailed information about the
operation of the program and the interface with the monitor.

CRSCPY has been tested on KI, KL, and KS  processors  under  the  7.01
version of the monitor.  It will work correctly under earlier versions
of  the  monitor  when  run  by  an  operator  but  will  not  be  run
automatically to copy dumps.



2.0  EXTERNAL CHANGES

None



3.0  KNOWN BUGS AND DEFICIENCIES

None.



4.0  INSTALLATION INSTRUCTIONS

CRSCPY searches JOBDAT, MACTEN, SCNMAC, and UUOSYM and loads with SCAN
and HELPER.



5.0  INTERNAL CHANGES
CRSCPY.DOC                                                      Page 3


Edit #

1      If the date/time of the dump is zero, print Unknown instead  of
       junk.

2      If the STOPCD  name  extracted  from  the  dump  is  not  three
       alphanumeric  characters,  use  SER.   This  keeps  the  output
       filename from being junk.

3      Add the CBEGIN and CEND commands to allow the user to  restrict
       the report to crashes copied (as opposed to dumped) between the
       specified times.

4      Add a block to each entry containing  the  disposition  of  the
       crash.    add  the  disposition  command  to  allow  a  systems
       programmer to give a disposition for a crash.  This edit starts
       file version 2 of CRASH.SYS.

5      Allow the report restriction  switches  to  be  placed  on  the
       report command line in addition to being typed as commands.

6      Change the syntax of the /STRUCTURE command to allow the system
       administrator  to  specify one or more sets of structures to be
       load balanced across.  Also allow the minimum acceptable number
       of  blocks  remaining  on  a structure to be specified for each
       structure.

7      Change the report format to print the uptime immediately  after
       the crash date/time instead of after the copy date/time.

10     Add the /PRIMETIME switch  to  restrict  the  report  to  those
       crashes which occured during prime time (0800-1700).

11     Add the PURGE FILE command which will delete SYS:CRASH.SYS  but
       maintain  the header so that the sequence numbers will continue
       from the current value.

12     Add the /UNDISPOSED switch to  only  report  on  those  crashes
       which have not been disposed.

13     Fix an off-by-one bug in /UNDISPOSED processing which caused to
       to flag some disposed crashes as undisposed.

14     Read the .EXE directory of the crash being copied and only copy
       the  number  of  blocks  specified.  This saves disk space when
       copying crashes dumped onto CRASH.EXE's which are  bigger  that
       the amount of memory actually dumped.

15     Add the [NO]DELETE command to allow  the  user  to  delete  the
       crash file when it is disposed.

16     Check for -1 in word 30 of the crash and call the  output  file
       SERnnn if it is.

17     If the symbol DFTPPN is set to a  PPN,  don't  clear  JACCT  if
CRSCPY.DOC                                                      Page 4


       FILDAE  is  not  running  and CRSCPY is running under that PPN.
       This is for field test sites which do not run  FILDAE  so  that
       DEC can update CRASH.SYS.

20     Edit 17 wasn't  sufficient  for  the  REPORT  command.   Add  a
       missing FO.PRV in OPNSYB.

21     Add  the  /[NO]HEADER  switch/command  to  enable/disable   the
       printing of the headers on the REPORT command.  The headers are
       a lose on a slow terminal.  Default is still /HEADER.

22     Change the /SEQUENCE  switch  to  allow  a  range  of  sequence
       numbers.  The new syntax is /SEQUENCE:m:n.

23     Change the syntax of the  DISPOSITION  command  to  allow  more
       flexibility  in the disposition of crashes.  The new syntax is:
       DISPOSITION filespec/switches, where  filespec  is  a  filespec
       that  appears  in  CRASH.SYS and switches are the switches that
       can be specified on the REPORT command.  this  means  that  the
       old syntax of DISPOSITION nn is now DISPOSITION/SEQUENCE:nn.

24     Memorize switches read from SWITCH.INI as sticky  defaults  for
       typed commands.



6.0  SUGGESTIONS

None.



[End of CRSCPY.DOC]