Conference iosg::all-in-1_v30

2127.0. "Prob: Linking Datatrieve V6.0-1 against ALL-IN-1" by AIMTEC::WICKS_A (A year behind in more ways than one) Wed Jan 20 1993 04:06

We've recently discovered a problem relinking ALL-IN-1 against the
latest patched version of Datatrieve which is slightly reminiscent
of the problem reported earlier in this notesfile with NOTES v2.3
in that it's caused by an unannounced change to the image-id of
a layered product so I thought i'd bring this to the attention of the 
greater noting public.

Thanks to Glenn Mixon in Colorado and Mark Hyde in Atlanta for all their
assistance on this article, also to Alice Braswell here in Atlanta
for first disturbing my all-day coffee and notes break to bring this
problem to my attention, and in advance to Faith for putting a more accurate
version of it into STARS tomorrow.

The facts are theirs, the errors mine

Regards,

Andrew.D.Wicks

TITLE: OA1: ALL-IN-1 fails to relink after Applying DTR V6.0 ECO
LAYERED PRODUCT: ALL-IN-1 v2.3, v2.4, v3.0

PROBLEM: 

After installing Datatrieve V6.0 ECO1, attempts to link Datatrieve
with ALL-IN-1 fail with:

Your DATATRIEVE version should be at least V5.0
You have V , the installation will continue, but the link with
  DATATRIEVE is not supported.

ANALYSIS:

Datatrieve V6.0 ECO1 is provided by CSCPAT_0355.  You can verify
if it has been applied by analyzing your DTRSHR image and checking
the file identification information (fourth screen):

$ ANALYZE/IMAGE/INTERACTIVE SYS$SHARE:DTRSHRxx

If you see V6.0-1 as in the example below, the patch has been applied.

	Image Identification Information

		image name: "DTRSHR"
		image file identification: "V6.0-1"
		link date/time: 16-DEC-1992 15:02:41.17
		linker identification: "05-13"

Image file identification for unpatched Datatrieve V6.0 is 
"VAX DTR V6.0-0".

SOLUTION:

If you wish to link Datatrieve V6.0 with ECO1 applied and ALL-IN-1 
V2.3, V2.4, or V3.0, you must modify the link command procedure 
OA$BUILD_SHARE:A1LNKASK.COM.

There are two scenarios in which this might apply:

1) If you already have ALL-IN-1 installed and you are trying to relink ALL-IN-1 
   to add Datatrieve support for the first time.
or:
2) if you had ALL-IN-1 linked with Datatrieve and are now relinking ALL-IN-1
   for the first time since installing ECO1 and following application of the 
   latest patch to your version of ALL-IN-1 which is either:
   a) ALL-IN-1 v2.3 patch K513 (CSCPAT_3000)
   b) ALL-IN-1 v2.4 patch K605 (CSCPAT_3009)
   c) ALL-IN-1 v3.0-1 (CSCPAT_3065)


    The original code:

$!=====================================================================
$! CHECK_VERSION subroutine P1 = image P2 = nn.n (min version) P3 =1 if .ges.p2
$!=====================================================================
$CHECK_VERSION:                                                     
$SUBROUTINE                                                         
$       on warning then goto CHECK_VERSION_ERROR                    
$       'p3 == 0                                                    
$       p2 = p2 - "."                                               
$                                       
$	open/read/share/error=CHECK_VERSION_ERROR idf  'p1'
$	read/error=CHECK_VERSION_ERROR idf hdr
$	close idf  
$	idoff = f$extract(6,2,hdr)      
$	idoff = f$cvui(0,16,idoff)+40   
$	idlen = f$extract(idoff,1,hdr)  
$	idlen = f$cvui(0,8,idlen)               
$	idver = "''f$extract(idoff+1,idlen,hdr)'"  - "VAX" - "VMS"
$       idver = f$edit(idver,"COMPRESS,TRIM")             
$	idver = "''f$element(1," ",idver)'"                             
$	mjver = "''f$element(0,"-",idver)'" - "T" - "V" - "."           
$	miver = "''f$element(1,"-",idver)'"                             
$       'p4 == "''f$element(0,"-",idver)'" - "T" - "V"
$  	if "''mjver'"   .ges. "''p2'" then 'p3 == 1                 
$	if "''mjver'"  .lts.  "''p2'" then 'p3 == 0                 
$       exit                                                    

Code after modification:    

$!=====================================================================
$! CHECK_VERSION subroutine P1 = image P2 = nn.n (min version) P3 =1 if .ges.p2
$!=====================================================================
$CHECK_VERSION:                                                     
$SUBROUTINE                                                         
$       on warning then goto CHECK_VERSION_ERROR                    
$       'p3 == 0                                                    
$       p2 = p2 - "."                                               
$                                       
$	open/read/share/error=CHECK_VERSION_ERROR idf  'p1'
$	read/error=CHECK_VERSION_ERROR idf hdr
$	close idf  
$	idoff = f$extract(6,2,hdr)      
$	idoff = f$cvui(0,16,idoff)+40   
$	idlen = f$extract(idoff,1,hdr)  
$	idlen = f$cvui(0,8,idlen)               
$	idver = "''f$extract(idoff+1,idlen,hdr)'"  - "VAX" - "VMS"
$       idver = f$edit(idver,"COMPRESS,TRIM")             
$ !
$ ! modification suggested by Customer Support Center/Colo Springs
$ ! to allow DTR V6.0 with eco 1 applied to link with ALL-IN-1
$ !
$       idloc = f$locate("6.0",IDVER)
$       IF "''IDLOC'" .EQS. "1" THEN IDVER = "DTR " + IDVER
$ !
$ ! end Customer Support Center recommendation
$ !
$	idver = "''f$element(1," ",idver)'"                             
$	mjver = "''f$element(0,"-",idver)'" - "T" - "V" - "."           
$	miver = "''f$element(1,"-",idver)'"                 
$       'p4 == "''f$element(0,"-",idver)'" - "T" - "V" 
$  	if "''mjver'"   .ges. "''p2'" then 'p3 == 1                 
$	if "''mjver'"  .lts.  "''p2'" then 'p3 == 0                 
$       exit                                                        


o Now you can relink ALL-IN-1:
  
If you are running ALL-IN-1 Version 2.3 or 2.4, issue this command:
$ SET DEFAULT OA$BUILD_SHARE:

If you are running ALL-IN-1 Version 3.0, issue this command:
$ SET DEFAULT OA$BUILD_LLV:

Now, relink ALL-IN-1:

$ @A1LNKDRV

Alternative scenario: Installing ALL-IN-1
=========================================

If you are installing ALL-IN-1, you can proceed with the ALL-IN-1 
installation, knowing that the link with Datatrieve will not be 
supported.  

Then you can modify the A1LNKASK.COM file after the  installation and relink
as detailed above.

VERSION INFORMATION:
     
Operating System and Version(s): VMS V5.5
Layered Product/Component Version(s): Datatrieve V6.0, ALL-IN-1 V2.3,
                                                           V2.4, V3.0
     
     
DIGITAL RESPONSE:

This problem has been reported to Engineering.