Syntax
Path = SRP_Mobile_Repository(CtrlEntID, 'AttachMobileRepository', Path, LoadOption)
Returns
If successful the path to the mobile repository just attached, otherwise 0.
Parameters
| Parameter | Description |
|---|---|
| Path | Directory path where the mobile repository is located. |
| LoadOption | Flag to determine how the RTP27 SSP should be used or even if it should be used at all. Valid options are ‘Now’, ‘Later’, and ‘Skip’. Default value is ‘Later’. See Remarks for more information. |
Remarks
Attaching a mobile repository allows OpenInsight to use entities that are stored in the designated path.
When a mobile repository path is attached then RTP27 (OpenInsight’s program loader) needs to be called to refresh the program stack cache. Otherwise, if any procedure in the mobile repository had already been executed from the local repository then local version will still be called using the cache. The AttachMobileRepository method will automatically manage this but there are occasions when running RTP27 immediately versus later can have unpredictable results. (Note: This is almost certain to happen if the procedure is currently in the active Call Stack.) Setting the LoadOption flag to ‘Later’, the default value, allows OpenInsight to call RTP27 after the current Call Stack is emptied. It uses the IDLEPROC property to handle this. If the AttachMobileRepository method is called using a remote engine then the LoadOption should always be ‘Now’. ‘Skip’ is generally used when the purpose is to validate that a valid mobile repository exists at a designated path.
It generally recommended that the corresponding DetachMobileRepository method use the same value for LoadOption.
Examples
// Attempt to attach the mobile repository located in 'C:\MobRep'. Allow the // LoadType argument to set to the default value of 'Later' Path = SRP_Mobile_Repository(CtrlEntID, 'AttachMobileRepository', 'C:\MobRep')
