THE WELCH COMPANY
440 Davis Court #1602
San Francisco, CA 94111-2496
415 781 5700


S U M M A R Y


DIARY: April 13, 1998 06:12 PM Monday; Rod Welch

Revised SDS record save to work with dose command.

1...Summary/Objective
2...Dose Code Similar to Calling 070405 for HTML Save
3...Planning
4...Design of New System
5...000008 - F2 "Save" call with DOSE
.....Identify SDS Record Type and User ID for DOSE Session
.....Macro 1421 Eliminated
.....Avoid updating pointers for Schedule and SAA records, per note at
.....Entry 145 - Manage Citations, Needs Error Message
6...0702052 - New Macro for Overhead in Macro 142 so E.exe will Compile
7...07020510 - Save, Add Format Check for "summary/objective"
8...000009 - Modify Error Messages for Doc Log Management
9...01220 Save Editor file to Temp HTML directory on h - F1 F2
10...050404 Added menu call to "save" Editor File to HTML dir
11...000008 F1 F2 Save Editor File to HTML Temp Directory for Transfer
12...000000 - Change to Update colors only when 47 2


..............
Click here to comment!

CONTACTS 

SUBJECTS
Save, F2, macro 142, 0702051
Memory Management
Design Concept
Publications Inventory by Subject, F2,
Sort References
F02 Save

0908 -    ..
0909 - Summary/Objective
0910 -
091001 - Follow up ref SDS 3 0000.
091002 -
091003 - Began major change to "save" SDS records using dose to create a
091004 - separate DOS session.  The aim is to avoid erroneous processing that
091005 - seems to occur when Medit gets close to being out of memory. ref SDS 0
091006 - 3405
091007 -
091008 - Created "save" in HTML to Web site directory for Editor files, when
091009 - file is opened from SDS record.
091010 -
091011 -    [On 980415 evaluated changes. ref SDS 7 2226]
091012 -
091013 -    [On 980415 changed function key and menu assignments to support
091014 -    changes to program operation made today. ref SDS 8 0000]
091015 -
091016 -    [On 980427 improved conversion of Editor files to web pages using
091017 -    macro 0122. ref SDS 9 0000]
091018 -
091019 -
091020 -
091021 -  ..
0911 -
0912 -
0913 - Problem
0914 -
091401 - We have had a lot of instances lately of citations getting out of sync
091402 - with References.  When links are called, they do not open the correct
091403 - record at the correct location. This seems to occur mainly with SDS
091404 - records. I have not found any instances of incorrect citations for
091405 - documents or other files.  This may simply reflect that these are
091406 - accessed much less frequently than SDS records, so I just have not
091407 - encountered them as yet.
091408 -
091409 - In the past month, I have been loading files to the new Web site, see
091410 - ref SDS 6 0000, and testing the links, because they will be used by
091411 - potential customers.  At this time document links are not accessible,
091412 - so they have not been tested as rigorously as SDS links.
091413 -
091414 -  ..
091415 -
091416 - SDS links seem to have a great tendency to become offset by one or two
091417 - records, as new links are added to a large record.
091418 -
091419 - I noticed this last night with the record for the meeting with Dave
091420 - Vannier on 950927. ref SDS 2 0000, and then later I found a similar
091421 - problem with the record reviewing Peter Drucker's book on 931130, see
091422 - ref SDS 1 0000.  It took several hours to fix the citations in these
091423 - records. In fact I think I had to do the record on 950927 twice, after
091424 - another link was added.
091425 -
091426 - I am hoping this problem is solely a memory problem because there is
091427 - no other evident cause.  If it is not a memory problem then the
091428 - randomness of the problem makes it very difficult to isolate and fix.
091429 -
091430 - The fact that it only seems to occur on large records points in the
091431 - direction of memory.  If it was a general error in the code, then the
091432 - problem should occur on any record, and with some regularity.
091433 -
091434 -
091435 -  ..
091436 - Dose Code Similar to Calling 070405 for HTML Save
091437 -
091438 - I am therefore going to try to solve it by changing "save" for SDS
091439 - records to use the dose command, in similar manner that the HTML save
091440 - function works.  It was created for similar reasons and seems to be
091441 - working much better.  We have had very few system crashes when saving
091442 - an SDS record to HTML, since the change on 980405 to use the dose
091443 - command. ref SDS 5 1896
091444 -
091445 -
091446 -  ..
091447 - Planning
091448 -
091449 - I considered not using dose for smaller files, say under 300 lines.
091450 - But smaller files may be saved when much larger files are in memory,
091451 - and so there remains the potential that memory can become congested
091452 - and fragmented when processing smaller files and also get confused, so
091453 - I am going to start by doing everything with dose, and if it seems too
091454 - clunky, we we can make adjustments.
091455 -
091456 - We can use F1 Alt F2 when the full Save operation is not needed.
091457 -
091458 -     [On 980416 changed this to F1 F2 so it is more convenient to use.
091459 -     ref SDS 8 5647]
091460 -
091461 - The key objective is accuracy and consistency.  Since, processors are
091462 - getting faster, we can afford to sacrafice some code efficiency in
091463 - order to ensure the system accuracy does not fail.
091464 - ..
091465 - The concept of using dose is that it always starts with fresh
091466 - memory, and I am hopeful that when it reads itself back, it also
091467 - resets itself, although I am not sure about this latter point.
091468 -
091469 - I am attracted to the idea of only using dose with 0702051 because it
091470 - uses cut and paste which are memory intensive in SDS.  Therefore this
091471 - operation would seem to pose the greatest risk of failure.
091472 -
091473 - The problem with this reasoning is that the citation management with
091474 - macro 145 occurs before 0702051 is called so that the references are
091475 - properly organized, and at this time that is where the major problem
091476 - is occurring. ref SDS 0 6619
091477 -
091478 - So, we will change the code to process both citations, macro 145, and
091479 - update the pointers, 702051 and doc log fields, macro 1315, all in a
091480 - secondary session called by dose.
091481 -
091482 -
091483 -  ..
091484 - Design of New System
091485 -
091486 - Identify SDS record type and User ID on line 1, and save the file to
091487 - disk in local directory with temp file name.
091488 -
091489 - Process the temporary file in a dose session with 0702051 using new
091490 - code in 0702051 taken from macro 142 today, to do the following:
091491 -
091492 -         Manage citations,                - macro 145
091493 -         Update line numbers              - macro 0
091494 -         Save pointers in SDS data base   - regular 0702051
091495 -         Manage Doc Log status            - macro 1814
091496 -
091497 - Error messages will be reported in same location as User ID
091498 -
091499 - If Current Diary, Schedule 00 file is update with 0702052.
091500 -
091501 - If Errors occurred from 0702051, then 0702052 is called.
091502 -
091503 -
091504 -
0916 -
0917 -
0918 - Progress
0919 -
091901 -  ..
091902 - 000008 - F2 "Save" call with DOSE
091903 -
091904 - Line 2100, ref OF 10 4240, -entry 142, performs the "save" function.
091905 -
091906 - After I got this stuff coded, the program would not compile, so I
091907 - created another macro file, 0702052 that handles error messages. see
091908 - below at ref SDS 0 1578
091909 -
091910 - Is there a difference between saving...
091911 -
091912 -                  Archived Diary Record
091913 -                  Current Diary Record
091914 -                  Schedule Record
091915 -
091916 -      ...yes, we do not archive pointers for scheduled records.
091917 -
091918 - Where is macro 142 to "save" SDS records, called?
091919 -
091920 -        000006    -entry 108, ref OF 9 4131
091921 -
091922 -                  This uses macro 142 to call the code the prevents
091923 -                  saving another person's records.
091924 -
091925 -                  -entry 108, ref OF 9 4124,
091926 -
091927 -                  Uses macro to adjust citations, update line numbers
091928 -                  and save the record, when a file is deleted that is
091929 -                  listed under a Doc Log heading.
091930 -
091931 -
091932 -      ..
091933 -     Identify SDS Record Type and User ID for DOSE Session
091934 -
091935 -     Line 2140, ref OF 10 0970, added code to enter a flag on col 35 of
091936 -     line 1 in front of "Diary" or "Schedule" to identify the record as
091937 -     a Schedule, Current or Archived Diary record.
091938 -
091939 -     The local User ID is entered on col 44 so it will miss the end of
091940 -     "Schedule".  These are used in 0702051 to update pointers.
091941 -
091942 -
091943 -      ..
091944 -     Macro 1421 Eliminated
091945 -
091946 -     Was able to eliminate entry 1421 which was a special mark just for
091947 -     this routine, and use instead standard macros 22 and 23.  We
091948 -     formerly needed a separate mark opertation because the other marks
091949 -     are used by the citation update, macro 145, and Doc Log macro
091950 -     1813.  Since these now occur in a separate dose session, we can
091951 -     use the regular marks in the current session.
091952 -
091953 -  ..
091954 -
091955 -     Avoid updating pointers for Schedule and SAA records, per note at
091956 -     ref OF 10 6410
091957 -
091958 -          This is accomplished in 0702051, per ref SDS 0 2414.
091959 -
091960 -
091961 -      ..
091962 -     Entry 145 - Manage Citations, Needs Error Message
091963 -
091964 -     Line 2750, ref OF 10 5501, -label msg96 added code to flag a
091965 -     condition where a citation does not have a corresponding entry in
091966 -     the Reference field.  This is identified in macro 145, and will
091967 -     return a condition to macro file 0702051 which will save the file.
091968 -
091969 -
091970 -  ..
091971 - 0702052 - New Macro for Overhead in Macro 142 so E.exe will Compile
091972 -
091973 - Line 30, ref OF 6 0970, this new macro was created because we could
091974 - not compile e.exe with the new code to call 0702051 with the dose
091975 - command.
091976 -
091977 -  ..
091978 - Moved the DL evaluation error messages from 000009, to this file, so
091979 - we same compiler space.
091980 -
091981 -
091982 -  ..
091983 - 07020510 - Save, Add Format Check for "summary/objective"
091984 -
091985 - Where is 0702051 called?
091986 -
091987 -        000006    -entry 108, ref OF 9 4131
091988 -
091989 - Line 1, ref OF 4 1177, -goto 04702 in 0207051 this is a new step added
091990 - today to call the code for archiving pointers when called by 04702.
091991 -
091992 -  ..
091993 - Line 2 is now called in 0702052 with a dose command, per ref SDS 0
091994 - 1578, to execute code that was formerly part of compiled macro 142, it
091995 - calls the compiled macro 145 to sort and update citations, it calls
091996 - the line number macro without updating color scheme, per ref SDS 0
091997 - 3630, does a subroutine to archive pointers, then it calls compiled
091998 - macro 1813 to upate the doc log stuff.
091999 -
092000 -  ..
092001 - Created conditional so pointers and DL ops are not run for Schedule
092002 - and SAA records. ref OF 6 1870
092003 -
092004 -  ..
092005 - Line 120, ref OF 4 5656, -label ok119 we will not set 47 2 which is
092006 - the SDS record profile flag.  I changed macro 0, so it only updates
092007 - colors when 47 2. ref SDS 0 3630  There is no point in updating colors
092008 - in this 0702051 op because it is a separate session.  The colors have
092009 - to be reset when we get back to the primary session, anyway, so we
092010 - will omit the step at this time to save a little time.
092011 -
092012 -  ..
092013 - Line 225, ref OF 4 3918, -label nvMnd1, about 50 lines below, added
092014 - code for processing the Schedule 00 file when a current Diary record
092015 - is being saved.  The 00 file is marked to show that the current SDS
092016 - Diary in memory has been opened with a time, so if the time is changed
092017 - later, it can be adjusted.
092018 -
092019 -  ..
092020 - Line, ref OF 4 3588, -label 04702, get the filename and prior save
092021 - time for Current Diary records.
092022 -
092023 -  ..
092024 - Line 245, ref OF 4 1699, -label nvMnd1, about 70 lines below, changed
092025 - this code to open the Schedule 00 file from the disk instead of using
092026 - ecur 96, since we are doing this from a separate dose session now.
092027 -
092028 - The code in 000008 macro 145 determines if a Current Diary record was
092029 - processed, and if so, then after 0702051 runs, macro 145 calls a new
092030 - macro file 0702052 that calls ecur 96 to open 00 file, empty the
092031 - Schedule and read in the revised 00 file.
092032 -
092033 -
092034 -  ..
092035 - 000009 - Modify Error Messages for Doc Log Management
092036 -
092037 - Line 3755, ref OF 11 6300, -label erAsgn, need to make this a separate
092038 - macro so it can be called after the file is read back in the primary
092039 - session.
092040 -
092041 - Created -entry 1815 for error messages called after 0702051 runs and
092042 - the SDS record is read back.
092043 -
092044 - Actually, moved these error messages to 0702052 to save compiler
092045 - space. ref SDS 0 7427
092046 -
092047 -
092048 -
092049 -
0921 -

SUBJECTS
Save to HTML Directory for Web Site
Editor, F02
Convert Documents, 0122

1306 -
130601 -  ..
130602 - 01220  Save Editor file to Temp HTML directory on h - F1 F2
130603 -
130604 - Follow up ref SDS 4 1405.
130605 -
130606 - Line 30, ref OF 1 0775, created code to work similar to 070405. see
130607 - at ref OF 6 4260
130608 -
130609 - This is a comparable function to 070405 that converts SDS records into
130610 - HTML for publication on the Internet and viewing on a Web browser.
130611 - Macro file 0122 does not add any HTML, but we could check a file to
130612 - see if it is there, and if not, then convert the file by adding only
130613 - the pre command.
130614 -
130615 - The file is saved on h: and on e.
130616 - ..
130617 - This is called by F1 F2 assigned in 000008, ref SDS 0 5427,
130618 - which is a little dangerous, but we could not call it with a menu
130619 - because the code messes up the file name saved in global counters.
130620 - There is probably a way to do it if I ever get enough time to think
130621 - about it again.
130622 -
130623 -      [On 980427 added code to enter HTML in a file that does not have
130624 -      it and save to HTML inventory directory for transfer to the Web
130625 -      site. ref SDS 9 0000]
130626 -
130627 -
130628 -  ..
130629 - 050404  Added menu call to "save" Editor File to HTML dir
130630 -
130631 - Line 45, ref OF 3 3906, this is similar to the SDS function call.
130632 -
130633 - Had to disconnect this because the filename is saved in globals
130634 - beginning with counter 1, and when the menu calls the macro file
130635 - processor it overwrites the filename values.
130636 -
130637 - So will use F1 F2 for awhile, per ref SDS 0 1108.
130638 -
130639 - Need to figure out how to put this in the menu so it is the same
130640 - operation that is used in SDS records.
130641 -
130642 -     [On 980720 did more work. ref SDS 10 5808]
130643 -
130644 -     [On 980722 completed this objective. ref SDS 11 3125]
130645 -
130646 -
130647 -  ..
130648 - 000008 F1 F2 Save Editor File to HTML Temp Directory for Transfer
130649 -
130650 - Line 610, ref OF 10 2556, -entry 155, this just calls macro file 0122
130651 - create above. ref SDS 0 2718
130652 -
130653 - This is dangerous because of the tendency for the hands to get used
130654 - to using F1 F2 to do a regular save for SDS records.  Will try
130655 - putting in some constraints.
130656 -
130657 -     [On 990415 made F1 F2 in SDS alternate save. ref SDS 8 2629]
130658 -
130659 -
130660 -
130661 -
1307 -

SUBJECTS
Line Counters, macro 0
Planning

1605 -
160501 -  ..
160502 - 000000 - Change to Update colors only when 47 2
160503 -
160504 - Line 100, ref OF 8 1230, -label nxt_ln, under macro 0 for updating
160505 - line numbers and entering color flags.
160506 -
160507 - Added condition for 47 0 to exit because when an SDS record is
160508 - processed by macro 142 calling 0702051 in a dose session, ref SDS 0
160509 - 5159, the file will not have a profile flag, i.e., 47 = 0.
160510 -
160511 - This makes it possible to skip updating colors when a record is not
160512 - being processed in the primary session, since all colors will be lost
160513 - when the file is read back after processing by 0702051 in a secondary
160514 - session.  The colors are restored by calling macro 0 again from the
160515 - primary session where 47 2 is set.  The heading and follow up colors
160516 - are then reset.
160517 -
160518 -
160519 -
160520 -