Trailing-Edge
-
PDP-10 Archives
-
k20v7c
-
subsys/notify.spe
There are 9 other files named notify.spe in the archive. Click here to see a list.
@@FILE-SPEC
! The following file spec can be modified to specify a specific device
! and directory (or you can even change its name). Both NOTIFY and
! SPEAR/COMPUTE use this file spec.
NOTIFY.SYS ! Change according to local preference
@@LOG-LINE
###################### -- ######################
@@CONTRACT-LINE
###################: ##
@@LOG-HEADER
reported accepted
@@CONTRACT-HEADER
Effective date: ##
Expiration date: ##
@@BLANK-TO
###################### -- ********
@@BLANK-FROM
********* -- ######################
@@GUTS_SHORT
System uptime = 1.0 - ( chargeable downtime / usage cycle )
%%%%%%%%%%% % = 1.0 - ( ## / ## )
@@FINAL-STATS
Total chargeable downtime (hh:mm:ss) -- ##:##:##
@@NOTIFY_HELP
The NOTIFY program provides a human interface with a portion of the
system event data base used by SPEAR. Currently, this portion consists
of an outage log and a contract coverage file, both of which are
contained in NOTIFY.SYS.
You use this program to give SPEAR your perception of a system outage
and to record your contract coverage. This information is used by the
COMPUTE function of SPEAR to produce "System uptime".
At this, the main NOTIFY prompt, you can type:
1. ? to list the NOTIFY commands.
2. the name of the command that you want to execute.
3. /HELP for an explanation of switches.
4. @HELP for information about response streams and indirect files.
5. EXIT to exit NOTIFY and return to the operating system.
@@DISPLAY_HELP
The DISPLAY command will display a portion of the data base on any output
device. This prompt is waiting for you to indicate what kind of data
should be displayed. Later you will be asked to specify a time-range.
1. LOG -- to display all or a portion of the outage log.
2. CONTRACT -- to display all or a subset of the contract file.
@@OUTPUT_TO
At this prompt Notify is waiting for you to specify a destination for
the output file. You can:
1. Press the RETURN key to select the default file specification,
which is TTY:
2. Enter your own unique file name. (e.g., DSK:NOT.TXT. The standard
file specification format is: dev:<user>file.extension.version.
@@PURGE_HELP
The PURGE command will remove a portion of the data base. This prompt is
waiting for you to indicate what kind of data should be removed. Later you
will be asked to specify a time-range.
1. LOG -- to remove all or a portion of the outage log.
2. CONTRACT -- to remove all or a subset of the contract file.
If you type /GO after this response, you will truncate the selected
data base to the last six months (180 days).
@@TIME_FROM
Time From: Time To:
***********|oooooooooooooooooooo|************
02-Mar-81 09-Mar-81
18:30:45 23:30:01
(If CONTRACT, "Time from" = "Effective date".)
You use the "Time From:" and the "Time To:" prompts to specify the
period to be displayed or purged. Notify is now waiting for you to
specify the time at which you want the operation to begin. You can:
1. Press RETURN to begin with the earliest time in the file.
2. Enter real time. The format is: dd-mmm-yy hh:mm:ss where dd is the
numerical day, mmm is the first three letters of the month, yy is
the year, hh is the hour, mm the minute, and ss the second. If only
the date is specified, the default time is 1 second after midnight.
3. Enter relative time. The format is: -dd where -dd is the number of
past days. To indicate today at 00:00:01 hours, type: -0.
@@TIME_TO
Time From: Time To:
***********|oooooooooooooooooooo|************
02-Mar-81 09-Mar-81
18:30:45 23:30:01
(If CONTRACT, "Time from" = "Effective date".)
At this prompt NOTIFY is waiting for you to specify the time at which
you want the selected operation to end. You can:
1. Press the RETURN key to default to:
A. If PURGE, 180 days (to keep the last six months)
B. if DISPLAY, the latest entry in the file.
2. Enter real time. The format is: dd-mmm-yy hh:mm:ss where dd is the
numerical day, mmm is the first three letters of the month, yy is
the year, hh is the hour, mm the minute, and ss the second. If only
the date is specified, the default time is 1 second after midnight.
3. Enter relative time. The format is: -dd where -dd is the number of
past days. To indicate today at 00:00:01 hours, type: -0.
@@UPDATE_HELP
The UPDATE command is used to write outage log entries or to
insert/modify contract coverage times. NOTIFY is now waiting for
you to specify which of these actions you wish to take.
1. LOG -- If you wish to report that your system has gone down
or has been returned to service.
2. CONTRACT -- If you wish to insert the terms of a maintenance
contract.
@@ACTION_HELP
Each log entry has a type. Notify is waiting for you to indicate
one of the following:
1. REPORTED -- System is down and vendor is notified.
2. ACCEPTED -- System is up and returned to user
Both entries are normally made after the system has been returned to
the user and it has been determined that the problem was the
responsibility of the vendor. The time between REPORTED and ACCEPTED
entries is considered downtime.
After responding to this, you will be asked to type in the date/time.
@@REPORT_HELP
At this prompt NOTIFY is waiting for you to specify when the
problem was reported to whoever is responsible for solving it.
Enter real time. The format is: dd-mmm-yy hh:mm:ss where dd is the
numerical day, mmm is the first three letters of the month, yy is
the year, hh is the hour, mm the minute, and ss the second. If only
the date is specified, the default time is 1 second after midnight.
@@ACCEPT_TIME
At this prompt NOTIFY is waiting for you to specify when the
problem was solved and the system was returned to production.
Enter real time. The format is: dd-mmm-yy hh:mm:ss where dd is the
numerical day, mmm is the first three letters of the month, yy is
the year, hh is the hour, mm the minute, and ss the second. If only
the date is specified, the default time is 1 second after midnight.
@@EFF_CONTRACT
Effective date: Expiration date:
***********|ooooooooooooooooooooo|***********
01-Jan-81 01-Jan-82
Notify is waiting for you to type in the effective date of the contract.
This date is the first day of the coverage which you will be asked
to specify later.
This command will supersede any contract with the same effective date.
Multiple contracts (with different effective dates) can exist and can
be read with the DISPLAY CONTRACT command. Unwanted contracts can be
removed with the PURGE CONTRACT command.
@@EXP_CONTRACT
Effective date: Expiration date:
***********|ooooooooooooooooooooo|***********
01-Jan-81 01-Jan-82
Notify is waiting for you to type in the expiration date of the
contract. All log entries which fall between the effective date and
expiration date of this contract and which do not occur after the
effective date of a newer contract will be evaluated according to this
contract.
Next, you will be asked to type in your specific coverage times.
@@CONTRACT_DAY
Type in the time-range during which your system is covered by maintenance
contract on this day. If the system is not covered at all, type NONE. If
you have "around-the-clock" coverage, just say 24.
Possible Responses:
hh-hh -- (EXAMPLE: 9-18)
hh:mm-hh:mm -- (EXAMPLE: 8:30-16:30)
hh -- (EXAMPLE: 24) --
NONE -- (no coverage)
Type "/G" anytime to preset the rest of the days to your last response.
@@List_Fault#_Help
You are now selecting an error to diagnose. Spear will default
to the most severe fault in our list excluding those that have already
called out the failing FRU and those that you have already diagnosed.
@@List_Investigate_Help
It is recommended that you should continue to take Spear
defaults which will give you all the the data that Spear thinks is
important to a fault in the order that Spear thinks is most important
and when You have been given all that data possible Spear will default
back to the Notify memu.
One of the following to read:
Log:
If Spear has defaulted to (log) Spear is recommending that you
read the Maintenance log because this fault has failed a Spear
verification test. This means that this fault has occurred before and
someone took some action that he thought had fixed the the problem,
but it has now failed again.
Read Beware file:
If Spear has defaulted to (Beware file) Spear is recommending
that you read the Beware entries that are in the Maintenance log
because someone has made an entry warning that there is a known
problem with this device.
Analysed:
If Spear has defaulted to (Analysed) Spear is recommeding
that you get an Analysed error report to help you diagnose the error
to a smaller unit then Spear could call out.
@@NOT_DONE
this option is not yet simulated
@@MODE COMPLETION
At any prompt you can type:
/BREAK to return to the Notify prompt.
/REVERSE (or press the BACKSPACE key) to repeat the last prompt.
/GO to execute the current prompt/response list right now.
/? to display this list without the explanations.
Type @HELP for information about Response Streams and Indirect Files.
Press the RETURN key to specify the default or terminate a response.
Press the ESCAPE (or Altmode) key to: display the default, or complete
a partially typed response. There is no default at the NOTIFY> prompt.
@@INDIRECT FILES
Response Streams - A response stream is a single line of consecutive
responses entered at the main NOTIFY prompt. Separate each responses with
a space, and terminate the line with a carriage return. (Use the Escape
or Altmode key to insert defaults).
Example: NOTIFY> DISPLAY LOG EARLIEST LATEST TTY:<cr> or NOTIFY> D/G
Indirect Response Files - An Indirect Response File is an ASCII text
file that contains a list of NOTIFY responses. Note:
1. Almost any editor can be used to build an Indirect Response File.
2. The responses in the file must pertain to one NOTIFY command only.
3. The responses must be in the correct order.
4. If /GO is omitted you will be prompted for all unsupplied responses.
Thus, you can build a response file that prompts for specific items.
5. An Indirect Response File can be submitted at any prompt. Proceed the
file name with an @ sign. (e.g., SPEAR> @WEEKLY.CMD<cr>)
@@