ASPL User Guide v 1.00
© 2025 Bassem W. Jamaleddine

The workspace repository is a container for namedspaces. A namedspace has a unique name that consists of a simple uppercase word. For example, TRIVIAL is a valid namedspace called TRIVIAL. The meta data of the attributes, the symbol tables, answer stacks, history, and description of TRIVIAL are all saved in its corresponding namedspace.

ASPL users do not need to access and maintain the namedspaces directly, as ASPL automatically saves namedspaces and checks the consistency of their meta data when loading them. However, there are situations when migrating namedspaces across legacy system, the user may need to fix the meta data. The following command asplmgrp helps you manage ASPL namedspace mgrp files.

  asplmgrp [-help] 
       [-attributes MGRPFILE]
       [-attverbose]
       [-list WSPREPOS] 
       [-dumpmgrp MGRPFILE] [-dumpmgrps WSPREPOS DESTDIR] 
       [-fixmagic MGRFILE SOMEDIR] [-fixmagicall WSPREPOS SOMEDIR]
       [-fix MGRPFILE] [-fixemall WSPREPOS]
       [-updatedescriptions WSPREPOS SOMEDIR]
       [-dumpdescription MGRPFILE TEXTFILE]
       [-updatedescription MGRPFILE TEXTFILE]
       [-validatemgrps WSPREPOS SOMEDIR]
       [-comparemgrp MGRPFILE1 MGRPFILE2]
       [-comparemgrps WSPREPOS1 WSPREPOS2]
       [-compareattributes MGRPFILE1 MGRPFILE2]
       [-compare2elmd MGRPFILE] 
       [-catdescription MGRPFILE]
       [-catscratchpad MGRPFILE]
       [-caths MGRPFILE] 
       [-lisths WSPREPOS] 

Where:

 -help                                   
    display this summary.
 -attributes MGRPFILE    
   inspect attributes of an mgrp file
 -attverbose               
    print additional consistency check on attributes when using -list or -fix,
    if ATTRIBUTES FAIL CONSISTENCY then show attributes
 -list WSPREPOS                          
    list the namedspaces located in the workspace repository WSPREPOS
 -dumpmgrp MGRPFILE                      
    dump the mgrp namedspace MGRPFILE to current directory
 -dumpmgrps WSPREPOS SOMEDIR             
    dump all mgrp files in workspace repository WSPREPOS to the
    destination SOMEDIR
 -fixmagic MGRPFILE SOMEDIR              
    fix the mgrp file reading by its mgO file from SOMEDIR
 -fixmagicall WSPREPOS SOMEDIR           
    fix all the mrgp files in WSPREPOS by reading their corresponding
    mgO from SOMEDIR
 -fix MGRPFILE                           
    fix the mgrp file without mgO, rather fixing its El.G.C. by
    loading its Elements-enodeClass (INTERNAL USE)
 -fixemall WSPREPOS                      
    fix all the mgrp files located in the workspace WSPREPOS, (INTERNAL USE)
 -updatedescriptions WSPREPOS SOMEDIR  
    update descriptions of all namedspaces in WSPREPOS by reading their data from SOMEDIR
 -dumpdescription MGRPFILE TEXTFILE      
   dump the description in the mgrp namedspace MGRPFILE to text file TEXTFILE
 -updatedescription MGRPFILE TEXTFILE    
   update description in the MGRPFILE file by reading it from TEXTFILE
 -validatemgrps WSPREPOS SOMEDIR        
   validate all mgrp files in WSPREPOS by reading their data from SOMEDIR
 -comparemgrp MGRPFILE1 MGRPFILE2      
   compare two mgrp files
 -comparemgrps WSPREPOS1 WSPREPOS2      
   compare all mgrp files in both repos WSPREPOS1 and WSPREPOS2
 -compareattributes MGRPFILE1 MGRPFILE2 
   compare attributes of two mgrp files
 -compare2elmd MGRPFILE     
   compare ELMD of an mgrp file
-catdescription MGRPFILE
   print the description in the mgrp namedspace MGRPFILE
-catscratchpad MGRPFILE
   print the scratchpad in the mgrp namedspace MGRPFILE
-caths MGRPFILE
   print the history in the mgrp namedspace MGRPFILE
 -lisths WSPREPOS                        
    print the history of all workspaces located in the workspace 
    repository WSPREPOS

To list the namedspaces in your workspace, show their corresponding grouping classes, and check their consistency:

# asplmgrp -list `asplcmd ~wsp`

To display the history saved in the namedspace TRIVIAL:

# asplmgrp -caths `asplcmd ~wsp`/TRIVIAL.mgrp

To display the description of the namedspace TRIVIAL:

# asplmgrp -catdescription `asplcmd ~wsp`/TRIVIAL.mgrp

To dump the description of the namedspace ACMESTUFF to text file foo.txt:

# asplmgrp -dumpdescription `asplcmd ~wsp`/ACMESTUFF.mgrp foo.txt

Now foo.txt is dumped in the current directory. You can edit it, then update ACMESTUFF description

#  asplmgrp -updatedescription `asplcmd ~wsp`/ACMESTUFF.mgrp foo.txt