XSCHEMA is a utility to extract a schema from an IMAGE database,                
producing a DBSCHEMA-compatible schema file.                                    
                                                                                
For help on a specific command, enter:     HELP <command name>                  
For a list of commands, enter:             HELP COMMANDS                        
                                                                                
-----------------------------------------------------------------               
Commands:                                                                       
   EXIT           ... terminate program                                         
   SCHEMA         ... produce a schema for an IMAGE database.                   
   QUICKREFERENCE ... produce a quick one-line-per-dataset                      
                      reference card for an IMAGE database.                     
   FLAGS          ... report some flags for the database                        
   HELP           ... display help about the program                            
   and: SET, VERSION, CLEARREDO, DO, LISTREDO, REDO                             
                                                                                
Each command is documented below, in alphabetic order:                          
                                                                                
   DO      [prefix]                                                             
                                                                                
      If a prefix is specified, finds the most recent redo line that            
      matches the prefix and re-submits it.  If no prefix is specified,         
      the most recent input is re-submitted.                                    
                                                                                
   Exit                                                                         
                                                                                
      Terminates XSCHEMA.                                                       
                                                                                
FLAGS basename [options]  [ [TO] outputfile ]                                   
                                                                                
   Reports interesting 'flags' for the database.                                
                                                                                
   Help   [OFFLINE] [command_name_prefix]                                       
                                                                                
      HELP <cr> displays the entire help text.                                  
      HELP E    displays help for all commands starting with E.                 
                                                                                
      The OFFLINE option routes the help text to LP instead of to the           
      terminal.                                                                 
                                                                                
   LISTREDO                                                                     
                                                                                
      Lists the REDO stack, which persists across runs (while in the            
      same session or job).                                                     
                                                                                
   QUICKREF base [options]                                                      
                                                                                
   REDO    [prefix]                                                             
                                                                                
      If a prefix is specified, finds the most recent redo line that            
      matches the prefix and presents it for editing and re-submitting.         
                                                                                
      If no prefix is specified, the most recent input is presented for         
      editing and re-submitting.                                                
                                                                                
      The editor used by REDO is QZMODIFY.  Pressing ^W and then H will         
      result in help information.                                               
                                                                                
   SCHEMA <base>  [options] [FLAGSonly]  [[TO] outputfile]                      
                                                                                
      Extract the schema from the specified database (root file).               
                                                                                
   SET [<option>]*                                                              
                                                                                
      options ::=                                                               
                         BATCH        |                                         
                     [no]CAPacity     |                                         
                     [no]CHECK_NAME_SYNTAX |                                    
                     [no]COLTRUNcate  |                                         
                     [no]DEBUG1       |                                         
                     [no]DEBUGCAP     |                                         
                     [no]DELete       |                                         
                     [no]FEAtures     |                                         
                     [no]LP           |                                         
                     [no]NOROOT       |                                         
                     [no]PAGING       |                                         
                     [no]PASSwords    |                                         
                     [no]PATHS        |                                         
                     [no]SHORTUClist                                            
                                                                                
      The FLAGS, QUICKREFERENCE, and SCHEMA commands allow you to               
      temporarily specify any of the above options (which will be               
      affected for the duration of the command).                                
                                                                                
      The SET command turns on (or off) the specified flags, remembering        
      their state for subsequent commands.  The state of all options is         
      reported at the end of the SET command.  To see the options and           
      flags without changing any of them, enter SET with no options.            
      SETQ is like SET, but does not report the settings at the end of          
      the command.                                                              
                                                                                
   options:                                                                     
                                                                                
      BATCH tells XSCHEMA to act as if it was in a batch job.                   
      Default: (set for jobs)                                                   
                                                                                
      CAPacity tells XSCHEMA to display the capacity (and other                 
      information) for each dataset.  (One output line per dataset.)            
      Default: (set to true for QUICKREF if PASSWORDS is off)                   
                                                                                
      CHECK_NAME_SYNTAX tells X to check the syntax of the database name        
      for validity before opening it.                                           
      Default: set                                                              
                                                                                
      COLTRUNcate tells XSCHEMA to truncate output (if needed) during a         
      QUICKREFERENCE command.                                                   
                                                                                
      DELete tells XSCHEMA it is okay to delete the target output file          
      if it already exists.                                                     
                                                                                
      FEAture tells X to emit extra information about each dataset in           
      the SCHEMA output (including features used, and .  including              
      highwater information).                                                   
                                                                                
      LP routes all subsequent output to the printer instead of to the          
      terminal.  SET NOLP cancels this.                                         
                                                                                
      NOROOT tells XSCHEMA that the schema files should default to              
      having "$control noroot" at the start.                                    
                                                                                
      PAGING tells XSCHEMA to paginate the output sent to the terminal.         
      Default: set (for sessions)                                               
                                                                                
      PASSwords tells X to display all the passwords for the database.          
      Default: set                                                              
                                                                                
      PATHS tells X to display path information in the SCHEMA output.           
                                                                                
      SHORTUClist tells X to display the map of read/write access for           
      passwords in a shorter manner: by not mentioning 'R' for any              
      password that grants 'W'.  (IMAGE probably assumes that 'W'               
      implies 'R'.)                                                             
      Default: set                                                              
                                                                                
   VERSION                                                                      
                                                                                
      Reports the version number of XSCHEMA.                                    
                                                                                
-----------------------------------------------------------------               
News (recent changes)                                                           
                                                                                
2014-06-05                                                                      
   Added NOROOT option                                                          
                                                                                
2014-06-03                                                                      
   First version                                                                
                                                                                
-----------------------------------------------------------------               
                                                                                
NOTE: if you find problems, please email support@allegrosupport.com                    
//                                                                              


XSCHEMA [20150128]   Copyright (c) 2000 Allegro Consultants, Inc.