Conference iosg::all-in-1_v30

    
    Hi Felix,
    
    Hmmm, this error occurs if CM cannot find the file where is exepcts it
    to find. What did you do before you did the MBA (move to base area)?
    
    - How did you receive the element in CM? Receive from VMS? Create
      element?
    - Did you move it to the Live area first or did you move it to Base
      right away? 
    - What are the values of the following fields ($CM_KEY = element key):
    
    	CM$SITELOG.LIVE[$CM_KEY]
    	CM$SITELOG.LIVE_EQ_DEV[$CM_KEY]
    	CM$SITELOG.LIVE_DISK_LOCATION[$CM_KEY]
    	CM$SITELOG.STANDARD_FLAG[$CM_KEY]
    
    - Does HELP element CONF exist in RRS$SITE_LIB_RRS_GERMAN:OAHELP.HLB?
    - Is RRS$SITE_LIB_RRS_GERMAN:OAHELP.HLB the HELP library for the
      compiled HELP? If so, what is the HELP library for the HELP SOURCES?
    
    
    Concerning your message:
    
    You can use only 1 HELP library at the time. By default this will be
    OA$LIB:OAHELP.HLB (meaning either OA$SITE_LIB_<language>:OAHELP.HLB or
    OA$LIB_<language>:OAHELP.HLB). In which library did you put your HELP
    element when moving it to Base?
    
    Please refer to note 981.2 for an explanation on HELP elements and
    their Live/Base locations.
    
    Ciao,
    
    	Simon 

    Hi Simon,
    
    Well, a lot of questions but i think i see now how it works. If i'm not too
    wrong this is how the authorization location should looks like:
    
                                  Add Authorized Location
    
     Area:             RRS_GERMAN
     Type:             HLP
     Site Location:    OA$SITE_LIB_GERMAN:OAHELP.HLB
     Base Location:    RRS$LIB_RRS_GERMAN:OAHELP.HLB
     Description:      Help for Raum Reservation System
     Open:             Y
     Txl:              N    Txl Type:
     Languages:        GERMAN
     Protection proc.:
     Site Translation: A1DISK:[ALLIN1.SITE.LIB_GERMAN]
     Base Translation: A1DISK:[ALLIN1.LIB_RRS_GERMAN]
    
    In the previous try, the site location was
    RRS$SITE_LIB_RRS_GERMAN:OAHELP.HLB, which is not allowed as there is
    only one OAHELP.HLB at the time.
    
    Thanks for your help Simon.
    
    Felix

     Hi Felix,
    
     > Site Location:    OA$SITE_LIB_GERMAN:OAHELP.HLB

     You've overlooked one thing here. The Live and Base locations defined
     for HLP elements are for the HELP Sources, not the compiled versions.

     When creating/editing a HLP source, CM automatically maintains the
     compiled version; it's taken into the slipstream of the HLP source. 
     Hence the reason for e.g. OA$SITE_DEV_GERMAN:FORMATTED_DEVELOP.HLB
     which contains the compiled version of your HLP source.

     To 'recover' from this, I would suggest to:

     - delete the record from CM$AUTH$LOCATIONS
     - create 2 HLP Source libraries in the same directory as where OAHELP
       resides (at least OA$LIB_GERMAN: but also OA$SITE_LIB_GERMAN:), e.g.:

		OA$SITE_LIB_GERMAN:RRS_SITEHLPSOURCE.HLB
		OA$LIB_GERMAN:RRS_HLPSOURCE.HLB

     - add a record to CM$AUTH$LOCATIONS:

	<WRITE ADD CM$AUTH$LOCATIONS AREA = "RRS_GERMAN", TYPE = "HLP" ,-
		   LOCATION = "OA$SITE_LIB_GERMAN:RRS_SITEHLPSOURTCE.HLB" ,-
		   BASE_LOCATION = "OA$LIB_GERMAN:RRS_HLPSOURTCE.HLB" ,-
		   DESCRIPTION = "Help for Raum Reservation System" ,-
		   OPEN = CM$_Y

       (the reason for the interactive addition is that a particular Live
	location can only be used for one application area)

     I hope this makews sense.

     Ciao,

	Simon

    Hi Simon,
    
    Can you tell me what append then when restoring my application package
    on an other system, does CM+ restore OA$LIB_GERMAN:RRS_HLPSOURCE.HLP for
    example? Or do i have to make it by hand?
    
    Felix

    
    Hi Felix,
    
    You got me between the 'eys' this time.
    
    > Or do i have to make it by hand?
    
    A straight answer, yes. There appears to be a problem in
    CM_PUT_HLP_IN_HLB.COM in that it only uses '/REPLACE', which doesn't
    work if the HELP library doesn't exist. FMS does create the library,
    even with '/REPLACE'.
    
    There are some workarounds of which the following 2 are the easiests:
    
    1) Modify CM_PUT_HLP_IN_HLB.COM and change:
    
    	$       LIBRARY/HELP/REPLACE 'P2' 'P1'
    
       to:
    
    	$	IF F$SEARCH(P2) .EQS. "" 
    	$	 THEN
    	$	  LIBRARY/HELP/CREATE 'P2' 'P1'
    	$	 ELSE
    	$	  LIBRARY/HELP/REPLACE 'P2' 'P1'
    	$	ENDIF
    
       If it were Base elements which are being restored, you need to check
       the protection of the new HELP library
    
    2) If this is the first time
       Make sure all HLP elements are moved to Base 
       Create a new element: A_RRS_HLPSOURCE FGN <area>
       Take OA$LIB_GERMAN:RRS_HLPSOURCE.HLP as the required template
       Move it to Base
       Package it with the other elements
       Restore it on the receiving system
       As it is the first element to be processed, the library will be
    	available before any of the RRS elements is processed
    
       Bottom line: Make the library the first element in the package
                    The HLP elements are replaced unnecessary the first
    			time, but it is a workaround
    
    I've sent the problem report. 
    
    Sorry,
    
    	Simon
    
    PS Yes, I'm aware, solutions are getting more 'dangerous' but someone
       else once started this habit ...;-)