Creating EsiObjects MSM Volume Sets

CREATING EXPORT FILES

First you must export all the routines and globals from your Cache development environment. To do this follow the steps below:

1. Make sure the EsiObjects listener serving the ESI development environment is shut down.
2. Bring the Cache Terminal interface up.
3. Use the ZN command to switch to the development ESI namespace that contains the software you want to kit.
4. Now, execute Do MSMKit^VESOUGSV. This saves all VES* routines to the MSM_KIT_VES.RSA and the ^VESO* globals in the KIT_VESO.GSA file. They will reside in the ESI development (default) directory.
5. Shut down the Terminal interface.

CREATE THE MSM CONFIGURATION

1. To create a kitting and test environment for MSM, create a new MSM configuration by executing the following option:
   • Do ^SYSGEN -> 2 - Create New Configuration
2. The partition size must be large enough to prevent <PGMOV> errors. Set (default partition size) = 500 KB
   • Do ^SYSGEN -> 3 - Edit Configuration Parameters -> 12 - Default Partition Size
3. Can also be set via ^%PARTSIZ
4. Set (allow routine lines greater than 255)
   • Do ^SYSGEN -> 3 - Edit Configuration Parameters -> 20 - Mode Flags
5. This prevents <ISYNT> errors. You may have to restart MSM to enable this flag.
6. Increase the STACK and STAP to 64 KB
   • Do ^SYSGEN : 9 - System Configuration Parameters : 2 - Stack and Stap Size
7. This prevents <STKOV> errors when you are doing large routine restores. You have to restart MSM to enable this.

CREATE THE ESI.VOL and USER.VOL VOLUME GROUPS

1. MSM Server has global translation, but no routine translation. So the two volume sets created here will contain:
   • [ESI,ESI]: ESI.VOL -> VESO* globals
   • VESO* routines
   • VESo* routines,
   • [USR,USR]: USER.VOL -> VESO* routines
   • VESo* routines
2. The VESo* globals are not needed, they are created automatically
3. Log into MGR:XXX
4. Create the ESI.VOL volume group.
   • Do ^SYSGEN -> 10 Database Definition -> 1 - Create a Database Volume (50 MB)
5. Mount the volume set.
   • Do ^SYSGEN : 10 Database Definition : 4 - Mount a Volume Group
6. Create the [ESI,ESI] UCI.
   • Do ^SYSGEN -> 7 - UCI Management -> 1 - Create New UCI
7. Set (max global data length) = 511
   • Do ^SYSGEN ->10 Database Definition -> 9 - Edit Volume Group Characteristics
8. Switch to the volume set ESI:XXX (if you shut down, remember to mount ESI.VOL again, or auto-mount it)
9. Import the routines from the MSM_KIT_VES.RSA file.
   • Do ^%RR
10. Import the VESOUGLD.rsa routine. This routine cleans up all ^VES globals and loads all new globals from the KIT_VESO.GSA file.
    • Do ^%RR
11. Run this routine to insure all MSM specific lines in routines are enabled and non-MSM lines are disabled.
    • Do ^VESOUXCD
12. Load the VESO* globals (KIT_VESO.GSA). The VESOUGLD routine is hardcoded to look within the MSM directory for the KIT_VESO.GSA file. Make sure it is in that directory before starting.
    • Do ^VESOUGLD
13. If you run out of space in the volume, halt out of the ESI UCI and log into the MGR UCI and expand it. Log out and back into ESI:XXX and rerun Step 11.
    • Do ^SYSGEN -> 10 - Database Definition -> 6 - Expand a Database Volume
14. Now create the USR,USR volume group. Log out of ESI,ESI and into MGR:XXX
15. Create the USR.VOL volume group.
    • Do ^SYSGEN -> 10 Database Definition -> 1 - Create a Database Volume (26 MB)
16. Mount the volume set.
    • Do ^SYSGEN : 10 Database Definition : 4 - Mount a Volume Group
17. Create the [USR,USR] UCI.
    • Do ^SYSGEN -> 7 - UCI Management -> 1 - Create New UCI
18. Set (max global data length) = 511
    • Do ^SYSGEN ->10 Database Definition -> 9 - Edit Volume Group Characteristics
19. Switch to the volume set USR:XXX
20. Import the routines from the CACHE_KIT_VES.RSA file. The VESO* and VESo* routines must be loaded to this UCI since MSM does not support routine translation.
    • Do ^%RR
21. Run this routine to insure all MSM specific lines in routines are enabled and non-MSM lines are disabled.
    • Do ^VESOUXCD

SET GLOBAL TRANSLATION

1. Switch to manager MGR:XXX.
2. Create translation table entry.
3. Do ^SYSGEN -> 3 - Edit Configuration Parameters -> 13 - Translation/Replication Table Maintenance
4. Enable translation.Global Translate Lock Repl Functions Coll Global
   
5. # Name(s) From UCI To UCI Master Ind Enabled Seq encode
6. ------- ---------------- ------ ---- --------- ---- ------
7. 1 VESO* USR,USR ESI,ESI ESI,ESI TRANSLATION NUM 8-bit
8. LOCK MASTER
9. Do ^SYSGEN -> 3 - Edit Configuration Parameters -> 13 - Translation/Replication Table Maintenance -> 2 - Enable Translation

SET PROTECTION ON ESI GLOBALS

1. Switch to ESI:XXX
   Set protection
   1. Do ^%GCH
2. Set all globals to RW access for World.
   • New Status --> System = RWD World = RWD Group = NONE User = RWD

UPDATE ROUTINES AND COMPILE LIBRARIES

1. Switch to ESI:XXX.
2. Run the primitive browser.
   • Do ^VESOZ
3. Enter your initials.
4. Select the R)ecompile All option.
5. Switch to USR:XXX
   • Do ^VESOZ
6. Select the R)ecompile All option.
7. Create the User Library References
8. Move to USR,USR
   • Merge ^VESoL("I")=^["ESI","ESI"]VESOL("I")
   • Merge ^VESoL("S")=^["ESI","ESI"]VESOL("S")
9. Log out of MSM and shut it down. The ESI.VOL and USR.VOL are now ready to kit.