1                                                                   1
-
              INSTALLATION INSTRUCTIONS FOR OLD INSTALLATIONS
+             ____________ ____________ ___ ___ _____________
0                               August 1977
-         This procedure will convert D3.2 MTS disk packs to the D4.0
     format (allowing 32767 byte records in  line  files).   It  will
     produce  new  disk packs containing all files from the old packs
     that do not need to be  changed  for  Distribution  4.0.   Those
     files  that  need  to change will be replaced with new versions.
     It is estimated that the conversion will take at least  2  hours
     per disk pack, and it will not be possible to run the version of
     MTS that is being converted for any other purpose while it is in
     progress   from   step  5  on.   You  should  read  this  entire
     description and be familiar with it before you attempt to  start
     the  conversion  process.   Otherwise you may make mistakes that
     will be hard to undo.
0         Because this conversion procedure is  complicated  and  has
     not been tried many times before, it is strongly recomended that
     you  first use it to convert your current one pack system (which
     is  presumably  compatible  with  your  production  system)   to
     Distribution  4.0  format.   You  are  almost  certain  to  find
     problems when you do this and this will give  you  a  chance  to
     avoid them when you convert the production system.
0    1.    Restore  the disk pack included with the distribution onto
           an extra disk pack.  This pack should not be  one  of  the
           regular  MTS disk packs so that it can be used for setting
           up the new system without affecting the operation  of  the
           old  system.   Use  the  TSS  DASDI  (or  MTS  DASDI)  and
           DUMP/RESTORE provided.  On  the  distributed  DUMP/RESTORE
           tapes, the volume label of the pack is TMTS02; this may be
           changed  to  any other desired label (with PVN 1) when the
           pack is restored, except that it is  strongly  recommended
           that  the label be different from the label of any pack in
           your production system.  If desired, you may  use  the  LO
           (label only) option in MTS DASDI (598) to change the label
           after the conversion is complete.
0    2.    Use  the pack restored above to get the new version of MTS
           working to your satisfaction.  This will require  changing
           your  TABLES  to  conform  to Distribution 4.0 format (see
           writeup on TABLES), and adding any local modifications  to
           the  resident  system.   The TABLES Deck Generator Program
           can be used to produce a new TABLES (see  the  writeup  on
           installing  MTS at a new installation).  The pack restored
           in step 1  contains  almost  all  public  and  semi-public
           files,  but  not  all the utility programs you might want.
           If additional programs are needed move them from  the  old
           packs by copying them to tape or cards.  Do not attempt to
           use  the the new MTS with the old packs and do not attempt
           to use the old version of FM to move things from  the  old
           system.
0    3.    Use  component 104/51, or a modification of it if you have
1                                                                   2
-
           changed  the   accounting   file   format,   to   generate
           Distribution  4  accounting  files in private files in the
           old system.  This program is a subroutine to be used  with
           ACCRDWRT  (104/25),  see  the  comments in 104/25 for more
           information.  Run  it  with  the  old  ACCLIST  and  other
+                                            ___
           accounting  subroutines.   Note  that this program assumes
           that your accounting files  are  Distribution  3.2  format
           (not  3.1  or  earlier); if this is not the case, you must
           first  use  the  conversion  programs  from  any  previous
           distributions  you  have skipped.  The project file format
           is unchanged from Distribution 3.2.
0    4.    Move the new accounting files (which should not be in  the
+                                                      ___
           regular accounting files yet) over to the Distribution 4.0
           pack using file save in the old system and *RST in the new
           one.   These  should  be  put in private files on the test
           pack.  After the files in the production system have  been
           converted  to  the  new  format, these files will be moved
           back into the public files.
0    5.    Save all old disk packs with stand-alone  DUMP/RESTORE  or
           Filesave.   These  tapes will probably not be used, but it
           would be foolish to proceed with  the  conversion  without
           some  back-up.   From  this  point until the conversion is
           complete it will not be possible  to  run  the  MTS  being
           converted, so be sure enough time is available to complete
           the conversion if the regular MTS is being converted.
0    6.    The  next  step  is to run the program to convert all line
           files to the new (long line) format.  To do this  IPL  the
           Distribution  4.0 system.  In order to be able to run more
           than one copy of the conversion program (to  cut  down  on
           the  time  required) you must load a copy of VOLGET with a
           set of TABLES for the  disk  packs  being  converted  into
           shared  VM.   Copy  the  appropriate  TABLES to the end of
           W047:FCNV.VOLGET and use SEG2:S2L to load the result  into
           shared VM.  Then enter the run command:
0          RUN W047:FILECONV.O+W047:WRITPKG.O+W047:OLD.FILERTNS
               PROT=OFF PAR=pvn1,...
0          where  pvn1,...  is a list of public volume numbers.  This
+                 ________
           will convert all files whose file descriptors exist on one
           of the given  public  volumes.   If  desired  (and  it  is
           probably  a  good  idea  if  more  than  one pack is being
           converted) more than one copy of this program can  be  run
           from  different  tasks.  Make sure that no two of them are
           given the same pvn in their parameter list.
0    7.    All of the files have now been converted to the new format
           and can be processed by the new file  routines.   However,
           many  files on the converted pack(s) need to be updated to
           contain programs or data compatible with the  new  system.
           This will be done by using FM on the Distribution 4.0 pack
           to  move  the files back to the converted packs.  The list
           of files affected by this is included with  this  writeup.
1                                                                   3
-
           Go  through  this  list and decide which files you want to
           move (some are optional).  You also will probably want  to
           move  some  other  files from the Distribution 4.0 pack to
           the regular packs to get the newer  version  (for  example
           *CLSEDIT).   Make  a list in a file of all the files to be
           moved.  This list should include the converted  accounting
           files moved in step 4.  Then enter the command:
0          RUN FILE:FM+FILE:FILERTNS(1,99)+tables+sysdefs PROT=OFF
0          where tables contains the TABLES for the converted pack(s)
+                ______
           and  sysdefs  contains  the  loader  records  to reference
+               _______
           SYSDEFS.  This may reference  one  undefined  symbol  (the
           2314  unit  check routines) which should be IGNOREd.  When
           FM reads from the terminal enter a $CONTINUE WITH line  to
           read the list of files you produced above.  FM will ask if
           it is ok to destroy some files, tell it OK or ALLOK.
0    8.    You are now ready to IPL the converted system again.
0    9.    Signon  at  the  operator's  console  under userid MTS and
           enter:
0              $RUN FILE:FILEUPD PKEY=DISASTER 0=*DUMMY* 1=-EMPTY
0          This will update file storage records for all userids.  It
           is important that this be done, since some userids may  be
           incorrect.  It may be necessary to change some of the file
           names  on  $CONTINUE WITH lines at the end of FILE:FILEUPD
           to correspond to the names used in your system.
0    10.   Add any local modules to *LIBRARY.  Do not simply  replace
           the  new  *LIBRARY with your old one, but rather merge the
           two.
0    11.   Add any local messages  to  *SMDS.   Again,  do  not  just
           replace  the  new  file  with  your  old one, as there are
           several new  messages  in  it.   If  there  are  conflicts
           between  our  new  messages  and  your added messages, the
           Message Manual (555) can be used to find  out  where  each
           FMSG is issued in the Distribution 4.0 MTS.
0    11.   Add  any  local  changes to *SYSMAC.  These must be merged
           with the Distribution 4.0 version of *SYSMAC.
1                                                                   4
-
     The following files should be moved to the converted packs after
     the D4.0 conversion is done:
0     *ACCOUNTING1       move these
      *ACCOUNTING2        files from
      *ACCOUNTING3         the private
      *ACCOUNTING4          file copies on
      *ACCOUNTING5           the test pack
      *ACCRESTORE
      *BNCHRTN           for @MAXLEN
      *CCPOST            if UM plot support needed
      *CCQUEUE           if UM plot support needed
      *CKID              new accounting file format
      *CLSACC            new accounting file format
      *CLSFILESTATUS
      *CLSMOUNT
      *CLSPERMIT
      *CLSSDS
      *CLSSSTA
      *CNFGINFODSECT
      *DEDIT             new driver file format
      *DYSSUB
      *FAKEOS            old one won't run with PROT=ON
      *FS                new driver file format
      *FSM               used by system initialization (INIT:INITCMD)
      *GDINFODSECT
      *GFINFODSECT
      *INIT
      *IPL.DECKGEN       if desired
      *IPL.D4            if desired
      *IPL.D4.360        if desired
      *IPL.0
      *IPL.1
      *IPL.2
      *LABEL             for protection
      *LAR
      *LBL               for protection
      *LIBRARY           add local components
      *LOADINFODSECT
      *MNETRTN           for @MAXLEN
      *MRXARTN           for @MAXLEN
      *PDP8RTN           for @MAXLEN
      *PERSUB            loaded by MTS
      *PTPRRTN           for @MAXLEN
      *RES               new online FILE SAVE
      *RESTORE           new online FILE SAVE
      *RST
      *SAV               new online FILE SAVE
      *SENSEDSECT
      *SFSAVSUB          loaded by MTS
      *SKEYSUB           loaded by MTS
      *SMDS              add local changes
      *SPRIVSUB          loaded by MTS
      *STATUS            new accounting file format
      *SYSMAC            add local changes
      *S2L
1                                                                   5
-
      *TAPECOPY          for new tape routines
      *TAPERTN           for @MAXLEN
      *VALIDATEFILE
      *1052RTN           for @MAXLEN
      *2260RTN           for @MAXLEN
      *2501RTN           for @MAXLEN
      *2741RTN           for @MAXLEN
      *3066RTN           for @MAXLEN
      *3270RTN           for @MAXLEN
      ACC:ACCDISPLAY     new accounting file format
      ACC:ACCERRORSCAN   new accounting file format
      ACC:ACCFILCHARGE   new accounting file format
      ACC:ACCLIB         new accounting file format
      ACC:ACCLIST        new accounting file format
      ACC:ACCLISTING     new accounting file format
      ACC:ACCMAINT       new accounting file format
      ACC:ACCSAVE        new accounting file format
      ACC:CCREBATE       new accounting file format
      ACC:FILEINFO       new accounting file format
      ACC:PASSWORDS      new accounting file format
      ACC:REBATE         new accounting file format
      ACC:REBATESUBS     new accounting file format
      ACC:REBATE1        new accounting file format
      ACC:STAPROJECT     new accounting file format
      COPY:ACCFORMAT     new accounting file format
      COPY:BJPDSCT
      COPY:CDCADSECT
      COPY:CMDAREADSECT
      COPY:DRDSECT
      COPY:FILE.MACROS
      COPY:GLOBALDEFS    make local changes
      COPY:GLOBALSETS    make local changes
      COPY:JOBSTA
      COPY:LLMPSEQU
      COPY:MTS.MACROS
      COPY:PCBDSECT
      COPY:RATEVEC
      COPY:SETPARM
      COPY:STATDSECT
      ETC:BDAM           for new *FAKEOS
      ETC:FAKEOS.EXCP    for new *FAKEOS
      ETC:FIX.EXPLAIN    if new FIX moved
      ETC:FIX.MESSAGES   if new FIX moved
      ETC:FOS.IGG        for new *FAKEOS
      ETC:FOS.OLTS       for new *FAKEOS
      FILE:ACATSUB       for disaster recovery
      FILE:CALLDR        for disaster recovery
      FILE:CATL.O
      FILE:CCATL.O       for disaster recovery
      FILE:CHKVTOC
      FILE:CHONID
      FILE:DASDI
      FILE:DASDI.360
      FILE:DASDUC.O
      FILE:DESVOLUME
      FILE:DISKCOPY
1                                                                   6
-
      FILE:DISKDUMP
      FILE:DS.O
      FILE:DSKMAN
      FILE:DUP
      FILE:FILERTNS
      FILE:FILEUPD
      FILE:FIXCAT
      FILE:FIXEH
      FILE:FIXSD
      FILE:FLIN.O
      FILE:FM
      FILE:FSTEST
      FILE:GETDSK.O
      FILE:GETFINF.O
      FILE:MOVE.O
      FILE:OPEN.O
      FILE:PM
      FILE:READ.O
      FILE:READL.O
      FILE:RECATALOG
      FILE:RESETCATREF
      FILE:RWSEQ.O
      FILE:STARFILES
      FILE:TABLES.TEST
      FILE:TABLMODMP.O
      FILE:TABLRTN.O
      FILE:TRAK.O
      FILE:VAMREC
      FILE:VNTD.O
      FILE:VOLGET.O
      FILE:WHATSLEFT
      INIT:CNFGSOU       used by initialization and *S2L
      INIT:ED.360        used by initialization
      INIT:ED.370        used by initialization
      INIT:FMT2305       used by initialization
      INIT:GSETS.360     used by initialization, make local changes
      INIT:GSETS.370     used by initialization, make local changes
      INIT:IG.3270.360   used by initialization (delete this from
                           INITCMD if *IG not moved)
      INIT:IG.3270.370   used by initialization (delete this from
                           INITCMD if *IG not moved)
      INIT:INIT          used by initialization
      INIT:INITCMD       used by initialization
      INIT:INITLOG       used by initialization
      INIT:TALLY.360     used by initialization
      INIT:TALLY.370     used by initialization
      INIT:USERS.360     used by initialization
      INIT:USERS.370     used by initialization
      INIT:VALIDATE.360  used by initialization
      INIT:VALIDATE.370  used by initialization
      MTA:PRINTDUMP      move to wherever PRINTDUMP is kept
      MTA:UNITS.O
      MTA:V370
      MTA:V67
      MTS:BNCH.ANAL.O    for new *BNCHRTN
      MTS:BNCH.MONITOR   for new *BNCHRTN
1                                                                   7
-
      MTS:BNCH.SEG2      for new *BNCHRTN
      MTS:RAMROD         not compatible with old ROD file
      MTS:RAMRODEXP      not compatible with old ROD file
      MTS:ROD            not compatible with old ROD file
      MTS:RRDMP
      SYS:CCP            if UM plot support needed
      RSTR:AMALGAMATE
      RSTR:AUTOREST      new FILE SAVE
      RSTR:CHKFILE
      RSTR:DEADFILEDES
      RSTR:DEADSAVE
      RSTR:DEADUCATDES
      RSTR:DIRTAPEOUT
      RSTR:DSF
      RSTR:FASTRESTORE
      RSTR:FASTRSTR
      RSTR:FILEDIR.MAS   empty file permitted R to PKEY=*RESTORE
      RSTR:FILEDIR.NEW   empty file permitted R to PKEY=*RESTORE
      RSTR:FILEDSCB
      RSTR:FILESAVE
      RSTR:FILESAVEOBJ
      RSTR:FSLOG
      RSTR:FSS
      RSTR:FSTAPECOPY
      RSTR:LFS.RESTART
      RSTR:MERGE
      RSTR:OLFSOBJ
      RSTR:OPER*RESTORE
      RSTR:RENAMEIT2
      RSTR:RESTORE
      RSTR:RST
      RSTR:RSTFMT1
      RSTR:RSTFMT0
      RSTR:RSTFMT2
      RSTR:SAVEFILE
      RSTR:SVSTART       change for disk pack names
      RSTR:TAPEDIR
      RSTR:TAPEOUT
      RSTR:TAPERECOVER
      RSTR:TIMECFE
      RSTR:VTOCREAD
      SEG2:CFE           old name for this is no longer valid
      SEG2:FIX           if desired
      SEG2:FREAD         if desired
      SEG2:GRAB3270
      SEG2:HASP          or local version
      SEG2:IF            if desired
      SEG2:PRINTMAP
      SEG2:SETTIME
      SEG2:STDTV
      SEG2:S2APL         old version won't run with PROT=ON
      SEG2:S2FILES       make local changes if desired
      SEG2:S2L
      SEG2:TIME
      SEG2:UNITS
      SYS:CMDFDIR        initially empty
1                                                                   8
-
      SYS:CMDPIKUP.O
      SYS:CMDTAPE.O
      SYS:MOUNTSTAT
      SYS:PLOTDIR        if UM plot support needed
      SYS:PLOTREBAT      if UM plot support needed
      SYS:PLOTRECPT      if UM plot support needed
      SYS:PLOT1          if UM plot support needed
      SYS:PLOT2          if UM plot support needed
      SYS:PLT            if UM plot support needed
      SYS:STA
      SYS:TLIMIT
      TMTS:LOADMTS
