sysdoc/pdset.info

   1 Copyright (c) 1999 Massachusetts Institute of Technology
   2
   3 This program is free software; you can redistribute it and/or modify
   4 it under the terms of the GNU General Public License as published by
   5 the Free Software Foundation; either version 3 of the License, or (at
   6 your option) any later version.
   7
   8 This program is distributed in the hope that it will be useful, but
   9 WITHOUT ANY WARRANTY; without even the implied warranty of
  10 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11 General Public License for more details.
  12
  13 You should have received a copy of the GNU General Public License
  14 along with this program; if not, write to the Free Software
  15 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  16 ------------------------------
  17
  18 PDSET was re-written from scratch in 1985, so it now has a nicer
  19 user interface, but does essentially the same work as described in
  20 this file.  That is, it hacks PDTIME and the clock, and the backup
  21 PDYTIM, and FYEAR.  --- CSTACY
  22
  23 The following information pertains to the old PDSET program circa 1969.
  24
  25   SYS:TS PDSET IS A PROGRAM FOR THE
  26 SETTING OF SYSTEM VARIABLES ASSOCIATED
  27 WITH THE KEEPING OF REAL TIME IN ITS
  28 VERSIONS 547 AND GREATER. IT DOES
  29 THIS ON THE BASIS OF TYPED IN COMMANDS,
  30 EXCEPT THAT IT MAY BE CALLED BY
  31 :PDSET YYMMDD HHMMSS FROM DDT, WHERE
  32 YYMMDD AND HHMMSS ARE THE DATE AND
  33 TIME IT IT STARTED ($G'D BY DDT).
  34   WHEN PDSET IS FIRST STARTED
  35 UP, IT ENTERS IOT USER MODE IN ORDER
  36 TO DATAI FROM A HARDWARE CLOCK, SO DON'T
  37 PLAY WITH ITS BINARY CASUALLY.
  38   WHEN NOT STARTED UP BY :PDSET YYMMDD HHMMSS,
  39 PDSET TAKES TYPED IN COMMANDS IN MUCH
  40 THE SAME MANNER AS TENLOD, WITH WHICH
  41 IT SHARES THE Q, X, AND ? COMMANDS.
  42 AFTER EACH CHARACTER IS TYPED IN AND
  43 BEFORE IT IS ECHOED, PDSET DOES A
  44 DATAI FROM THE HARDWARE CLOCK, AS WELL
  45 AS A .RDTIME. IT IS ON THE BASIS OF
  46 THIS INFORMATION, AS WELL AS THAT TYPED
  47 IN, THAT IT DOES WHAT IT DOES.
  48
  49 MAIN COMMANDS:
  50
  51 D  SET DATE. ACCEPTS A SIX
  52    DIGIT (YYMMDD) LEADING ARGUMENT OR,
  53    IF NOT SUPPLIED, THEN SETS A FLAG
  54    TO USE THE SYSTEM DATE (INITIAL MODE).
  55
  56 T  SELECT *THE *TIME *AT *WHICH *THE
  57    *SETLOC *COMMAND *WILL *BE *GIVEN*.
  58    (HHMMSS 24 HR-TYPE LEADING ARGUMENT).
  59
  60 !  MUST BE FOLLOWED BY A POINT.
  61    THE TIME THE "." IS TYPED IS ASSUMED
  62    TO BE THE TIME SELECTED BY THE
  63    MOST RECENT "T" COMMAND. IF THE
  64    HARDWARE CLOCK IS RUNNING THEN PDSET
  65    .SETLOC'S A LOCATION IN THE SYSTEM
  66    WHICH THE SYSTEM USES AS AN OFFSET
  67    FOR TRANSLATING CLOCK DATAI'S INTO
  68    TIME OF YEAR. IF THE CLOCK IS NOT
  69    RUNNING, IT .SETLOC'S ANOTHER
  70    LOCATION IN THE SYSTEM TO THE TIME
  71    OF YEAR (FOR USE BY THE SYSTEM AS
  72    BACKUP TO THE HARDWARE CLOCK).
  73    EITHER WAY IT ALSO .SETLOC'S THE
  74    LOCATION IN THE SYSTEM CONTAINING THE
  75    YEAR, ALTHOUGH THIS WILL USUALLY
  76    NOT CAUSE SYSTEM JOB PRINTOUT
  77    DUE TO AGREEMENT.
  78    IN SHORT, THIS COMMAND DOES WHATEVER
  79    IT THINKS NECESSARY TO TELL THE
  80    SYSTEM WHAT TIME OF WHAT YEAR IT IS.
  81         --JSF 9/20/69 6:40PM
  82      AMENDED 5/22/72 9:10PM BY JSF
  83 \f\ 3\f\87\878