THE WELCH COMPANY
440 Davis Court #1602
San Francisco, CA 94111-2496
415 781 5700
rodwelch@pacbell.net


S U M M A R Y


DIARY: May 5, 2003 01:59 PM Monday; Rod Welch

SDS problem opening citation to an OF listing reported by Gary.

1...Summary/Objective
2...SDS Reports Incorrectly Citation Not Present When Opening Link
3...000006 Open Citation Macro 982
4...Flexible Structure for DL Conform to SDS Standards
5...0702051 Save F2 Conform Record Structure to Doc Log Formats
6...SDS Program Code and Work Records Updated


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

CONTACTS 

SUBJECTS
SDS Records Opening Link Returning Error Message that Citation Not Pr
Johnson, Gary SDS Records Opening Link Returning Error Message that C
Link Returning Error Message that Citation Not Present When Press Ent
Open Links without Flag to Link Back, macro 982
Links open SDS records from Citation Macro 982

0707 -
0707 -    ..
0708 - Summary/Objective
0709 -
070901 - Follow up ref SDS 7 0000. ref SDS 6 0000.
070902 -
070903 - Problem with citation not working correctly in flexible structure of
070904 - SDS record, ref SDS 0 T85N, was caused by slight error in the format
070905 - for the DRP reference field. ref SDS 0 QK5F  Changed the code to
070906 - accomodate this condition ref SDS 0 FU5Q  Also, modified the F2 "save"
070907 - process using 0702051 to check and conform all document listings in
070908 - the Reference field to SDS record format standards. ref SDS 0 6U9S
070909 - Still not perfect, but eliminate a couple more problems, as a result
070910 - of discoverying one type of problem that is difficult to recognize.
070911 - Submitted an update to Gary linked to this record with a program
070912 - update that incorporates these changes. ref SDS 0 GX3N
070913 -
070914 -
070915 -
070916 -
070917 -
070919 -  ..
0710 -
0711 -
0712 - Problem
0713 -
071301 - SDS Reports Incorrectly Citation Not Present When Opening Link
071302 -
071303 - Gary called today and reported that a link is failing to open to a
071304 - listing under Other Files (OF).
071306 -  ..
071307 - We did some preliminary testing and could not find the problem.  Gary
071308 - zipped his records for today and sent them via Internet.
071310 -  ..
071311 - Investigation shows that his record on 030416 has a link, ref SDS 5
071312 - E55G, to a listing under Other Files. ref DRP 1 A050  When Enter is
071313 - pressed an error message occurs....
071314 -
071315 -          Citation Line not present!
071317 -  ..
071318 - I created a test using Gary's records on my computer and everything
071319 - seems to work fine.
071321 -  ..
071322 - After getting Gary's record's the error is replicated.
071323 -
071324 -      Turns out the problem is similar to the action item reported on
071325 -      030403 for maintaining consistent format with blank line below
071326 -      each Reference field. ref SDS 3 0240
071327 -
071328 -
071329 -
071331 -  ..
0714 -
0715 -
0716 - Progress
0717 -
071701 - 000006  Open Citation Macro 982
071702 -
071703 - Line 1750, ref OF 2 2846, -label eCur8 in 000006.
071704 -
071705 -      This is where the error message is entered, so the problem
071706 -      occurs above this location.
071707 -
071709 -  ..
071710 - Line 1710, ref OF 2 ZQ6H, -label doc_of in 000006
071711 -
071712 -    The code at this point has determined that the citation is not an
071713 -    SDS record, and is either a document which is either a formal
071714 -    correspondence or it is an Other File.  Therefore it is looking for
071715 -    the bottom of SDS records listed on lines 030101 in order to look
071716 -    for the type of document identified in the citation string.  Since
071717 -    this begins with 0302 lines the code looks for...
071719 -     ..
071720 -    l/0302 -/
071721 -
071722 -        The problem is that the record on 030416 does not have this
071723 -        standard condition.  The structure is created for DRP to
071724 -        have...
071725 -            ..
071726 -           0301nn -
071727 -           0301nn -
071728 -           0301nn -
071729 -           0302 -
071730 -           0303j-   <----------------- DRP * Documents Received Prior ---------------------
071731 -           0304j-   Dr Project     Yr Mn Filenm   Typ <----------- Description ------------
071732 -           030301 - F: 04 00001 60 03 04 1001     r0  Technical Exchange Meeting
071733 -           030302 -
071734 -           030302 -
071736 -         ..
071737 -        In this case, we have...
071738 -            ..
071739 -           0301nn -
071740 -           0301nn -
071741 -           0302j-   <----------------- DRP * Documents Received Prior ---------------------
071742 -           0303j-   Dr Project     Yr Mn Filenm   Typ <----------- Description ------------
071743 -           030301 - F: 04 00001 60 03 04 1001     r0  Technical Exchange Meeting
071744 -           030302 -
071745 -           030302 -
071746 -
071747 -        ...so, somehow the line "0302 -" is missing even though there
071748 -        is no nominal reason for it to ever be touched.  As a result
071749 -        when the code tried to jump to the bottom of the stack for SDS
071750 -        records, which is below 0301nn lines, and then then do a search
071751 -        for document fields, since "0302 -" is not in the record, it
071752 -        reported an error message.
071754 -     ..
071755 -    We could eliminate this search entirely, since the only purpose is
071756 -    to pick up speed slightly by jumping direcly past all
071758 -     ..
071759 -    Solution is to change the code to look instead for....
071761 -     ..
071762 -    l/0302/
071763 -
071764 -        This provides some leaway in the event the structure is
071765 -        interrupted some way or another.
071767 -         ..
071768 -        Maybe we need an "engine" to conform these type of format
071769 -        issues under analysis on 890523 that flexible structure is
071770 -        powerful, but fragile. ref SDS 1 YN8J  When people are
071771 -        concentrating on one thing, the hands can inadvertantly press
071772 -        something that disrupts the structure in a way that is not
071773 -        evident, and yet causes problems.
071774 -
071775 -
071776 -
071777 -
0718 -

SUBJECTS
0702051 Macro F2 Save Sort References, Action Items, 0702051
Format Reference Fields Verify Correct Structure During F2 Save Op wi

0904 -
090501 -  ..
090502 - Flexible Structure for DL Conform to SDS Standards
090503 - 0702051  Save F2 Conform Record Structure to Doc Log Formats
090504 -
090505 - Follow up ref SDS 3 0240.
090506 -
090507 - Actually, a better solution than modifying the code to accept
090508 - defective structure, per above, ref SDS 0 QK5F, is for the archive
090509 - function to examine the record during the F2 "save" op and
090510 - affirmatively conform all document listings to the correct SDS
090511 - document log format. It can be done easily without involving the user,
090512 - i.e., the User never knows this occurs.
090513 -
090514 -      This accomplishes action item on 030403. ref SDS 3 0240
090516 -  ..
090517 - Line 450, ref OF 1 3S8K, -label lpvdlf in 0702051
090518 -
090519 -    top
090520 -    z 1 3
090521 -    l/03 /
090522 -    z 10 10
090523 -    l / /
090524 -    down 2
090525 -    macro 14
090526 -
090527 -       Setup to process the record from the bottom of SDS References by
090528 -       identifying wtih macro 14 to save a little time; applied below.
090529 -       ref SDS 0 QC6N
090531 -     ..
090532 -    z 27 31
090533 -    setcnt 3 0
090534 -    -label lpvdlf
090535 -    addcnt 3 1
090536 -    -gosub tsDLf
090537 -
090538 -       Zone for constant field for Doc Log type identifiers; and do a
090539 -       loop increments a flag to process each of the 5 document types
090540 -       by incrementing counter 3 and then call subroutine to evaluate
090541 -       and correct any defective condition.
090543 -     ..
090544 -    -if @3 = 5 -goto sumobJ
090545 -    -goto lpvdlf
090546 -
090547 -       When the last doc type has been processed, do the next task;
090548 -       other wise go do the next doc type.
090549 -
090551 -  ..
090552 - Line 510, ref OF 1 QF4N, -label tsDLf in 0702051
090553 -
090554 -    -label tsDLf
090555 -    macro 15
090556 -
090557 -       Return to bottom of SDS References to look for next doc type
090558 -       field. ref SDS 0 GZ99
090560 -     ..
090561 -    setcnt 0 0
090562 -    -if @3 = 1 l/- DRP/
090563 -    -if @3 = 2 l/- DRT/
090564 -    -if @3 = 3 l/- DIP/
090565 -    -if @3 = 4 l/- DIT/
090566 -    -if @3 = 5 l/- OF /
090567 -    -if @0 = 0 -goto DRTf
090568 -    -return
090569 -
090570 -        Look for each doc type; and if found, do routine to verify
090571 -        correct structure; if not found go end routine.
090572 -
090574 -  ..
090575 - Line 530, ref OF 1 EV3O, -label DRTf in 0702051
090576 -
090577 -    -label DRTf
090578 -    down
090579 -    setlen 1 0
090580 -    -if @1 < 10 -goto whabl
090581 -
090582 -        Subroutine begins with down to check the line above which is
090583 -        where the Doc Log format structure should begin with line 0302.
090584 -        If the line is less than 10 then it is blank within the
090585 -        meaning of SDS structure, so go check to the structure.
090587 -     ..
090588 -    -label mblabf
090589 -    immed r
090590 -    up
090591 -    loc_cur 0 10
090592 -    split
090593 -    rel_cur 1 0
090594 -    immed d
090595 -    rel_cur -1 0
090596 -    loc_cur 0 1
090597 -    -goto whab2
090598 -
090599 -        This means the line above is not blank; this is an error so
090600 -        fix it by making the line blank.
090601 -
090603 -  ..
090604 - Line 550, ref OF 1 6S6J, -label whabl
090605 -
090606 -    -label whabl
090607 -    down
090608 -    setlen 1 0
090609 -    -if @1 < 10 -goto whab2
090610 -    -goto mblabf
090611 -
090612 -        Check the line above to establish there is a blank line below
090613 -        the bottom of the prior field, which is another important SDS
090614 -        format.  If, so go and enter the correct structure for a six
090615 -        level line number, ref SDS 0 IS4O; otherwise, go and make this
090616 -        a blank line. ref SDS 0 QM7M
090617 -
090619 -  ..
090620 - Line 560, ref OF 1 IV7J, -label whab2
090621 -
090622 -    -label whab2
090623 -    up
090624 -    ins_text"0302 -     "
090625 -    -return
090626 -
090627 -        Create a six level line number with the right structure for
090628 -        document listing formats.  Then return from the subroutine and
090629 -        do next doc type. ref SDS 0 SK6G
090630 -
090631 -
090632 -
090633 -
090634 -
090635 -
0907 -

SUBJECTS
Zip Update SDS Program and My SDS Records for Training Purposes on Ga

1003 -
100401 -  ..
100402 - SDS Program Code and Work Records Updated
100403 -
100404 - Follow up ref SDS 4 NE6M, ref SDS 3 NE6M.
100405 -
100406 - Submitted email notifying Gary SDS update is on the web covering the
100407 - period from last transfer on 030414. ref SDS 4 NE6M
100409 -  ..
100410 - Used procedures reported on 021201. ref SDS 2 CL9N
100412 -  ..
100413 - This update has following improvements and corrections...
100414 -
100415 -     1.  Improve code for F2 that saves
100416 -         SDS records; now automatically
100417 -         maintains the format for listing
100418 -         documents that are cited in the
100419 -         record, explained above............... 030505 ref SDS 0 0001
100421 -          ..
100422 -     2.  Developed guidance on outlining
100423 -         in long, complex records,
100424 -         because this has proven to be
100425 -         problematic........................... 030505 ref SDS 8 0001
100426 -
100428 -  ..
100429 - Updated files can be downloaded at....
100430 -
100431 -        http://www.welchco.com/09/
100432 -
100433 -
100434 -
100435 -
100436 -
100437 -
100438 -
100439 -
100440 -
100441 -
100442 -
100443 -
100444 -
1005 -