xmstuff (c) 2008  Allegro Consultants, Inc.; www.allegrosupport.com            
                                                                        
XMSTUFF is a program to do explore/report some information about        
the Transaction Manager (XM) on the current system.                     
                                                                        
Although some care is taken to check parameters, this is still an       
experimental program.  To date, no problems have been seen, but         
be careful.                                                             
                                                                        
The user may want to issue a process-local breakpoint at xm_sf          
...if hit, do:  mr pc [sr4.r2]; abort                                   
-----------------------------------------------------------             
                                                                        
Commands:                                                               
                                                                        
Exit              (or:  //)                                             
                                                                        
   Terminates the program.                                              
                                                                        
GETVSets [options]                                                      
   options ::= < noFAST | noSLOW >                                      
                                                                        
Help  [keyword]   (or: ?)                                               
                                                                        
   HELP keyword displays any help text associated with the              
   specified keyword.                                                   
                                                                        
   HELP <return> displays the entire help file.                         
                                                                        
LISTvs [options]*                                                       
   options ::= < noALLVOLUMES | noLOGFiles | noMembers |                
                  noVerbose | noXm >                                    
                                                                        
   Lists all known/mounted volume sets.  For each set, some             
   information is listed (depending upon the other options).            
                                                                        
   ALLVOLUMES lists all the mounted volumes, regardless of              
   volume set.                                                          
                                                                        
   LOGFILES lists statistics from the XM checkpoint logffiles           
   for all volume sets.                                                 
                                                                        
   MEMBERS lists all the member volumes of each volume set.             
                                                                        
   VERBOSE is equivalent means ALLVOLUMES, XM.                          
                                                                        
LOGS [noVerbose]                                                        
                                                                        
   Causes XMSTUFF to do a call xm_checkpoint_ssm_maps and               
   xm_do_checkpointlog for every mounted volume set (other than         
   $SYS (MPEXL_SYSTEM_VOLUME_SET)).                                     
                                                                        
   For $SYS, calls checkpointsystemlog;                                 
                                                                        
   Example output:                                                      
                                                                        
      Doing checkpointlog on MPEXL_SYSTEM_VOLUME_SET                    
         lsrowptr = $81c172e0, volid = $056c0001010e3558                
         (checkpointsystemlog)                                          
                                                                        
      Doing checkpointlog on BIG                                        
         lsrowptr = $81c17430, volid = $056c0001384f1fb3                
                                                                        
LSID [volumeid# | ALL | BOTH | DUMP]*                                   
                                                                        
   LSID lists information about a specific volume set (specified        
   via volume ID) or about all volume sets.                             
                                                                        
      NOTE: do not provide it with invalid volume IDs, or with          
      volume IDs that are not associated with the master volume         
      of a set You may regret it ... the system may fail.               
                                                                        
   volumeid# ...  lists information about the specified volume ID       
        (a 16-bit hex nu                                                
                                                                        
   ALL lists information about all volume sets.                         
                                                                        
   DUMP walks the XM logid pool and lists all entries it finds.         
                                                                        
   BOTH implies ALL and DUMP.                                           
                                                                        
SERVERS [[ALL | SOME | #] [options] ]*                                  
      options ::= [noVerbose]                                           
                                                                        
   SERVERS ALL will list all xm_static_checkpoint_server                
   processes.  For each such process, it will attempt to                
   display the most recent "work" message XM has sent to it,            
   which might mean displaying the LDEV of the the master               
   volume of the set the work message was for.                          
                                                                        
   The ALL option says: check all processes to see if they              
   are XM servers.                                                      
                                                                        
   The SOME option says: check processes 2..32 to see if they           
   are XM servers.   (Usually, PINs 17..21 are the servers.)            
                                                                        
   The # option says: check the specified PIN to see if it is           
   an XM server.                                                        
                                                                        
   The Verbose option dumps more information.                           
                                                                        
   Default: ALL                                                         
                                                                        
SET_RESET [options]                                                     
   options ::= < noDEBUG1   | noDEBUG2   | noPAGING |                   
                 noRESET    | noSET      | noTIMES  | noVerbose         
                                                                        
SIZES [<noQuiet | noVerbose]>                                           
                                                                        
SSMS [noVerbose]                                                        
                                                                        
   Causes XMSTUFF to call xm_checkpoint_ssm_maps for every              
   mounted volume set.                                                  
                                                                        
USEq [options]                                                          
   options ::= < noUSEQQ    | noUSEQ     | noQuiet |                    
                 noQUIETError >                                         
VERsion                                                                 
                                                                        
   Reports the version of XMSTUFF.                                      
                                                                        
XMGlobals                                                               
                                                                        
   Lists some global XM (Transaction Manager) information.              
                                                                        
CLEARREDO                                                               
DO                                                                      
LISTREDO                                                                
REDO                                                                    

xmstuff XMSTUFF 20150128